@ramathibodi/nuxt-commons 0.1.72 → 0.1.74

package/dist/runtime/components/device/Scanner.vue

@@ -1,4 +1,8 @@
 <script lang="ts" setup>
+/**
+ * DeviceScanner bridges UI actions with host-agent hardware/device operations and emits runtime scan/read results.
+ * This doc block is consumed by vue-docgen for generated API documentation.
+ */
 import { computed, ref, watch, reactive } from 'vue'
 import type { Base64File } from '../../composables/assetFile'
 import { useAlert } from '../../composables/alert'
@@ -13,20 +17,28 @@ import {
 const alert = useAlert()
 const host = useHostAgent()
 
+/**
+ * Custom events emitted by DeviceScanner.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits<{
   (e: 'scan', files: Base64File[]): void
 }>()
 
 interface Props {
-  feeder?: boolean
-  duplex?: boolean
-  dpi?: number
-  quality?: number
+  feeder?: boolean // Uses ADF feeder mode instead of flatbed scanning.
+  duplex?: boolean // Scans both sides of pages when feeder mode supports duplex.
+  dpi?: number // Scan resolution in DPI for image quality and file size tradeoff.
+  quality?: number // Compression/quality value used when exporting scanned images.
   /** UI string: 'color' | 'grey' | 'bw' */
-  color?: string
-  maxSize?: number
+  color?: string // Vuetify color name applied to the visual element.
+  maxSize?: number // Maximum allowed output size (MB) before upload is blocked.
 }
 
+/**
+ * Public props accepted by DeviceScanner.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<Props>(), {
   feeder: false,
   duplex: false,

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

@@ -1,18 +1,26 @@
 <script lang="ts" setup>
+/**
+ * DialogConfirm coordinates modal rendering and interactions for runtime dialog flows.
+ * This doc block is consumed by vue-docgen for generated API documentation.
+ */
 import { type Ref, ref, watch, computed } from 'vue'
 import { isEqual, isUndefined, isEmpty } from 'lodash-es'
 
 interface DialogProps {
-  title?: string
-  modelValue: boolean
-  message?: string
-  buttonTrueText?: string
-  buttonFalseText?: string
-  type?: 'primary' | 'success' | 'warning' | 'info' | 'error'
-  confirmData?: string
-  width?: string
+  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
+  buttonTrueText?: string // label for the confirm/primary action
+  buttonFalseText?: string // label for the cancel/secondary action
+  type?: 'primary' | 'success' | 'warning' | 'info' | 'error' // visual variant controlling color and intent semantics
+  confirmData?: string // confirmation text that users must type before continue
+  width?: string // dialog/component width in CSS-compatible units
 }
 
+/**
+ * Public props accepted by DialogConfirm.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<DialogProps>(), {
   title: 'ยืนยัน',
   message: 'ยืนยันทำรายการนี้',
@@ -21,6 +29,10 @@ const props = withDefaults(defineProps<DialogProps>(), {
   width: 'auto',
 })
 
+/**
+ * Custom events emitted by DialogConfirm.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits<{
   (e: 'update:result', value: boolean): void
   (e: 'update:modelValue', value: boolean): void

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

@@ -1,4 +1,8 @@
 <script setup lang="ts">
+/**
+ * DialogHost coordinates modal rendering and interactions for runtime dialog flows.
+ * This doc block is consumed by vue-docgen for generated API documentation.
+ */
 import {shallowReactive, onMounted} from 'vue'
 import {useDialog} from "../../composables/dialog"
 import type {DialogOpenResult} from "../../types/dialogManager";

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

@@ -1,15 +1,27 @@
 <script lang="ts" setup>
+/**
+ * DialogIndex coordinates modal rendering and interactions for runtime dialog flows.
+ * This doc block is consumed by vue-docgen for generated API documentation.
+ */
 import { computed } from 'vue'
 
 interface DialogProps {
-  modelValue?: boolean
-  title?: string
-  message?: string
-  type?: 'success' | 'error' | 'warning' | 'info'
-  width?: number | string
+  modelValue?: boolean // Bound value for v-model synchronization with the parent component.
+  title?: string // Title text displayed in the component header or dialog.
+  message?: string // main message body shown in UI
+  type?: 'success' | 'error' | 'warning' | 'info' // visual variant controlling color and intent semantics
+  width?: number | string // dialog/component width in CSS-compatible units
 }
 
+/**
+ * Public props accepted by DialogIndex.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = defineProps<DialogProps>()
+/**
+ * Custom events emitted by DialogIndex.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['update:modelValue'])
 
 const dialogIcon = computed(() => {

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

@@ -1,12 +1,24 @@
 <script setup lang="ts">
+/**
+ * DialogLoading coordinates modal rendering and interactions for runtime dialog flows.
+ * This doc block is consumed by vue-docgen for generated API documentation.
+ */
 import { ref, watch } from 'vue'
 
 interface DialogProps {
-  modelValue: boolean
-  color?: string
+  modelValue: boolean // Bound value for v-model synchronization with the parent component.
+  color?: string // Vuetify color name applied to the visual element.
 }
+/**
+ * Custom events emitted by DialogLoading.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['update:modelValue'])
 
+/**
+ * Public props accepted by DialogLoading.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = defineProps<DialogProps>()
 const dialogVisible = ref<boolean>(props.modelValue)
 

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

@@ -1,18 +1,26 @@
 <script lang="ts" setup>
+/**
+ * DialogDefaultConfirm 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 { ref, watch, computed, type Ref } from 'vue'
 import { isEqual, isUndefined, isEmpty } from 'lodash-es'
 
 interface DialogProps {
-  title?: string
-  modelValue: boolean
-  message?: string
-  buttonTrueText?: string
-  buttonFalseText?: string
-  type?: 'primary' | 'success' | 'warning' | 'info' | 'error'
-  confirmData?: string
-  width?: string
+  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
+  buttonTrueText?: string // label for the confirm/primary action
+  buttonFalseText?: string // label for the cancel/secondary action
+  type?: 'primary' | 'success' | 'warning' | 'info' | 'error' // visual variant controlling color and intent semantics
+  confirmData?: string // confirmation text that users must type before continue
+  width?: string // dialog/component width in CSS-compatible units
 }
 
+/**
+ * Public props accepted by DialogDefaultConfirm.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<DialogProps>(), {
   title: 'Confirm',
   message: 'Do you want to proceed?',
@@ -22,6 +30,10 @@ const props = withDefaults(defineProps<DialogProps>(), {
   width: 'auto',
 })
 
+/**
+ * Custom events emitted by DialogDefaultConfirm.
+ * 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: boolean): void

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

@@ -1,12 +1,24 @@
 <script setup lang="ts">
+/**
+ * DialogDefaultLoading 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 { ref, watch } from 'vue'
 
 interface DialogProps {
-  modelValue: boolean
-  color?: string
+  modelValue: boolean // Bound value for v-model synchronization with the parent component.
+  color?: string // Vuetify color name applied to the visual element.
 }
+/**
+ * Custom events emitted by DialogDefaultLoading.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['update:modelValue'])
 
+/**
+ * Public props accepted by DialogDefaultLoading.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = defineProps<DialogProps>()
 const dialogVisible = ref<boolean>(props.modelValue)
 

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

@@ -1,15 +1,23 @@
 <script lang="ts" setup>
+/**
+ * DialogDefaultNotify 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 { ref, watch, type Ref } from 'vue'
 
 interface DialogProps {
-  title?: string
-  modelValue: boolean
-  message?: string
-  buttonText?: string
-  type?: 'primary' | 'success' | 'warning' | 'info' | 'error'
-  width?: string
+  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
+  buttonText?: string // Label text displayed on the primary action button.
+  type?: 'primary' | 'success' | 'warning' | 'info' | 'error' // visual variant controlling color and intent semantics
+  width?: string // dialog/component width in CSS-compatible units
 }
 
+/**
+ * Public props accepted by DialogDefaultNotify.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<DialogProps>(), {
   title: 'Notice',
   message: 'Something happened.',
@@ -18,6 +26,10 @@ const props = withDefaults(defineProps<DialogProps>(), {
   width: 'auto',
 })
 
+/**
+ * Custom events emitted by DialogDefaultNotify.
+ * 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: boolean): void

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

@@ -1,11 +1,23 @@
 <script setup lang="ts">
+/**
+ * DialogDefaultPrinting 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 { ref, watch } from 'vue'
 
 interface DialogProps {
-  modelValue: boolean
-  color?: string
+  modelValue: boolean // Bound value for v-model synchronization with the parent component.
+  color?: string // Vuetify color name applied to the visual element.
 }
+/**
+ * Custom events emitted by DialogDefaultPrinting.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['update:modelValue'])
+/**
+ * Public props accepted by DialogDefaultPrinting.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = defineProps<DialogProps>()
 const dialogVisible = ref(props.modelValue)
 

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

@@ -1,20 +1,28 @@
 <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
-  modelValue: boolean
-  message?: string
-  confirmButtonText?: string
-  cancelButtonText?: string
-  type?: 'primary' | 'success' | 'warning' | 'info' | 'error'
-  fixedUsername?: boolean | string
-  width?: string
+  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.',
@@ -25,6 +33,10 @@ const props = withDefaults(defineProps<DialogProps>(), {
   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

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

@@ -1,12 +1,20 @@
 <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
-  parentTemplates?: string|string[]
+  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[] => [],
 })

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

@@ -1,4 +1,8 @@
 <script lang="ts" setup>
+/**
+ * DocumentTemplateBuilder 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 {computed, ref, watch} from 'vue'
 import * as prettier from 'prettier'
 import prettierPluginHtml from 'prettier/plugins/html'
@@ -10,15 +14,23 @@ import 'vue-json-pretty/lib/styles.css';
 import {safeParseJSONDeep} from "../../utils/object";
 
 interface Props {
-  title?: string
-  disableAdvanceMode?: boolean
+  title?: string // Title text displayed in the component header or dialog.
+  disableAdvanceMode?: boolean // Disables advanced editor mode toggles and actions.
 }
 
+/**
+ * Public props accepted by DocumentTemplateBuilder.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<Props>(), {
   title: "Document Template",
   disableAdvanceMode: false,
 })
 
+/**
+ * Custom events emitted by DocumentTemplateBuilder.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['update:modelValue'])
 const modelValue = defineModel<string|Record<string, any>[]>()
 

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

@@ -1,19 +1,27 @@
 <script lang="ts" setup>
+/**
+ * FormActionPad 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 {computed, defineExpose, ref, watchEffect} from 'vue'
 import {cloneDeep, isEqual} from 'lodash-es'
 import type {FormDialogCallback} from '../../types/formDialog'
 import FormPadComponent from './Pad.vue'
 
 interface Props extends /* @vue-ignore */ InstanceType<typeof FormPadComponent['$props']> {
-  title?: string
-  initialData?: object
-  saveCaption?: string
-  cancelCaption?: string
-  readonly?: boolean
-  showTitle?: boolean
-  skipValidation?:boolean
+  title?: string // Title text displayed in the component header or dialog.
+  initialData?: object // Initial form/object values used when creating a new record.
+  saveCaption?: string // Label text for the save/confirm action button.
+  cancelCaption?: string // Label text for the cancel action button.
+  readonly?: boolean // renders as read-only while keeping value visible
+  showTitle?: boolean // Shows or hides the component title/header area.
+  skipValidation?: boolean // Skips form validation before emitting save actions.
 }
 
+/**
+ * Public props accepted by FormActionPad.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<Props>(), {
   saveCaption: 'บันทึก',
   cancelCaption: 'ยกเลิก',
@@ -27,6 +35,10 @@ const formPadRef = ref()
 const formData = ref<object>({})
 const formDataOriginalValue = ref<object>()
 
+/**
+ * Custom events emitted by FormActionPad.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['create', 'update'])
 
 function save() {

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

@@ -1,4 +1,8 @@
 <script lang="ts" setup>
+/**
+ * FormBirthdate 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 '@vuepic/vue-datepicker/dist/main.css'
 import {computed, onMounted, ref} from 'vue'
 import {VTextField} from "vuetify/components/VTextField";
@@ -12,15 +16,23 @@ interface IDobPrecision {
 }
 
 interface Props {
-  flow?: ('month' | 'year' | 'calendar' | 'time' | 'minutes' | 'hours' | 'seconds')[]
-  dobPrecisionText?: IDobPrecision
-  rules?: typeof VTextField['rules']
+  flow?: ('month' | 'year' | 'calendar' | 'time' | 'minutes' | 'hours' | 'seconds')[] // picker navigation flow order shown to users
+  dobPrecisionText?: IDobPrecision // Label map for birthdate precision values (day/month/year).
+  rules?: typeof VTextField['rules'] // validation rules applied before accepting input
 }
 
+/**
+ * Public props accepted by FormBirthdate.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<Props>(), {
   flow: () => ['year', 'month', 'calendar'],
 })
 
+/**
+ * Custom events emitted by FormBirthdate.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['update:modelValue'])
 
 const modelValue = defineModel<string>()

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

@@ -1,4 +1,8 @@
 <script setup lang="ts">
+/**
+ * FormCheckboxGroup 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 { ref, watch, computed} from 'vue'
 import { VCheckbox } from 'vuetify/components/VCheckbox'
 import { join,without,filter,head,reject } from 'lodash-es'
@@ -7,15 +11,23 @@ interface Items {
   value : any
 }
 interface Props extends /* @vue-ignore */ InstanceType<typeof VCheckbox['$props']>{
-  items : Items[]
-  label? : string
-  modelValue : []
-  inline? : boolean
-  rules?: typeof import('vuetify/components')['VCheckbox']['rules']
+  items: Items[] // option collection used for selection rendering
+  label?: string // UI label displayed to end users
+  modelValue: [] // Bound value for v-model synchronization with the parent component.
+  inline?: boolean // Displays checkbox options inline instead of stacked.
+  rules?: typeof import('vuetify/components')['VCheckbox']['rules'] // validation rules applied before accepting input
 }
+/**
+ * Public props accepted by FormCheckboxGroup.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props =  withDefaults(defineProps<Props>(),{
   inline:false
 })
+/**
+ * Custom events emitted by FormCheckboxGroup.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['update:modelValue'])
 const values = ref([])
 const valuesOther = ref()

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

@@ -1,4 +1,8 @@
 <script setup lang="ts">
+/**
+ * FormCodeEditor 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 {Codemirror} from 'vue-codemirror'
 import {oneDark} from '@codemirror/theme-one-dark'
 import {javascript} from '@codemirror/lang-javascript'
@@ -6,11 +10,15 @@ import {html} from '@codemirror/lang-html'
 import {vue as vueLang} from '@codemirror/lang-vue'
 
 interface Props {
-  height?: string | number
-  minHeight?: string | number
-  lang?: 'html' | 'javascript' | 'vue'
+  height?: string | number // Fixed or minimum height applied to the component container.
+  minHeight?: string | number // Minimum editor/container height before scrolling is used.
+  lang?: 'html' | 'javascript' | 'vue' // Language code used when selecting localized option labels.
 }
 
+/**
+ * Public props accepted by FormCodeEditor.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<Props>(), {
   height: '100%',
   minHeight: '20em',

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

@@ -1,4 +1,8 @@
 <script lang="ts" setup>
+/**
+ * FormDate 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 { ref, watch, watchEffect, nextTick, defineExpose, computed} from 'vue'
 import { VTextField } from 'vuetify/components/VTextField'
 import Datepicker from '@vuepic/vue-datepicker'
@@ -9,19 +13,23 @@ import { useRules } from "../../composables/utils/validation";
 import { th } from 'date-fns/locale';
 
 interface Props extends /* @vue-ignore */ InstanceType<typeof VTextField['$props']> {
-  locale?: 'TH' | 'EN'
-  format?: dateFormat | string
-  modelValue?: string | null
-  holiday?: object[] | undefined
-  minDate?: Date | string
-  maxDate?: Date | string
-  pickerOnly?: boolean
-  flow?: ('month' | 'year' | 'calendar' | 'time' | 'minutes' | 'hours' | 'seconds')[]
-  rules?: typeof VTextField['rules']
-
-  defaultDate?: boolean | string
+  locale?: 'TH' | 'EN' // Locale used for date/time formatting and localized labels.
+  format?: dateFormat | string // Output format used when converting the value for display or emit.
+  modelValue?: string | null // Bound value for v-model synchronization with the parent component.
+  holiday?: object[] | undefined // Holiday date list used to decorate or block specific dates.
+  minDate?: Date | string // earliest selectable date allowed by business rules
+  maxDate?: Date | string // latest selectable date allowed by business rules
+  pickerOnly?: boolean // forces value selection through picker interaction only
+  flow?: ('month' | 'year' | 'calendar' | 'time' | 'minutes' | 'hours' | 'seconds')[] // picker navigation flow order shown to users
+  rules?: typeof VTextField['rules'] // validation rules applied before accepting input
+
+  defaultDate?: boolean | string // default date behavior/value when model is initially empty
 }
 
+/**
+ * Public props accepted by FormDate.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
 const props = withDefaults(defineProps<Props>(), {
   locale: 'TH',
   format: 'shortDate',
@@ -31,6 +39,10 @@ const props = withDefaults(defineProps<Props>(), {
   defaultDate: false,
 })
 
+/**
+ * Custom events emitted by FormDate.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
 const emit = defineEmits(['update:modelValue'])
 
 const computedRules = computed(() => {