@weitutech/by-components-v3 1.1.25 → 1.1.27

package/dist/types/packages/batch-query-selector/src/index.vue.d.ts

@@ -1,6 +1,11 @@
 import './index.scss';
+type FieldValue = string | number | boolean | null | undefined;
 interface Option {
-    [key: string]: string | number;
+    [key: string]: FieldValue;
+}
+interface BatchInputOptionConfig {
+    label?: string;
+    field: string;
 }
 interface Props {
     modelValue?: Array<string | number> | string | number;
@@ -9,10 +14,20 @@ interface Props {
     autoLoad?: boolean;
     valueKey?: string;
     labelKey?: string;
+    /** 别名字段，拼接在名称后，只影响下拉展示 */
+    aliasKey?: string;
+    /** 描述字段，展示在选项右侧 */
+    descKey?: string;
+    /** 除名称、值之外额外参与搜索的字段 */
+    extraSearchKeys?: string[];
     disabledKey?: string;
     disabledMethod?: (option: Option) => boolean;
     multiple?: boolean;
+    /** 仅多选时生效，控制批量输入按钮 */
+    showBatchInput?: boolean;
     collapseTags?: boolean;
+    /** 多选可搜索时，选中后是否保留搜索词 */
+    reserveKeyword?: boolean;
     placeholder?: string;
     disabled?: boolean;
     clearable?: boolean;
@@ -20,10 +35,20 @@ interface Props {
     maxWidth?: string | number;
     popoverWidth?: string | number;
     customMapFunction?: (inputValues: string[], inputType: string, optionsList: Option[]) => Array<string | number>;
+    /**
+     * 自定义批量输入项。不传时仍是「ID / 名称」
+     * [{ label: '工号', field: 'jobNumber' }]
+     */
+    batchInputOptions?: BatchInputOptionConfig[];
     pageSize?: number;
     initialPageCount?: number;
+    /** 有文案时在选择框右侧展示问号提示 */
+    tooltip?: string;
 }
-declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+declare const _default: import("vue").DefineComponent<Props, {
+    refreshOptions: (params?: Record<string, unknown>) => Promise<void>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    input: (value: string | number | (string | number)[]) => any;
     "update:modelValue": (value: string | number | (string | number)[]) => any;
     change: (value: string | number | (string | number)[]) => any;
     "batch-selector-focus": (event: Event) => any;
@@ -36,6 +61,7 @@ declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, imp
         type: string;
     }) => any;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{
+    onInput?: (value: string | number | (string | number)[]) => any;
     "onUpdate:modelValue"?: (value: string | number | (string | number)[]) => any;
     onChange?: (value: string | number | (string | number)[]) => any;
     "onBatch-selector-focus"?: (event: Event) => any;
@@ -52,20 +78,27 @@ declare const _default: import("vue").DefineComponent<Props, {}, {}, {}, {}, imp
     options: Option[];
     disabled: boolean;
     modelValue: Array<string | number> | string | number;
+    clearable: boolean;
     loadOptions: (params?: Record<string, unknown>) => Promise<Option[]>;
     multiple: boolean;
     placeholder: string;
     pageSize: number;
-    clearable: boolean;
     collapseTags: boolean;
-    maxWidth: string | number;
+    showBatchInput: boolean;
     autoLoad: boolean;
     valueKey: string;
     labelKey: string;
+    aliasKey: string;
+    descKey: string;
+    extraSearchKeys: string[];
     disabledKey: string;
     disabledMethod: (option: Option) => boolean;
+    reserveKeyword: boolean;
+    maxWidth: string | number;
     popoverWidth: string | number;
     customMapFunction: (inputValues: string[], inputType: string, optionsList: Option[]) => Array<string | number>;
+    batchInputOptions: BatchInputOptionConfig[];
     initialPageCount: number;
+    tooltip: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/types/packages/card-selector/index.d.ts

@@ -0,0 +1,3 @@
+import ByCardSelector from './src/ByCardSelector.vue';
+export { ByCardSelector };
+export default ByCardSelector;

package/dist/types/packages/card-selector/src/ByCardSelector.vue.d.ts

@@ -0,0 +1,295 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** v-model：单选为选项 value；多选为 value 数组 */
+    value: {
+        type: (BooleanConstructor | StringConstructor | ObjectConstructor | NumberConstructor | ArrayConstructor)[];
+        default: any;
+    };
+    modelValue: {
+        type: (BooleanConstructor | StringConstructor | ObjectConstructor | NumberConstructor | ArrayConstructor)[];
+        default: any;
+    };
+    options: {
+        type: ArrayConstructor;
+        default: () => any[];
+    };
+    /** 是否多选 */
+    multiple: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 排列方向：横向（默认）或纵向；纵向时建议配合 verticalMaxHeight 以产生换列效果 */
+    direction: {
+        type: StringConstructor;
+        default: string;
+        validator: (v: unknown) => boolean;
+    };
+    /** 纵向排列时容器最大高度，便于 flex 换列；仅 direction=vertical 时生效 */
+    verticalMaxHeight: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 卡片尺寸（内边距、图标与字号等）；卡片列宽默认由 size 与样式表决定 */
+    size: {
+        type: StringConstructor;
+        default: string;
+        validator: (v: unknown) => boolean;
+    };
+    /**
+     * 每张卡片宽度（像素，组件级统一）。未设置时列宽由 size 对应样式决定，横向仍会均分拉伸。
+     * 合法范围 100–600，小于 100 按 100、大于 600 按 600；可传数字或字符串（如 240、"320px"）。
+     * 设置后横向默认按该值固定宽度、不再拉伸；若仍要均分拉伸，请显式设 :card-fill="true"。
+     */
+    cardWidth: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: any;
+    };
+    /**
+     * 横向是否均分拉伸。
+     * - 未传（默认）：有 card-width 时固定宽，无 card-width 时均分拉伸；
+     * - true：强制均分拉伸（即使设置了 card-width）；
+     * - false：强制固定为 card-width（或 size 对应列宽基准）。
+     * 纵向排列本身为固定宽，该属性对纵向无额外影响。
+     */
+    cardFill: {
+        type: BooleanConstructor;
+        default: any;
+    };
+    /** 整组禁用 */
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 选项字段映射，默认 value / label / description / icon / tooltip / tags。
+     * - 仅显式覆盖部分字段时，未覆盖字段保持默认；
+     * - 未显式配置 label 时，组件会在数据项缺少 `label` 字段的情况下自动回退到 `name`；
+     * - 未显式配置 value 时，同理回退到 `id`；
+     * - 显式配置（即便值与默认相同，如 `{ label: 'label', value: 'value' }`）会关闭对应字段的自动回退。
+     */
+    optionProps: {
+        type: ObjectConstructor;
+        default: () => {};
+    };
+    /** 用于判断禁用的数据字段，默认 disabled；数值类型时 1 为可选，非 1 为不可选；布尔 true 为禁用 */
+    disabledField: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 选项唯一键字段，用于 :key，默认与 value 字段一致 */
+    optionKeyField: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 标签最多展示个数，其余以 +N 省略 */
+    maxVisibleTags: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * 组件级说明：有内容时在所有选项之后展示问号，悬停显示提示（与单项内的 tooltip 字段无关）。
+     * 支持字符串或数字；仅空白则整组不展示该问号。
+     */
+    tooltips: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: string;
+    };
+    /** 是否在选中卡片右上角展示角标打钩，默认展示；未选中时不占位；如不需要可显式设为 false */
+    showCheckmark: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, {}, {
+    focusedIndex: number;
+}, {
+    boundValue(): string | number | boolean | Record<string, any> | unknown[];
+    mergedOptionProps(): {
+        value: string;
+        label: string;
+        description: string;
+        icon: string;
+        tooltip: string;
+        tags: string;
+    };
+    /**
+     * 当业务方未显式配置 optionProps.label 时启用 label → name 回退；
+     * 显式配置则关闭回退（严格使用业务方指定的字段）。
+     */
+    labelFallbackField(): "" | "name";
+    /**
+     * 当业务方未显式配置 optionProps.value 时启用 value → id 回退；
+     * 显式配置则关闭回退。
+     */
+    valueFallbackField(): "" | "id";
+    /** 解析后的卡片宽度（px），无效或未传时为 null */
+    resolvedCardWidthPx(): number;
+    /**
+     * 是否使用固定列宽（不拉伸）。
+     * 显式 cardFill 优先；未传时：有 card-width → 固定，无 → 均分拉伸。
+     */
+    useFixedCardWidth(): boolean;
+    /** 根节点样式：纵向高度 + 可选自定义卡片宽度（CSS 变量） */
+    rootStyle(): {
+        maxHeight: string;
+        '--by-card-selector-min': string;
+    };
+    hasCardSlot(): boolean;
+    hasIconSlot(): boolean;
+    /** 是否展示组件级尾部问号 */
+    hasGroupTooltip(): boolean;
+    /** 传给 el-tooltip 的纯文本 */
+    groupTooltipText(): string;
+}, {
+    pick(obj: any, key: any): any;
+    /**
+     * 取字段值，主键 `key` 在对象上不存在时回退到 `fallbackKey`。
+     * 仅以 hasOwnProperty 判断字段「是否存在」，因此业务方有意置 null / '' 不会被覆盖。
+     */
+    pickWithFallback(obj: any, key: any, fallbackKey: any): any;
+    optionKey(item: any, index: any): any;
+    optionValue(item: any): any;
+    optionLabel(item: any): string;
+    optionDescription(item: any): string;
+    rawIcon(item: any): any;
+    optionTooltip(item: any): any;
+    rawTags(item: any): any[];
+    iconComponent(item: any): any;
+    iconIsImage(item: any): boolean;
+    hasIconArea(item: any): boolean;
+    /** 仅标题卡片：无图标、描述、标签、单项 tooltip，角标自动缩小尺寸 */
+    isTitleOnlyCard(item: any): boolean;
+    iconFallbackLetter(item: any): string;
+    formatTag(tag: any): string;
+    visibleTags(item: any): any[];
+    tagOverflowCount(item: any): number;
+    isItemDisabled(item: any): boolean;
+    valuesEqual(a: any, b: any): boolean;
+    isSelected(item: any): boolean;
+    cardTabindex(item: any, index: any): 0 | -1;
+    emitChange(next: any): void;
+    toggleItem(item: any): void;
+    onCardClick(item: any, index: any): void;
+    onCardFocus(index: any): void;
+    enabledOptionIndices(): number[];
+    focusCardAtIndex(index: any): void;
+    moveFocus(delta: any): void;
+    onCardKeydown(e: any, index: any): void;
+    syncFocusedToFirstEnabled(): void;
+}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** v-model：单选为选项 value；多选为 value 数组 */
+    value: {
+        type: (BooleanConstructor | StringConstructor | ObjectConstructor | NumberConstructor | ArrayConstructor)[];
+        default: any;
+    };
+    modelValue: {
+        type: (BooleanConstructor | StringConstructor | ObjectConstructor | NumberConstructor | ArrayConstructor)[];
+        default: any;
+    };
+    options: {
+        type: ArrayConstructor;
+        default: () => any[];
+    };
+    /** 是否多选 */
+    multiple: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 排列方向：横向（默认）或纵向；纵向时建议配合 verticalMaxHeight 以产生换列效果 */
+    direction: {
+        type: StringConstructor;
+        default: string;
+        validator: (v: unknown) => boolean;
+    };
+    /** 纵向排列时容器最大高度，便于 flex 换列；仅 direction=vertical 时生效 */
+    verticalMaxHeight: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 卡片尺寸（内边距、图标与字号等）；卡片列宽默认由 size 与样式表决定 */
+    size: {
+        type: StringConstructor;
+        default: string;
+        validator: (v: unknown) => boolean;
+    };
+    /**
+     * 每张卡片宽度（像素，组件级统一）。未设置时列宽由 size 对应样式决定，横向仍会均分拉伸。
+     * 合法范围 100–600，小于 100 按 100、大于 600 按 600；可传数字或字符串（如 240、"320px"）。
+     * 设置后横向默认按该值固定宽度、不再拉伸；若仍要均分拉伸，请显式设 :card-fill="true"。
+     */
+    cardWidth: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: any;
+    };
+    /**
+     * 横向是否均分拉伸。
+     * - 未传（默认）：有 card-width 时固定宽，无 card-width 时均分拉伸；
+     * - true：强制均分拉伸（即使设置了 card-width）；
+     * - false：强制固定为 card-width（或 size 对应列宽基准）。
+     * 纵向排列本身为固定宽，该属性对纵向无额外影响。
+     */
+    cardFill: {
+        type: BooleanConstructor;
+        default: any;
+    };
+    /** 整组禁用 */
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 选项字段映射，默认 value / label / description / icon / tooltip / tags。
+     * - 仅显式覆盖部分字段时，未覆盖字段保持默认；
+     * - 未显式配置 label 时，组件会在数据项缺少 `label` 字段的情况下自动回退到 `name`；
+     * - 未显式配置 value 时，同理回退到 `id`；
+     * - 显式配置（即便值与默认相同，如 `{ label: 'label', value: 'value' }`）会关闭对应字段的自动回退。
+     */
+    optionProps: {
+        type: ObjectConstructor;
+        default: () => {};
+    };
+    /** 用于判断禁用的数据字段，默认 disabled；数值类型时 1 为可选，非 1 为不可选；布尔 true 为禁用 */
+    disabledField: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 选项唯一键字段，用于 :key，默认与 value 字段一致 */
+    optionKeyField: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 标签最多展示个数，其余以 +N 省略 */
+    maxVisibleTags: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /**
+     * 组件级说明：有内容时在所有选项之后展示问号，悬停显示提示（与单项内的 tooltip 字段无关）。
+     * 支持字符串或数字；仅空白则整组不展示该问号。
+     */
+    tooltips: {
+        type: (StringConstructor | NumberConstructor)[];
+        default: string;
+    };
+    /** 是否在选中卡片右上角展示角标打钩，默认展示；未选中时不占位；如不需要可显式设为 false */
+    showCheckmark: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{}>, {
+    size: string;
+    options: unknown[];
+    disabled: boolean;
+    value: string | number | boolean | Record<string, any> | unknown[];
+    modelValue: string | number | boolean | Record<string, any> | unknown[];
+    multiple: boolean;
+    direction: string;
+    verticalMaxHeight: string;
+    cardWidth: string | number;
+    cardFill: boolean;
+    optionProps: Record<string, any>;
+    disabledField: string;
+    optionKeyField: string;
+    maxVisibleTags: number;
+    tooltips: string | number;
+    showCheckmark: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/packages/card-view/index.d.ts

@@ -0,0 +1,3 @@
+import ByCardView from './src/ByCardView.vue';
+export { ByCardView };
+export default ByCardView;

package/dist/types/packages/card-view/src/ByCardView.vue.d.ts

@@ -0,0 +1,69 @@
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** 标题文案 */
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 与 title 相同含义；个别工程里 title 易被吞时可改用 heading */
+    heading: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 无边框模式 */
+    plain: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 为 true 时用 #header 整块替换默认标题行 */
+    customHeader: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 标题右侧的提示文案，配置后显示问号图标，鼠标悬停展示 */
+    tooltip: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {}, {}, {
+    effectiveTitle(): string;
+    titleSlotLen(): any;
+    extraSlotLen(): any;
+    showTitleRow(): boolean;
+    hasTitleText(): boolean;
+    effectiveTooltip(): string;
+}, {
+    namedSlotLen(name: any): any;
+}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** 标题文案 */
+    title: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 与 title 相同含义；个别工程里 title 易被吞时可改用 heading */
+    heading: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 无边框模式 */
+    plain: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 为 true 时用 #header 整块替换默认标题行 */
+    customHeader: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 标题右侧的提示文案，配置后显示问号图标，鼠标悬停展示 */
+    tooltip: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    title: string;
+    tooltip: string;
+    plain: boolean;
+    heading: string;
+    customHeader: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/packages/cascader-panel/index.d.ts

@@ -0,0 +1,3 @@
+import ByCascaderPanel from './src/ByCascaderPanel.vue';
+export { ByCascaderPanel };
+export default ByCascaderPanel;