@ramathibodi/nuxt-commons 0.1.73 → 0.1.75

package/dist/runtime/components/dialog/default/VerifyUser.vue

@@ -1,132 +1,144 @@
-<script lang="ts" setup>
-import {computed, ref, type Ref, watch} from 'vue'
-import {useDialog} from "../../../composables/dialog"
-import {useGraphQlOperation} from "../../../composables/graphqlOperation";
-import {type AuthenticationState, useState} from '#imports'
-
-interface DialogProps {
-  title?: string
-  modelValue: boolean
-  message?: string
-  confirmButtonText?: string
-  cancelButtonText?: string
-  type?: 'primary' | 'success' | 'warning' | 'info' | 'error'
-  fixedUsername?: boolean | string
-  width?: string
-}
-
-const props = withDefaults(defineProps<DialogProps>(), {
-  title: 'Verify User',
-  message: 'Please enter your credentials to continue.',
-  confirmButtonText: 'Verify',
-  cancelButtonText: 'Cancel',
-  type: 'primary',
-  fixedUsername: true,
-  width: '400',
-})
-
-const emit = defineEmits<{
-  (e: 'update:modelValue', value: boolean): void
-  (e: 'resolve', value: string): void
-  (e: 'reject', value: any): void
-}>()
-
-const authenState = useState<AuthenticationState>("authentication")
-
-const dialogVisible: Ref<boolean> = ref(props.modelValue)
-
-watch(() => props.modelValue, (val) => {
-  dialogVisible.value = val
-})
-
-watch(dialogVisible, (val) => {
-  if (!val) emit('update:modelValue', false)
-})
-
-const username = ref<string>('')
-const password = ref<string>('')
-
-watch(()=>props.fixedUsername, (fixedUsername) => {
-  if (fixedUsername === true) {
-    let userProfile =  authenState.value?.userProfile as {username: string}
-    username.value = userProfile?.username ?? ""
-  } else {
-    username.value =  (fixedUsername) ? fixedUsername as string : ""
-  }
-},{immediate: true})
-
-const isDisabled = computed(() => {
-  return !username.value || !password.value
-})
-
-const verifyUser = async (username: string, password: string): Promise<boolean> => {
-  try {
-    let result: any = await useGraphQlOperation('Mutation',"verifyUser",["success"], {username: username, password: password})
-    return result.success
-  } catch (_error) {
-    return false
-  }
-}
-
-const handleConfirm = async () => {
-  const verified = await verifyUser(username.value, password.value)
-  if (verified) {
-    dialogVisible.value = false
-    emit('resolve', username.value)
-  } else {
-    useDialog().notify({message: "Invalid username or password",type: 'warning',title:"Error"})
-  }
-}
-
-const handleCancel = () => {
-  dialogVisible.value = false
-  emit('reject', 'User cancelled')
-}
-</script>
-
-<template>
-  <v-row justify="center">
-    <v-dialog
-        v-model="dialogVisible"
-        :width="props.width"
-        persistent
-    >
-      <v-card>
-        <v-toolbar
-            :color="props.type"
-            :title="props.title"
-            density="compact"
-        />
-        <v-card-text>
-          <div class="mb-2">{{ props.message }}</div>
-          <v-text-field
-              v-model="username"
-              :readonly="!!props.fixedUsername"
-              label="Username"
-              variant="underlined"
-          />
-          <v-text-field
-              v-model="password"
-              label="Password"
-              type="password"
-              variant="underlined"
-          />
-        </v-card-text>
-        <v-card-actions>
-          <v-spacer />
-          <v-btn variant="text" @click="handleCancel">
-            {{ props.cancelButtonText }}
-          </v-btn>
-          <v-btn
-              :color="props.type"
-              :disabled="isDisabled"
-              variant="text"
-              @click="handleConfirm"
-          >
-            {{ props.confirmButtonText }}
-          </v-btn>
-        </v-card-actions>
-      </v-card>
-    </v-dialog>
-  </v-row>
-</template>
+<script lang="ts" setup>
+/**
+ * DialogDefaultVerifyUser is a default dialog content component used by the dialog host for common runtime prompts and feedback.
+ * This doc block is consumed by vue-docgen for generated API documentation.
+ */
+import {computed, ref, type Ref, watch} from 'vue'
+import {useDialog} from "../../../composables/dialog"
+import {useGraphQlOperation} from "../../../composables/graphqlOperation";
+import {type AuthenticationState, useState} from '#imports'
+
+interface DialogProps {
+  title?: string // Title text displayed in the component header or dialog.
+  modelValue: boolean // Bound value for v-model synchronization with the parent component.
+  message?: string // main message body shown in UI
+  confirmButtonText?: string // Label text for the confirm/verify action button.
+  cancelButtonText?: string // Label text for the cancel action button.
+  type?: 'primary' | 'success' | 'warning' | 'info' | 'error' // visual variant controlling color and intent semantics
+  fixedUsername?: boolean | string // Locks username input to provided/default value when enabled.
+  width?: string // dialog/component width in CSS-compatible units
+}
+
+/**
+ * Public props accepted by DialogDefaultVerifyUser.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+const props = withDefaults(defineProps<DialogProps>(), {
+  title: 'Verify User',
+  message: 'Please enter your credentials to continue.',
+  confirmButtonText: 'Verify',
+  cancelButtonText: 'Cancel',
+  type: 'primary',
+  fixedUsername: true,
+  width: '400',
+})
+
+/**
+ * Custom events emitted by DialogDefaultVerifyUser.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
+const emit = defineEmits<{
+  (e: 'update:modelValue', value: boolean): void
+  (e: 'resolve', value: string): void
+  (e: 'reject', value: any): void
+}>()
+
+const authenState = useState<AuthenticationState>("authentication")
+
+const dialogVisible: Ref<boolean> = ref(props.modelValue)
+
+watch(() => props.modelValue, (val) => {
+  dialogVisible.value = val
+})
+
+watch(dialogVisible, (val) => {
+  if (!val) emit('update:modelValue', false)
+})
+
+const username = ref<string>('')
+const password = ref<string>('')
+
+watch(()=>props.fixedUsername, (fixedUsername) => {
+  if (fixedUsername === true) {
+    let userProfile =  authenState.value?.userProfile as {username: string}
+    username.value = userProfile?.username ?? ""
+  } else {
+    username.value =  (fixedUsername) ? fixedUsername as string : ""
+  }
+},{immediate: true})
+
+const isDisabled = computed(() => {
+  return !username.value || !password.value
+})
+
+const verifyUser = async (username: string, password: string): Promise<boolean> => {
+  try {
+    let result: any = await useGraphQlOperation('Mutation',"verifyUser",["success"], {username: username, password: password})
+    return result.success
+  } catch (_error) {
+    return false
+  }
+}
+
+const handleConfirm = async () => {
+  const verified = await verifyUser(username.value, password.value)
+  if (verified) {
+    dialogVisible.value = false
+    emit('resolve', username.value)
+  } else {
+    useDialog().notify({message: "Invalid username or password",type: 'warning',title:"Error"})
+  }
+}
+
+const handleCancel = () => {
+  dialogVisible.value = false
+  emit('reject', 'User cancelled')
+}
+</script>
+
+<template>
+  <v-row justify="center">
+    <v-dialog
+        v-model="dialogVisible"
+        :width="props.width"
+        persistent
+    >
+      <v-card>
+        <v-toolbar
+            :color="props.type"
+            :title="props.title"
+            density="compact"
+        />
+        <v-card-text>
+          <div class="mb-2">{{ props.message }}</div>
+          <v-text-field
+              v-model="username"
+              :readonly="!!props.fixedUsername"
+              label="Username"
+              variant="underlined"
+          />
+          <v-text-field
+              v-model="password"
+              label="Password"
+              type="password"
+              variant="underlined"
+          />
+        </v-card-text>
+        <v-card-actions>
+          <v-spacer />
+          <v-btn variant="text" @click="handleCancel">
+            {{ props.cancelButtonText }}
+          </v-btn>
+          <v-btn
+              :color="props.type"
+              :disabled="isDisabled"
+              variant="text"
+              @click="handleConfirm"
+          >
+            {{ props.confirmButtonText }}
+          </v-btn>
+        </v-card-actions>
+      </v-card>
+    </v-dialog>
+  </v-row>
+</template>

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

@@ -1,43 +1,51 @@
-<script lang="ts" setup>
-import {ref, withDefaults,watch,computed} from 'vue'
-import {graphqlOperation} from '#imports'
-
-interface Props {
-  templateCode: string
-  parentTemplates?: string|string[]
-}
-
-const props = withDefaults(defineProps<Props>(), {
-  parentTemplates: (): string[] => [],
-})
-
-const template = ref<any>()
-const templateScript = ref<string>()
-
-const parentTemplates = computed(()=>{
-  if (typeof props.parentTemplates === 'string') {
-    if (props.parentTemplates && props.parentTemplates!="") return props.parentTemplates.split("|")
-    else return []
-  } else {
-    return props.parentTemplates
-  }
-})
-
-const parentTemplatesNext = computed(()=>{
-  return [...parentTemplates.value,props.templateCode]
-})
-
-watch(()=>props.templateCode,()=>{
-  if (!parentTemplates.value.includes(props.templateCode) && props.templateCode) {
-    if (graphqlOperation["documentTemplateByTemplateCode"]) {
-      graphqlOperation["documentTemplateByTemplateCode"].call(["*"],{templateCode: props.templateCode}).then((result: any)=>{
-        template.value = result.editTemplate
-        templateScript.value = result.templateScript
-      })
-    }
-  }
-},{immediate: true})
-</script>
-<template>
-  <form-pad :template="template" :template-script="templateScript" :parent-templates="parentTemplatesNext"></form-pad>
+<script lang="ts" setup>
+/**
+ * DocumentForm supports document-template rendering and synchronizes template-defined field behavior with runtime data.
+ * This doc block is consumed by vue-docgen for generated API documentation.
+ */
+import {ref, withDefaults,watch,computed} from 'vue'
+import {graphqlOperation} from '#imports'
+
+interface Props {
+  templateCode: string // Template identifier used to load document schema/config.
+  parentTemplates?: string|string[] // Parent template code(s) used for template inheritance/extension.
+}
+
+/**
+ * Public props accepted by DocumentForm.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+const props = withDefaults(defineProps<Props>(), {
+  parentTemplates: (): string[] => [],
+})
+
+const template = ref<any>()
+const templateScript = ref<string>()
+
+const parentTemplates = computed(()=>{
+  if (typeof props.parentTemplates === 'string') {
+    if (props.parentTemplates && props.parentTemplates!="") return props.parentTemplates.split("|")
+    else return []
+  } else {
+    return props.parentTemplates
+  }
+})
+
+const parentTemplatesNext = computed(()=>{
+  return [...parentTemplates.value,props.templateCode]
+})
+
+watch(()=>props.templateCode,()=>{
+  if (!parentTemplates.value.includes(props.templateCode) && props.templateCode) {
+    if (graphqlOperation["documentTemplateByTemplateCode"]) {
+      graphqlOperation["documentTemplateByTemplateCode"].call(["*"],{templateCode: props.templateCode}).then((result: any)=>{
+        template.value = result.editTemplate
+        templateScript.value = result.templateScript
+      })
+    }
+  }
+},{immediate: true})
+</script>
+<template>
+  <form-pad :template="template" :template-script="templateScript" :parent-templates="parentTemplatesNext"></form-pad>
 </template>