@ramathibodi/nuxt-commons 4.0.11 → 4.0.13

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^4.3.1"
   },
-  "version": "4.0.11",
+  "version": "4.0.13",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/runtime/components/dialog/ImportProgress.d.vue.ts

@@ -0,0 +1,35 @@
+/**
+ * Public props accepted by DialogImportProgress.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+interface DialogImportProgressProps {
+    modelValue: boolean;
+    total: number;
+    processed: number;
+    succeeded?: number;
+    failed?: number;
+    percent: number;
+    title?: string;
+    color?: string;
+}
+declare var __VLS_20: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_20) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<DialogImportProgressProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<DialogImportProgressProps> & Readonly<{
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+}>, {
+    title: string;
+    succeeded: number;
+    failed: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/dialog/ImportProgress.vue

@@ -0,0 +1,53 @@
+<script setup>
+import { ref, watch } from "vue";
+const props = defineProps({
+  modelValue: { type: Boolean, required: true },
+  total: { type: Number, required: true },
+  processed: { type: Number, required: true },
+  succeeded: { type: Number, required: false, default: 0 },
+  failed: { type: Number, required: false, default: 0 },
+  percent: { type: Number, required: true },
+  title: { type: String, required: false, default: "\u0E01\u0E33\u0E25\u0E31\u0E07\u0E19\u0E33\u0E40\u0E02\u0E49\u0E32\u0E02\u0E49\u0E2D\u0E21\u0E39\u0E25" },
+  color: { type: String, required: false }
+});
+const emit = defineEmits(["update:modelValue"]);
+const dialogVisible = ref(props.modelValue);
+watch(() => props.modelValue, (newValue) => {
+  dialogVisible.value = newValue;
+});
+watch(() => dialogVisible.value, (newValue) => {
+  emit("update:modelValue", newValue);
+});
+</script>
+
+<template>
+  <v-dialog
+    v-model="dialogVisible"
+    persistent
+    max-width="500"
+  >
+    <v-card :color="props.color">
+      <v-card-text>
+        <div class="text-center mb-2">
+          <slot>{{ props.title }}</slot>
+        </div>
+        <div class="text-center text-body-2 mb-2">
+          {{ props.processed }} / {{ props.total }}
+          <span
+            v-if="props.failed > 0"
+            class="text-medium-emphasis"
+          >
+            (ล้มเหลว {{ props.failed }})
+          </span>
+        </div>
+      </v-card-text>
+      <v-progress-linear
+        :model-value="props.percent"
+        height="20"
+        color="primary"
+      >
+        <strong>{{ props.percent }}%</strong>
+      </v-progress-linear>
+    </v-card>
+  </v-dialog>
+</template>

package/dist/runtime/components/dialog/ImportProgress.vue.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Public props accepted by DialogImportProgress.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+interface DialogImportProgressProps {
+    modelValue: boolean;
+    total: number;
+    processed: number;
+    succeeded?: number;
+    failed?: number;
+    percent: number;
+    title?: string;
+    color?: string;
+}
+declare var __VLS_20: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_20) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<DialogImportProgressProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<DialogImportProgressProps> & Readonly<{
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+}>, {
+    title: string;
+    succeeded: number;
+    failed: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/document/TemplateBuilder.d.vue.ts

@@ -18,9 +18,9 @@ type __VLS_ModelProps = {
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (...args: any[]) => void;
+    "update:modelValue": (value: string | Record<string, any>[] | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | Record<string, any>[] | undefined) => any) | undefined;
 }>, {
     title: string;
     disableAdvanceMode: boolean;

package/dist/runtime/components/document/TemplateBuilder.vue

@@ -2,12 +2,21 @@
 import { computed, ref, watch } from "vue";
 import * as prettier from "prettier";
 import prettierPluginHtml from "prettier/plugins/html";
-import { useDocumentTemplate, validationRulesRegex, optionStringToChoiceObject } from "../../composables/document/template";
+import {
+  useDocumentTemplate,
+  validationRulesRegex,
+  optionStringToChoiceObject,
+  printConfigToRows,
+  rowsToPrintConfig,
+  printConfigToAttributes,
+  configStringToRows,
+  rowsToConfigString
+} from "../../composables/document/template";
 import {
   useDocumentTemplateInputTypes
 } from "../../composables/document/templateInputTypes";
 import { autoActionHeader, templateToHeader } from "../../composables/document/templateFormTable";
-import { cloneDeep } from "lodash-es";
+import { cloneDeep, isPlainObject } from "lodash-es";
 import VueJsonPretty from "vue-json-pretty";
 import "vue-json-pretty/lib/styles.css";
 import { safeParseJSONDeep } from "../../utils/object";
@@ -92,6 +101,51 @@ const choiceHeaders = ref([
     width: "120px"
   }
 ]);
+const printConfigHeaders = ref([
+  {
+    title: "Attribute",
+    key: "key"
+  },
+  {
+    title: "Value",
+    key: "value"
+  },
+  {
+    title: "Action",
+    key: "action",
+    width: "120px"
+  }
+]);
+function itemsForEdit(items) {
+  return items.map((item) => isPlainObject(item.printConfig) ? { ...item, printConfig: printConfigToRows(item.printConfig) } : item);
+}
+function itemsForStore(items) {
+  return items.map((item) => {
+    if (Array.isArray(item.printConfig)) {
+      const map = rowsToPrintConfig(item.printConfig);
+      const { printConfig, ...rest } = item;
+      return Object.keys(map).length ? { ...rest, printConfig: map } : rest;
+    }
+    if (typeof item.printConfig === "string" && item.printConfig.trim() === "") {
+      const { printConfig, ...rest } = item;
+      return rest;
+    }
+    return item;
+  });
+}
+function setPrintConfigMode(item, mode) {
+  if (mode === "raw") {
+    if (typeof item.printConfig === "string") return;
+    item.printConfig = rowsToConfigString(Array.isArray(item.printConfig) ? item.printConfig : []);
+  } else {
+    if (Array.isArray(item.printConfig)) return;
+    item.printConfig = configStringToRows(typeof item.printConfig === "string" ? item.printConfig : "");
+  }
+}
+function printConfigPreview(printConfig) {
+  if (Array.isArray(printConfig)) return printConfigToAttributes(rowsToPrintConfig(printConfig));
+  return printConfigToAttributes(printConfig);
+}
 function isValidJsonArrayOfObjects(str) {
   try {
     const parsed = JSON.parse(str);
@@ -101,19 +155,19 @@ function isValidJsonArrayOfObjects(str) {
   }
 }
 watch(templateItems, (newValue) => {
-  if (!isAdvanceMode.value) modelValue.value = JSON.stringify(newValue);
+  if (!isAdvanceMode.value) modelValue.value = JSON.stringify(itemsForStore(newValue));
 }, { deep: true });
 watch(modelValue, (newValue) => {
-  if (typeof newValue === "string" && isValidJsonArrayOfObjects(newValue)) templateItems.value = JSON.parse(newValue);
+  if (typeof newValue === "string" && isValidJsonArrayOfObjects(newValue)) templateItems.value = itemsForEdit(JSON.parse(newValue));
   else if (typeof newValue === "string") advanceModeCode.value = newValue;
-  else if (newValue) templateItems.value = cloneDeep(newValue);
+  else if (newValue) templateItems.value = itemsForEdit(cloneDeep(newValue));
 }, { deep: true, immediate: true });
 watch(advanceModeCode, (newValue) => {
   if (isAdvanceMode.value) modelValue.value = newValue;
 });
 async function convertToAdvanceMode() {
   if (!isAdvanceMode.value) {
-    modelValue.value = await prettier.format(useDocumentTemplate(templateItems.value).replaceAll(">", ">\n"), { parser: "html", plugins: [prettierPluginHtml] });
+    modelValue.value = await prettier.format(useDocumentTemplate(itemsForStore(templateItems.value)).replaceAll(">", ">\n"), { parser: "html", plugins: [prettierPluginHtml] });
   }
 }
 const inputTypes = computed(() => useDocumentTemplateInputTypes());
@@ -362,7 +416,7 @@ const ruleOptions = (inputType) => (value) => {
                             label="Validation Rules"
                             :rules="[rules.regex(validationRulesRegex)]"
                         />
-                        <b>Available rules :</b>     require, requireIf(condition), requireTrue, requireTrueIf(condition), numeric, range(min,max), integer, unique, length(length), lengthGreater(length), lengthLess(length), telephone, email, regex(regex), idcard, DateFuture, DatetimeFuture, DateHappen, DatetimeHappen, DateAfter(date), DateBefore(Date), DateEqual(date)
+                        <b>Available rules :</b>     require, requireIf(condition), requireTrue, requireTrueIf(condition), requireNotEmpty, numeric, range(min,max), integer, unique, length(length), lengthGreater(length), lengthLess(length), telephone, email, regex(regex), idcard, DateFuture, DatetimeFuture, DateHappen, DatetimeHappen, DateAfter(date), DateBefore(Date), DateEqual(date)
                       </v-col>
                     </v-row>
                   </v-container>
@@ -403,6 +457,54 @@ const ruleOptions = (inputType) => (value) => {
                             label="Retrieved Value"
                         />
                       </v-col>
+                      <v-col cols="12">
+                        <div class="d-flex align-center ga-2 mb-1">
+                          <span class="opacity-60">Print Config</span>
+                          <span class="text-caption opacity-60">— print/docx-only; ignored by the form renderer</span>
+                          <v-spacer />
+                          <v-btn-toggle
+                              :model-value="typeof data.printConfig === 'string' ? 'raw' : 'map'"
+                              @update:model-value="(mode) => setPrintConfigMode(data, mode)"
+                              density="compact"
+                              variant="outlined"
+                              divided
+                              mandatory
+                          >
+                            <v-btn value="map" size="small">Key / Value</v-btn>
+                            <v-btn value="raw" size="small">Raw string</v-btn>
+                          </v-btn-toggle>
+                        </div>
+                        <v-textarea
+                            v-if="typeof data.printConfig === 'string'"
+                            v-model="data.printConfig"
+                            label="Print Config (raw attributes)"
+                            placeholder="format=dd/MM/yyyy; locale=th_TH"
+                            auto-grow
+                            rows="1"
+                        />
+                        <form-table
+                            v-else
+                            v-model="data.printConfig"
+                            :headers="printConfigHeaders"
+                            title="Print Config"
+                        >
+                          <template #form="{ data: rowData, rules }">
+                            <v-container fluid>
+                              <v-row density="compact">
+                                <v-col cols="6">
+                                  <v-text-field v-model="rowData.key" label="Attribute" :rules="[rules.require()]" />
+                                </v-col>
+                                <v-col cols="6">
+                                  <v-text-field v-model="rowData.value" label="Value (blank = flag)" />
+                                </v-col>
+                              </v-row>
+                            </v-container>
+                          </template>
+                        </form-table>
+                        <div class="text-caption opacity-60 mt-1" v-if="printConfigPreview(data.printConfig)">
+                          Appends to placeholder: <code>{{ printConfigPreview(data.printConfig) }}</code>
+                        </div>
+                      </v-col>
                     </v-row>
                   </v-container>
                 </v-expansion-panel-text>
@@ -438,7 +540,7 @@ const ruleOptions = (inputType) => (value) => {
           elevation="1"
           max-height="250"
           class="overflow-y-auto my-1 pa-2"
-          v-if="props.item.inputType == 'CustomCode' || props.item.validationRules || props.item.inputOptions || props.item.inputAttributes || props.item.columnAttributes || props.item.conditionalDisplay || props.item.computedValue || props.item.retrievedValue"
+          v-if="props.item.inputType == 'CustomCode' || props.item.validationRules || props.item.inputOptions || props.item.inputAttributes || props.item.columnAttributes || props.item.conditionalDisplay || props.item.computedValue || props.item.retrievedValue || printConfigPreview(props.item.printConfig)"
       >
         <template v-if="props.item.inputType == 'CustomCode'">
           <b>Custom Code :</b><br>
@@ -466,6 +568,9 @@ const ruleOptions = (inputType) => (value) => {
         <template v-if="props.item.retrievedValue">
           <b>Retrieved Value :</b> {{ props.item.retrievedValue }}<br>
         </template>
+        <template v-if="printConfigPreview(props.item.printConfig)">
+          <b>Print Config :</b> <code>{{ printConfigPreview(props.item.printConfig) }}</code><br>
+        </template>
       </v-sheet>
     </template>
   </FormTable>

package/dist/runtime/components/document/TemplateBuilder.vue.d.ts

@@ -18,9 +18,9 @@ type __VLS_ModelProps = {
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (...args: any[]) => void;
+    "update:modelValue": (value: string | Record<string, any>[] | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | Record<string, any>[] | undefined) => any) | undefined;
 }>, {
     title: string;
     disableAdvanceMode: boolean;

package/dist/runtime/components/form/ActionPad.vue

@@ -17,6 +17,7 @@ const formData = ref({});
 const formDataOriginalValue = ref();
 const emit = defineEmits(["create", "update"]);
 function save() {
+  formPadRef.value?.flushSanitize?.();
   if (props.skipValidation || formPadRef.value?.isValid) {
     isSaving.value = true;
     emit(isCreating.value ? "create" : "update", cloneDeep(formData.value), callback);

package/dist/runtime/components/form/Birthdate.d.vue.ts

@@ -26,10 +26,10 @@ type __VLS_ModelProps = {
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (...args: any[]) => void;
-    "update:dobPrecision": (value: "year" | "yearMonthDay" | "yearMonth" | "estimated" | undefined) => void;
+    "update:modelValue": (value: string | undefined) => any;
+    "update:dobPrecision": (value: "year" | "yearMonthDay" | "yearMonth" | "estimated" | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
     "onUpdate:dobPrecision"?: ((value: "year" | "yearMonthDay" | "yearMonth" | "estimated" | undefined) => any) | undefined;
 }>, {
     flow: ("month" | "year" | "calendar" | "time" | "minutes" | "hours" | "seconds")[];

package/dist/runtime/components/form/Birthdate.vue.d.ts

@@ -26,10 +26,10 @@ type __VLS_ModelProps = {
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
 declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    "update:modelValue": (...args: any[]) => void;
-    "update:dobPrecision": (value: "year" | "yearMonthDay" | "yearMonth" | "estimated" | undefined) => void;
+    "update:modelValue": (value: string | undefined) => any;
+    "update:dobPrecision": (value: "year" | "yearMonthDay" | "yearMonth" | "estimated" | undefined) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
-    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
     "onUpdate:dobPrecision"?: ((value: "year" | "yearMonthDay" | "yearMonth" | "estimated" | undefined) => any) | undefined;
 }>, {
     flow: ("month" | "year" | "calendar" | "time" | "minutes" | "hours" | "seconds")[];

package/dist/runtime/components/form/Date.vue

@@ -1,12 +1,12 @@
 <script setup>
 import { ref, watch, watchEffect, nextTick, computed } from "vue";
 import { VTextField } from "vuetify/components/VTextField";
-import Datepicker from "@vuepic/vue-datepicker";
+import { VueDatePicker as Datepicker } from "@vuepic/vue-datepicker";
 import "@vuepic/vue-datepicker/dist/main.css";
 import { isArray, isString } from "lodash-es";
 import { Datetime } from "../../utils/datetime";
 import { useRules } from "../../composables/utils/validation";
-import { th } from "date-fns/locale";
+import { th, enUS } from "date-fns/locale";
 const props = defineProps({
   locale: { type: String, required: false, default: "TH" },
   format: { type: String, required: false, default: "shortDate" },
@@ -60,6 +60,8 @@ const computedRules = computed(() => {
 });
 const selectedDate = ref(null);
 const displayedDate = ref(null);
+const datepickerLocale = computed(() => props.locale === "TH" ? th : enUS);
+const datepickerFlow = computed(() => props.flow.length ? { steps: props.flow, partial: true } : void 0);
 const isMenuOpen = ref(false);
 const isTextFieldFocused = ref(false);
 const hasTextFieldInput = ref(false);
@@ -197,14 +199,13 @@ defineExpose({
     <Datepicker
         v-model="selectedDate"
         model-type="yyyy-MM-dd"
-        :enable-time-picker="false"
-        :flow="flow"
+        :time-config="{ enableTimePicker: false }"
+        :flow="datepickerFlow"
         :min-date="props.minDate"
         :max-date="props.maxDate"
         auto-apply
         inline
-        :locale="locale"
-        :format-locale="locale == 'TH' ? th : void 0"
+        :locale="datepickerLocale"
         @update:model-value="updateDatePicker"
     >
       <template #year="{ value }" v-if="locale == 'TH'">
@@ -216,3 +217,7 @@ defineExpose({
     </Datepicker>
   </v-menu>
 </template>
+
+<style scoped>
+:deep(.dp__button.dp__overlay_action){display:none}
+</style>

package/dist/runtime/components/form/Dialog.d.vue.ts

@@ -45,13 +45,9 @@ type __VLS_Slots = {} & {
     action?: (props: typeof __VLS_69) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    create: (...args: any[]) => void;
-    update: (...args: any[]) => void;
-    "update:modelValue": (value: boolean) => void;
+    "update:modelValue": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
-    onCreate?: ((...args: any[]) => any) | undefined;
-    onUpdate?: ((...args: any[]) => any) | undefined;
 }>, {
     readonly: boolean;
     saveCaption: string;

package/dist/runtime/components/form/Dialog.vue

@@ -20,6 +20,7 @@ const formData = ref({});
 const formDataOriginalValue = ref();
 const emit = defineEmits(["create", "update"]);
 function save() {
+  formPadRef.value?.flushSanitize?.();
   if (formPadRef.value.isValid) {
     isSaving.value = true;
     emit(isCreating.value ? "create" : "update", cloneDeep(formData.value), props.saveAndStay ? stayCallback : callback);

package/dist/runtime/components/form/Dialog.vue.d.ts

@@ -45,13 +45,9 @@ type __VLS_Slots = {} & {
     action?: (props: typeof __VLS_69) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    create: (...args: any[]) => void;
-    update: (...args: any[]) => void;
-    "update:modelValue": (value: boolean) => void;
+    "update:modelValue": (value: boolean) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
-    onCreate?: ((...args: any[]) => any) | undefined;
-    onUpdate?: ((...args: any[]) => any) | undefined;
 }>, {
     readonly: boolean;
     saveCaption: string;

package/dist/runtime/components/form/EditPad.vue

@@ -18,6 +18,7 @@ const formData = ref({});
 const formDataOriginalValue = ref();
 const emit = defineEmits(["create", "update"]);
 function save() {
+  formPadRef.value?.flushSanitize?.();
   if (props.skipValidation || formPadRef.value?.isValid) {
     isSaving.value = true;
     emit(isCreating.value ? "create" : "update", cloneDeep(formData.value), callback);

package/dist/runtime/components/form/Pad.d.vue.ts

@@ -12,6 +12,7 @@ interface Props {
     dirtyOnCreate?: boolean;
     sanitizeDelay?: number;
 }
+declare function flushSanitize(): void;
 declare function reset(): void;
 declare function validate(): void;
 declare function resetValidate(): void;
@@ -75,6 +76,17 @@ declare var __VLS_10: {
          * This doc block is consumed by vue-docgen for generated API documentation.
          */
         ) => string | true;
+        requireNotEmpty: (customError?: string) => (
+        /**
+         * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
+         * This doc block is consumed by vue-docgen for generated API documentation.
+         */
+        value: any
+        /**
+         * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
+         * This doc block is consumed by vue-docgen for generated API documentation.
+         */
+        ) => string | true;
         numeric: (customError?: string) => (
         /**
          * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
@@ -381,6 +393,17 @@ declare var __VLS_10: {
          * This doc block is consumed by vue-docgen for generated API documentation.
          */
         ) => string | true;
+        requireNotEmpty: (customError?: string) => (
+        /**
+         * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
+         * This doc block is consumed by vue-docgen for generated API documentation.
+         */
+        value: any
+        /**
+         * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
+         * This doc block is consumed by vue-docgen for generated API documentation.
+         */
+        ) => string | true;
         numeric: (customError?: string) => (
         /**
          * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
@@ -650,6 +673,7 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
     reset: typeof reset;
     validate: typeof validate;
     resetValidate: typeof resetValidate;
+    flushSanitize: typeof flushSanitize;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (...args: any[]) => void;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{

package/dist/runtime/components/form/Pad.vue

@@ -61,11 +61,11 @@ function scheduleIdle(fn) {
   }
 }
 const sanitizeBlankStrings = debounce((val, original) => {
-  scheduleIdle(() => sanitizeBlankStringsRaw(val, original));
+  scheduleIdle(() => sanitizeBlankStringsSync(val, original));
 }, props.sanitizeDelay);
-function sanitizeBlankStringsRaw(val, original) {
+function sanitizeBlankStringsSync(val, original) {
   if (!original && props.originalData) {
-    sanitizeBlankStrings(val, props.originalData);
+    sanitizeBlankStringsSync(val, props.originalData);
     return;
   }
   if (isArray(val)) {
@@ -74,7 +74,7 @@ function sanitizeBlankStringsRaw(val, original) {
       if (isBlankString(item)) {
         val.splice(i, 1);
       } else if (isPlainObject(item) || isArray(item)) {
-        sanitizeBlankStrings(item, {});
+        sanitizeBlankStringsSync(item, {});
       } else {
         if (item && typeof item === "string") val[i] = item.replace(/[ \t]+$/, "");
       }
@@ -89,13 +89,17 @@ function sanitizeBlankStringsRaw(val, original) {
         else val[key] = null;
       } else if (isPlainObject(v) || isArray(v)) {
         let originalChild = original && (isPlainObject(original[key]) || isArray(original[key])) ? original[key] : {};
-        sanitizeBlankStrings(v, originalChild);
+        sanitizeBlankStringsSync(v, originalChild);
       } else {
         if (v && typeof v === "string") val[key] = v.replace(/[ \t]+$/, "");
       }
     }
   }
 }
+function flushSanitize() {
+  sanitizeBlankStrings.cancel();
+  sanitizeBlankStringsSync(formData.value, props.originalData ?? {});
+}
 function autoSanitizedDisplay(item, separator = ",") {
   const isEmptyScalar = (v) => v === null || v === void 0 || typeof v === "string" && v.trim() === "" || typeof v === "number" && Number.isNaN(v);
   const toStr = (v) => {
@@ -257,7 +261,8 @@ defineExpose({
   readonly,
   reset,
   validate,
-  resetValidate
+  resetValidate,
+  flushSanitize
 });
 </script>
 

package/dist/runtime/components/form/Pad.vue.d.ts

@@ -12,6 +12,7 @@ interface Props {
     dirtyOnCreate?: boolean;
     sanitizeDelay?: number;
 }
+declare function flushSanitize(): void;
 declare function reset(): void;
 declare function validate(): void;
 declare function resetValidate(): void;
@@ -75,6 +76,17 @@ declare var __VLS_10: {
          * This doc block is consumed by vue-docgen for generated API documentation.
          */
         ) => string | true;
+        requireNotEmpty: (customError?: string) => (
+        /**
+         * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
+         * This doc block is consumed by vue-docgen for generated API documentation.
+         */
+        value: any
+        /**
+         * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
+         * This doc block is consumed by vue-docgen for generated API documentation.
+         */
+        ) => string | true;
         numeric: (customError?: string) => (
         /**
          * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
@@ -381,6 +393,17 @@ declare var __VLS_10: {
          * This doc block is consumed by vue-docgen for generated API documentation.
          */
         ) => string | true;
+        requireNotEmpty: (customError?: string) => (
+        /**
+         * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
+         * This doc block is consumed by vue-docgen for generated API documentation.
+         */
+        value: any
+        /**
+         * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
+         * This doc block is consumed by vue-docgen for generated API documentation.
+         */
+        ) => string | true;
         numeric: (customError?: string) => (
         /**
          * FormPad is a schema-driven form field component that binds model data, renders field UI, and emits normalized updates.
@@ -650,6 +673,7 @@ declare const __VLS_base: import("vue").DefineComponent<Props, {
     reset: typeof reset;
     validate: typeof validate;
     resetValidate: typeof resetValidate;
+    flushSanitize: typeof flushSanitize;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     "update:modelValue": (...args: any[]) => void;
 }, string, import("vue").PublicProps, Readonly<Props> & Readonly<{