huibo-ui 0.3.0

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

@@ -0,0 +1,21 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Tag 标签组件
+ * 用于标记和选择
+ */
+export declare class Tag {
+    /** 标签类型 */
+    type: 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'default';
+    /** 是否可关闭 */
+    closable: boolean;
+    /** 主题效果 */
+    effect: 'dark' | 'light' | 'plain';
+    /** 是否圆角 */
+    round: boolean;
+    /** 标签尺寸 */
+    size: 'small' | 'default' | 'large';
+    /** 关闭事件 */
+    hbClose: EventEmitter<void>;
+    private handleClose;
+    render(): any;
+}

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

@@ -0,0 +1,37 @@
+/**
+ * Text 文本组件
+ * 用于文本展示的基础组件
+ */
+export declare class Text {
+    /**
+     * 文本类型
+     * @default ''
+     */
+    type: 'primary' | 'success' | 'warning' | 'danger' | 'info' | '';
+    /**
+     * 文本大小
+     * @default 'default'
+     */
+    size: 'large' | 'default' | 'small';
+    /**
+     * 是否省略
+     * @default false
+     */
+    truncated: boolean;
+    /**
+     * 是否加粗
+     * @default false
+     */
+    bold: boolean;
+    /**
+     * 是否斜体
+     * @default false
+     */
+    italic: boolean;
+    /**
+     * 是否删除线
+     * @default false
+     */
+    deleted: boolean;
+    render(): any;
+}

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

@@ -0,0 +1,62 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * TimePicker 时间选择器组件
+ * 用于选择或输入时间
+ */
+export declare class TimePicker {
+    el: HTMLElement;
+    /**
+     * 绑定值
+     */
+    modelValue?: string;
+    /**
+     * 输入框占位文本
+     */
+    placeholder: string;
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled: boolean;
+    /**
+     * 输入框尺寸
+     */
+    size: 'large' | 'default' | 'small';
+    /**
+     * 是否可清空
+     * @default false
+     */
+    clearable: boolean;
+    /**
+     * 时间格式
+     * @default 'HH:mm:ss'
+     */
+    format: string;
+    /**
+     * 原生 name 属性
+     */
+    name?: string;
+    /**
+     * 原生 id 属性
+     */
+    inputId?: string;
+    isOpen: boolean;
+    inputValue: string;
+    selectedHour: number;
+    selectedMinute: number;
+    selectedSecond: number;
+    /**
+     * 值改变事件
+     */
+    hbChange: EventEmitter<string>;
+    private clickOutside;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    handleValueChange(): void;
+    private updateInputValue;
+    private handleInputClick;
+    private handleClear;
+    private handleTimeSelect;
+    private generateNumbers;
+    render(): any;
+}

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

@@ -0,0 +1,69 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * TimeSelect 时间选择组件
+ * 可用于时间选择
+ */
+export declare class TimeSelect {
+    el: HTMLElement;
+    /**
+     * 绑定值
+     */
+    modelValue?: string;
+    /**
+     * 输入框占位文本
+     */
+    placeholder: string;
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled: boolean;
+    /**
+     * 输入框尺寸
+     */
+    size: 'large' | 'default' | 'small';
+    /**
+     * 是否可清空
+     * @default false
+     */
+    clearable: boolean;
+    /**
+     * 开始时间
+     * @default '09:00'
+     */
+    start: string;
+    /**
+     * 结束时间
+     * @default '18:00'
+     */
+    end: string;
+    /**
+     * 间隔时间
+     * @default 60
+     */
+    step: number;
+    /**
+     * 最小时间
+     */
+    minTime?: string;
+    /**
+     * 最大时间
+     */
+    maxTime?: string;
+    isOpen: boolean;
+    inputValue: string;
+    /**
+     * 值改变事件
+     */
+    hbChange: EventEmitter<string>;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    private handleDocumentClick;
+    handleValueChange(): void;
+    private updateInputValue;
+    private generateTimeOptions;
+    private handleInputClick;
+    private handleClear;
+    private handleSelect;
+    render(): any;
+}

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

@@ -0,0 +1,16 @@
+/**
+ * Timeline 时间线组件
+ * 按竖线渲染每个 item 的圆点 + 内容 + 时间，支持左/右/交替三种模式
+ */
+export declare class Timeline {
+    /** 时间线模式 */
+    mode: 'left' | 'alternate' | 'right';
+    /** 时间线节点数组 */
+    items: TimelineItem[];
+    render(): any;
+}
+export interface TimelineItem {
+    content: string;
+    time?: string;
+    color?: 'blue' | 'green' | 'red' | 'gray';
+}

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

@@ -0,0 +1,28 @@
+import { Placement } from '../../utils/popup-manager';
+/**
+ * Tooltip 文字提示组件
+ * 鼠标悬停或点击时显示提示文字
+ */
+export declare class Tooltip {
+    el: HTMLElement;
+    /** 提示文字 */
+    content: string;
+    /** 弹出位置 */
+    placement: Placement;
+    /** 触发方式 */
+    trigger: 'hover' | 'click';
+    /** 是否禁用 */
+    disabled: boolean;
+    /** 是否显示箭头 */
+    showArrow: boolean;
+    visible: boolean;
+    popupStyle: Record<string, string>;
+    private triggerRef?;
+    private popupRef?;
+    private hideTimer?;
+    private show;
+    private hide;
+    private toggle;
+    private updatePosition;
+    render(): any;
+}

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

@@ -0,0 +1,39 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export interface TourStep {
+    /** 目标元素 CSS selector */
+    target: string;
+    /** 步骤标题 */
+    title: string;
+    /** 步骤描述 */
+    description: string;
+}
+/**
+ * Tour 引导组件
+ * 通过遮罩 + 高亮卡片引导用户关注页面元素。
+ */
+export declare class Tour {
+    el: HTMLElement;
+    /** 是否显示（受控） */
+    visible: boolean;
+    /** 步骤列表 */
+    steps: TourStep[];
+    /** 当前步骤索引 */
+    current: number;
+    /** 步骤变化事件，detail 为新 current */
+    hbChange: EventEmitter<number>;
+    /** 关闭事件 */
+    hbClose: EventEmitter<void>;
+    private targetRect;
+    private get currentStep();
+    private get isLast();
+    private get isFirst();
+    componentDidRender(): void;
+    componentDidUpdate(): void;
+    private updateTargetRect;
+    private goNext;
+    private goPrev;
+    private finish;
+    private cardStyle;
+    private maskStyle;
+    render(): any;
+}

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

@@ -0,0 +1,73 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+/**
+ * Transfer 数据项
+ */
+export interface TransferDataItem {
+    key: string;
+    title: string;
+    disabled?: boolean;
+}
+/**
+ * Transfer 穿梭框组件
+ * 双栏列表选择，勾选项后通过中间按钮在两栏间移动
+ */
+export declare class Transfer {
+    /**
+     * 数据源
+     */
+    data: TransferDataItem[];
+    /**
+     * 右侧（目标列表）的 keys
+     */
+    targetKeys: string[];
+    /**
+     * 两侧已勾选的 keys
+     */
+    selectedKeys: string[];
+    /**
+     * 标题，[源列表标题, 目标列表标题]
+     * @default ['源列表', '目标列表']
+     */
+    titles: [string, string];
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled: boolean;
+    /**
+     * 是否显示搜索框
+     * @default false
+     */
+    filterable: boolean;
+    /**
+     * 右侧列表变化事件
+     */
+    hbChange: EventEmitter<{
+        targetKeys: string[];
+    }>;
+    leftFilter: string;
+    rightFilter: string;
+    handleSelectedKeysChange(): void;
+    /** 左侧列表：key 不在 targetKeys 中 */
+    private get leftList();
+    /** 右侧列表：key 在 targetKeys 中 */
+    private get rightList();
+    /** 当前列表项是否被勾选 */
+    private isSelected;
+    /** 切换某项的勾选状态 */
+    private toggleItem;
+    /** 获取某侧可勾选（非 disabled）的全部 keys */
+    private getSelectableKeys;
+    /** 计算某侧全选 checkbox 状态：'all' | 'none' | 'indeterminate' */
+    private getCheckAllState;
+    /** 切换某侧全选 */
+    private toggleCheckAll;
+    /** 向右移动：把左侧已勾选的项移到右侧 */
+    private moveToRight;
+    /** 向左移动：把右侧已勾选的项移回左侧 */
+    private moveToLeft;
+    /** 列表项过滤 */
+    private filterList;
+    private renderList;
+    render(): any;
+}

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

@@ -0,0 +1,113 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export interface TreeNode {
+    /** 节点唯一标识 */
+    key: string;
+    /** 节点标题 */
+    title: string;
+    /** 子节点 */
+    children?: TreeNode[];
+    /** 是否禁用 */
+    disabled?: boolean;
+}
+/**
+ * Tree 树形组件
+ * 文件夹、组织架构、分类导航等层级结构的展示与选择
+ */
+export declare class Tree {
+    el: HTMLElement;
+    /**
+     * 可选项数据源（递归树结构）
+     */
+    data: TreeNode[];
+    /**
+     * （受控）展开的节点 key 集合
+     */
+    expandedKeys: string[];
+    /**
+     * （受控）选中的节点 key 集合
+     */
+    selectedKeys: string[];
+    /**
+     * 是否显示 checkbox 复选框
+     * @default false
+     */
+    checkable: boolean;
+    /**
+     * （受控）勾选的节点 key 集合
+     */
+    checkedKeys: string[];
+    /**
+     * 是否默认展开全部节点
+     * @default false
+     */
+    defaultExpandAll: boolean;
+    /**
+     * 是否显示连接线
+     * @default false
+     */
+    showLine: boolean;
+    internalExpanded: string[] | null;
+    internalSelected: string[] | null;
+    internalChecked: string[] | null;
+    /**
+     * 选中节点变化事件（detail: 选中节点 key 数组）
+     */
+    hbSelect: EventEmitter<string[]>;
+    /**
+     * 展开节点变化事件（detail: 展开节点 key 数组）
+     */
+    hbExpand: EventEmitter<string[]>;
+    /**
+     * 勾选节点变化事件（detail: 勾选节点 key 数组）
+     */
+    hbCheck: EventEmitter<string[]>;
+    componentWillLoad(): void;
+    /**
+     * data 变化时，若 defaultExpandAll=true，把所有含 children 的节点 key
+     * 合并进 expandedKeys（保留用户已手动展开的节点，不收起任何已展开项）。
+     * 解决「先 mount 再赋 data」时 componentWillLoad 基于空数据计算导致不展开的问题。
+     */
+    handleDataChange(): void;
+    handleExpandedKeysChange(): void;
+    handleSelectedKeysChange(): void;
+    handleCheckedKeysChange(): void;
+    private collectExpandableKeys;
+    private getExpandedKeys;
+    private getSelectedKeys;
+    private getCheckedKeys;
+    private isExpanded;
+    private isSelected;
+    private isChecked;
+    private handleToggleExpand;
+    private handleSelect;
+    private handleCheck;
+    /**
+     * 从集合中移除某节点所有后代 key（含禁用项），用于取消父级时级联取消。
+     * 不可变：仅修改传入的 Set 副本，不修改树本身。
+     */
+    private removeDescendantKeys;
+    /**
+     * 收集某节点所有「可勾选（非禁用）」后代 key，用于勾选父级时级联勾选。
+     * 注意：禁用子节点本身不可手动勾选，但若其下还有非禁用后代，仍应被级联勾选。
+     */
+    private collectCheckableDescendantKeys;
+    /**
+     * 自底向上修正 checkedKeys 中某节点的所有祖先勾选状态。
+     * 规则：一个祖先节点，当且仅当其所有「非禁用子节点」均被勾选时，自身才被勾选；
+     * 否则移出 checkedKeys（部分选情况由 indeterminate 集合在渲染层暴露，不进入 checkedKeys）。
+     */
+    private reconcileAncestors;
+    /**
+     * 递归查找某 key 的祖先链（不含自身），返回从直接父到根的数组。
+     * 找不到返回空数组（key 为根节点或不存在时）。
+     */
+    private findAncestors;
+    /**
+     * 计算当前 checkedKeys 下处于「部分选中（indeterminate）」的节点 key 集合。
+     * 一个节点为 indeterminate 当：其本身不在 checkedKeys，但其下（递归）存在被勾选的后代。
+     * 用于渲染层暴露三方态（aria-checked="mixed" + class）。
+     */
+    private computeIndeterminateKeys;
+    private renderNode;
+    render(): any;
+}

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

@@ -0,0 +1,71 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import type { TreeNode } from '../Tree/Tree';
+/**
+ * TreeSelect 树形选择器
+ * 类似 Select，但下拉选项以树形结构展示，支持单选与多选
+ */
+export declare class TreeSelect {
+    el: HTMLElement;
+    /**
+     * 可选项数据源（与 Tree 相同的递归树结构）
+     */
+    data: TreeNode[];
+    /**
+     * （受控）绑定值，单选为 string，多选为 string[]
+     */
+    modelValue: string | string[];
+    /**
+     * 是否多选
+     * @default false
+     */
+    multiple: boolean;
+    /**
+     * 占位文本
+     * @default '请选择'
+     */
+    placeholder: string;
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled: boolean;
+    /**
+     * 是否显示 checkbox（多选模式下推荐开启）
+     * @default false
+     */
+    checkable: boolean;
+    /**
+     * 是否默认展开全部节点
+     * @default false
+     */
+    defaultExpandAll: boolean;
+    isOpen: boolean;
+    internalExpanded: string[];
+    internalSelected: string[];
+    internalChecked: string[];
+    /**
+     * 值变化事件（单选为 string，多选为 string[]）
+     */
+    hbChange: EventEmitter<string | string[]>;
+    /**
+     * 下拉浮层显隐变化事件
+     */
+    hbVisibleChange: EventEmitter<boolean>;
+    private clickOutside;
+    componentWillLoad(): void;
+    componentDidLoad(): void;
+    disconnectedCallback(): void;
+    private syncFromModelValue;
+    private collectExpandableKeys;
+    private findTitle;
+    private getDisplayText;
+    private openDropdown;
+    private closeDropdown;
+    private toggleDropdown;
+    private handleNodeSelect;
+    private handleNodeCheck;
+    private handleToggleExpand;
+    private handleClear;
+    private renderNode;
+    render(): any;
+}

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

@@ -0,0 +1,55 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+export interface UploadFile {
+    name: string;
+    size: number;
+    type: string;
+    url?: string;
+    status: 'ready' | 'uploading' | 'success' | 'error';
+    /** 上传进度（0-100），仅 uploading 阶段有意义 */
+    progress?: number;
+    /** 服务端响应体（成功时） */
+    response?: any;
+}
+export declare class Upload {
+    /** 上传地址。设置后启用自动上传；未设置时文件以 ready 状态抛出，由消费方自行上传 */
+    action?: string;
+    /** 多选 */
+    multiple: boolean;
+    /** 接受的文件类型 */
+    accept?: string;
+    /** 是否禁用 */
+    disabled: boolean;
+    /** 最大上传数量 */
+    limit?: number;
+    /** 是否拖拽上传 */
+    drag: boolean;
+    /** 上传字段名 */
+    name: string;
+    /** 额外的请求头 */
+    headers?: Record<string, string>;
+    /** 额外的表单数据 */
+    data?: Record<string, string>;
+    /** 是否携带凭证（cookie） */
+    withCredentials: boolean;
+    /** 上传前钩子，返回 false / Promise<false> 则取消上传 */
+    beforeUpload?: (file: File) => boolean | Promise<boolean>;
+    fileList: UploadFile[];
+    isDragover: boolean;
+    hbChange: EventEmitter<UploadFile[]>;
+    hbSuccess: EventEmitter<UploadFile>;
+    hbError: EventEmitter<UploadFile>;
+    private inputRef?;
+    private handleClick;
+    private handleChange;
+    private handleFiles;
+    /** 真实上传：FormData + XHR，带进度回调 */
+    private realUpload;
+    private parseResponse;
+    private handleRemove;
+    private handleDrop;
+    private handleDragOver;
+    private handleDragLeave;
+    private formatSize;
+    private renderStatus;
+    render(): any;
+}

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

@@ -0,0 +1,25 @@
+/**
+ * Watermark 水印组件
+ * 在内容之上平铺一层文字水印，常用于版权/防泄密标识
+ */
+export declare class Watermark {
+    host: HTMLElement;
+    /** 水印文字 */
+    content: string;
+    /** 单个水印单元宽度 */
+    width: number;
+    /** 单个水印单元高度 */
+    height: number;
+    /** 水印单元之间的间距 */
+    gap: number;
+    /** 旋转角度 */
+    rotate: number;
+    /** 字体颜色 */
+    fontColor: string;
+    /** 字号 */
+    fontSize: number;
+    private get backgroundImage();
+    private escapeXml;
+    private get layerStyle();
+    render(): any;
+}