@ramathibodi/nuxt-commons 0.1.74 → 4.0.0

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

@@ -0,0 +1,62 @@
+import { VInput } from 'vuetify/components/VInput';
+import { type Base64Asset } from '../../composables/assetFile.js';
+interface SignatureProps extends /* @vue-ignore */ InstanceType<typeof VInput['$props']> {
+    title?: string;
+    btnName?: string;
+    titleConfirm?: string;
+    penColor?: string;
+    /** hydrate when id is present but base64String is missing */
+    autoHydrate?: boolean;
+}
+/**
+ * Public props accepted by FormSignPad.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+type __VLS_Props = SignatureProps;
+type __VLS_ModelProps = {
+    modelValue?: Base64Asset | string | null;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_PublicProps>, {
+    title: string;
+    btnName: string;
+    titleConfirm: string;
+    penColor: string;
+    autoHydrate: boolean;
+}>>, {
+    errorMessages: import("vue").ComputedRef<(string & string[]) | (readonly string[] & string[]) | undefined>;
+    isValid: import("vue").ComputedRef<boolean | null | undefined>;
+    reset: () => Promise<void> | undefined;
+    resetValidation: () => Promise<void> | undefined;
+    validate: () => Promise<string[]> | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | Base64Asset | null) => any;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_PublicProps>, {
+    title: string;
+    btnName: string;
+    titleConfirm: string;
+    penColor: string;
+    autoHydrate: boolean;
+}>>> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | Base64Asset | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -1,161 +1,115 @@
-<script lang="ts" setup>
-/**
- * FormSignPad 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.
- */
-import { VueSignaturePad } from 'vue-signature-pad'
-import { VInput } from 'vuetify/components/VInput'
-import { ref, computed, withDefaults, defineProps, defineExpose, watch } from 'vue'
-import { useAssetFile, type Base64Asset, type Base64File } from '../../composables/assetFile'
-
-interface SignatureProps extends /* @vue-ignore */ InstanceType<typeof VInput['$props']> {
-  title?: string // Title text displayed in the component header or dialog.
-  btnName?: string // Button label used to open the signature pad dialog.
-  titleConfirm?: string // Confirmation text shown before accepting the signature.
-  penColor?: string // Pen stroke color used while drawing the signature.
-  /** hydrate when id is present but base64String is missing */
-  autoHydrate?: boolean // Converts incoming serialized values into component runtime format on mount/watch.
-}
-
-/**
- * Public props accepted by FormSignPad.
- * Document each prop field with intent, defaults, and side effects for clear generated docs.
- */
-const props = withDefaults(defineProps<SignatureProps>(), {
-  title: 'Signature',
-  btnName: 'Draw Your Signature',
-  titleConfirm: 'I Accept My Signature',
-  penColor: '#303F9F',
-  autoHydrate: true,
-})
-
-const { hydrateAssetFile } = useAssetFile()
-
-const model = defineModel<Base64Asset | string | null>({ default: null })
-
-// refs
-const inputRef = ref<InstanceType<typeof VInput> | null>(null)
-const signaturePadRef = ref<InstanceType<typeof VueSignaturePad> | null>(null)
-
-const isDialogOpen = ref(false)
-
-// signature pad options from props
+<script setup>
+import { VueSignaturePad } from "vue-signature-pad";
+import { VInput } from "vuetify/components/VInput";
+import { ref, computed, useAttrs, watch } from "vue";
+import { useAssetFile } from "../../composables/assetFile";
+const props = defineProps({
+  title: { type: String, required: false, default: "Signature" },
+  btnName: { type: String, required: false, default: "Draw Your Signature" },
+  titleConfirm: { type: String, required: false, default: "I Accept My Signature" },
+  penColor: { type: String, required: false, default: "#303F9F" },
+  autoHydrate: { type: Boolean, required: false, default: true }
+});
+const { hydrateAssetFile } = useAssetFile();
+const attrs = useAttrs();
+const model = defineModel({ type: [Object, String, null], ...{ default: null } });
+const inputRef = ref(null);
+const signaturePadRef = ref(null);
+const isDialogOpen = ref(false);
 const signatureOptions = computed(() => ({
   penColor: props.penColor,
   minWidth: 0.5,
-  maxWidth: 4,
-}))
-
-// internal normalized value
-const normalized = ref<Base64Asset | null>(null)
+  maxWidth: 4
+}));
+const normalized = ref(null);
 const imageDataUrl = computed(() => {
-  const val = normalized.value
-  if (!val?.base64String) return null
-
-  return useAssetFile().ensureDataUrl(val.base64String.trim(),(val as Base64File).fileType || "image/png")
-})
-
-
-// guards
-let syncing = false      // block re-entrancy while normalizing/hydrating
-
-function wrapToAsset(input: Base64Asset | string | null): Base64Asset | null {
-  if (input == null) return null
-  return typeof input === 'string' ? { base64String: input } : input
+  const val = normalized.value;
+  if (!val?.base64String) return void 0;
+  return useAssetFile().ensureDataUrl(val.base64String.trim(), val.fileType || "image/png");
+});
+const cardVariant = computed(() => {
+  return attrs.variant;
+});
+let syncing = false;
+function wrapToAsset(input) {
+  if (input == null) return null;
+  return typeof input === "string" ? { base64String: input } : input;
 }
-
-/** Normalize & (optionally) hydrate whenever external model changes */
 watch(
-    model,
-    async (val) => {
-      if (syncing) return
-      syncing = true
-      try {
-        const asAsset = wrapToAsset(val)
-        normalized.value = asAsset
-
-        // If parent provided a string, convert and write back once
-        if (typeof val === 'string') {
-          model.value = asAsset
-        }
-
-        // Hydrate if requested and needed (id present, no base64String)
-        if (props.autoHydrate && asAsset?.id != null && !asAsset.base64String) {
-          await hydrateAssetFile(asAsset) // mutates asAsset in-place
-          // reflect hydrated base64String back to parent (guarded)
-          model.value = asAsset
-        }
-      } finally {
-        syncing = false
+  model,
+  async (val) => {
+    if (syncing) return;
+    syncing = true;
+    try {
+      const asAsset = wrapToAsset(val);
+      normalized.value = asAsset;
+      if (typeof val === "string") {
+        model.value = asAsset;
       }
-    },
-    { immediate: true }
-)
-
-// signature actions
-const undoSignature = () => signaturePadRef.value?.undoSignature()
-const clearSignature = () => signaturePadRef.value?.clearSignature()
-
+      if (props.autoHydrate && asAsset?.id != null && !asAsset.base64String) {
+        await hydrateAssetFile(asAsset);
+        model.value = asAsset;
+      }
+    } finally {
+      syncing = false;
+    }
+  },
+  { immediate: true }
+);
+const undoSignature = () => signaturePadRef.value?.undoSignature();
+const clearSignature = () => signaturePadRef.value?.clearSignature();
 const closeDialog = () => {
-  isDialogOpen.value = false
-  signaturePadRef.value?.clearSignature()
-  signaturePadRef.value?.clearCacheImages?.()
-}
-
+  isDialogOpen.value = false;
+  signaturePadRef.value?.clearSignature();
+  signaturePadRef.value?.clearCacheImages?.();
+};
 const saveSignature = () => {
-  isDialogOpen.value = false
-  const result = signaturePadRef.value?.saveSignature()
-  if (!result) return
-  const { isEmpty, data } = result
+  isDialogOpen.value = false;
+  const result = signaturePadRef.value?.saveSignature();
+  if (!result) return;
+  const { isEmpty, data } = result;
   if (isEmpty) {
-    normalized.value = null
-    model.value = null
+    normalized.value = null;
+    model.value = null;
   } else {
-    const asset: Base64Asset = { base64String: data }
-    normalized.value = asset
-    model.value = asset
+    const asset = { base64String: data };
+    normalized.value = asset;
+    model.value = asset;
   }
-}
-
+};
 const openSignatureDialog = async () => {
-  // ensure hydration before opening to preview correctly
   if (props.autoHydrate && normalized.value?.id != null && !normalized.value.base64String) {
-    await hydrateAssetFile(normalized.value)
-    model.value = normalized.value
+    await hydrateAssetFile(normalized.value);
+    model.value = normalized.value;
   }
-
-  isDialogOpen.value = true
-
-  const existing = normalized.value?.base64String
+  isDialogOpen.value = true;
+  const existing = normalized.value?.base64String;
   if (existing) {
-    // seed after dialog mount
-    requestAnimationFrame(() => signaturePadRef.value?.fromDataURL(existing))
+    requestAnimationFrame(() => signaturePadRef.value?.fromDataURL(existing));
   }
-}
-
-// validation passthrough
-const isValid = computed(() => inputRef.value?.isValid)
-const errorMessages = computed(() => inputRef.value?.errorMessages)
-
+};
+const isValid = computed(() => inputRef.value?.isValid);
+const errorMessages = computed(() => inputRef.value?.errorMessages);
 defineExpose({
   errorMessages,
   isValid,
   reset: () => inputRef.value?.reset(),
   resetValidation: () => inputRef.value?.resetValidation(),
-  validate: () => inputRef.value?.validate(),
-})
+  validate: () => inputRef.value?.validate()
+});
 </script>
 
 <template>
   <v-input v-model="model" v-bind="$attrs" ref="inputRef">
     <template #default="{ isReadonly, isDisabled }">
-      <v-card class="w-100" flat :variant="$attrs.variant" :title="props.title">
+      <v-card class="w-100" flat :variant="cardVariant" :title="props.title">
         <v-card-text v-if="normalized?.base64String">
           <v-img :src="imageDataUrl" cover />
           <v-icon
               class="position-absolute"
               style="top: 8px; right: 8px; z-index: 10;"
-              @click="model = null; normalized = null"
+              @click="model = null;
+  normalized = null"
               v-if="!isReadonly?.value"
           >
             mdi mdi-close-circle

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

@@ -0,0 +1,62 @@
+import { VInput } from 'vuetify/components/VInput';
+import { type Base64Asset } from '../../composables/assetFile.js';
+interface SignatureProps extends /* @vue-ignore */ InstanceType<typeof VInput['$props']> {
+    title?: string;
+    btnName?: string;
+    titleConfirm?: string;
+    penColor?: string;
+    /** hydrate when id is present but base64String is missing */
+    autoHydrate?: boolean;
+}
+/**
+ * Public props accepted by FormSignPad.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+type __VLS_Props = SignatureProps;
+type __VLS_ModelProps = {
+    modelValue?: Base64Asset | string | null;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_PublicProps>, {
+    title: string;
+    btnName: string;
+    titleConfirm: string;
+    penColor: string;
+    autoHydrate: boolean;
+}>>, {
+    errorMessages: import("vue").ComputedRef<(string & string[]) | (readonly string[] & string[]) | undefined>;
+    isValid: import("vue").ComputedRef<boolean | null | undefined>;
+    reset: () => Promise<void> | undefined;
+    resetValidation: () => Promise<void> | undefined;
+    validate: () => Promise<string[]> | undefined;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | Base64Asset | null) => any;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_PublicProps>, {
+    title: string;
+    btnName: string;
+    titleConfirm: string;
+    penColor: string;
+    autoHydrate: boolean;
+}>>> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | Base64Asset | null) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -0,0 +1,34 @@
+/**
+ * FormSystem 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.
+ */
+import Pad from './Pad.vue.js';
+interface Props extends /* @vue-ignore */ InstanceType<typeof Pad['$props']> {
+    templateId: string;
+    cache?: boolean | number;
+}
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
+    cache: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
+    cache: boolean;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};

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

@@ -1,35 +1,21 @@
-<script lang="ts" setup>
-/**
- * FormSystem 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.
- */
-import Pad from './Pad.vue'
-import { watch } from 'vue'
-import { useGraphQlOperation } from '../../composables/graphqlOperation'
-
-interface Props extends /* @vue-ignore */ InstanceType<typeof Pad['$props']> {
-  templateId: string; // identifier value used to resolve business data
-  cache?: boolean | number // Enables cached requests; number values represent cache TTL in milliseconds.
-}
-
-/**
- * Public props accepted by FormSystem.
- * Document each prop field with intent, defaults, and side effects for clear generated docs.
- */
-const props = withDefaults(defineProps<Props>(),{
-  cache: false
-})
-
-const currentTemplate = ref<any>({})
-
-watch(()=>props.templateId, (newValue) => {
-  useGraphQlOperation("Query","systemTemplateById",["template","templateScript"],{id: newValue},props.cache).then(result => {
-    currentTemplate.value = result
-  }).catch(_error => {
-    currentTemplate.value = {}
-  })
-})
+<script setup>
+import Pad from "./Pad.vue";
+import { ref, watch } from "vue";
+import { useGraphQlOperation } from "../../composables/graphqlOperation";
+const props = defineProps({
+  templateId: { type: String, required: true },
+  cache: { type: [Boolean, Number], required: false, default: false }
+});
+const currentTemplate = ref({});
+watch(() => props.templateId, (newValue) => {
+  useGraphQlOperation("Query", "systemTemplateById", ["template", "templateScript"], { id: newValue }, props.cache).then((result) => {
+    currentTemplate.value = result;
+  }).catch((_error) => {
+    currentTemplate.value = {};
+  });
+});
 </script>
+
 <template>
   <FormPad v-bind="$attrs" :template="currentTemplate.template" :template-script="currentTemplate.templateScript" />
-</template>
+</template>

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

@@ -0,0 +1,34 @@
+/**
+ * FormSystem 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.
+ */
+import Pad from './Pad.vue.js';
+interface Props extends /* @vue-ignore */ InstanceType<typeof Pad['$props']> {
+    templateId: string;
+    cache?: boolean | number;
+}
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
+    cache: boolean;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
+    cache: boolean;
+}>>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_TypePropsToOption<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<Required<T>[K]>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
+    [K in keyof T as K]: T[K];
+}) & {};