/**
 * Cascader Types & Props
 * @description 级联选择器组件类型定义，严格类型化
 */
import type { InjectionKey, ComputedRef, Ref } from 'vue';
export type CascaderSize = 'large' | 'default' | 'small';
export type CascaderExpandTrigger = 'click' | 'hover';
export type CascaderTagType = 'success' | 'info' | 'warning' | 'danger' | '';
/**
 * 级联项格式
 */
export interface CascaderOption {
    value: string | number;
    label: string;
    children?: CascaderOption[];
    disabled?: boolean;
    leaf?: boolean;
    [key: string]: unknown;
}
/**
 * 级联绑定值类型
 */
export type CascaderValue = string | number | (string | number)[] | (string | number)[][];
/**
 * 级联选择器配置项
 */
export interface CascaderConfig {
    expandTrigger: CascaderExpandTrigger;
    multiple: boolean;
    checkStrictly: boolean;
    emitPath: boolean;
    lazy: boolean;
    lazyLoad?: (node: CascaderOption, resolve: (children: CascaderOption[]) => void) => void;
    value: string;
    label: string;
    children: string;
    disabled: string;
    leaf: string;
}
export interface CascaderProps {
    /** 绑定值 */
    modelValue?: CascaderValue;
    /** 选项数据 */
    options?: CascaderOption[];
    /** 占位文本 */
    placeholder?: string;
    /** 是否禁用 */
    disabled?: boolean;
    /** 是否可清空 */
    clearable?: boolean;
    /** 输入框尺寸 */
    size?: CascaderSize;
    /** 是否可搜索 */
    filterable?: boolean;
    /** 自定义过滤方法 */
    filterMethod?: (node: CascaderOption, keyword: string) => boolean;
    /** 分隔符 */
    separator?: string;
    /** 是否显示完整路径 */
    showAllLevels?: boolean;
    /** 是否折叠标签 */
    collapseTags?: boolean;
    /** 折叠标签是否显示 tooltip */
    collapseTagsTooltip?: boolean;
    /** 最大折叠标签数 */
    maxCollapseTags?: number;
    /** 是否多选 */
    multiple?: boolean;
    /** 是否严格遵守父子节点不互相关联 */
    checkStrictly?: boolean;
    /** 展开触发方式 */
    expandTrigger?: CascaderExpandTrigger;
    /** 是否返回完整路径 */
    emitPath?: boolean;
    /** 是否启用虚拟滚动 */
    virtual?: boolean;
    /** 虚拟滚动每项高度 */
    virtualItemHeight?: number;
    /** 配置选项（向后兼容） */
    props?: Partial<CascaderConfig>;
    /** 下拉框类名 */
    popperClass?: string;
    /** 是否将下拉框插入到 body */
    teleported?: boolean;
    /** 标签类型 */
    tagType?: CascaderTagType;
    /** 是否触发表单验证 */
    validateEvent?: boolean;
    /** 主题覆盖变量 */
    themeOverrides?: import('@yh-ui/theme').ComponentThemeVars;
}
export interface CascaderEmits {
    (e: 'update:modelValue', value: CascaderValue | undefined): void;
    (e: 'change', value: CascaderValue | undefined): void;
    (e: 'focus', event: FocusEvent): void;
    (e: 'blur', event: FocusEvent): void;
    (e: 'clear'): void;
    (e: 'expand-change', value: (string | number)[]): void;
    (e: 'visible-change', visible: boolean): void;
}
export interface CascaderSlots {
    /** 自定义选项内容 */
    default?: (props: {
        node: CascaderOption;
        data: CascaderOption;
    }) => unknown;
    /** 无数据时的内容 */
    empty?: () => unknown;
}
export interface CascaderExpose {
    /** 获取焦点 */
    focus: () => void;
    /** 失去焦点 */
    blur: () => void;
    /** 获取选中节点 */
    getCheckedNodes: (leafOnly?: boolean) => CascaderOption[];
    /** 输入框引用 */
    inputRef: Ref<HTMLInputElement | undefined>;
}
export interface CascaderContext {
    props: CascaderProps;
    config: ComputedRef<CascaderConfig>;
    expandedPath: ComputedRef<(string | number)[]>;
    checkedValue: ComputedRef<CascaderValue | undefined>;
    handleExpand: (option: CascaderOption, level: number) => void;
    handleCheck: (option: CascaderOption, path: (string | number)[]) => void;
    isChecked: (path: (string | number)[]) => boolean;
}
export declare const CascaderContextKey: InjectionKey<CascaderContext>;
export declare const defaultCascaderConfig: CascaderConfig;