@weitutech/by-components-v3 1.1.26 → 1.1.27

package/dist/types/packages/cascader-panel/src/ByCascaderPanel.vue.d.ts

@@ -0,0 +1,674 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    options: {
+        type: ArrayConstructor;
+        default: () => any[];
+    };
+    value: {
+        type: (StringConstructor | NumberConstructor | ArrayConstructor)[];
+        default: () => any[];
+    };
+    modelValue: {
+        type: (StringConstructor | NumberConstructor | ArrayConstructor)[];
+        default: any;
+    };
+    cascaderProps: {
+        type: ObjectConstructor;
+        default: () => {
+            multiple: boolean;
+            label: string;
+            value: string;
+            children: string;
+        };
+    };
+    panelHeight: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: number;
+        validator: (value: unknown) => boolean;
+    };
+    searchPlaceholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabledField: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabledValue: {
+        type: (BooleanConstructor | StringConstructor | NumberConstructor)[];
+        default: boolean;
+    };
+    disabledCheck: {
+        type: FunctionConstructor;
+        default: any;
+    };
+    showSelectAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    aggregationMode: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 非叶子节点前缀标识 (聚合模式下用于标识非叶子节点)
+     * 注意：聚合模式下，由于叶子节点和非叶子节点可能存在相同id,所以绑定数据中务必给非叶子节点加上parentNodePrefix前缀作为标识
+     */
+    parentNodePrefix: {
+        type: StringConstructor;
+        default: string;
+    };
+    isViewMode: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showSubtitle: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    subtitleField: {
+        type: StringConstructor;
+        default: string;
+    };
+    /**
+     * 是否显示刷新按钮。
+     * 点击后仅触发 refresh 事件，由业务侧重新请求并更新 options。
+     */
+    showRefresh: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 刷新按钮 tooltip 文案，传空字符串则不展示提示 */
+    refreshTooltip: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 刷新中状态（由业务控制，用于展示 loading 并防止连点） */
+    refreshing: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    columnMinWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    columnMaxWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * 下拉筛选配置。外部传入且 enabled 不为 false、并指定 field 时才展示下拉框。
+     * { enabled, title, placeholder, options: [{ label, value }], field }
+     * field 为数据中用于过滤和展示的字段名。
+     */
+    dropdownFilter: {
+        type: ObjectConstructor;
+        default: any;
+    };
+}>, {}, {
+    selectedValues: any[];
+    searchSelectedValues: any[];
+    filteredOptions: any[];
+    searchOptions: any[];
+    selectedItems: any[];
+    searchInput: string;
+    isShow: boolean;
+    isShowSearch: boolean;
+    totalCount: number;
+    selectedCount: number;
+    isAllSelected: boolean;
+    isInternalUpdate: boolean;
+    batchSearchVisible: boolean;
+    batchSearchContent: string;
+    compactPanelValue: any[];
+    searchDebounceTimer: any;
+    searchLeafSetCache: any;
+    panelSyncTimer: any;
+    isExternalSync: boolean;
+    dropdownFilterValue: string;
+}, {
+    externalValue(): string | number | unknown[];
+    disabledConfig(): {
+        disabledField: string;
+        disabledValue: string | number | boolean;
+        disabledCheck: Function;
+    };
+    computedPanelHeight(): number;
+    isMultiple(): boolean;
+    showBatchSearchBtn(): boolean;
+    showRefreshBtn(): boolean;
+    /**
+     * 刷新中临时进入只读态，复用 isViewMode 的交互限制。
+     * 不覆盖 props.isViewMode，业务传入的查看态不受影响。
+     */
+    panelViewMode(): boolean;
+    useCompactSelection(): boolean;
+    panelPresentationValue(): any;
+    compactSearchPanelValue(): any[];
+    selectedItemHeight(): 40;
+    selectedListHeight(): number;
+    currentValue(): any;
+    mainPanelValue: {
+        get(): any;
+        set(value: any): void;
+    };
+    searchPanelValue: {
+        get(): any;
+        set(value: any): void;
+    };
+    showDropdownFilter(): boolean;
+    dropdownFilterPlaceholder(): any;
+    dropdownFilterTitle(): string;
+    dropdownFilterField(): any;
+    normalizedDropdownFilterOptions(): any;
+    hasActiveDropdownFilter(): boolean;
+    displayOptions(): any;
+    isFilterView(): boolean;
+    viewOptions(): any;
+}, {
+    emitModel(value: any): void;
+    onMainPanelInput(value: any): void;
+    refreshSelectionDisplayFromPanel(): void;
+    /**
+     * 用户操作（勾选/全选/清除/删除）统一提交：更新展示 + emit，标记内部更新防回显覆盖
+     */
+    commitUserSelectionChange(): void;
+    /**
+     * 向父组件 emit 当前选中（仅用户操作路径调用，外部回显走 syncPanelFromExternalValue 不 emit）
+     */
+    emitSelectionToParent(): void;
+    applyPanelSelectionChange(): void;
+    buildSelectedItemsFromValuesLazy(panel: any): any;
+    syncPanelFromExternalValue(): boolean;
+    hasExternalValue(): boolean;
+    getExternalValueList(): any[];
+    clearPanelSyncTimer(): void;
+    schedulePanelSyncFromExternalValue(retry?: number): void;
+    resolveExternalValueToPaths(): any;
+    expandPanelToExternalValue(panel: any): void;
+    onSearchPanelInput(value: any): void;
+    processValue(): void;
+    initOptions(): void;
+    processOptions(options: any): any;
+    isItemDisabled(item: any): any;
+    countTotalItems(): void;
+    updateSelectedItems(): void;
+    buildSelectedItemsFromValues(): any;
+    scheduleSearch(): void;
+    clearSearchState(): void;
+    runSearch(): void;
+    getSearchSelectedPathsFromMain(searchLeafSet: any): any;
+    getSearchLeafSet(): any;
+    syncSearchPanelSelection(): void;
+    handleSearchExpand(): void;
+    prepareFilterView(): void;
+    handleDropdownFilterChange(): void;
+    getNodeFilterFieldText(data: any): string;
+    updateFilterAllSelectedState(): void;
+    handleValueChange(): void;
+    handleSearchValueChange(): void;
+    removeItem(item: any, index: any): void;
+    clearPanelSelectionState(panel: any): void;
+    handleSelectAll(): void;
+    getSelectedData(): {
+        valuesPath: any[];
+        values: any;
+        items: any[];
+        count: number;
+    };
+    clearSelection(): void;
+    setValue(values: any): void;
+    findPathsByValues(values: any): any[];
+    handleBatchSearchShow(): void;
+    /**
+     * 点击刷新：通知业务重新拉取级联数据。
+     * 清空左侧搜索，避免旧关键词在新数据上残留空结果；
+     * 组件本身不请求接口，也不清空选中态；options 更新后由现有 watch 驱动面板刷新。
+     */
+    handleRefresh(): void;
+    handleBatchSearch(): void;
+    searchNamesInCascader(names: any): any[];
+    forceVerticalCenter(): void;
+}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("input" | "update:modelValue" | "refresh" | "change")[], "input" | "update:modelValue" | "refresh" | "change", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    options: {
+        type: ArrayConstructor;
+        default: () => any[];
+    };
+    value: {
+        type: (StringConstructor | NumberConstructor | ArrayConstructor)[];
+        default: () => any[];
+    };
+    modelValue: {
+        type: (StringConstructor | NumberConstructor | ArrayConstructor)[];
+        default: any;
+    };
+    cascaderProps: {
+        type: ObjectConstructor;
+        default: () => {
+            multiple: boolean;
+            label: string;
+            value: string;
+            children: string;
+        };
+    };
+    panelHeight: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: number;
+        validator: (value: unknown) => boolean;
+    };
+    searchPlaceholder: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabledField: {
+        type: StringConstructor;
+        default: string;
+    };
+    disabledValue: {
+        type: (BooleanConstructor | StringConstructor | NumberConstructor)[];
+        default: boolean;
+    };
+    disabledCheck: {
+        type: FunctionConstructor;
+        default: any;
+    };
+    showSelectAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    aggregationMode: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 非叶子节点前缀标识 (聚合模式下用于标识非叶子节点)
+     * 注意：聚合模式下，由于叶子节点和非叶子节点可能存在相同id,所以绑定数据中务必给非叶子节点加上parentNodePrefix前缀作为标识
+     */
+    parentNodePrefix: {
+        type: StringConstructor;
+        default: string;
+    };
+    isViewMode: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showSubtitle: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    subtitleField: {
+        type: StringConstructor;
+        default: string;
+    };
+    /**
+     * 是否显示刷新按钮。
+     * 点击后仅触发 refresh 事件，由业务侧重新请求并更新 options。
+     */
+    showRefresh: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 刷新按钮 tooltip 文案，传空字符串则不展示提示 */
+    refreshTooltip: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 刷新中状态（由业务控制，用于展示 loading 并防止连点） */
+    refreshing: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    columnMinWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    columnMaxWidth: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * 下拉筛选配置。外部传入且 enabled 不为 false、并指定 field 时才展示下拉框。
+     * { enabled, title, placeholder, options: [{ label, value }], field }
+     * field 为数据中用于过滤和展示的字段名。
+     */
+    dropdownFilter: {
+        type: ObjectConstructor;
+        default: any;
+    };
+}>> & Readonly<{
+    "onUpdate:modelValue"?: (...args: any[]) => any;
+    onChange?: (...args: any[]) => any;
+    onInput?: (...args: any[]) => any;
+    onRefresh?: (...args: any[]) => any;
+}>, {
+    options: unknown[];
+    value: string | number | unknown[];
+    modelValue: string | number | unknown[];
+    disabledField: string;
+    columnMinWidth: number;
+    columnMaxWidth: number;
+    isViewMode: boolean;
+    cascaderProps: Record<string, any>;
+    panelHeight: string | number;
+    searchPlaceholder: string;
+    disabledValue: string | number | boolean;
+    disabledCheck: Function;
+    showSelectAll: boolean;
+    aggregationMode: boolean;
+    parentNodePrefix: string;
+    showSubtitle: boolean;
+    subtitleField: string;
+    showRefresh: boolean;
+    refreshTooltip: string;
+    refreshing: boolean;
+    dropdownFilter: Record<string, any>;
+}, {}, {
+    VirtualCascaderPanel: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+        value: {
+            type: (StringConstructor | NumberConstructor | ArrayConstructor)[];
+            default: () => any[];
+        };
+        options: {
+            type: ArrayConstructor;
+            default: () => any[];
+        };
+        props: {
+            type: ObjectConstructor;
+            default: () => {
+                multiple: boolean;
+                label: string;
+                value: string;
+                children: string;
+                checkStrictly: boolean;
+            };
+        };
+        height: {
+            type: NumberConstructor;
+            default: number;
+        };
+        columnMinWidth: {
+            type: NumberConstructor;
+            default: number;
+        };
+        columnMaxWidth: {
+            type: NumberConstructor;
+            default: number;
+        };
+        disabledConfig: {
+            type: ObjectConstructor;
+            default: () => {};
+        };
+        isViewMode: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        autoExpandDeep: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        syncValueFromParent: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        filterField: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>, {}, {
+        store: any;
+        selection: any;
+        activePath: any[];
+        itemHeight: number;
+        syncingValue: boolean;
+        suppressValueSync: boolean;
+        selectionTick: number;
+    }, {
+        multiple(): boolean;
+        checkStrictly(): boolean;
+        columns(): any[];
+        singleCheckedValue(): any;
+    }, {
+        emitModel(value: any): void;
+        syncHorizontalOverflow(): void;
+        getColumnStyle(colIndex: any, columnNodes: any): {
+            width: string;
+            minWidth: string;
+            maxWidth: string;
+        };
+        getFilterFieldText(item: any): string;
+        rebuildStore(): void;
+        syncFromValue(): void;
+        normalizeSinglePath(val: any): any;
+        emitValue(): void;
+        isActive(node: any, colIndex: any): boolean;
+        isExpanded(node: any, colIndex: any): boolean;
+        isInActivePath(node: any): boolean;
+        getNodeClass(node: any, colIndex: any): {
+            'is-selectable': boolean;
+            'is-disabled': any;
+            'in-active-path': boolean;
+            'in-checked-path': any;
+            'is-active': any;
+        };
+        isInCheckedPath(node: any): any;
+        isNodeActive(node: any): any;
+        isChecked(node: any): any;
+        isIndeterminate(node: any): any;
+        bumpSelectionView(): void;
+        sanitizeActivePath(pathIds: any): any[];
+        expandNode(node: any, silent?: boolean): void;
+        expandDeepFromNode(node: any): void;
+        expandPathValues(pathValues: any, deep?: boolean): void;
+        onNodeClick(node: any, colIndex: any): void;
+        onCheckClick(node: any, checked: any): void;
+        onRadioClick(node: any): void;
+        clearCheckedNodes(): void;
+        selectAllLeaves(): void;
+        syncCheckedValue(): void;
+        syncFromParentValues(values: any, prefix: any): void;
+        getSelectionSnapshot(): {
+            store: any;
+            selection: any;
+            isCompact: any;
+            count: any;
+        };
+    }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("input" | "update:modelValue" | "change" | "expand-change" | "store-ready")[], "input" | "update:modelValue" | "change" | "expand-change" | "store-ready", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+        value: {
+            type: (StringConstructor | NumberConstructor | ArrayConstructor)[];
+            default: () => any[];
+        };
+        options: {
+            type: ArrayConstructor;
+            default: () => any[];
+        };
+        props: {
+            type: ObjectConstructor;
+            default: () => {
+                multiple: boolean;
+                label: string;
+                value: string;
+                children: string;
+                checkStrictly: boolean;
+            };
+        };
+        height: {
+            type: NumberConstructor;
+            default: number;
+        };
+        columnMinWidth: {
+            type: NumberConstructor;
+            default: number;
+        };
+        columnMaxWidth: {
+            type: NumberConstructor;
+            default: number;
+        };
+        disabledConfig: {
+            type: ObjectConstructor;
+            default: () => {};
+        };
+        isViewMode: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        autoExpandDeep: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        syncValueFromParent: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        filterField: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>> & Readonly<{
+        "onUpdate:modelValue"?: (...args: any[]) => any;
+        onChange?: (...args: any[]) => any;
+        onInput?: (...args: any[]) => any;
+        "onExpand-change"?: (...args: any[]) => any;
+        "onStore-ready"?: (...args: any[]) => any;
+    }>, {
+        options: unknown[];
+        value: string | number | unknown[];
+        props: Record<string, any>;
+        height: number;
+        columnMinWidth: number;
+        columnMaxWidth: number;
+        disabledConfig: Record<string, any>;
+        isViewMode: boolean;
+        autoExpandDeep: boolean;
+        syncValueFromParent: boolean;
+        filterField: string;
+    }, {}, {
+        VcpVirtualList: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+            items: {
+                type: ArrayConstructor;
+                default: () => any[];
+            };
+            itemHeight: {
+                type: NumberConstructor;
+                default: number;
+            };
+            height: {
+                type: NumberConstructor;
+                default: number;
+            };
+            overscan: {
+                type: NumberConstructor;
+                default: number;
+            };
+            listPadding: {
+                type: NumberConstructor;
+                default: number;
+            };
+        }>, {}, {
+            scrollTop: number;
+        }, {
+            totalHeight(): number;
+            enableVirtual(): boolean;
+            startIndex(): number;
+            endIndex(): number;
+            offsetY(): number;
+            visibleItems(): unknown[];
+        }, {
+            isSameItemList(nextItems: any, prevItems: any): boolean;
+            rowKey(item: any, index: any): string;
+            getItemKey(item: any): any;
+            onScroll(event: any): void;
+            resetScroll(): void;
+        }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+            items: {
+                type: ArrayConstructor;
+                default: () => any[];
+            };
+            itemHeight: {
+                type: NumberConstructor;
+                default: number;
+            };
+            height: {
+                type: NumberConstructor;
+                default: number;
+            };
+            overscan: {
+                type: NumberConstructor;
+                default: number;
+            };
+            listPadding: {
+                type: NumberConstructor;
+                default: number;
+            };
+        }>> & Readonly<{}>, {
+            height: number;
+            items: unknown[];
+            itemHeight: number;
+            overscan: number;
+            listPadding: number;
+        }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+    }, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+    VcpVirtualList: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+        items: {
+            type: ArrayConstructor;
+            default: () => any[];
+        };
+        itemHeight: {
+            type: NumberConstructor;
+            default: number;
+        };
+        height: {
+            type: NumberConstructor;
+            default: number;
+        };
+        overscan: {
+            type: NumberConstructor;
+            default: number;
+        };
+        listPadding: {
+            type: NumberConstructor;
+            default: number;
+        };
+    }>, {}, {
+        scrollTop: number;
+    }, {
+        totalHeight(): number;
+        enableVirtual(): boolean;
+        startIndex(): number;
+        endIndex(): number;
+        offsetY(): number;
+        visibleItems(): unknown[];
+    }, {
+        isSameItemList(nextItems: any, prevItems: any): boolean;
+        rowKey(item: any, index: any): string;
+        getItemKey(item: any): any;
+        onScroll(event: any): void;
+        resetScroll(): void;
+    }, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+        items: {
+            type: ArrayConstructor;
+            default: () => any[];
+        };
+        itemHeight: {
+            type: NumberConstructor;
+            default: number;
+        };
+        height: {
+            type: NumberConstructor;
+            default: number;
+        };
+        overscan: {
+            type: NumberConstructor;
+            default: number;
+        };
+        listPadding: {
+            type: NumberConstructor;
+            default: number;
+        };
+    }>> & Readonly<{}>, {
+        height: number;
+        items: unknown[];
+        itemHeight: number;
+        overscan: number;
+        listPadding: number;
+    }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;