morningfast-plus 1.0.20 → 1.0.21

package/components/product-select/index.d.ts

@@ -0,0 +1,9 @@
+import { SFCWithInstall } from '../install';
+import { default as ProductSelect } from './src/product-select.vue';
+/**
+ * @file ProductSelect 产品选择器组件
+ * @module /packages/components/product-select
+ */
+export declare const MpProductSelect: SFCWithInstall<typeof ProductSelect>;
+export default MpProductSelect;
+export * from './src/product-select';

package/components/product-select/src/product-select.d.ts

@@ -0,0 +1,106 @@
+import { PropType } from 'vue';
+/** 透传给 ElTooltip 的配置（与组件内默认属性浅合并，每格仍强制使用当前单元格文案作为 content） */
+export type MpProductSelectTooltipProps = Record<string, unknown>;
+/** 列表项一行展示的字段配置 */
+export interface MpProductSelectField {
+    /** 对应 `items` 中取值的属性名 */
+    key: string;
+    /** 左侧标签文案 */
+    label: string;
+    /** 单字段覆盖 `tooltipProps`（浅合并） */
+    tooltipProps?: MpProductSelectTooltipProps;
+}
+/**
+ * 每条卡片内嵌的行数据（常见于接口直接返回 key-value 列表）
+ * - `label` 与 `key` 二选一作为左侧文案；接口常用 `key` 表示「名称、编码」等标签
+ */
+export interface MpProductSelectItemRow {
+    label?: string;
+    key?: string;
+    value: unknown;
+    tooltipProps?: MpProductSelectTooltipProps;
+}
+export type MpProductSelectItem = Record<string, unknown>;
+export declare const MpProductSelectProps: {
+    items: {
+        type: PropType<MpProductSelectItem[]>;
+        default: () => never[];
+    };
+    /**
+     * 左侧信息区列配置（与 `itemRowsKey` 二选一）
+     * 有 `itemRowsKey` 时以每条 `items` 上的数组为准，可不再传 `fields`
+     */
+    fields: {
+        type: PropType<MpProductSelectField[]>;
+        default: () => never[];
+    };
+    /**
+     * 每条 `items` 上存放「行列表」的属性名，如 `message`、`rows`
+     * 数组项形如 `{ key: '名称', value: 'xxx' }` 或 `{ label: '名称', value: 'xxx' }`
+     */
+    itemRowsKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 图片地址字段名，不传则不展示图片列 */
+    imageKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 勾选与 `v-model` 绑定的唯一键字段 */
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 是否启用勾选（关闭后不展示全选与各卡片复选框，且无法通过 UI 改选中项） */
+    selectable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 是否展示顶部「全选」（仅当 `selectable` 为 true 时生效） */
+    showSelectAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    selectAllText: {
+        type: StringConstructor;
+        default: string;
+    };
+    emptyText: {
+        type: StringConstructor;
+        default: string;
+    };
+    /**
+     * 值区域最大宽度，避免过长文本撑破布局；支持数字(px)或任意 CSS 宽度
+     * @default min(100%, 160px)
+     */
+    valueMaxWidth: {
+        type: PropType<string | number>;
+        default: string;
+    };
+    /** 统一配置各字段值上的 ElTooltip（可被字段级 `tooltipProps` 覆盖） */
+    tooltipProps: {
+        type: PropType<MpProductSelectTooltipProps>;
+        default: () => {};
+    };
+    /**
+     * Tooltip 气泡层默认最大宽度（写入 `popperStyle.maxWidth`，可被 `tooltipProps.popperStyle` 覆盖）
+     * @default min(90vw, 320px)
+     */
+    tooltipPopperMaxWidth: {
+        type: PropType<string | number>;
+        default: string;
+    };
+    /**
+     * Tooltip 层级，需高于布局侧栏等（如 MppLayout 侧栏 z-index: 5000）
+     */
+    tooltipZIndex: {
+        type: NumberConstructor;
+        default: number;
+    };
+};
+export declare const MpProductSelectEmits: {
+    change: (_keys: (string | number)[], _selectedItems: MpProductSelectItem[]) => boolean;
+    /** 选中项变化（与 `change` 同步触发，便于在模板用 `@selection-change` 监听） */
+    'selection-change': (_keys: (string | number)[], _selectedItems: MpProductSelectItem[]) => boolean;
+};

package/components/product-select/src/product-select.vue.d.ts

@@ -0,0 +1,137 @@
+import { MpProductSelectField, MpProductSelectItem } from './product-select';
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    items: {
+        type: import('vue').PropType<MpProductSelectItem[]>;
+        default: () => never[];
+    };
+    fields: {
+        type: import('vue').PropType<MpProductSelectField[]>;
+        default: () => never[];
+    };
+    itemRowsKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    imageKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showSelectAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    selectAllText: {
+        type: StringConstructor;
+        default: string;
+    };
+    emptyText: {
+        type: StringConstructor;
+        default: string;
+    };
+    valueMaxWidth: {
+        type: import('vue').PropType<string | number>;
+        default: string;
+    };
+    tooltipProps: {
+        type: import('vue').PropType<import('./product-select').MpProductSelectTooltipProps>;
+        default: () => {};
+    };
+    tooltipPopperMaxWidth: {
+        type: import('vue').PropType<string | number>;
+        default: string;
+    };
+    tooltipZIndex: {
+        type: NumberConstructor;
+        default: number;
+    };
+    modelValue: {
+        type: import('vue').PropType<(string | number)[]>;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (_keys: (string | number)[], _selectedItems: MpProductSelectItem[]) => void;
+    "selection-change": (_keys: (string | number)[], _selectedItems: MpProductSelectItem[]) => void;
+    "update:modelValue": (value: (string | number)[]) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    items: {
+        type: import('vue').PropType<MpProductSelectItem[]>;
+        default: () => never[];
+    };
+    fields: {
+        type: import('vue').PropType<MpProductSelectField[]>;
+        default: () => never[];
+    };
+    itemRowsKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    imageKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    selectable: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showSelectAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    selectAllText: {
+        type: StringConstructor;
+        default: string;
+    };
+    emptyText: {
+        type: StringConstructor;
+        default: string;
+    };
+    valueMaxWidth: {
+        type: import('vue').PropType<string | number>;
+        default: string;
+    };
+    tooltipProps: {
+        type: import('vue').PropType<import('./product-select').MpProductSelectTooltipProps>;
+        default: () => {};
+    };
+    tooltipPopperMaxWidth: {
+        type: import('vue').PropType<string | number>;
+        default: string;
+    };
+    tooltipZIndex: {
+        type: NumberConstructor;
+        default: number;
+    };
+    modelValue: {
+        type: import('vue').PropType<(string | number)[]>;
+    };
+}>> & Readonly<{
+    onChange?: ((_keys: (string | number)[], _selectedItems: MpProductSelectItem[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: (string | number)[]) => any) | undefined;
+    "onSelection-change"?: ((_keys: (string | number)[], _selectedItems: MpProductSelectItem[]) => any) | undefined;
+}>, {
+    fields: MpProductSelectField[];
+    items: MpProductSelectItem[];
+    emptyText: string;
+    rowKey: string;
+    selectable: boolean;
+    itemRowsKey: string;
+    imageKey: string;
+    showSelectAll: boolean;
+    selectAllText: string;
+    valueMaxWidth: string | number;
+    tooltipProps: import('./product-select').MpProductSelectTooltipProps;
+    tooltipPopperMaxWidth: string | number;
+    tooltipZIndex: number;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, HTMLDivElement>;
+export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "morningfast-plus",
-    "version": "1.0.20",
+    "version": "1.0.21",
     "type": "module",
     "description": "A library based on Vue 3 and Element Plus",
     "author": "jishu_app@morningfast.com",