@tmagic/form 1.8.2 → 1.8.3

package/dist/es/fields/Date/Index.vue_vue_type_script_setup_true_lang.js

@@ -1,3 +1,4 @@
+import { normalizeTimestampValue } from "../../utils/form.js";
 import { useAddField } from "../../utils/useAddField.js";
 import { createBlock, defineComponent, openBlock, unref } from "vue";
 import { TMagicDatePicker } from "@tmagic/design";
@@ -26,7 +27,7 @@ var Index_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComp
 		const emit = __emit;
 		useAddField(props.prop);
 		const changeHandler = (v) => {
-			emit("change", v);
+			emit("change", normalizeTimestampValue(v, props.config.valueFormat));
 		};
 		return (_ctx, _cache) => {
 			return openBlock(), createBlock(unref(TMagicDatePicker), {

package/dist/es/fields/DateTime/Index.vue_vue_type_script_setup_true_lang.js

@@ -1,3 +1,4 @@
+import { normalizeTimestampValue } from "../../utils/form.js";
 import { useAddField } from "../../utils/useAddField.js";
 import { createBlock, defineComponent, openBlock, unref } from "vue";
 import { TMagicDatePicker } from "@tmagic/design";
@@ -26,7 +27,7 @@ var Index_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComp
 		const emit = __emit;
 		useAddField(props.prop);
 		const changeHandler = (v) => {
-			emit("change", v);
+			emit("change", normalizeTimestampValue(v, props.config.valueFormat));
 		};
 		return (_ctx, _cache) => {
 			return openBlock(), createBlock(unref(TMagicDatePicker), {

package/dist/es/fields/Daterange.vue_vue_type_script_setup_true_lang.js

@@ -1,4 +1,4 @@
-import { datetimeFormatter } from "../utils/form.js";
+import { datetimeFormatter, normalizeTimestampValue } from "../utils/form.js";
 import { useAddField } from "../utils/useAddField.js";
 import { createBlock, defineComponent, onUnmounted, openBlock, ref, unref, watch } from "vue";
 import { TMagicDatePicker } from "@tmagic/design";
@@ -28,22 +28,27 @@ var Daterange_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 		useAddField(props.prop);
 		const { names } = props.config;
 		const value = ref([]);
+		const rangeFormat = () => `${props.config.dateFormat || "YYYY/MM/DD"} ${props.config.timeFormat || "HH:mm:ss"}`;
+		/** `X` 的选择器值就是秒级数字，展示格式不能拿去代替 valueFormat。 */
+		const toPickerValue = (item) => {
+			if (!item) return void 0;
+			if (props.config.valueFormat === "X") return normalizeTimestampValue(item, "X");
+			return datetimeFormatter(item, "", rangeFormat());
+		};
 		if (props.model !== void 0) {
 			if (names?.length) {
 				const unWatch = watch([() => props.model[names[0]], () => props.model[names[1]]], ([start, end], [preStart, preEnd]) => {
 					if (!value.value) value.value = [];
-					const format = `${props.config.dateFormat || "YYYY/MM/DD"} ${props.config.timeFormat || "HH:mm:ss"}`;
 					if (!start || !end) value.value = [];
-					if (start !== preStart) value.value[0] = datetimeFormatter(start, "", format);
-					if (end !== preEnd) value.value[1] = datetimeFormatter(end, "", format);
+					if (start !== preStart) value.value[0] = toPickerValue(start);
+					if (end !== preEnd) value.value[1] = toPickerValue(end);
 				}, { immediate: true });
 				onUnmounted(() => {
 					unWatch();
 				});
 			} else if (props.name && props.model[props.name]) {
 				const unWatch = watch(() => props.model[props.name], (start, preStart) => {
-					const format = `${props.config.dateFormat || "YYYY/MM/DD"} ${props.config.timeFormat || "HH:mm:ss"}`;
-					if (start !== preStart) value.value = start.map((item) => item ? datetimeFormatter(item, "", format) : void 0);
+					if (start !== preStart) value.value = start.map((item) => toPickerValue(item));
 				}, { immediate: true });
 				onUnmounted(() => {
 					unWatch();
@@ -51,15 +56,16 @@ var Daterange_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 			}
 		}
 		const changeHandler = (v) => {
-			const value = v || [];
+			const normalized = normalizeTimestampValue(v, props.config.valueFormat);
+			const value = normalized || [];
 			if (props.name) emit("change", value);
 			else if (props.config.names?.length) {
 				const newChangeRecords = [];
 				props.config.names.forEach((item, index) => {
 					if (!props.model) return;
-					if (Array.isArray(v)) newChangeRecords.push({
+					if (Array.isArray(normalized)) newChangeRecords.push({
 						propPath: props.prop ? `${props.prop}.${item}` : item,
-						value: v[index]
+						value: normalized[index]
 					});
 					else newChangeRecords.push({
 						propPath: props.prop ? `${props.prop}.${item}` : item,

package/dist/es/fields/Time.vue_vue_type_script_setup_true_lang.js

@@ -1,3 +1,4 @@
+import { normalizeTimestampValue } from "../utils/form.js";
 import { useAddField } from "../utils/useAddField.js";
 import { createBlock, defineComponent, openBlock, unref } from "vue";
 import { TMagicTimePicker } from "@tmagic/design";
@@ -26,7 +27,7 @@ var Time_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 		const emit = __emit;
 		useAddField(props.prop);
 		const changeHandler = (v) => {
-			emit("change", v);
+			emit("change", normalizeTimestampValue(v, props.config.valueFormat));
 		};
 		return (_ctx, _cache) => {
 			return openBlock(), createBlock(unref(TMagicTimePicker), {

package/dist/es/fields/Timerange.vue_vue_type_script_setup_true_lang.js

@@ -1,4 +1,4 @@
-import { datetimeFormatter } from "../utils/form.js";
+import { datetimeFormatter, normalizeTimestampValue } from "../utils/form.js";
 import { useAddField } from "../utils/useAddField.js";
 import { createBlock, defineComponent, onUnmounted, openBlock, ref, unref, watch } from "vue";
 import dayjs from "dayjs";
@@ -32,21 +32,26 @@ var Timerange_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 		const getFullDatetime = (item) => item ? `${dayjs().format("YYYY/MM/DD")} ${item}` : "";
 		const getFormat = () => `YYYY/MM/DD ${props.config.valueFormat || "HH:mm:ss"}`;
 		const timeFormatter = (time, format) => datetimeFormatter(getFullDatetime(time), "", format).substring(11);
+		/** `X` 的选择器值就是秒级数字，不能再拼成日期后截取。 */
+		const toPickerValue = (time) => {
+			if (!time) return void 0;
+			if (props.config.valueFormat === "X") return normalizeTimestampValue(time, "X");
+			return timeFormatter(time, getFormat());
+		};
 		if (props.model !== void 0) {
 			if (names?.length) {
 				const unWatch = watch([() => props.model[names[0]], () => props.model[names[1]]], ([start, end], [preStart, preEnd]) => {
 					if (!value.value) value.value = [];
-					const format = getFormat();
 					if (!start || !end) value.value = [];
-					if (start !== preStart) value.value[0] = timeFormatter(start, format);
-					if (end !== preEnd) value.value[1] = timeFormatter(end, format);
+					if (start !== preStart) value.value[0] = toPickerValue(start);
+					if (end !== preEnd) value.value[1] = toPickerValue(end);
 				}, { immediate: true });
 				onUnmounted(() => {
 					unWatch();
 				});
 			} else if (props.name) {
 				const unWatch = watch(() => props.model[props.name], (v = []) => {
-					if (Array.isArray(v)) value.value = v.map((item) => item ? timeFormatter(item, getFormat()) : void 0);
+					if (Array.isArray(v)) value.value = v.map((item) => toPickerValue(item));
 					else value.value = [];
 				}, { immediate: true });
 				onUnmounted(() => {
@@ -55,15 +60,16 @@ var Timerange_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 			}
 		}
 		const changeHandler = (v) => {
-			const value = v || [];
+			const normalized = normalizeTimestampValue(v, props.config.valueFormat);
+			const value = normalized || [];
 			if (props.name) emit("change", value);
 			else if (props.config.names?.length) {
 				const newChangeRecords = [];
 				props.config.names.forEach((item, index) => {
 					if (!props.model) return;
-					if (Array.isArray(v)) newChangeRecords.push({
+					if (Array.isArray(normalized)) newChangeRecords.push({
 						propPath: props.prop ? `${props.prop}.${item}` : item,
-						value: v[index]
+						value: normalized[index]
 					});
 					else newChangeRecords.push({
 						propPath: props.prop ? `${props.prop}.${item}` : item,

package/dist/es/headless.js

@@ -2,7 +2,7 @@ import { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY } fro
 import { isLeafFieldType } from "./utils/fieldValueEffects.js";
 import { MAX_SUGGESTION_OPTIONS, clearTypeMatchRules, deleteTypeMatchRule, getTypeMatchRule, optionSuggestion, stringifyExampleValue, validateTypeMatch } from "./utils/typeMatch.js";
 import { createFormStateProxy, mergeFormContexts } from "./utils/formStateProxy.js";
-import { adaptFormValidator, appendProp, createFormStateBase, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getItemProp, getNativeRules, getRules, initValue, isValidName, resolveItemType, sortArray, sortChange } from "./utils/form.js";
+import { adaptFormValidator, appendProp, createFormStateBase, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getItemProp, getNativeRules, getRules, initValue, isValidName, normalizeTimestampValue, resolveItemType, sortArray, sortChange } from "./utils/form.js";
 import { FieldInnerConfigError, applyMountValueEffects, collectValidatableFields, isFieldInnerConfigError } from "./utils/collectFields.js";
 import { formatValidateError, getTextByName } from "./utils/validateError.js";
 import { createHeadlessFormState, validateValues } from "./utils/validateValues.js";
@@ -10,4 +10,4 @@ import { submitForm, validateForm } from "./utils/submitHeadless.js";
 import { clearFields, getField, mergeFieldOptions, registerBuiltInFields, registerField, registerFields, unregisterField } from "./utils/registerField.js";
 import { builtInFields } from "./utils/builtInFields.js";
 export * from "@tmagic/form-schema";
-export { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfigError, MAX_SUGGESTION_OPTIONS, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, submitForm, unregisterField, validateForm, validateTypeMatch, validateValues };
+export { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfigError, MAX_SUGGESTION_OPTIONS, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, normalizeTimestampValue, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, submitForm, unregisterField, validateForm, validateTypeMatch, validateValues };

package/dist/es/index.js

@@ -2,7 +2,7 @@ import { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY } fro
 import { isLeafFieldType } from "./utils/fieldValueEffects.js";
 import { MAX_SUGGESTION_OPTIONS, clearTypeMatchRules, deleteTypeMatchRule, getTypeMatchRule, optionSuggestion, stringifyExampleValue, validateTypeMatch } from "./utils/typeMatch.js";
 import { createFormStateProxy, mergeFormContexts } from "./utils/formStateProxy.js";
-import { adaptFormValidator, appendProp, createFormStateBase, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getItemProp, getNativeRules, getRules, initValue, isValidName, resolveItemType, sortArray, sortChange } from "./utils/form.js";
+import { adaptFormValidator, appendProp, createFormStateBase, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getItemProp, getNativeRules, getRules, initValue, isValidName, normalizeTimestampValue, resolveItemType, sortArray, sortChange } from "./utils/form.js";
 import { FieldInnerConfigError, applyMountValueEffects, collectValidatableFields, isFieldInnerConfigError } from "./utils/collectFields.js";
 import { formatValidateError, getTextByName } from "./utils/validateError.js";
 import { createHeadlessFormState, validateValues } from "./utils/validateValues.js";
@@ -46,4 +46,4 @@ export * from "@tmagic/form-schema";
 //#region packages/form/src/index.ts
 var createForm = (config) => config;
 //#endregion
-export { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfigError, MAX_SUGGESTION_OPTIONS, Cascader_default as MCascader, Checkbox_default as MCheckbox, Index_default as MCheckboxGroup, ColorPicker_default as MColorPicker, Container_default as MContainer, Index_default$1 as MDate, Index_default$2 as MDateTime, Daterange_default as MDaterange, Index_default$3 as MDisplay, Index_default$4 as MDynamicField, Fieldset_default as MFieldset, FlexLayout_default as MFlexLayout, Form_default as MForm, FormBox_default as MFormBox, FormDialog_default as MFormDialog, FormDrawer_default as MFormDrawer, TableGroupList_default as MGroupList, Hidden_default as MHidden, Link_default as MLink, Number_default as MNumber, Index_default$5 as MNumberRange, Panel_default as MPanel, RadioGroup_default as MRadioGroup, Row_default as MRow, Select_default as MSelect, Switch_default as MSwitch, TableGroupList_default as MTable, TableGroupList_default as MTableGroupList, Tabs_default as MTabs, Text_default as MText, Textarea_default as MTextarea, Time_default as MTime, Timerange_default as MTimerange, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createForm, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, plugin_default as default, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, unregisterField, useAddField, validateForm, validateTypeMatch, validateValues };
+export { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfigError, MAX_SUGGESTION_OPTIONS, Cascader_default as MCascader, Checkbox_default as MCheckbox, Index_default as MCheckboxGroup, ColorPicker_default as MColorPicker, Container_default as MContainer, Index_default$1 as MDate, Index_default$2 as MDateTime, Daterange_default as MDaterange, Index_default$3 as MDisplay, Index_default$4 as MDynamicField, Fieldset_default as MFieldset, FlexLayout_default as MFlexLayout, Form_default as MForm, FormBox_default as MFormBox, FormDialog_default as MFormDialog, FormDrawer_default as MFormDrawer, TableGroupList_default as MGroupList, Hidden_default as MHidden, Link_default as MLink, Number_default as MNumber, Index_default$5 as MNumberRange, Panel_default as MPanel, RadioGroup_default as MRadioGroup, Row_default as MRow, Select_default as MSelect, Switch_default as MSwitch, TableGroupList_default as MTable, TableGroupList_default as MTableGroupList, Tabs_default as MTabs, Text_default as MText, Textarea_default as MTextarea, Time_default as MTime, Timerange_default as MTimerange, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createForm, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, plugin_default as default, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, normalizeTimestampValue, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, unregisterField, useAddField, validateForm, validateTypeMatch, validateValues };

package/dist/es/utils/form.js

@@ -1,5 +1,5 @@
 import { getConfig } from "./config.js";
-import { createTypeMatchValidator } from "./typeMatch.js";
+import { TIMESTAMP_VALUE_FORMATS, createTypeMatchValidator } from "./typeMatch.js";
 import { createFormStateProxy, mergeFormContexts } from "./formStateProxy.js";
 import { readonly, unref } from "vue";
 import { cloneDeep } from "lodash-es";
@@ -269,10 +269,33 @@ var initValue = async (mForm, { initValues, config }) => {
 	});
 	return valuesTmp || {};
 };
+/**
+* 把值收成 Unix 秒，无法解析时返回 undefined。
+*
+* 纯数字（含数字字符串）按已是秒处理：dayjs 会把数字当成毫秒，不能再过一遍。
+* Date、ISO 和日期字符串则解析后取秒。
+*/
+var toUnixSeconds = (v) => {
+	if (typeof v === "number") return Number.isFinite(v) ? Math.trunc(v) : void 0;
+	if (typeof v === "string" && /^-?\d+$/.test(v.trim())) return Math.trunc(Number(v));
+	const parsed = dayjs(v);
+	return parsed.isValid() ? parsed.unix() : void 0;
+};
+/**
+* `valueFormat: 'X'` 时把选择器值收成秒级 number，其余格式原样返回。
+* Element Plus 对 `X` 写出的是秒字符串（`x` 才会直接给毫秒数字）；空值、无法解析的值原样返回。
+*/
+var normalizeTimestampValue = (value, valueFormat) => {
+	if (valueFormat !== "X") return value;
+	if (Array.isArray(value)) return value.map((item) => normalizeTimestampValue(item, valueFormat));
+	if (value === null || value === void 0 || value === "") return value;
+	return toUnixSeconds(value) ?? value;
+};
 var datetimeFormatter = (v, defaultValue = "-", format = "YYYY-MM-DD HH:mm:ss") => {
 	if (v) {
 		let time;
-		if (["x", "timestamp"].includes(format)) time = dayjs(Number.isNaN(Number(v)) ? v : Number(v)).valueOf();
+		if (format === "X") time = toUnixSeconds(v) ?? "Invalid Date";
+		else if (TIMESTAMP_VALUE_FORMATS.has(format)) time = dayjs(Number.isNaN(Number(v)) ? v : Number(v)).valueOf();
 		else if (typeof v === "string" && v.includes("Z") || v instanceof Date) {
 			dayjs.extend(utc);
 			time = dayjs(v).utcOffset(8).format(format);
@@ -307,4 +330,4 @@ var createObjectProp = (prop, key, name) => {
 	return `${[...itemPath, key].join(".")}`;
 };
 //#endregion
-export { adaptFormValidator, appendProp, createFormStateBase, createFormStateProxy, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getItemProp, getNativeRules, getRules, initValue, isValidName, mergeFormContexts, resolveItemType, sortArray, sortChange };
+export { adaptFormValidator, appendProp, createFormStateBase, createFormStateProxy, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getItemProp, getNativeRules, getRules, initValue, isValidName, mergeFormContexts, normalizeTimestampValue, resolveItemType, sortArray, sortChange };

package/dist/es/utils/typeMatch.js

@@ -86,7 +86,11 @@ var DATE_LIKE_DEFAULT_VALUE_FORMAT = {
 	daterange: "YYYY/MM/DD HH:mm:ss",
 	timerange: "HH:mm:ss"
 };
-var TIMESTAMP_VALUE_FORMATS = /* @__PURE__ */ new Set(["x", "timestamp"]);
+var TIMESTAMP_VALUE_FORMATS = /* @__PURE__ */ new Set([
+	"x",
+	"X",
+	"timestamp"
+]);
 /**
 * 将值格式化为可读的参考示例字符串。
 */
@@ -179,23 +183,31 @@ var isEmptyArray = (value) => Array.isArray(value) && value.length === 0;
 var resolveDateValueFormat = (fieldType, config) => config.valueFormat || DATE_LIKE_DEFAULT_VALUE_FORMAT[fieldType] || "YYYY/MM/DD HH:mm:ss";
 var isTimestampValueFormat = (valueFormat) => TIMESTAMP_VALUE_FORMATS.has(valueFormat);
 var isValidDateValueByFormat = (value, valueFormat) => {
-	if (isTimestampValueFormat(valueFormat)) return typeof value === "number" && !Number.isNaN(value);
+	if (isTimestampValueFormat(valueFormat)) {
+		if (typeof value !== "number") return false;
+		return valueFormat === "X" ? Number.isInteger(value) : !Number.isNaN(value);
+	}
 	if (typeof value !== "string") return false;
 	return dayjs(value, valueFormat, true).isValid();
 };
 /**
 * 生成单个日期类字段的参考示例值：时间戳格式给出当前时间戳，其余按 valueFormat 格式化当前时间。
 */
-var dateSuggestion = (valueFormat) => isTimestampValueFormat(valueFormat) ? `请参考以下示例值：${Date.now()}` : `请参考以下示例值："${dayjs().format(valueFormat)}"`;
+var timestampExample = (valueFormat) => valueFormat === "X" ? Math.floor(Date.now() / 1e3) : Date.now();
+var dateSuggestion = (valueFormat) => isTimestampValueFormat(valueFormat) ? `请参考以下示例值：${timestampExample(valueFormat)}` : `请参考以下示例值："${dayjs().format(valueFormat)}"`;
 /**
 * 生成日期范围类字段的参考示例值（长度为 2 的数组）。
 */
 var dateRangeSuggestion = (valueFormat) => {
-	if (isTimestampValueFormat(valueFormat)) return `请参考以下示例值：[${Date.now()}, ${Date.now()}]`;
+	if (isTimestampValueFormat(valueFormat)) {
+		const example = timestampExample(valueFormat);
+		return `请参考以下示例值：[${example}, ${example}]`;
+	}
 	const example = dayjs().format(valueFormat);
 	return `请参考以下示例值：["${example}", "${example}"]`;
 };
-var dateValueFormatErrorMessage = (message, valueFormat) => defaultMessage(message, isTimestampValueFormat(valueFormat) ? "值类型应为时间戳数字" : `值格式应为 ${valueFormat}`, dateSuggestion(valueFormat));
+var timestampTypeLabel = (valueFormat) => valueFormat === "X" ? "秒级时间戳数字" : "毫秒级时间戳数字";
+var dateValueFormatErrorMessage = (message, valueFormat) => defaultMessage(message, isTimestampValueFormat(valueFormat) ? `值类型应为${timestampTypeLabel(valueFormat)}` : `值格式应为 ${valueFormat}`, dateSuggestion(valueFormat));
 var resolveToggleValues = (config) => {
 	const filterIsNumber = config.filter === "number";
 	const { activeValue: configActiveValue, inactiveValue: configInactiveValue } = config;
@@ -392,7 +404,7 @@ var validateBuiltinTypeMatch = (value, fieldType, mForm, props, message) => {
 	if (fieldType === "daterange" || fieldType === "timerange") {
 		if (config.names) return;
 		const valueFormat = resolveDateValueFormat(fieldType, config);
-		if (!Array.isArray(value) || value.length !== 2 || value.some((item) => !isValidDateValueByFormat(item, valueFormat))) return defaultMessage(message, isTimestampValueFormat(valueFormat) ? `${formatErrorValue(value)} 类型应为长度为 2 的时间戳数字数组` : `${formatErrorValue(value)} 格式应为长度为 2 的 ${valueFormat} 数组`, dateRangeSuggestion(valueFormat));
+		if (!Array.isArray(value) || value.length !== 2 || value.some((item) => !isValidDateValueByFormat(item, valueFormat))) return defaultMessage(message, isTimestampValueFormat(valueFormat) ? `${formatErrorValue(value)} 类型应为长度为 2 的${timestampTypeLabel(valueFormat)}数组` : `${formatErrorValue(value)} 格式应为长度为 2 的 ${valueFormat} 数组`, dateRangeSuggestion(valueFormat));
 		return;
 	}
 	if (fieldType === "table" || fieldType === "group-list" || fieldType === "grouplist") {
@@ -529,4 +541,4 @@ var createTypeMatchValidator = (mForm, props, rule) => {
 	};
 };
 //#endregion
-export { MAX_SUGGESTION_OPTIONS, clearTypeMatchRules, createTypeMatchValidator, deleteTypeMatchRule, getTypeMatchRule, optionSuggestion, registerTypeMatchRule, stringifyExampleValue, validateTypeMatch };
+export { MAX_SUGGESTION_OPTIONS, TIMESTAMP_VALUE_FORMATS, clearTypeMatchRules, createTypeMatchValidator, deleteTypeMatchRule, getTypeMatchRule, optionSuggestion, registerTypeMatchRule, stringifyExampleValue, validateTypeMatch };

package/dist/es/utils/validateValues.js

@@ -3,8 +3,9 @@ import { createFormStateBase, initValue } from "./form.js";
 import { applyMountValueEffects, collectValidatableFields } from "./collectFields.js";
 import { formatValidateError } from "./validateError.js";
 import { reactive } from "vue";
-import Schema from "async-validator";
+import AsyncValidator from "async-validator";
 //#region packages/form/src/utils/validateValues.ts
+var Schema = AsyncValidator.default ?? AsyncValidator;
 /**
 * 构造一个不依赖组件实例的 `formState`。
 *

package/dist/tmagic-form-headless.umd.cjs

@@ -2514,7 +2514,11 @@
 		daterange: "YYYY/MM/DD HH:mm:ss",
 		timerange: "HH:mm:ss"
 	};
-	var TIMESTAMP_VALUE_FORMATS = /* @__PURE__ */ new Set(["x", "timestamp"]);
+	var TIMESTAMP_VALUE_FORMATS = /* @__PURE__ */ new Set([
+		"x",
+		"X",
+		"timestamp"
+	]);
 	/**
 	* 将值格式化为可读的参考示例字符串。
 	*/
@@ -2607,23 +2611,31 @@
 	var resolveDateValueFormat = (fieldType, config) => config.valueFormat || DATE_LIKE_DEFAULT_VALUE_FORMAT[fieldType] || "YYYY/MM/DD HH:mm:ss";
 	var isTimestampValueFormat = (valueFormat) => TIMESTAMP_VALUE_FORMATS.has(valueFormat);
 	var isValidDateValueByFormat = (value, valueFormat) => {
-		if (isTimestampValueFormat(valueFormat)) return typeof value === "number" && !Number.isNaN(value);
+		if (isTimestampValueFormat(valueFormat)) {
+			if (typeof value !== "number") return false;
+			return valueFormat === "X" ? Number.isInteger(value) : !Number.isNaN(value);
+		}
 		if (typeof value !== "string") return false;
 		return (0, dayjs.default)(value, valueFormat, true).isValid();
 	};
 	/**
 	* 生成单个日期类字段的参考示例值：时间戳格式给出当前时间戳，其余按 valueFormat 格式化当前时间。
 	*/
-	var dateSuggestion = (valueFormat) => isTimestampValueFormat(valueFormat) ? `请参考以下示例值：${Date.now()}` : `请参考以下示例值："${(0, dayjs.default)().format(valueFormat)}"`;
+	var timestampExample = (valueFormat) => valueFormat === "X" ? Math.floor(Date.now() / 1e3) : Date.now();
+	var dateSuggestion = (valueFormat) => isTimestampValueFormat(valueFormat) ? `请参考以下示例值：${timestampExample(valueFormat)}` : `请参考以下示例值："${(0, dayjs.default)().format(valueFormat)}"`;
 	/**
 	* 生成日期范围类字段的参考示例值（长度为 2 的数组）。
 	*/
 	var dateRangeSuggestion = (valueFormat) => {
-		if (isTimestampValueFormat(valueFormat)) return `请参考以下示例值：[${Date.now()}, ${Date.now()}]`;
+		if (isTimestampValueFormat(valueFormat)) {
+			const example = timestampExample(valueFormat);
+			return `请参考以下示例值：[${example}, ${example}]`;
+		}
 		const example = (0, dayjs.default)().format(valueFormat);
 		return `请参考以下示例值：["${example}", "${example}"]`;
 	};
-	var dateValueFormatErrorMessage = (message, valueFormat) => defaultMessage(message, isTimestampValueFormat(valueFormat) ? "值类型应为时间戳数字" : `值格式应为 ${valueFormat}`, dateSuggestion(valueFormat));
+	var timestampTypeLabel = (valueFormat) => valueFormat === "X" ? "秒级时间戳数字" : "毫秒级时间戳数字";
+	var dateValueFormatErrorMessage = (message, valueFormat) => defaultMessage(message, isTimestampValueFormat(valueFormat) ? `值类型应为${timestampTypeLabel(valueFormat)}` : `值格式应为 ${valueFormat}`, dateSuggestion(valueFormat));
 	var resolveToggleValues = (config) => {
 		const filterIsNumber = config.filter === "number";
 		const { activeValue: configActiveValue, inactiveValue: configInactiveValue } = config;
@@ -2820,7 +2832,7 @@
 		if (fieldType === "daterange" || fieldType === "timerange") {
 			if (config.names) return;
 			const valueFormat = resolveDateValueFormat(fieldType, config);
-			if (!Array.isArray(value) || value.length !== 2 || value.some((item) => !isValidDateValueByFormat(item, valueFormat))) return defaultMessage(message, isTimestampValueFormat(valueFormat) ? `${formatErrorValue(value)} 类型应为长度为 2 的时间戳数字数组` : `${formatErrorValue(value)} 格式应为长度为 2 的 ${valueFormat} 数组`, dateRangeSuggestion(valueFormat));
+			if (!Array.isArray(value) || value.length !== 2 || value.some((item) => !isValidDateValueByFormat(item, valueFormat))) return defaultMessage(message, isTimestampValueFormat(valueFormat) ? `${formatErrorValue(value)} 类型应为长度为 2 的${timestampTypeLabel(valueFormat)}数组` : `${formatErrorValue(value)} 格式应为长度为 2 的 ${valueFormat} 数组`, dateRangeSuggestion(valueFormat));
 			return;
 		}
 		if (fieldType === "table" || fieldType === "group-list" || fieldType === "grouplist") {
@@ -3328,10 +3340,33 @@
 		});
 		return valuesTmp || {};
 	};
+	/**
+	* 把值收成 Unix 秒，无法解析时返回 undefined。
+	*
+	* 纯数字（含数字字符串）按已是秒处理：dayjs 会把数字当成毫秒，不能再过一遍。
+	* Date、ISO 和日期字符串则解析后取秒。
+	*/
+	var toUnixSeconds = (v) => {
+		if (typeof v === "number") return Number.isFinite(v) ? Math.trunc(v) : void 0;
+		if (typeof v === "string" && /^-?\d+$/.test(v.trim())) return Math.trunc(Number(v));
+		const parsed = (0, dayjs.default)(v);
+		return parsed.isValid() ? parsed.unix() : void 0;
+	};
+	/**
+	* `valueFormat: 'X'` 时把选择器值收成秒级 number，其余格式原样返回。
+	* Element Plus 对 `X` 写出的是秒字符串（`x` 才会直接给毫秒数字）；空值、无法解析的值原样返回。
+	*/
+	var normalizeTimestampValue = (value, valueFormat) => {
+		if (valueFormat !== "X") return value;
+		if (Array.isArray(value)) return value.map((item) => normalizeTimestampValue(item, valueFormat));
+		if (value === null || value === void 0 || value === "") return value;
+		return toUnixSeconds(value) ?? value;
+	};
 	var datetimeFormatter = (v, defaultValue = "-", format = "YYYY-MM-DD HH:mm:ss") => {
 		if (v) {
 			let time;
-			if (["x", "timestamp"].includes(format)) time = (0, dayjs.default)(Number.isNaN(Number(v)) ? v : Number(v)).valueOf();
+			if (format === "X") time = toUnixSeconds(v) ?? "Invalid Date";
+			else if (TIMESTAMP_VALUE_FORMATS.has(format)) time = (0, dayjs.default)(Number.isNaN(Number(v)) ? v : Number(v)).valueOf();
 			else if (typeof v === "string" && v.includes("Z") || v instanceof Date) {
 				dayjs.default.extend(dayjs_plugin_utc_js.default);
 				time = (0, dayjs.default)(v).utcOffset(8).format(format);
@@ -4297,6 +4332,7 @@
 	};
 	//#endregion
 	//#region packages/form/src/utils/validateValues.ts
+	var Schema = async_validator.default.default ?? async_validator.default;
 	/**
 	* 构造一个不依赖组件实例的 `formState`。
 	*
@@ -4349,7 +4385,7 @@
 		if (!rules.length) return null;
 		const value = getFieldValue(field.prop, values);
 		try {
-			await new async_validator.default({ [field.prop]: rules }).validate({ [field.prop]: value }, { firstFields: true });
+			await new Schema({ [field.prop]: rules }).validate({ [field.prop]: value }, { firstFields: true });
 			return null;
 		} catch (err) {
 			if (err?.fields) return err.fields;
@@ -4490,6 +4526,7 @@
 	exports.isValidName = isValidName;
 	exports.mergeFieldOptions = mergeFieldOptions;
 	exports.mergeFormContexts = mergeFormContexts;
+	exports.normalizeTimestampValue = normalizeTimestampValue;
 	exports.optionSuggestion = optionSuggestion;
 	exports.registerBuiltInFields = registerBuiltInFields;
 	exports.registerField = registerField;

package/dist/tmagic-form.umd.cjs

@@ -2982,7 +2982,11 @@
 		daterange: "YYYY/MM/DD HH:mm:ss",
 		timerange: "HH:mm:ss"
 	};
-	var TIMESTAMP_VALUE_FORMATS = /* @__PURE__ */ new Set(["x", "timestamp"]);
+	var TIMESTAMP_VALUE_FORMATS = /* @__PURE__ */ new Set([
+		"x",
+		"X",
+		"timestamp"
+	]);
 	/**
 	* 将值格式化为可读的参考示例字符串。
 	*/
@@ -3075,23 +3079,31 @@
 	var resolveDateValueFormat = (fieldType, config) => config.valueFormat || DATE_LIKE_DEFAULT_VALUE_FORMAT[fieldType] || "YYYY/MM/DD HH:mm:ss";
 	var isTimestampValueFormat = (valueFormat) => TIMESTAMP_VALUE_FORMATS.has(valueFormat);
 	var isValidDateValueByFormat = (value, valueFormat) => {
-		if (isTimestampValueFormat(valueFormat)) return typeof value === "number" && !Number.isNaN(value);
+		if (isTimestampValueFormat(valueFormat)) {
+			if (typeof value !== "number") return false;
+			return valueFormat === "X" ? Number.isInteger(value) : !Number.isNaN(value);
+		}
 		if (typeof value !== "string") return false;
 		return (0, dayjs.default)(value, valueFormat, true).isValid();
 	};
 	/**
 	* 生成单个日期类字段的参考示例值：时间戳格式给出当前时间戳，其余按 valueFormat 格式化当前时间。
 	*/
-	var dateSuggestion = (valueFormat) => isTimestampValueFormat(valueFormat) ? `请参考以下示例值：${Date.now()}` : `请参考以下示例值："${(0, dayjs.default)().format(valueFormat)}"`;
+	var timestampExample = (valueFormat) => valueFormat === "X" ? Math.floor(Date.now() / 1e3) : Date.now();
+	var dateSuggestion = (valueFormat) => isTimestampValueFormat(valueFormat) ? `请参考以下示例值：${timestampExample(valueFormat)}` : `请参考以下示例值："${(0, dayjs.default)().format(valueFormat)}"`;
 	/**
 	* 生成日期范围类字段的参考示例值（长度为 2 的数组）。
 	*/
 	var dateRangeSuggestion = (valueFormat) => {
-		if (isTimestampValueFormat(valueFormat)) return `请参考以下示例值：[${Date.now()}, ${Date.now()}]`;
+		if (isTimestampValueFormat(valueFormat)) {
+			const example = timestampExample(valueFormat);
+			return `请参考以下示例值：[${example}, ${example}]`;
+		}
 		const example = (0, dayjs.default)().format(valueFormat);
 		return `请参考以下示例值：["${example}", "${example}"]`;
 	};
-	var dateValueFormatErrorMessage = (message, valueFormat) => defaultMessage(message, isTimestampValueFormat(valueFormat) ? "值类型应为时间戳数字" : `值格式应为 ${valueFormat}`, dateSuggestion(valueFormat));
+	var timestampTypeLabel = (valueFormat) => valueFormat === "X" ? "秒级时间戳数字" : "毫秒级时间戳数字";
+	var dateValueFormatErrorMessage = (message, valueFormat) => defaultMessage(message, isTimestampValueFormat(valueFormat) ? `值类型应为${timestampTypeLabel(valueFormat)}` : `值格式应为 ${valueFormat}`, dateSuggestion(valueFormat));
 	var resolveToggleValues = (config) => {
 		const filterIsNumber = config.filter === "number";
 		const { activeValue: configActiveValue, inactiveValue: configInactiveValue } = config;
@@ -3288,7 +3300,7 @@
 		if (fieldType === "daterange" || fieldType === "timerange") {
 			if (config.names) return;
 			const valueFormat = resolveDateValueFormat(fieldType, config);
-			if (!Array.isArray(value) || value.length !== 2 || value.some((item) => !isValidDateValueByFormat(item, valueFormat))) return defaultMessage(message, isTimestampValueFormat(valueFormat) ? `${formatErrorValue(value)} 类型应为长度为 2 的时间戳数字数组` : `${formatErrorValue(value)} 格式应为长度为 2 的 ${valueFormat} 数组`, dateRangeSuggestion(valueFormat));
+			if (!Array.isArray(value) || value.length !== 2 || value.some((item) => !isValidDateValueByFormat(item, valueFormat))) return defaultMessage(message, isTimestampValueFormat(valueFormat) ? `${formatErrorValue(value)} 类型应为长度为 2 的${timestampTypeLabel(valueFormat)}数组` : `${formatErrorValue(value)} 格式应为长度为 2 的 ${valueFormat} 数组`, dateRangeSuggestion(valueFormat));
 			return;
 		}
 		if (fieldType === "table" || fieldType === "group-list" || fieldType === "grouplist") {
@@ -3796,10 +3808,33 @@
 		});
 		return valuesTmp || {};
 	};
+	/**
+	* 把值收成 Unix 秒，无法解析时返回 undefined。
+	*
+	* 纯数字（含数字字符串）按已是秒处理：dayjs 会把数字当成毫秒，不能再过一遍。
+	* Date、ISO 和日期字符串则解析后取秒。
+	*/
+	var toUnixSeconds = (v) => {
+		if (typeof v === "number") return Number.isFinite(v) ? Math.trunc(v) : void 0;
+		if (typeof v === "string" && /^-?\d+$/.test(v.trim())) return Math.trunc(Number(v));
+		const parsed = (0, dayjs.default)(v);
+		return parsed.isValid() ? parsed.unix() : void 0;
+	};
+	/**
+	* `valueFormat: 'X'` 时把选择器值收成秒级 number，其余格式原样返回。
+	* Element Plus 对 `X` 写出的是秒字符串（`x` 才会直接给毫秒数字）；空值、无法解析的值原样返回。
+	*/
+	var normalizeTimestampValue = (value, valueFormat) => {
+		if (valueFormat !== "X") return value;
+		if (Array.isArray(value)) return value.map((item) => normalizeTimestampValue(item, valueFormat));
+		if (value === null || value === void 0 || value === "") return value;
+		return toUnixSeconds(value) ?? value;
+	};
 	var datetimeFormatter = (v, defaultValue = "-", format = "YYYY-MM-DD HH:mm:ss") => {
 		if (v) {
 			let time;
-			if (["x", "timestamp"].includes(format)) time = (0, dayjs.default)(Number.isNaN(Number(v)) ? v : Number(v)).valueOf();
+			if (format === "X") time = toUnixSeconds(v) ?? "Invalid Date";
+			else if (TIMESTAMP_VALUE_FORMATS.has(format)) time = (0, dayjs.default)(Number.isNaN(Number(v)) ? v : Number(v)).valueOf();
 			else if (typeof v === "string" && v.includes("Z") || v instanceof Date) {
 				dayjs.default.extend(dayjs_plugin_utc_js.default);
 				time = (0, dayjs.default)(v).utcOffset(8).format(format);
@@ -4393,6 +4428,7 @@
 	};
 	//#endregion
 	//#region packages/form/src/utils/validateValues.ts
+	var Schema = async_validator.default.default ?? async_validator.default;
 	/**
 	* 构造一个不依赖组件实例的 `formState`。
 	*
@@ -4445,7 +4481,7 @@
 		if (!rules.length) return null;
 		const value = getFieldValue(field.prop, values);
 		try {
-			await new async_validator.default({ [field.prop]: rules }).validate({ [field.prop]: value }, { firstFields: true });
+			await new Schema({ [field.prop]: rules }).validate({ [field.prop]: value }, { firstFields: true });
 			return null;
 		} catch (err) {
 			if (err?.fields) return err.fields;
@@ -9025,7 +9061,7 @@
 			const emit = __emit;
 			useAddField(props.prop);
 			const changeHandler = (v) => {
-				emit("change", v);
+				emit("change", normalizeTimestampValue(v, props.config.valueFormat));
 			};
 			return (_ctx, _cache) => {
 				return (0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicDatePicker), {
@@ -9074,7 +9110,7 @@
 			const emit = __emit;
 			useAddField(props.prop);
 			const changeHandler = (v) => {
-				emit("change", v);
+				emit("change", normalizeTimestampValue(v, props.config.valueFormat));
 			};
 			return (_ctx, _cache) => {
 				return (0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicDatePicker), {
@@ -9126,7 +9162,7 @@
 			const emit = __emit;
 			useAddField(props.prop);
 			const changeHandler = (v) => {
-				emit("change", v);
+				emit("change", normalizeTimestampValue(v, props.config.valueFormat));
 			};
 			return (_ctx, _cache) => {
 				return (0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTimePicker), {
@@ -9293,22 +9329,27 @@
 			useAddField(props.prop);
 			const { names } = props.config;
 			const value = (0, vue.ref)([]);
+			const rangeFormat = () => `${props.config.dateFormat || "YYYY/MM/DD"} ${props.config.timeFormat || "HH:mm:ss"}`;
+			/** `X` 的选择器值就是秒级数字，展示格式不能拿去代替 valueFormat。 */
+			const toPickerValue = (item) => {
+				if (!item) return void 0;
+				if (props.config.valueFormat === "X") return normalizeTimestampValue(item, "X");
+				return datetimeFormatter(item, "", rangeFormat());
+			};
 			if (props.model !== void 0) {
 				if (names?.length) {
 					const unWatch = (0, vue.watch)([() => props.model[names[0]], () => props.model[names[1]]], ([start, end], [preStart, preEnd]) => {
 						if (!value.value) value.value = [];
-						const format = `${props.config.dateFormat || "YYYY/MM/DD"} ${props.config.timeFormat || "HH:mm:ss"}`;
 						if (!start || !end) value.value = [];
-						if (start !== preStart) value.value[0] = datetimeFormatter(start, "", format);
-						if (end !== preEnd) value.value[1] = datetimeFormatter(end, "", format);
+						if (start !== preStart) value.value[0] = toPickerValue(start);
+						if (end !== preEnd) value.value[1] = toPickerValue(end);
 					}, { immediate: true });
 					(0, vue.onUnmounted)(() => {
 						unWatch();
 					});
 				} else if (props.name && props.model[props.name]) {
 					const unWatch = (0, vue.watch)(() => props.model[props.name], (start, preStart) => {
-						const format = `${props.config.dateFormat || "YYYY/MM/DD"} ${props.config.timeFormat || "HH:mm:ss"}`;
-						if (start !== preStart) value.value = start.map((item) => item ? datetimeFormatter(item, "", format) : void 0);
+						if (start !== preStart) value.value = start.map((item) => toPickerValue(item));
 					}, { immediate: true });
 					(0, vue.onUnmounted)(() => {
 						unWatch();
@@ -9316,15 +9357,16 @@
 				}
 			}
 			const changeHandler = (v) => {
-				const value = v || [];
+				const normalized = normalizeTimestampValue(v, props.config.valueFormat);
+				const value = normalized || [];
 				if (props.name) emit("change", value);
 				else if (props.config.names?.length) {
 					const newChangeRecords = [];
 					props.config.names.forEach((item, index) => {
 						if (!props.model) return;
-						if (Array.isArray(v)) newChangeRecords.push({
+						if (Array.isArray(normalized)) newChangeRecords.push({
 							propPath: props.prop ? `${props.prop}.${item}` : item,
-							value: v[index]
+							value: normalized[index]
 						});
 						else newChangeRecords.push({
 							propPath: props.prop ? `${props.prop}.${item}` : item,
@@ -9393,21 +9435,26 @@
 			const getFullDatetime = (item) => item ? `${(0, dayjs.default)().format("YYYY/MM/DD")} ${item}` : "";
 			const getFormat = () => `YYYY/MM/DD ${props.config.valueFormat || "HH:mm:ss"}`;
 			const timeFormatter = (time, format) => datetimeFormatter(getFullDatetime(time), "", format).substring(11);
+			/** `X` 的选择器值就是秒级数字，不能再拼成日期后截取。 */
+			const toPickerValue = (time) => {
+				if (!time) return void 0;
+				if (props.config.valueFormat === "X") return normalizeTimestampValue(time, "X");
+				return timeFormatter(time, getFormat());
+			};
 			if (props.model !== void 0) {
 				if (names?.length) {
 					const unWatch = (0, vue.watch)([() => props.model[names[0]], () => props.model[names[1]]], ([start, end], [preStart, preEnd]) => {
 						if (!value.value) value.value = [];
-						const format = getFormat();
 						if (!start || !end) value.value = [];
-						if (start !== preStart) value.value[0] = timeFormatter(start, format);
-						if (end !== preEnd) value.value[1] = timeFormatter(end, format);
+						if (start !== preStart) value.value[0] = toPickerValue(start);
+						if (end !== preEnd) value.value[1] = toPickerValue(end);
 					}, { immediate: true });
 					(0, vue.onUnmounted)(() => {
 						unWatch();
 					});
 				} else if (props.name) {
 					const unWatch = (0, vue.watch)(() => props.model[props.name], (v = []) => {
-						if (Array.isArray(v)) value.value = v.map((item) => item ? timeFormatter(item, getFormat()) : void 0);
+						if (Array.isArray(v)) value.value = v.map((item) => toPickerValue(item));
 						else value.value = [];
 					}, { immediate: true });
 					(0, vue.onUnmounted)(() => {
@@ -9416,15 +9463,16 @@
 				}
 			}
 			const changeHandler = (v) => {
-				const value = v || [];
+				const normalized = normalizeTimestampValue(v, props.config.valueFormat);
+				const value = normalized || [];
 				if (props.name) emit("change", value);
 				else if (props.config.names?.length) {
 					const newChangeRecords = [];
 					props.config.names.forEach((item, index) => {
 						if (!props.model) return;
-						if (Array.isArray(v)) newChangeRecords.push({
+						if (Array.isArray(normalized)) newChangeRecords.push({
 							propPath: props.prop ? `${props.prop}.${item}` : item,
-							value: v[index]
+							value: normalized[index]
 						});
 						else newChangeRecords.push({
 							propPath: props.prop ? `${props.prop}.${item}` : item,
@@ -10702,6 +10750,7 @@ install(app, opt = {}) {
 	exports.isValidName = isValidName;
 	exports.mergeFieldOptions = mergeFieldOptions;
 	exports.mergeFormContexts = mergeFormContexts;
+	exports.normalizeTimestampValue = normalizeTimestampValue;
 	exports.optionSuggestion = optionSuggestion;
 	exports.registerBuiltInFields = registerBuiltInFields;
 	exports.registerField = registerField;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.2",
+  "version": "1.8.3",
   "name": "@tmagic/form",
   "type": "module",
   "sideEffects": [
@@ -58,9 +58,9 @@
   "peerDependencies": {
     "typescript": "^6.0.3",
     "vue": "^3.5.43",
-    "@tmagic/design": "1.8.2",
-    "@tmagic/form-schema": "1.8.2",
-    "@tmagic/utils": "1.8.2"
+    "@tmagic/design": "1.8.3",
+    "@tmagic/utils": "1.8.3",
+    "@tmagic/form-schema": "1.8.3"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/src/fields/Date/Index.vue

@@ -15,6 +15,7 @@
 import { TMagicDatePicker } from '@tmagic/design';
 
 import type { DateConfig, FieldProps } from '@form/schema';
+import { normalizeTimestampValue } from '@form/utils/form';
 import { useAddField } from '@form/utils/useAddField';
 
 defineOptions({
@@ -24,12 +25,12 @@ defineOptions({
 const props = defineProps<FieldProps<DateConfig>>();
 
 const emit = defineEmits<{
-  change: [value: string];
+  change: [value: string | number | null];
 }>();
 
 useAddField(props.prop);
 
-const changeHandler = (v: string) => {
-  emit('change', v);
+const changeHandler = (v: string | number | null) => {
+  emit('change', normalizeTimestampValue(v, props.config.valueFormat));
 };
 </script>

package/src/fields/DateTime/Index.vue

@@ -17,6 +17,7 @@
 import { TMagicDatePicker } from '@tmagic/design';
 
 import type { DateTimeConfig, FieldProps } from '@form/schema';
+import { normalizeTimestampValue } from '@form/utils/form';
 import { useAddField } from '@form/utils/useAddField';
 
 defineOptions({
@@ -26,12 +27,12 @@ defineOptions({
 const props = defineProps<FieldProps<DateTimeConfig>>();
 
 const emit = defineEmits<{
-  change: [value: string];
+  change: [value: string | number | null];
 }>();
 
 useAddField(props.prop);
 
-const changeHandler = (v: string) => {
-  emit('change', v);
+const changeHandler = (v: string | number | null) => {
+  emit('change', normalizeTimestampValue(v, props.config.valueFormat));
 };
 </script>

package/src/fields/Daterange.vue

@@ -23,7 +23,7 @@ import { onUnmounted, ref, watch } from 'vue';
 import { TMagicDatePicker } from '@tmagic/design';
 
 import type { ChangeRecord, DaterangeConfig, FieldProps } from '../schema';
-import { datetimeFormatter } from '../utils/form';
+import { datetimeFormatter, normalizeTimestampValue } from '../utils/form';
 import { useAddField } from '../utils/useAddField';
 
 defineOptions({
@@ -37,7 +37,14 @@ const emit = defineEmits(['change']);
 useAddField(props.prop);
 
 const { names } = props.config;
-const value = ref<(Date | string | undefined)[] | null>([]);
+const value = ref<(Date | string | number | undefined)[] | null>([]);
+const rangeFormat = () => `${props.config.dateFormat || 'YYYY/MM/DD'} ${props.config.timeFormat || 'HH:mm:ss'}`;
+/** `X` 的选择器值就是秒级数字，展示格式不能拿去代替 valueFormat。 */
+const toPickerValue = (item: string | number | Date) => {
+  if (!item) return undefined;
+  if (props.config.valueFormat === 'X') return normalizeTimestampValue(item, 'X');
+  return datetimeFormatter(item, '', rangeFormat()) as string;
+};
 
 if (props.model !== undefined) {
   if (names?.length) {
@@ -48,10 +55,9 @@ if (props.model !== undefined) {
           value.value = [];
         }
 
-        const format = `${props.config.dateFormat || 'YYYY/MM/DD'} ${props.config.timeFormat || 'HH:mm:ss'}`;
         if (!start || !end) value.value = [];
-        if (start !== preStart) value.value[0] = datetimeFormatter(start, '', format) as string;
-        if (end !== preEnd) value.value[1] = datetimeFormatter(end, '', format) as string;
+        if (start !== preStart) value.value[0] = toPickerValue(start);
+        if (end !== preEnd) value.value[1] = toPickerValue(end);
       },
       {
         immediate: true,
@@ -65,12 +71,7 @@ if (props.model !== undefined) {
     const unWatch = watch(
       () => props.model[props.name],
       (start, preStart) => {
-        const format = `${props.config.dateFormat || 'YYYY/MM/DD'} ${props.config.timeFormat || 'HH:mm:ss'}`;
-
-        if (start !== preStart)
-          value.value = start.map((item: string) =>
-            item ? (datetimeFormatter(item, '', format) as string) : undefined,
-          );
+        if (start !== preStart) value.value = start.map((item: string | number | Date) => toPickerValue(item));
       },
       {
         immediate: true,
@@ -82,8 +83,9 @@ if (props.model !== undefined) {
   }
 }
 
-const changeHandler = (v: Date[]) => {
-  const value = v || [];
+const changeHandler = (v: Array<Date | string | number> | null) => {
+  const normalized = normalizeTimestampValue(v, props.config.valueFormat);
+  const value = normalized || [];
 
   if (props.name) {
     emit('change', value);
@@ -94,10 +96,10 @@ const changeHandler = (v: Date[]) => {
         if (!props.model) {
           return;
         }
-        if (Array.isArray(v)) {
+        if (Array.isArray(normalized)) {
           newChangeRecords.push({
             propPath: props.prop ? `${props.prop}.${item}` : item,
-            value: v[index],
+            value: normalized[index],
           });
         } else {
           newChangeRecords.push({

package/src/fields/Time.vue

@@ -14,6 +14,7 @@
 import { TMagicTimePicker } from '@tmagic/design';
 
 import type { FieldProps, TimeConfig } from '../schema';
+import { normalizeTimestampValue } from '../utils/form';
 import { useAddField } from '../utils/useAddField';
 
 defineOptions({
@@ -23,12 +24,12 @@ defineOptions({
 const props = defineProps<FieldProps<TimeConfig>>();
 
 const emit = defineEmits<{
-  change: [value: string];
+  change: [value: string | number | null];
 }>();
 
 useAddField(props.prop);
 
-const changeHandler = (v: string) => {
-  emit('change', v);
+const changeHandler = (v: string | number | null) => {
+  emit('change', normalizeTimestampValue(v, props.config.valueFormat));
 };
 </script>

package/src/fields/Timerange.vue

@@ -22,7 +22,7 @@ import dayjs from 'dayjs';
 import { TMagicTimePicker } from '@tmagic/design';
 
 import type { ChangeRecord, FieldProps, TimerangeConfig } from '../schema';
-import { datetimeFormatter } from '../utils/form';
+import { datetimeFormatter, normalizeTimestampValue } from '../utils/form';
 import { useAddField } from '../utils/useAddField';
 
 defineOptions({
@@ -36,12 +36,18 @@ const emit = defineEmits(['change']);
 useAddField(props.prop);
 
 const { names } = props.config;
-const value = ref<(Date | string | undefined)[] | null>([]);
+const value = ref<(Date | string | number | undefined)[] | null>([]);
 
 const getFullDatetime = (item: string) => (item ? `${dayjs().format('YYYY/MM/DD')} ${item}` : '');
 const getFormat = () => `YYYY/MM/DD ${props.config.valueFormat || 'HH:mm:ss'}`;
 const timeFormatter = (time: string, format: string) =>
   (datetimeFormatter(getFullDatetime(time), '', format) as string).substring(11);
+/** `X` 的选择器值就是秒级数字，不能再拼成日期后截取。 */
+const toPickerValue = (time: string | number) => {
+  if (!time) return undefined;
+  if (props.config.valueFormat === 'X') return normalizeTimestampValue(time, 'X');
+  return timeFormatter(time as string, getFormat());
+};
 
 if (props.model !== undefined) {
   if (names?.length) {
@@ -52,10 +58,9 @@ if (props.model !== undefined) {
           value.value = [];
         }
 
-        const format = getFormat();
         if (!start || !end) value.value = [];
-        if (start !== preStart) value.value[0] = timeFormatter(start, format);
-        if (end !== preEnd) value.value[1] = timeFormatter(end, format);
+        if (start !== preStart) value.value[0] = toPickerValue(start);
+        if (end !== preEnd) value.value[1] = toPickerValue(end);
       },
       {
         immediate: true,
@@ -69,7 +74,7 @@ if (props.model !== undefined) {
       () => props.model[props.name],
       (v = []) => {
         if (Array.isArray(v)) {
-          value.value = v.map((item: string) => (item ? timeFormatter(item, getFormat()) : undefined));
+          value.value = v.map((item: string | number) => toPickerValue(item));
         } else {
           value.value = [];
         }
@@ -84,8 +89,9 @@ if (props.model !== undefined) {
   }
 }
 
-const changeHandler = (v: Date[]) => {
-  const value = v || [];
+const changeHandler = (v: Array<Date | string | number> | null) => {
+  const normalized = normalizeTimestampValue(v, props.config.valueFormat);
+  const value = normalized || [];
 
   if (props.name) {
     emit('change', value);
@@ -96,10 +102,10 @@ const changeHandler = (v: Date[]) => {
         if (!props.model) {
           return;
         }
-        if (Array.isArray(v)) {
+        if (Array.isArray(normalized)) {
           newChangeRecords.push({
             propPath: props.prop ? `${props.prop}.${item}` : item,
-            value: v[index],
+            value: normalized[index],
           });
         } else {
           newChangeRecords.push({

package/src/utils/form.ts

@@ -42,7 +42,7 @@ import type {
 } from '../schema';
 
 import { getConfig } from './config';
-import { createTypeMatchValidator } from './typeMatch';
+import { createTypeMatchValidator, TIMESTAMP_VALUE_FORMATS } from './typeMatch';
 
 export { createFormStateProxy, mergeFormContexts } from './formStateProxy';
 
@@ -509,14 +509,44 @@ export const initValue = async (
   return valuesTmp || {};
 };
 
+/**
+ * 把值收成 Unix 秒，无法解析时返回 undefined。
+ *
+ * 纯数字（含数字字符串）按已是秒处理：dayjs 会把数字当成毫秒，不能再过一遍。
+ * Date、ISO 和日期字符串则解析后取秒。
+ */
+const toUnixSeconds = (v: string | Date | number): number | undefined => {
+  if (typeof v === 'number') {
+    return Number.isFinite(v) ? Math.trunc(v) : undefined;
+  }
+  if (typeof v === 'string' && /^-?\d+$/.test(v.trim())) {
+    return Math.trunc(Number(v));
+  }
+  const parsed = dayjs(v);
+  return parsed.isValid() ? parsed.unix() : undefined;
+};
+
+/**
+ * `valueFormat: 'X'` 时把选择器值收成秒级 number，其余格式原样返回。
+ * Element Plus 对 `X` 写出的是秒字符串（`x` 才会直接给毫秒数字）；空值、无法解析的值原样返回。
+ */
+export const normalizeTimestampValue = (value: any, valueFormat?: string): any => {
+  if (valueFormat !== 'X') return value;
+  if (Array.isArray(value)) return value.map((item) => normalizeTimestampValue(item, valueFormat));
+  if (value === null || value === undefined || value === '') return value;
+  return toUnixSeconds(value) ?? value;
+};
+
 export const datetimeFormatter = (
-  v: string | Date,
+  v: string | Date | number,
   defaultValue = '-',
   format = 'YYYY-MM-DD HH:mm:ss',
 ): string | number => {
   if (v) {
     let time: string | number;
-    if (['x', 'timestamp'].includes(format)) {
+    if (format === 'X') {
+      time = toUnixSeconds(v) ?? 'Invalid Date';
+    } else if (TIMESTAMP_VALUE_FORMATS.has(format)) {
       time = dayjs(Number.isNaN(Number(v)) ? v : Number(v)).valueOf();
     } else if ((typeof v === 'string' && v.includes('Z')) || v instanceof Date) {
       // dayjs.extend 内部有防重复机制 (plugin.$i)，无需额外判断

package/src/utils/typeMatch.ts

@@ -150,7 +150,7 @@ const DATE_LIKE_DEFAULT_VALUE_FORMAT: Record<string, string> = {
   timerange: 'HH:mm:ss',
 };
 
-const TIMESTAMP_VALUE_FORMATS = new Set(['x', 'timestamp']);
+export const TIMESTAMP_VALUE_FORMATS = new Set(['x', 'X', 'timestamp']);
 
 /**
  * 将值格式化为可读的参考示例字符串。
@@ -281,7 +281,9 @@ const isTimestampValueFormat = (valueFormat: string) => TIMESTAMP_VALUE_FORMATS.
 
 const isValidDateValueByFormat = (value: any, valueFormat: string): boolean => {
   if (isTimestampValueFormat(valueFormat)) {
-    return typeof value === 'number' && !Number.isNaN(value);
+    if (typeof value !== 'number') return false;
+    // 秒级时间戳必须是有限整数，毫秒级只排除 NaN
+    return valueFormat === 'X' ? Number.isInteger(value) : !Number.isNaN(value);
   }
   if (typeof value !== 'string') {
     return false;
@@ -293,9 +295,11 @@ const isValidDateValueByFormat = (value: any, valueFormat: string): boolean => {
 /**
  * 生成单个日期类字段的参考示例值：时间戳格式给出当前时间戳，其余按 valueFormat 格式化当前时间。
  */
+const timestampExample = (valueFormat: string) => (valueFormat === 'X' ? Math.floor(Date.now() / 1000) : Date.now());
+
 const dateSuggestion = (valueFormat: string): string =>
   isTimestampValueFormat(valueFormat)
-    ? `请参考以下示例值：${Date.now()}`
+    ? `请参考以下示例值：${timestampExample(valueFormat)}`
     : `请参考以下示例值："${dayjs().format(valueFormat)}"`;
 
 /**
@@ -303,16 +307,19 @@ const dateSuggestion = (valueFormat: string): string =>
  */
 const dateRangeSuggestion = (valueFormat: string): string => {
   if (isTimestampValueFormat(valueFormat)) {
-    return `请参考以下示例值：[${Date.now()}, ${Date.now()}]`;
+    const example = timestampExample(valueFormat);
+    return `请参考以下示例值：[${example}, ${example}]`;
   }
   const example = dayjs().format(valueFormat);
   return `请参考以下示例值：["${example}", "${example}"]`;
 };
 
+const timestampTypeLabel = (valueFormat: string) => (valueFormat === 'X' ? '秒级时间戳数字' : '毫秒级时间戳数字');
+
 const dateValueFormatErrorMessage = (message: string | undefined, valueFormat: string) =>
   defaultMessage(
     message,
-    isTimestampValueFormat(valueFormat) ? '值类型应为时间戳数字' : `值格式应为 ${valueFormat}`,
+    isTimestampValueFormat(valueFormat) ? `值类型应为${timestampTypeLabel(valueFormat)}` : `值格式应为 ${valueFormat}`,
     dateSuggestion(valueFormat),
   );
 
@@ -748,7 +755,7 @@ const validateBuiltinTypeMatch = (
       return defaultMessage(
         message,
         isTimestampValueFormat(valueFormat)
-          ? `${formatErrorValue(value)} 类型应为长度为 2 的时间戳数字数组`
+          ? `${formatErrorValue(value)} 类型应为长度为 2 的${timestampTypeLabel(valueFormat)}数组`
           : `${formatErrorValue(value)} 格式应为长度为 2 的 ${valueFormat} 数组`,
         dateRangeSuggestion(valueFormat),
       );

package/src/utils/validateValues.ts

@@ -17,7 +17,7 @@
  */
 
 import { reactive } from 'vue';
-import Schema from 'async-validator';
+import AsyncValidator from 'async-validator';
 
 import type { FormConfig, FormContext, FormState, FormValue } from '../schema';
 
@@ -25,6 +25,10 @@ import { applyMountValueEffects, type CollectedField, collectValidatableFields }
 import { createFormStateBase, createFormStateProxy, initValue } from './form';
 import { formatValidateError } from './validateError';
 
+// async-validator 是 CJS 包（`exports.default = Schema`）。原生 Node ESM 下默认导入拿到的是整个 `module.exports`，
+// 需要再取一层 `.default`；打包器 / vitest 会自动处理互操作，此时 `.default` 不存在，直接用默认导入。
+const Schema: typeof AsyncValidator = (AsyncValidator as any).default ?? AsyncValidator;
+
 // #region HeadlessFormStateOptions
 /** 构造无渲染 formState 所需的参数（与 MForm 的同名 props 对齐） */
 export interface HeadlessFormStateOptions {

package/types/headless.d.ts

@@ -153,7 +153,12 @@ export declare const initValue: (mForm: schema_d_exports.FormState | undefined,
   initValues: schema_d_exports.FormValue;
   config: schema_d_exports.FormConfig;
 }) => Promise<schema_d_exports.FormValue>;
-export declare const datetimeFormatter: (v: string | Date, defaultValue?: string, format?: string) => string | number;
+/**
+ * `valueFormat: 'X'` 时把选择器值收成秒级 number，其余格式原样返回。
+ * Element Plus 对 `X` 写出的是秒字符串（`x` 才会直接给毫秒数字）；空值、无法解析的值原样返回。
+ */
+export declare const normalizeTimestampValue: (value: any, valueFormat?: string) => any;
+export declare const datetimeFormatter: (v: string | Date | number, defaultValue?: string, format?: string) => string | number;
 export declare const getDataByPage: (data: any[] | undefined, pagecontext: number, pagesize: number) => any[];
 export declare const sortArray: (data: any[], newIndex: number, oldIndex: number, sortKey?: string) => any[];
 export declare const sortChange: (data: any[], { prop, order }: schema_d_exports.SortProp) => void;
@@ -676,7 +681,7 @@ export declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
  */
 export declare const validateForm: (options: ValidateFormOptions) => Promise<string>;
 declare namespace headless_d_exports {
-  export { ChangeRecord, CollectedField, ContainerChangeEventData, FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfig, FieldInnerConfigContext, FieldInnerConfigError, FieldInnerConfigResult, FieldMountValueEffect, FieldMountValueEffectContext, FieldOptions, FormDiffConfig, FormLabelSlotProps, FormSlots, HeadlessFieldOptions, HeadlessFormStateOptions, MAX_SUGGESTION_OPTIONS, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, ValidateValuesOptions, ValidateValuesResult, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, submitForm, unregisterField, validateForm, validateTypeMatch, validateValues };
+  export { ChangeRecord, CollectedField, ContainerChangeEventData, FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfig, FieldInnerConfigContext, FieldInnerConfigError, FieldInnerConfigResult, FieldMountValueEffect, FieldMountValueEffectContext, FieldOptions, FormDiffConfig, FormLabelSlotProps, FormSlots, HeadlessFieldOptions, HeadlessFormStateOptions, MAX_SUGGESTION_OPTIONS, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, ValidateValuesOptions, ValidateValuesResult, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, normalizeTimestampValue, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, submitForm, unregisterField, validateForm, validateTypeMatch, validateValues };
 }
 //#endregion
 export { type CollectedField, type FieldInnerConfig, type FieldInnerConfigContext, type FieldInnerConfigResult, type FieldMountValueEffect, type FieldMountValueEffectContext, type FieldOptions, type HeadlessFieldOptions, type HeadlessFormStateOptions, type SubmitFormOptions, type SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, type ValidateFormOptions, type ValidateValuesOptions, type ValidateValuesResult, getField as getFormField };

package/types/index.d.ts

@@ -343,7 +343,12 @@ export declare const initValue: (mForm: schema_d_exports.FormState | undefined,
   initValues: schema_d_exports.FormValue;
   config: schema_d_exports.FormConfig;
 }) => Promise<schema_d_exports.FormValue>;
-export declare const datetimeFormatter: (v: string | Date, defaultValue?: string, format?: string) => string | number;
+/**
+ * `valueFormat: 'X'` 时把选择器值收成秒级 number，其余格式原样返回。
+ * Element Plus 对 `X` 写出的是秒字符串（`x` 才会直接给毫秒数字）；空值、无法解析的值原样返回。
+ */
+export declare const normalizeTimestampValue: (value: any, valueFormat?: string) => any;
+export declare const datetimeFormatter: (v: string | Date | number, defaultValue?: string, format?: string) => string | number;
 export declare const getDataByPage: (data: any[] | undefined, pagecontext: number, pagesize: number) => any[];
 export declare const sortArray: (data: any[], newIndex: number, oldIndex: number, sortKey?: string) => any[];
 export declare const sortChange: (data: any[], { prop, order }: schema_d_exports.SortProp) => void;
@@ -2160,27 +2165,27 @@ declare const _default$17: typeof __VLS_export$15;
 //#region temp/packages/form/src/fields/Date/Index.vue.d.ts
 type __VLS_Props$14 = schema_d_exports.FieldProps<schema_d_exports.DateConfig>;
 declare const __VLS_export$14: import("@vue/runtime-core").DefineComponent<__VLS_Props$14, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
-  change: (value: string) => any;
+  change: (value: string | number | null) => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$14> & Readonly<{
-  onChange?: ((value: string) => any) | undefined;
+  onChange?: ((value: string | number | null) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$5: typeof __VLS_export$14;
 //#endregion
 //#region temp/packages/form/src/fields/DateTime/Index.vue.d.ts
 type __VLS_Props$13 = schema_d_exports.FieldProps<schema_d_exports.DateTimeConfig>;
 declare const __VLS_export$13: import("@vue/runtime-core").DefineComponent<__VLS_Props$13, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
-  change: (value: string) => any;
+  change: (value: string | number | null) => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$13> & Readonly<{
-  onChange?: ((value: string) => any) | undefined;
+  onChange?: ((value: string | number | null) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$6: typeof __VLS_export$13;
 //#endregion
 //#region temp/packages/form/src/fields/Time.vue.d.ts
 type __VLS_Props$12 = schema_d_exports.FieldProps<schema_d_exports.TimeConfig>;
 declare const __VLS_export$12: import("@vue/runtime-core").DefineComponent<__VLS_Props$12, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
-  change: (value: string) => any;
+  change: (value: string | number | null) => any;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$12> & Readonly<{
-  onChange?: ((value: string) => any) | undefined;
+  onChange?: ((value: string | number | null) => any) | undefined;
 }>, {}, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const _default$29: typeof __VLS_export$12;
 //#endregion
@@ -2680,7 +2685,7 @@ declare const _default$31: {
   install(app: App, opt?: FormInstallOptions): void;
 };
 declare namespace index_d_exports {
-  export { ChangeRecord, CollectedField, ContainerChangeEventData, FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfig, FieldInnerConfigContext, FieldInnerConfigError, FieldInnerConfigResult, FieldMountValueEffect, FieldMountValueEffectContext, FieldOptions, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, HeadlessFieldOptions, HeadlessFormStateOptions, MAX_SUGGESTION_OPTIONS, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, ValidateValuesOptions, ValidateValuesResult, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createForm, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, unregisterField, useAddField, validateForm, validateTypeMatch, validateValues };
+  export { ChangeRecord, CollectedField, ContainerChangeEventData, FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfig, FieldInnerConfigContext, FieldInnerConfigError, FieldInnerConfigResult, FieldMountValueEffect, FieldMountValueEffectContext, FieldOptions, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, HeadlessFieldOptions, HeadlessFormStateOptions, MAX_SUGGESTION_OPTIONS, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, ValidateValuesOptions, ValidateValuesResult, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createForm, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, normalizeTimestampValue, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, unregisterField, useAddField, validateForm, validateTypeMatch, validateValues };
 }
 export declare const createForm: <T extends [] = []>(config: schema_d_exports.FormConfig | T) => schema_d_exports.FormConfig | T;
 //#endregion