@me-framework/me-ui-antdv-next 0.0.29 → 0.0.30

package/dist/input-property/index.vue.d.ts

@@ -1,15 +1,18 @@
-import { MeInputPropertyProps } from './types';
+import { MeInputPropertyProps, MeInputPropertyValidation } from './types';
 declare const __VLS_export: import('vue').DefineComponent<MeInputPropertyProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    change: (value: Record<string, any>) => any;
+    change: (value: Record<string, any>, validation?: MeInputPropertyValidation | undefined) => any;
     "update:modelValue": (value: Record<string, any>) => any;
 }, string, import('vue').PublicProps, Readonly<MeInputPropertyProps> & Readonly<{
-    onChange?: ((value: Record<string, any>) => any) | undefined;
+    onChange?: ((value: Record<string, any>, validation?: MeInputPropertyValidation | undefined) => any) | undefined;
     "onUpdate:modelValue"?: ((value: Record<string, any>) => any) | undefined;
 }>, {
     size: "small" | "middle" | "large";
     disabled: boolean;
     modelValue: Record<string, any>;
     draggable: boolean;
+    showType: boolean;
+    showRules: boolean;
+    validate: boolean;
     keyPlaceholder: string;
     valuePlaceholder: string;
     emptyText: string;

package/dist/input-property/types.d.ts

@@ -1,14 +1,63 @@
 /**
  * MeInputProperty 属性编辑器组件类型定义
  */
+/** 属性值类型 */
+export type PropertyValueType = 'string' | 'int' | 'float' | 'boolean' | 'date' | 'time';
+/** 类型列下拉选项（中文标签） */
+export declare const VALUE_TYPE_OPTIONS: ReadonlyArray<{
+    label: string;
+    value: PropertyValueType;
+}>;
+/** float 类型保留的小数位数 */
+export declare const FLOAT_PRECISION = 2;
+/** date 类型内部/导出格式 */
+export declare const DATE_FORMAT = "YYYY-MM-DD";
+/** time 类型内部/导出格式 */
+export declare const TIME_FORMAT = "HH:mm:ss";
+/** boolean 值编辑器下拉选项（是/否） */
+export declare const BOOLEAN_OPTIONS: ReadonlyArray<{
+    label: string;
+    value: boolean;
+}>;
 /** 内部行数据（一维属性项） */
 export interface PropertyKV {
     /** 行唯一 id（组件内部生成，用于定位编辑行，避免 key 变更导致表格重建） */
     id: string | number;
     /** 属性键 */
     key: string;
-    /** 属性值（原始值，统一按 string 编辑） */
+    /** 值类型：导入时按 JS 值自动推断，用户可在类型列切换 */
+    type: PropertyValueType;
+    /**
+     * 属性值。
+     * 各类型内部约定：string → 字符串（导入时非 string 原样保留）；
+     * int → 整数 number；float → 最多保留两位小数的 number；boolean → boolean；
+     * date → 'YYYY-MM-DD'；time → 'HH:mm:ss'。
+     */
     value: any;
+    /** 该行校验规则（弹窗编辑后写入；未配置 → undefined） */
+    rules?: PropertyRuleSet;
+}
+/**
+ * 属性校验规则集。
+ * 字段可用性随值类型区分：required 全类型；string 用 minLength/maxLength/pattern；
+ * int/float/date/time 用 min/max（int/float 为 number，date/time 为边界字符串）。
+ * 未配置的字段缺省即不启用；message 为全局自定义错误文案，任一规则触发时优先使用。
+ */
+export interface PropertyRuleSet {
+    /** 必填：值不能为空 */
+    required?: boolean;
+    /** string：最小长度 */
+    minLength?: number;
+    /** string：最大长度 */
+    maxLength?: number;
+    /** string：正则模式（JS 正则字符串；编译失败时该条不参与校验） */
+    pattern?: string;
+    /** int/float：最小值（number）；date/time：最早边界（'YYYY-MM-DD' / 'HH:mm:ss' 字符串） */
+    min?: number | string;
+    /** int/float：最大值（number）；date/time：最晚边界（'YYYY-MM-DD' / 'HH:mm:ss' 字符串） */
+    max?: number | string;
+    /** 全局自定义错误文案：任一规则触发时优先使用，缺省时用各规则默认文案 */
+    message?: string;
 }
 /** MeInputProperty Props */
 export interface MeInputPropertyProps {
@@ -20,19 +69,46 @@ export interface MeInputPropertyProps {
     size?: 'small' | 'middle' | 'large';
     /** 是否允许拖拽排序，默认 true */
     draggable?: boolean;
+    /** 是否显示类型列（string/int/float/boolean/date/time 下拉），默认 true；隐藏时类型保持推断结果 */
+    showType?: boolean;
+    /** 是否显示「校验」列（每行魔法图标弹窗编辑规则），默认 true；隐藏时仅隐藏规则编辑入口（不禁止注入/编辑规则数据） */
+    showRules?: boolean;
+    /** 是否启用校验，默认 false：关闭时不标红（key 空/重复、value 违反规则）且 change 校验报告为空；开启后按行内规则对 key 硬约束与 value 逐行校验并输出报告 */
+    validate?: boolean;
     /** key 列占位符 */
     keyPlaceholder?: string;
     /** value 列占位符 */
     valuePlaceholder?: string;
     /** 空数据提示 */
     emptyText?: string;
+    /** 外部注入的初始/持久化规则；键为属性 key（trim 后精确匹配）。外部重新赋值 modelValue 时，
+     *  会话内已有同 key 规则优先继承，新出现的 key 从这里取规则，消失的 key 规则丢弃 */
+    rules?: Record<string, PropertyRuleSet>;
 }
 /** MeInputProperty Events */
 export interface MeInputPropertyEmits {
     /** 更新 v-model 绑定对象 */
     (e: 'update:modelValue', value: Record<string, any>): void;
-    /** 数据变更（新增/删除/编辑/排序） */
-    (e: 'change', value: Record<string, any>): void;
+    /**
+     * 数据变更（新增/删除/编辑/排序）
+     * @param value 合并后的一维 JSON 对象（同名 key 会被覆盖合并，空 key 行被舍弃）
+     * @param validation 行级校验报告（重复 key、是否含空 key 等对象输出无法体现的信息）
+     */
+    (e: 'change', value: Record<string, any>, validation?: MeInputPropertyValidation): void;
+}
+/** change 事件附带的校验报告（行级信息，对象输出无法体现的数据问题） */
+export interface MeInputPropertyValidation {
+    /** 行级重复的 key（忽略大小写与首尾空格，含逐字重复；空数组表示无重复） */
+    duplicatedKeys: string[];
+    /** 是否存在为空的 key（键名 trim 后为空，该行会被从输出对象中舍弃） */
+    hasEmptyKey: boolean;
+    /** 逐属性 key 的校验规则快照（空 key 行、无规则行剔除），供消费方构建表单校验/规则体系 */
+    rowRules: Record<string, PropertyRuleSet>;
+    /**
+     * 逐属性 key 的当前违规文案（值为空或违反规则；空 key 行剔除；合法行不纳入）。
+     * 供消费方按规则做表单提交校验（提交前判定是否存在非空 valueErrors）。
+     */
+    valueErrors: Record<string, string>;
 }
 /** MeInputProperty 组件实例类型 */
 export type MeInputPropertyInstance = InstanceType<typeof import('./index.vue').default>;

package/dist/input-property/validate.d.ts

@@ -1,10 +1,28 @@
-/**
- * MeInputProperty 纯函数校验与转换逻辑
- *
- * 此模块不依赖 Vue，便于复用与单测。
- */
+import { PropertyKV, PropertyRuleSet, PropertyValueType } from './types';
 /** 生成简单唯一 id（组件内部用于定位行，避免用 key 定位导致表格重建丢焦点） */
 export declare function genId(): string;
+/**
+ * 按 JS 值类型推断内部类型：
+ * - 整数 number → 'int'
+ * - 小数 number（非整数）→ 'float'
+ * - boolean → 'boolean'
+ * - 匹配 YYYY-MM-DD 的字符串 → 'date'
+ * - 匹配 HH:mm(:ss) 的字符串 → 'time'
+ * - 其余（含 object/array/null/undefined）→ 'string'
+ */
+export declare function inferValueType(raw: any): PropertyValueType;
+/**
+ * 切换类型时把行内当前值归一化为目标类型的内部形态。
+ * 解析失败保守处理：int/float 非数字 → 保留原文；date/time 解析失败 → 保留原文，不丢数据；
+ * boolean 任何输入都能映射到 true/false（见 toBoolean），不存在丢数据。
+ */
+export declare function normalizeValue(raw: any, type: PropertyValueType): any;
+/**
+ * 导出时把行内值转换为输出对象值。
+ * 关键边界：`Number(null)` / `Number('')` 均为 0，int/float 导出必须先判空，避免空行污染为 0。
+ * float 统一四舍五入到小数位（如 3.14159 → 3.14）。
+ */
+export declare function exportValue(value: any, type: PropertyValueType): any;
 /** 将 key 统一为用于比较的小写形式（大小写不敏感） */
 export declare function normalizeKey(key: string): string;
 /**
@@ -16,3 +34,42 @@ export declare function checkDuplicateKeys(rows: {
 }[]): string[];
 /** 判断某 key 是否处于重复集合中（大小写不敏感） */
 export declare function isDuplicateKey(key: string, duplicates: string[]): boolean;
+/** 判断某规则字段是否适用于指定类型（用于 sanitize 清理与 UI 渲染） */
+export declare function isRuleApplicable(field: keyof PropertyRuleSet, type: PropertyValueType): boolean;
+/**
+ * 清理规则集：去掉空/NaN/空串的字段。
+ * - required 仅保留 true（false 等价于未设置）
+ * - minLength/maxLength 仅保留有效 number
+ * - pattern/message 仅保留非空字符串
+ * - min/max 仅保留有效 number 或非空字符串（date/time 边界）
+ * 清理后无有效字段 → 返回 undefined。
+ */
+export declare function normalizeRuleSet(rules: PropertyRuleSet | undefined): PropertyRuleSet | undefined;
+/**
+ * 类型切换时清理规则集：只保留该类型适用的字段。
+ * @example string 规则 { pattern, min } 切到 int → 删除 pattern（不适用 int），保留 min（int/float 适用）
+ */
+export declare function sanitizeRulesForType(rules: PropertyRuleSet | undefined, type: PropertyValueType): PropertyRuleSet | undefined;
+/**
+ * 校验行值是否满足规则集。
+ * @returns 违规时返回提示文案（自定义 message 优先，否则默认文案）；通过返回 null。
+ * 边界：非法正则编译失败 → 跳过该条；非字符串 string 值（导入遗留）不适用长度/正则；
+ * int/float/date/time 空值只由 required 拦截，非必填时不报错；boolean 恒有值无需除 required 外校验。
+ */
+export declare function validateValue(value: any, type: PropertyValueType, rules?: PropertyRuleSet): string | null;
+/**
+ * 由行集合构建逐 key 的规则快照（change 事件输出用）。
+ * 空 key 行 / 无有效规则的行剔除；同一 key 若多行重复，后出现的覆盖先出现的（与对象输出合并语义一致）。
+ */
+export declare function toRuleMap(rows: Pick<PropertyKV, 'key' | 'rules'>[]): Record<string, PropertyRuleSet>;
+/**
+ * 校验行值，返回违规文案或 null（供组件内置标红与 `valueErrors` 输出共用）。
+ * 完全委托 validateValue：value 校验严格按已配置的规则集执行——
+ * 未配置规则（或规则不适用当前值）→ 不报；空值唯一由 `required` 规则拦截，其余规则只针对有内容的值。
+ */
+export declare function valueError(value: any, type: PropertyValueType, rules?: PropertyRuleSet): string | null;
+/**
+ * 由行集合构建逐 key 的当前违规文案快照（change 事件 `valueErrors` 输出用）。
+ * 空 key 行 / 合法行剔除；同一 key 若多行重复，后出现的覆盖先出现的（与对象输出合并语义一致）。
+ */
+export declare function toValueErrorMap(rows: Pick<PropertyKV, 'key' | 'type' | 'value' | 'rules'>[]): Record<string, string>;