@mtn-ui/components 0.0.6 → 0.0.7

package/dist/types/dict-tag/types.d.ts

@@ -0,0 +1,23 @@
+import { DictItem } from '@mtn-ui/utils';
+
+export type { DictItem };
+export interface DictTagProps {
+    /** 要展示的字典值（dictValue），根据此值在字典中查找 label 与 color */
+    value?: string | number;
+    /** 字典列表，优先级高于 dictType */
+    options?: DictItem[];
+    /** 字典类型，从 localStorage 读取（key = storageKeyPrefix + dictType） */
+    dictType?: string;
+    /** 展示字段名 */
+    labelKey?: string;
+    /** 值字段名 */
+    valueKey?: string;
+    /** 颜色字段名，用于 Tag 的 color */
+    colorKey?: string;
+    /** localStorage 的 key 前缀 */
+    storageKeyPrefix?: string;
+    /** 未匹配到字典项时展示的占位文案 */
+    placeholder?: string;
+    /** 自定义类名 */
+    class?: string;
+}

package/dist/types/form-item/FormItem.d.ts

@@ -0,0 +1,39 @@
+import { FormItemProps } from './types';
+
+declare function __VLS_template(): {
+    append?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<FormItemProps>, {
+    show: boolean;
+    showLabel: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<FormItemProps>, {
+    show: boolean;
+    showLabel: boolean;
+}>>> & Readonly<{}>, {
+    showLabel: boolean;
+    show: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/form-item/constants.d.ts

@@ -0,0 +1,9 @@
+import { FormItemType } from './types';
+
+export declare const COMPONENT_MAP: Partial<Record<Exclude<FormItemType, 'custom'>, unknown>>;
+/** 不传给 a-form-item 的 props；label 需传给 a-form-item 以便在无 #label 插槽时正常显示 */
+export declare const OMIT_PROPS: readonly ["hidden", "validate", "type", "itemProps", "itemEvents", "span", "labelSpan", "wrapperCol", "name", "formData", "required", "placeholder", "showLabel"];
+export declare const DEFAULT_LAYOUT: {
+    readonly labelSpan: 6;
+    readonly wrapperCol: 18;
+};

package/dist/types/form-item/index.d.ts

@@ -0,0 +1,4 @@
+export { default as FormItem } from './FormItem';
+export type { FormItemType, FormItemTypeBase, FormItemTypeExtended, FormItemConfig, FormItemProps } from './types';
+export { COMPONENT_MAP, DEFAULT_LAYOUT, OMIT_PROPS } from './constants';
+export { validateCondition } from './validator';

package/dist/types/form-item/types.d.ts

@@ -0,0 +1,46 @@
+/**
+ * FormItem 表单项类型定义
+ * 参考 MxFormItem，支持可配置 type、嵌套路径、校验等
+ */
+/** 基础表单项类型（Ant Design Vue 组件） */
+export type FormItemTypeBase = 'input' | 'text-area' | 'select' | 'radio' | 'checkbox' | 'date-picker' | 'input-number' | 'input-search';
+/** 扩展类型 */
+export type FormItemTypeExtended = 'tree-select' | 'custom';
+/** 表单项 type 枚举 */
+export type FormItemType = FormItemTypeBase | FormItemTypeExtended;
+/** 表单项基础配置 */
+export interface FormItemConfig {
+    label: string;
+    /** 字段名，字符串为单层路径，数组为嵌套路径如 ['user','address','city'] */
+    name?: string | string[];
+    /** 占位文案；不传时根据 type 与 label 自动生成（请选择/请输入 + label） */
+    placeholder?: string;
+    /** 是否显示 label；false 时不渲染标签列（如 SearchBar 仅用 label 参与 placeholder 生成） */
+    showLabel?: boolean;
+    span?: 24 | 12 | 8;
+    labelSpan?: number;
+    wrapperCol?: number;
+    required?: boolean;
+    disabled?: boolean;
+    show?: boolean;
+    tooltip?: string;
+    rules?: Array<Record<string, unknown>>;
+    validate?: Array<{
+        condition: string;
+        message: string;
+    }>;
+}
+/** FormItem 组件 Props（内部 + 扩展） */
+export interface FormItemProps extends FormItemConfig {
+    type: FormItemType;
+    customComponent?: unknown;
+    itemProps?: Record<string, unknown>;
+    itemEvents?: Record<string, (...args: unknown[]) => void>;
+    showStr?: string | string[];
+    defaultValue?: unknown;
+    prefixName?: string[];
+    /** 表单数据对象或 ref，用于内部双向绑定 */
+    formData?: Record<string, unknown> | {
+        value: Record<string, unknown>;
+    };
+}

package/dist/types/form-item/validator.d.ts

@@ -0,0 +1 @@
+export declare function validateCondition(condition: string, value: unknown): boolean;

package/dist/types/form-renderer/FormRenderer.d.ts

@@ -0,0 +1,37 @@
+import { FormRendererProps } from './types';
+
+declare function __VLS_template(): Partial<Record<string, (_: {}) => any>>;
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<FormRendererProps>, {
+    cols: number;
+    gutter: number;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<FormRendererProps>, {
+    cols: number;
+    gutter: number;
+}>>> & Readonly<{}>, {
+    cols: number;
+    gutter: number | [number, number];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/form-renderer/helpers.d.ts

@@ -0,0 +1,9 @@
+/** 带 show/showStr 的字段项，用于 processHiddenFields（仅约束必要属性，便于 FormItemProps 等传入） */
+export interface FormFieldWithShow {
+    show?: boolean;
+    showStr?: string | string[];
+}
+/**
+ * 处理隐藏字段：根据 formData 与 showStr 计算每项的 show，并过滤出需要展示的字段
+ */
+export declare function processHiddenFields<T extends FormFieldWithShow>(fields: T[], formData: Record<string, unknown>): T[];

package/dist/types/form-renderer/index.d.ts

@@ -0,0 +1,3 @@
+export { default as FormRenderer } from './FormRenderer';
+export type { FormRendererProps, FormRendererFieldConfig } from './types';
+export { processHiddenFields } from './helpers';

package/dist/types/form-renderer/types.d.ts

@@ -0,0 +1,13 @@
+import { FormItemProps } from '../form-item/types';
+
+export type FormRendererFieldConfig = FormItemProps;
+export interface FormRendererProps {
+    /** 表单字段配置 */
+    fields: FormRendererFieldConfig[];
+    /** 表单数据（与 FormItem 双向绑定） */
+    formData: Record<string, unknown>;
+    /** 列数（传给 FormRow） */
+    cols?: number;
+    /** 列间距（传给 FormRow） */
+    gutter?: number | [number, number];
+}

package/dist/types/form-row/FormRow.d.ts

@@ -0,0 +1,33 @@
+import { FormRowProps } from './types';
+
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<FormRowProps>, {
+    cols: number;
+    gutter: number;
+    class: undefined;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<FormRowProps>, {
+    cols: number;
+    gutter: number;
+    class: undefined;
+}>>> & Readonly<{}>, {
+    class: string;
+    cols: number;
+    gutter: number | [number, number];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/types/form-row/index.d.ts

@@ -0,0 +1,2 @@
+export { default as FormRow } from './FormRow';
+export type { FormRowProps } from './types';

package/dist/types/form-row/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * FormRow 表单行布局组件类型
+ */
+export interface FormRowProps {
+    /** 每行显示的列数（1-24） */
+    cols?: number;
+    /** 列间距 */
+    gutter?: number | [number, number];
+    /** 自定义类名 */
+    class?: string;
+}

package/dist/types/index.d.ts

@@ -10,6 +10,28 @@ export * from './delete-button';
 export type * from './delete-button/types';
 export * from './color-picker';
 export type * from './color-picker/types';
+export * from './form-item';
+export type * from './form-item/types';
+export * from './form-row';
+export type * from './form-row/types';
+export * from './form-renderer';
+export type * from './form-renderer/types';
+export * from './content-container';
+export type * from './content-container/types';
+export * from './auto-tooltip';
+export type * from './auto-tooltip/types';
+export { DictSelect } from './dict-select';
+export type { DictItem, DictSelectProps } from './dict-select/types';
+export { DictRadio } from './dict-radio';
+export type { DictRadioProps } from './dict-radio/types';
+export { DictCheckbox } from './dict-checkbox';
+export type { DictCheckboxProps } from './dict-checkbox/types';
+export { DictBadge } from './dict-badge';
+export type { DictBadgeProps } from './dict-badge/types';
+export { DictTag } from './dict-tag';
+export type { DictTagProps } from './dict-tag/types';
+export { SearchBar } from './search-bar';
+export type { SearchBarProps, SearchConfigItem } from './search-bar/types';
 export type * from './button/types';
 /**
  * MTN UI Vue Plugin

package/dist/types/search-bar/SearchBar.d.ts

@@ -0,0 +1,60 @@
+import { SearchBarProps, SearchConfigItem } from './types';
+
+declare function __VLS_template(): {
+    default?(_: {}): any;
+};
+declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<SearchBarProps>, {
+    searchList: () => never[];
+    cols: number;
+    gutter: number;
+    searchText: string;
+    resetText: string;
+    expandText: () => [string, string];
+    validateBeforeSearch: boolean;
+}>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    reset: () => void;
+    search: (values: Record<string, unknown>) => void;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<SearchBarProps>, {
+    searchList: () => never[];
+    cols: number;
+    gutter: number;
+    searchText: string;
+    resetText: string;
+    expandText: () => [string, string];
+    validateBeforeSearch: boolean;
+}>>> & Readonly<{
+    onReset?: (() => any) | undefined;
+    onSearch?: ((values: Record<string, unknown>) => any) | undefined;
+}>, {
+    cols: number;
+    gutter: number | [number, number];
+    searchList: SearchConfigItem[];
+    searchText: string;
+    resetText: string;
+    expandText: [string, string];
+    validateBeforeSearch: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/search-bar/index.d.ts

@@ -0,0 +1,2 @@
+export { default as SearchBar } from './SearchBar';
+export type { SearchBarProps, SearchConfigItem } from './types';

package/dist/types/search-bar/types.d.ts

@@ -0,0 +1,58 @@
+/**
+ * 配置化搜索项：用于 searchList，支持基础/高级（isHidden）与多种控件类型
+ */
+export interface SearchConfigItem {
+    /** 字段名，对应 model 的 key */
+    key: string;
+    /** 控件类型 */
+    type: 'input' | 'search' | 'select' | 'date' | 'dateRange' | 'custom';
+    /** 展示名称（高级区域表单项 label） */
+    name?: string;
+    /** 占位文案 */
+    placeholder?: string;
+    /** 下拉选项（type=select 时） */
+    options?: Array<{
+        label: string;
+        value: string | number;
+    }>;
+    /** true 时放入高级搜索折叠区 */
+    isHidden?: boolean;
+    /** 默认值 */
+    defaultValue?: unknown;
+    /** 控件宽度（像素） */
+    width?: number;
+    /** 控件样式 */
+    style?: Record<string, string | number>;
+    /** 透传给控件的 props */
+    props?: Record<string, unknown>;
+    /** 自定义渲染（type=custom 时），返回 VNode 或组件 */
+    render?: (ctx: {
+        value: unknown;
+        onChange: (v: unknown) => void;
+        item: SearchConfigItem;
+    }) => import('vue').VNode | import('vue').Component;
+}
+/**
+ * SearchBar 组件 Props
+ * 用于表格上方搜索区。支持两种用法：1）插槽 + FormItem；2）配置 searchList（基础 + 高级展开），不含操作按钮区。
+ */
+export interface SearchBarProps {
+    /** 表单数据对象（与内部 FormItem 的 form-data 或配置项绑定共用） */
+    model: Record<string, unknown>;
+    /** 配置化搜索项列表；有值时使用配置化 UI（基础行 + 高级展开），无值时使用默认插槽 */
+    searchList?: SearchConfigItem[];
+    /** 每行表单项列数（仅插槽模式生效，传给 FormRow） */
+    cols?: number;
+    /** 列间距（仅插槽模式生效） */
+    gutter?: number | [number, number];
+    /** 查询按钮文案 */
+    searchText?: string;
+    /** 重置按钮文案 */
+    resetText?: string;
+    /** 展开/收起文案，[展开, 收起] */
+    expandText?: [string, string];
+    /** 是否在点击查询前进行表单校验 */
+    validateBeforeSearch?: boolean;
+    /** 自定义类名 */
+    class?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mtn-ui/components",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "MTN UI Components",
   "type": "module",
   "main": "./dist/index/index.js",
@@ -80,7 +80,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "tailwind-merge": "^3.4.0",
-    "@mtn-ui/utils": "0.0.5"
+    "@mtn-ui/utils": "0.0.6"
   },
   "scripts": {
     "build": "vite build",