@ramathibodi/nuxt-commons 4.0.12 → 4.0.14

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^4.3.1"
   },
-  "version": "4.0.12",
+  "version": "4.0.14",
   "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/dialog/ImportResult.d.vue.ts

@@ -0,0 +1,28 @@
+import type { ImportError } from '../../composables/importProgress.js';
+/**
+ * Public props accepted by DialogImportResult.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+interface DialogImportResultProps {
+    modelValue: boolean;
+    errors: ImportError[];
+    total: number;
+    failed: number;
+    isImporting?: boolean;
+    title?: string;
+    color?: string;
+}
+declare const __VLS_export: import("vue").DefineComponent<DialogImportResultProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: boolean) => any;
+    retry: (index: number) => any;
+    "retry-all": () => any;
+}, string, import("vue").PublicProps, Readonly<DialogImportResultProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onRetry?: ((index: number) => any) | undefined;
+    "onRetry-all"?: (() => any) | undefined;
+}>, {
+    title: string;
+    isImporting: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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

@@ -0,0 +1,122 @@
+<script setup>
+import { ref, watch } from "vue";
+const props = defineProps({
+  modelValue: { type: Boolean, required: true },
+  errors: { type: Array, required: true },
+  total: { type: Number, required: true },
+  failed: { type: Number, required: true },
+  isImporting: { type: Boolean, required: false, default: false },
+  title: { type: String, required: false, default: "\u0E19\u0E33\u0E40\u0E02\u0E49\u0E32\u0E25\u0E49\u0E21\u0E40\u0E2B\u0E25\u0E27" },
+  color: { type: String, required: false }
+});
+const emit = defineEmits(["update:modelValue", "retry-all", "retry"]);
+const dialogVisible = ref(props.modelValue);
+watch(() => props.modelValue, (newValue) => {
+  dialogVisible.value = newValue;
+});
+watch(() => dialogVisible.value, (newValue) => {
+  emit("update:modelValue", newValue);
+});
+const chipColor = (t) => t === "server" ? "error" : t === "unknown" ? "grey" : "warning";
+const pretty = (v) => {
+  try {
+    return typeof v === "string" ? v : JSON.stringify(v, null, 2);
+  } catch {
+    return String(v);
+  }
+};
+</script>
+
+<template>
+  <v-dialog
+    v-model="dialogVisible"
+    persistent
+    scrollable
+    max-width="700"
+  >
+    <v-card :color="props.color">
+      <v-card-title class="d-flex align-center">
+        <span>{{ props.title }} {{ props.failed }} / {{ props.total }}</span>
+        <v-spacer />
+        <v-btn
+          color="primary"
+          variant="tonal"
+          prepend-icon="mdi mdi-refresh"
+          :loading="props.isImporting"
+          :disabled="props.isImporting || props.errors.length === 0"
+          @click="emit('retry-all')"
+        >
+          Retry all failed
+        </v-btn>
+      </v-card-title>
+
+      <v-progress-linear
+        v-if="props.isImporting"
+        indeterminate
+        color="primary"
+        height="6"
+      />
+
+      <v-card-text>
+        <v-expansion-panels multiple>
+          <v-expansion-panel
+            v-for="err in props.errors"
+            :key="err.index"
+          >
+            <v-expansion-panel-title>
+              <div
+                class="d-flex align-center"
+                style="gap: 8px; width: 100%"
+              >
+                <span class="text-medium-emphasis">#{{ err.index + 1 }}</span>
+                <v-chip
+                  :color="chipColor(err.errorType)"
+                  size="small"
+                  label
+                >
+                  {{ err.errorType }}
+                </v-chip>
+                <span class="text-truncate">{{ err.message }}</span>
+                <v-spacer />
+                <v-btn
+                  icon="mdi mdi-refresh"
+                  size="small"
+                  variant="text"
+                  :disabled="props.isImporting"
+                  @click.stop="emit('retry', err.index)"
+                />
+              </div>
+            </v-expansion-panel-title>
+            <v-expansion-panel-text>
+              <div class="text-caption text-medium-emphasis mb-1">
+                Data
+              </div>
+              <pre class="import-result-pre">{{ pretty(err.item) }}</pre>
+              <template v-if="err.detail !== void 0">
+                <div class="text-caption text-medium-emphasis mb-1 mt-2">
+                  Detail
+                </div>
+                <pre class="import-result-pre">{{ pretty(err.detail) }}</pre>
+              </template>
+            </v-expansion-panel-text>
+          </v-expansion-panel>
+        </v-expansion-panels>
+      </v-card-text>
+
+      <v-card-actions>
+        <v-spacer />
+        <v-btn
+          variant="text"
+          :disabled="props.isImporting"
+          @click="dialogVisible = false"
+        >
+          ปิด
+        </v-btn>
+      </v-card-actions>
+    </v-card>
+  </v-dialog>
+</template>
+
+<style scoped>
+.import-result-pre{background:rgba(0,0,0,.04);border-radius:4px;font-size:12px;margin:0;padding:8px;white-space:pre-wrap;word-break:break-word}
+</style>

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

@@ -0,0 +1,28 @@
+import type { ImportError } from '../../composables/importProgress.js';
+/**
+ * Public props accepted by DialogImportResult.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+interface DialogImportResultProps {
+    modelValue: boolean;
+    errors: ImportError[];
+    total: number;
+    failed: number;
+    isImporting?: boolean;
+    title?: string;
+    color?: string;
+}
+declare const __VLS_export: import("vue").DefineComponent<DialogImportResultProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:modelValue": (value: boolean) => any;
+    retry: (index: number) => any;
+    "retry-all": () => any;
+}, string, import("vue").PublicProps, Readonly<DialogImportResultProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+    onRetry?: ((index: number) => any) | undefined;
+    "onRetry-all"?: (() => any) | undefined;
+}>, {
+    title: string;
+    isImporting: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

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());
@@ -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/model/Pad.vue

@@ -19,7 +19,8 @@ const props = defineProps({
   operationUpdate: { type: [Object, String], required: false },
   operationDelete: { type: [Object, String], required: false },
   operationRead: { type: [Object, String], required: false },
-  fields: { type: Array, required: false, default: () => ["*"] }
+  fields: { type: Array, required: false, default: () => ["*"] },
+  importConcurrency: { type: Number, required: false }
 });
 const emit = defineEmits(["create", "update"]);
 const {