@ramathibodi/nuxt-commons 0.1.73 → 0.1.75

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

@@ -1,32 +1,44 @@
-<script lang="ts" setup>
-import { watch } from 'vue'
-import { cloneDeep } from 'lodash-es'
-
-interface Props {
-  itemValue?: any
-  hook?: Function
-  modelValue?: any
-}
-
-const props = defineProps<Props>()
-const emit = defineEmits(['update:modelValue'])
-
-watch(() => props.itemValue, (newValue,oldValue) => {
-  const resultValue = cloneDeep(newValue)
-  if (props.hook) {
-    Promise.resolve(props.hook(resultValue, props.modelValue,newValue,oldValue)).then((result) => {
-      emit('update:modelValue', result)
-    }).catch(e => void e)
-  }
-  else {
-    emit('update:modelValue', resultValue)
-  }
-}, { deep: true, immediate: true })
-</script>
-
-<template>
-  <input
-    type="hidden"
-    v-bind="$attrs"
-  >
-</template>
+<script lang="ts" setup>
+/**
+ * FormHidden 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 { watch } from 'vue'
+import { cloneDeep } from 'lodash-es'
+
+interface Props {
+  itemValue?: any // Internal hidden value to emit/store from this field.
+  hook?: Function // Callback function executed before emitting the final value.
+  modelValue?: any // Bound value for v-model synchronization with the parent component.
+}
+
+/**
+ * Public props accepted by FormHidden.
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
+ */
+const props = defineProps<Props>()
+/**
+ * Custom events emitted by FormHidden.
+ * Parents can listen to these events to react to user actions and internal state changes.
+ */
+const emit = defineEmits(['update:modelValue'])
+
+watch(() => props.itemValue, (newValue,oldValue) => {
+  const resultValue = cloneDeep(newValue)
+  if (props.hook) {
+    Promise.resolve(props.hook(resultValue, props.modelValue,newValue,oldValue)).then((result) => {
+      emit('update:modelValue', result)
+    }).catch(e => void e)
+  }
+  else {
+    emit('update:modelValue', resultValue)
+  }
+}, { deep: true, immediate: true })
+</script>
+
+<template>
+  <input
+    type="hidden"
+    v-bind="$attrs"
+  >
+</template>