@zuoyo/viteui 0.0.2

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

@@ -0,0 +1,1091 @@
+/**
+ * Base 组件类型定义
+ */
+import type { ComponentPublicInstance, CSSProperties } from 'vue';
+import type { FormInstance } from '../form/types';
+/**
+ * Label Props 接口
+ */
+export interface LabelProps {
+    /**
+     * 关联的输入元素ID
+     */
+    for?: string;
+    /**
+     * 对齐方式
+     * @default 'left'
+     */
+    align?: 'left' | 'right' | 'center' | 'top';
+}
+/**
+ * Label 组件实例接口
+ */
+export interface LabelInstance extends ComponentPublicInstance {
+    /**
+     * 标签类名
+     */
+    labelClasses: (string | Record<string, boolean>)[];
+    /**
+     * 标签样式
+     */
+    labelStyle: CSSProperties;
+}
+/**
+ * Addon Props 接口
+ */
+export interface AddonProps {
+    /**
+     * 对齐方式
+     * @default 'right'
+     */
+    align?: 'left' | 'right';
+}
+/**
+ * Addon 组件实例接口
+ */
+export interface AddonInstance extends ComponentPublicInstance {
+    /**
+     * 对齐方式
+     */
+    align: 'left' | 'right';
+}
+/**
+ * 过滤操作符接口
+ */
+export interface FilterOperator {
+    /**
+     * 文本
+     */
+    text: string;
+    /**
+     * 是否匹配
+     */
+    isMatch: (source: any, value: any) => boolean;
+}
+/**
+ * 过滤操作符集合
+ */
+export interface FilterOperators {
+    [key: string]: FilterOperator;
+}
+/**
+ * 过滤规则接口
+ */
+export interface FilterRule {
+    /**
+     * 字段名
+     */
+    field: string;
+    /**
+     * 操作符
+     */
+    op: string;
+    /**
+     * 值
+     */
+    value: any;
+}
+/**
+ * 选中单元格接口
+ */
+export interface SelectedCell {
+    /**
+     * 行
+     */
+    row: any;
+    /**
+     * 列
+     */
+    column: any;
+}
+/**
+ * 高亮单元格接口
+ */
+export interface HighlightCell {
+    /**
+     * 行
+     */
+    row: any;
+    /**
+     * 列
+     */
+    column: any;
+}
+/**
+ * 分页状态接口
+ */
+export interface PageState {
+    /**
+     * 页码
+     */
+    pageNumber: number;
+    /**
+     * 每页大小
+     */
+    pageSize: number;
+    /**
+     * 是否刷新
+     */
+    refresh?: boolean;
+    /**
+     * 过滤规则
+     */
+    filterRules?: FilterRule[];
+}
+/**
+ * ListBase Props 接口
+ */
+export interface ListBaseProps {
+    /**
+     * 是否显示边框
+     * @default true
+     */
+    border?: boolean;
+    /**
+     * 是否加载中
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * 加载消息
+     */
+    loadMsg?: string;
+    /**
+     * 空消息
+     */
+    emptyMsg?: string;
+    /**
+     * 是否分页
+     * @default false
+     */
+    pagination?: boolean;
+    /**
+     * 分页位置
+     * @default 'bottom'
+     */
+    pagePosition?: 'top' | 'bottom';
+    /**
+     * 分页选项
+     */
+    pageOptions?: any;
+    /**
+     * 是否懒加载
+     * @default false
+     */
+    lazy?: boolean;
+    /**
+     * 是否虚拟滚动
+     * @default false
+     */
+    virtualScroll?: boolean;
+    /**
+     * 行高
+     * @default 32
+     */
+    rowHeight?: number;
+    /**
+     * 页码
+     * @default 1
+     */
+    pageNumber?: number;
+    /**
+     * 每页大小
+     * @default 10
+     */
+    pageSize?: number;
+    /**
+     * 分页布局
+     * @default ['first','prev','links','next','last','refresh']
+     */
+    pageLayout?: string[];
+    /**
+     * 每页大小列表
+     * @default [10,20,30,40,50]
+     */
+    pageList?: number[];
+    /**
+     * 分页链接数
+     * @default 10
+     */
+    pageLinks?: number;
+    /**
+     * 总数
+     * @default 0
+     */
+    total?: number;
+    /**
+     * ID 字段
+     */
+    idField?: string;
+    /**
+     * 选择模式
+     */
+    selectionMode?: 'single' | 'multiple' | 'cell' | 'multicell';
+    /**
+     * 选中项
+     */
+    selection?: any | any[] | null;
+    /**
+     * 是否可过滤
+     * @default false
+     */
+    filterable?: boolean;
+    /**
+     * 过滤规则
+     * @default []
+     */
+    filterRules?: FilterRule[];
+    /**
+     * 过滤延迟
+     * @default 400
+     */
+    filterDelay?: number;
+    /**
+     * 过滤匹配类型
+     * @default 'all'
+     */
+    filterMatchingType?: 'all' | 'any';
+    /**
+     * 过滤位置
+     * @default 'bottom'
+     */
+    filterPosition?: 'top' | 'bottom';
+    /**
+     * 过滤按钮位置
+     * @default 'right'
+     */
+    filterBtnPosition?: 'left' | 'right';
+    /**
+     * 过滤操作符
+     */
+    filterOperators?: FilterOperators;
+    /**
+     * 数据
+     * @default []
+     */
+    data?: any[];
+}
+/**
+ * ListBase 组件实例接口
+ */
+export interface ListBaseInstance extends ComponentPublicInstance {
+    /**
+     * 总数状态
+     */
+    totalState: number;
+    /**
+     * 页码状态
+     */
+    pageNumberState: number;
+    /**
+     * 每页大小状态
+     */
+    pageSizeState: number;
+    /**
+     * 分页状态
+     */
+    pageState: PageState | null;
+    /**
+     * 高亮行
+     */
+    highlightRow: any | null;
+    /**
+     * 高亮单元格
+     */
+    highlightCell: HighlightCell | null;
+    /**
+     * 选择模式状态
+     */
+    selectionModeState: string | undefined;
+    /**
+     * 选中的行
+     */
+    selectedRows: any[];
+    /**
+     * 选中的单元格
+     */
+    selectedCells: SelectedCell[];
+    /**
+     * 行数据
+     */
+    rows: any[];
+    /**
+     * 内部数据
+     */
+    innerData: any[];
+    /**
+     * 过滤后的数据
+     */
+    filteredData: any[];
+    /**
+     * 选中值
+     */
+    selectionValue: any | any[] | null;
+    /**
+     * 设置数据
+     */
+    setData(value?: any[] | null): void;
+    /**
+     * 设置分组数据
+     */
+    setGroupData(): void;
+    /**
+     * 设置选中值
+     */
+    setSelectionValue(value?: any | any[] | null): void;
+    /**
+     * 排序数据
+     */
+    sortData(): void;
+    /**
+     * 过滤数据
+     */
+    filterData(data: any[]): any[];
+    /**
+     * 执行过滤
+     */
+    doFilter(rule?: FilterRule | null): void;
+    /**
+     * 执行回车
+     */
+    doEnter(): void;
+    /**
+     * 获取选中索引
+     */
+    getSelectedIndex(row: any): number;
+    /**
+     * 获取选中单元格索引
+     */
+    getSelectedCellIndex(row: any, column: any): number;
+    /**
+     * 是否单元格选择模式
+     */
+    isCellSelectionMode(): boolean;
+    /**
+     * 是否高亮
+     */
+    isHighlighted(row: any, column?: any): boolean;
+    /**
+     * 是否选中
+     */
+    isSelected(row: any, column?: any): boolean;
+    /**
+     * 选择行
+     */
+    selectRow(row: any): void;
+    /**
+     * 取消选择行
+     */
+    unselectRow(row: any): void;
+    /**
+     * 选择单元格
+     */
+    selectCell(row: any, column: any): void;
+    /**
+     * 取消选择单元格
+     */
+    unselectCell(row: any, column: any): void;
+    /**
+     * 清除选择
+     */
+    clearSelections(): void;
+    /**
+     * 导航行
+     */
+    navRow(step: number): void;
+    /**
+     * 获取过滤规则索引
+     */
+    getFilterRuleIndex(field: string): number;
+    /**
+     * 获取过滤规则
+     */
+    getFilterRule(field: string): FilterRule | null;
+    /**
+     * 添加过滤规则
+     */
+    addFilterRule(rule: FilterRule): void;
+    /**
+     * 移除过滤规则
+     */
+    removeFilterRule(field: string): void;
+    /**
+     * 设置分页数据
+     */
+    setPageData(): void;
+    /**
+     * 分页改变事件
+     */
+    onPageChange(event: PageState): void;
+    /**
+     * 虚拟分页改变事件
+     */
+    onVirtualPageChange(event: PageState): void;
+    /**
+     * 行点击事件
+     */
+    onRowClick(row: any): void;
+    /**
+     * 单元格点击事件
+     */
+    onCellClick(row: any, column: any): void;
+    /**
+     * 选择改变后回调
+     */
+    afterSelectionChange(value?: any | any[] | null): void;
+}
+/**
+ * FormField 实例接口（用于 FieldBase）
+ */
+export interface FormFieldInstance extends ComponentPublicInstance {
+    name?: string;
+}
+/**
+ * FieldBase Props 接口
+ */
+export interface FieldBaseProps {
+    /**
+     * 字段名
+     */
+    name?: string;
+    /**
+     * 是否无效
+     * @default false
+     */
+    invalid?: boolean;
+    /**
+     * 创建时验证
+     * @default true
+     */
+    validateOnCreate?: boolean;
+    /**
+     * 失焦时验证
+     * @default false
+     */
+    validateOnBlur?: boolean;
+    /**
+     * 改变时验证
+     * @default true
+     */
+    validateOnChange?: boolean;
+}
+/**
+ * FieldBase 组件实例接口
+ */
+export interface FieldBaseInstance extends ComponentPublicInstance {
+    /**
+     * 无效状态
+     */
+    invalidState: boolean;
+    /**
+     * 表单实例
+     */
+    form: FormInstance | null;
+    /**
+     * 表单字段实例
+     */
+    field: FormFieldInstance | null;
+    /**
+     * 字段名
+     */
+    fieldName: string | null;
+    /**
+     * 渲染字段
+     */
+    renderField(): any;
+    /**
+     * 聚焦后回调
+     */
+    afterFocus(): void;
+    /**
+     * 失焦后回调
+     */
+    afterBlur(): void;
+    /**
+     * 值改变后回调
+     */
+    afterValueChange(): void;
+    /**
+     * 设置有效状态
+     */
+    setValid(valid: boolean): void;
+}
+/**
+ * InputBase Props 接口
+ */
+export interface InputBaseProps extends FieldBaseProps {
+    /**
+     * 值（v-model）
+     */
+    value?: string | number | any[] | null;
+    /**
+     * 模型值（v-model）
+     */
+    modelValue?: string | number | any[] | null;
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 是否只读
+     * @default false
+     */
+    readonly?: boolean;
+    /**
+     * 是否可编辑
+     * @default true
+     */
+    editable?: boolean;
+    /**
+     * 图标类名
+     */
+    iconCls?: string;
+    /**
+     * 图标对齐方式
+     * @default 'right'
+     */
+    iconAlign?: 'left' | 'right';
+    /**
+     * 占位符
+     */
+    placeholder?: string;
+    /**
+     * 是否多行
+     * @default false
+     */
+    multiline?: boolean;
+    /**
+     * Tab 索引
+     */
+    tabindex?: number;
+    /**
+     * 类名
+     */
+    cls?: string;
+    /**
+     * 输入框类名
+     */
+    inputCls?: string;
+    /**
+     * 输入框样式
+     */
+    inputStyle?: CSSProperties;
+    /**
+     * 输入框 ID
+     */
+    inputId?: string;
+    /**
+     * 文本格式化函数
+     */
+    textFormatter?: (value: any) => string;
+}
+/**
+ * InputBase 组件实例接口
+ */
+export interface InputBaseInstance extends FieldBaseInstance {
+    /**
+     * 值状态
+     */
+    valueState: string | number | any[] | null | undefined;
+    /**
+     * 文本状态
+     */
+    textState: string;
+    /**
+     * 是否聚焦
+     */
+    focused: boolean;
+    /**
+     * 基础类名
+     */
+    baseClasses: (string | Record<string, boolean>)[];
+    /**
+     * 输入框类名
+     */
+    inputClasses: (string | Record<string, boolean>)[];
+    /**
+     * 附加组件类名
+     */
+    addonClasses: (string | Record<string, boolean>)[];
+    /**
+     * 附加图标类名
+     */
+    addonIconClasses: (string | Record<string, boolean>)[];
+    /**
+     * 文本
+     */
+    text: string;
+    /**
+     * 默认文本格式化函数
+     */
+    defaultTextFormatter(value: any): string;
+    /**
+     * 设置值
+     */
+    setValue(value?: string | number | any[] | null): void;
+    /**
+     * 输入事件
+     */
+    onInput(event: Event): void;
+    /**
+     * 聚焦
+     */
+    focus(): void;
+    /**
+     * 失焦
+     */
+    blur(): void;
+    /**
+     * 获取选择开始位置
+     */
+    getSelectionStart(): number;
+    /**
+     * 获取选择范围
+     */
+    getSelectionRange(): {
+        start: number;
+        end: number;
+    };
+    /**
+     * 设置选择范围
+     */
+    setSelectionRange(start: number, end: number): void;
+    /**
+     * 渲染输入框
+     */
+    renderInput(): any;
+    /**
+     * 渲染附加组件
+     */
+    renderAddon(): any;
+    /**
+     * 渲染其他内容
+     */
+    renderOthers(): any;
+}
+/**
+ * SpinnerBase Props 接口
+ */
+export interface SpinnerBaseProps extends InputBaseProps {
+    /**
+     * 是否反转
+     * @default false
+     */
+    reversed?: boolean;
+    /**
+     * 是否显示微调器
+     * @default true
+     */
+    spinners?: boolean;
+    /**
+     * 微调器对齐方式
+     * @default 'right'
+     */
+    spinAlign?: 'left' | 'right' | 'horizontal' | 'vertical';
+}
+/**
+ * SpinnerBase 组件实例接口
+ */
+export interface SpinnerBaseInstance extends InputBaseInstance {
+    /**
+     * 点击上按钮
+     */
+    onClickUp(): void;
+    /**
+     * 点击下按钮
+     */
+    onClickDown(): void;
+    /**
+     * 执行上旋转
+     */
+    doSpinUp(): void;
+    /**
+     * 执行下旋转
+     */
+    doSpinDown(): void;
+    /**
+     * 渲染水平微调器
+     */
+    renderHorizontal(): any;
+    /**
+     * 渲染垂直微调器
+     */
+    renderVertical(): any;
+    /**
+     * 渲染默认微调器
+     */
+    renderDefault(): any;
+}
+/**
+ * ComboBase Props 接口
+ */
+export interface ComboBaseProps extends InputBaseProps {
+    /**
+     * 是否有下拉箭头
+     * @default true
+     */
+    hasDownArrow?: boolean;
+    /**
+     * 箭头图标类名
+     * @default 'combo-arrow'
+     */
+    arrowIconCls?: string;
+    /**
+     * 箭头对齐方式
+     * @default 'right'
+     */
+    arrowAlign?: 'left' | 'right';
+    /**
+     * 面板对齐方式
+     * @default 'left'
+     */
+    panelAlign?: 'left' | 'right';
+    /**
+     * 面板样式
+     */
+    panelStyle?: CSSProperties;
+    /**
+     * 是否多选
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * 分隔符
+     * @default ','
+     */
+    separator?: string;
+    /**
+     * 延迟
+     * @default 200
+     */
+    delay?: number;
+}
+/**
+ * ComboBase 组件实例接口
+ */
+export interface ComboBaseInstance extends InputBaseInstance {
+    /**
+     * 面板是否关闭
+     */
+    panelClosed: boolean;
+    /**
+     * 面板左边距
+     */
+    panelLeft: number;
+    /**
+     * 面板上边距
+     */
+    panelTop: number;
+    /**
+     * 滚动位置
+     */
+    scrollTop: number;
+    /**
+     * 基础类名
+     */
+    baseClasses: (string | Record<string, boolean>)[];
+    /**
+     * 箭头类名
+     */
+    arrowClasses: (string | Record<string, boolean>)[];
+    /**
+     * 文档点击事件
+     */
+    onDocumentClick(event: Event): boolean | void;
+    /**
+     * 文档鼠标滚轮事件
+     */
+    onDocumentMouseWheel(event: Event): boolean | void;
+    /**
+     * 切换面板
+     */
+    togglePanel(): void;
+    /**
+     * 对齐面板
+     */
+    alignPanel(): void;
+    /**
+     * 打开面板
+     */
+    openPanel(): void;
+    /**
+     * 关闭面板
+     */
+    closePanel(): void;
+    /**
+     * 渲染箭头
+     */
+    renderArrow(): any;
+    /**
+     * 渲染面板
+     */
+    renderPanel(): any;
+    /**
+     * 渲染内容
+     */
+    renderContent(): any;
+}
+/**
+ * 滚动位置接口
+ */
+export interface ScrollPosition {
+    /**
+     * 顶部高度数组
+     */
+    topHeights?: number[];
+    /**
+     * 底部高度数组
+     */
+    bottomHeights?: number[];
+    /**
+     * 顶部增量高度
+     */
+    deltaTopHeight?: number;
+    /**
+     * 开始索引
+     */
+    startIndex?: number;
+    /**
+     * 滚动位置
+     */
+    scrollTop?: number;
+    /**
+     * 项目数组
+     */
+    items?: any[];
+    /**
+     * 内部数据
+     */
+    innerData?: any[];
+}
+/**
+ * 滚动状态接口
+ */
+export interface ScrollState {
+    /**
+     * 顶部高度数组
+     */
+    topHeights: number[];
+    /**
+     * 底部高度数组
+     */
+    bottomHeights: number[];
+    /**
+     * 顶部增量高度
+     */
+    deltaTopHeight: number;
+    /**
+     * 开始索引
+     */
+    startIndex: number;
+    /**
+     * 滚动位置
+     */
+    scrollTop: number;
+    /**
+     * 项目数组
+     */
+    items: any[];
+    /**
+     * 内部数据
+     */
+    innerData: any[];
+}
+/**
+ * 分页改变事件接口
+ */
+export interface VirtualScrollPageChange {
+    /**
+     * 页码
+     */
+    pageNumber: number;
+    /**
+     * 每页大小
+     */
+    pageSize: number;
+}
+/**
+ * 滚动事件接口
+ */
+export interface VirtualScrollBodyScroll {
+    /**
+     * 左边距
+     */
+    left: number;
+    /**
+     * 顶部位置
+     */
+    top: number;
+    /**
+     * 相对顶部位置
+     */
+    relativeTop: number;
+    /**
+     * 项目数组
+     */
+    items: any[];
+}
+/**
+ * VirtualScroll Props 接口
+ */
+export interface VirtualScrollProps {
+    /**
+     * 是否懒加载
+     * @default false
+     */
+    lazy?: boolean;
+    /**
+     * 行高
+     * @default 32
+     */
+    rowHeight?: number;
+    /**
+     * 最大 div 高度
+     * @default 10000000
+     */
+    maxDivHeight?: number;
+    /**
+     * 最大可见高度
+     * @default 15000000
+     */
+    maxVisibleHeight?: number;
+    /**
+     * 页码
+     * @default 1
+     */
+    pageNumber?: number;
+    /**
+     * 每页大小
+     * @default 10
+     */
+    pageSize?: number;
+    /**
+     * 总数
+     * @default 0
+     */
+    total?: number;
+    /**
+     * 数据
+     * @default []
+     */
+    data?: any[];
+    /**
+     * 滚动位置
+     */
+    scrollPosition?: ScrollPosition | null;
+}
+/**
+ * VirtualScroll 组件实例接口
+ */
+export interface VirtualScrollInstance extends ComponentPublicInstance {
+    /**
+     * 内部数据
+     */
+    innerData: any[];
+    /**
+     * 项目数组
+     */
+    items: any[];
+    /**
+     * 等待页码
+     */
+    waitingPage: number;
+    /**
+     * 获取页码
+     */
+    fetchingPage: number;
+    /**
+     * 开始索引
+     */
+    startIndex: number;
+    /**
+     * 顶部增量高度
+     */
+    deltaTopHeight: number;
+    /**
+     * 顶部高度数组
+     */
+    topHeights: number[];
+    /**
+     * 底部高度数组
+     */
+    bottomHeights: number[];
+    /**
+     * 是否更新中
+     */
+    isUpdating: boolean;
+    /**
+     * 是否新获取中
+     */
+    isNewFetching: boolean;
+    /**
+     * 总数状态
+     */
+    totalState: number;
+    /**
+     * 页码状态
+     */
+    pageNumberState: number;
+    /**
+     * 滚动位置状态
+     */
+    scrollPositionState: ScrollPosition | null | undefined;
+    /**
+     * 设置数据
+     */
+    setData(value?: any[] | null): void;
+    /**
+     * 清除
+     */
+    clear(): void;
+    /**
+     * 滚动状态
+     */
+    scrollState(value?: ScrollState | null): ScrollState | void;
+    /**
+     * 滚动位置
+     */
+    scrollTop(value?: number): number | void;
+    /**
+     * 滚动中
+     */
+    scrolling(): void;
+    /**
+     * 相对滚动位置
+     */
+    relativeScrollTop(): number;
+    /**
+     * 滚动条宽度
+     */
+    scrollbarWidth(): number;
+    /**
+     * 滚动事件
+     */
+    onScroll(event: Event): void;
+    /**
+     * 填充
+     */
+    populate(): void;
+    /**
+     * 分割高度
+     */
+    splitHeights(height: number): number[];
+    /**
+     * 加载页面
+     */
+    loadPage(items: any[]): void;
+    /**
+     * 获取页面
+     */
+    fetchPage(page: number): void;
+    /**
+     * 跳转到页面
+     */
+    gotoPage(page: number): void;
+    /**
+     * 刷新
+     */
+    refresh(): void;
+}
+//# sourceMappingURL=types.d.ts.map