@ramathibodi/nuxt-commons 0.1.74 → 0.1.75

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (96) hide show
  1. package/README.md +115 -115
  2. package/dist/module.json +1 -1
  3. package/dist/runtime/components/Alert.vue +58 -58
  4. package/dist/runtime/components/BarcodeReader.vue +130 -130
  5. package/dist/runtime/components/ExportCSV.vue +110 -110
  6. package/dist/runtime/components/FileBtn.vue +79 -79
  7. package/dist/runtime/components/ImportCSV.vue +151 -151
  8. package/dist/runtime/components/MrzReader.vue +168 -168
  9. package/dist/runtime/components/SplitterPanel.vue +67 -67
  10. package/dist/runtime/components/TabsGroup.vue +39 -39
  11. package/dist/runtime/components/TextBarcode.vue +66 -66
  12. package/dist/runtime/components/device/IdCardButton.vue +95 -95
  13. package/dist/runtime/components/device/IdCardWebSocket.vue +207 -207
  14. package/dist/runtime/components/device/Scanner.vue +350 -350
  15. package/dist/runtime/components/dialog/Confirm.vue +112 -112
  16. package/dist/runtime/components/dialog/Host.vue +88 -88
  17. package/dist/runtime/components/dialog/Index.vue +84 -84
  18. package/dist/runtime/components/dialog/Loading.vue +51 -51
  19. package/dist/runtime/components/dialog/default/Confirm.vue +112 -112
  20. package/dist/runtime/components/dialog/default/Loading.vue +60 -60
  21. package/dist/runtime/components/dialog/default/Notify.vue +82 -82
  22. package/dist/runtime/components/dialog/default/Printing.vue +46 -46
  23. package/dist/runtime/components/dialog/default/VerifyUser.vue +144 -144
  24. package/dist/runtime/components/document/Form.vue +50 -50
  25. package/dist/runtime/components/document/TemplateBuilder.vue +536 -536
  26. package/dist/runtime/components/form/ActionPad.vue +156 -156
  27. package/dist/runtime/components/form/Birthdate.vue +116 -116
  28. package/dist/runtime/components/form/CheckboxGroup.vue +99 -99
  29. package/dist/runtime/components/form/CodeEditor.vue +45 -45
  30. package/dist/runtime/components/form/Date.vue +270 -270
  31. package/dist/runtime/components/form/DateTime.vue +220 -220
  32. package/dist/runtime/components/form/Dialog.vue +178 -178
  33. package/dist/runtime/components/form/EditPad.vue +157 -157
  34. package/dist/runtime/components/form/File.vue +295 -295
  35. package/dist/runtime/components/form/Hidden.vue +44 -44
  36. package/dist/runtime/components/form/Iterator.vue +538 -538
  37. package/dist/runtime/components/form/Login.vue +143 -143
  38. package/dist/runtime/components/form/Pad.vue +399 -399
  39. package/dist/runtime/components/form/SignPad.vue +226 -226
  40. package/dist/runtime/components/form/System.vue +34 -34
  41. package/dist/runtime/components/form/Table.vue +391 -391
  42. package/dist/runtime/components/form/TableData.vue +236 -236
  43. package/dist/runtime/components/form/Time.vue +177 -177
  44. package/dist/runtime/components/form/images/Capture.vue +245 -245
  45. package/dist/runtime/components/form/images/Edit.vue +133 -133
  46. package/dist/runtime/components/form/images/Field.vue +331 -331
  47. package/dist/runtime/components/form/images/Pad.vue +54 -54
  48. package/dist/runtime/components/label/Date.vue +37 -37
  49. package/dist/runtime/components/label/DateAgo.vue +102 -102
  50. package/dist/runtime/components/label/DateCount.vue +152 -152
  51. package/dist/runtime/components/label/Field.vue +111 -111
  52. package/dist/runtime/components/label/FormatMoney.vue +37 -37
  53. package/dist/runtime/components/label/Mask.vue +46 -46
  54. package/dist/runtime/components/label/Object.vue +21 -21
  55. package/dist/runtime/components/master/Autocomplete.vue +89 -89
  56. package/dist/runtime/components/master/Combobox.vue +88 -88
  57. package/dist/runtime/components/master/RadioGroup.vue +90 -90
  58. package/dist/runtime/components/master/Select.vue +70 -70
  59. package/dist/runtime/components/master/label.vue +55 -55
  60. package/dist/runtime/components/model/Autocomplete.vue +91 -91
  61. package/dist/runtime/components/model/Combobox.vue +90 -90
  62. package/dist/runtime/components/model/Pad.vue +114 -114
  63. package/dist/runtime/components/model/Select.vue +78 -84
  64. package/dist/runtime/components/model/Table.vue +370 -370
  65. package/dist/runtime/components/model/iterator.vue +497 -497
  66. package/dist/runtime/components/model/label.vue +58 -58
  67. package/dist/runtime/components/pdf/Print.vue +75 -75
  68. package/dist/runtime/components/pdf/View.vue +146 -146
  69. package/dist/runtime/composables/dialog.d.ts +1 -1
  70. package/dist/runtime/composables/graphql.d.ts +1 -1
  71. package/dist/runtime/composables/graphqlModel.d.ts +9 -9
  72. package/dist/runtime/composables/graphqlModelItem.d.ts +7 -7
  73. package/dist/runtime/composables/graphqlModelOperation.d.ts +6 -6
  74. package/dist/runtime/composables/userPermission.d.ts +1 -1
  75. package/dist/runtime/labs/Calendar.vue +99 -99
  76. package/dist/runtime/labs/form/EditMobile.vue +152 -152
  77. package/dist/runtime/labs/form/TextFieldMask.vue +43 -43
  78. package/dist/runtime/plugins/clientConfig.d.ts +1 -1
  79. package/dist/runtime/plugins/default.d.ts +1 -1
  80. package/dist/runtime/plugins/dialogManager.d.ts +1 -1
  81. package/dist/runtime/plugins/permission.d.ts +1 -1
  82. package/dist/runtime/types/alert.d.ts +11 -11
  83. package/dist/runtime/types/clientConfig.d.ts +13 -13
  84. package/dist/runtime/types/dialogManager.d.ts +35 -35
  85. package/dist/runtime/types/formDialog.d.ts +5 -5
  86. package/dist/runtime/types/graphqlOperation.d.ts +23 -23
  87. package/dist/runtime/types/menu.d.ts +31 -31
  88. package/dist/runtime/types/modules.d.ts +7 -7
  89. package/dist/runtime/types/permission.d.ts +13 -13
  90. package/package.json +131 -131
  91. package/scripts/enrich-vue-docs-from-ai.mjs +197 -197
  92. package/scripts/generate-ai-summary.mjs +321 -321
  93. package/scripts/generate-composables-md.mjs +129 -129
  94. package/scripts/postInstall.cjs +70 -70
  95. package/templates/.codegen/codegen.ts +32 -32
  96. package/templates/.codegen/plugin-schema-object.js +161 -161
@@ -1,91 +1,91 @@
1
- <script lang="ts" setup>
2
- /**
3
- * ModelCombobox connects model metadata to reusable selection, labeling, iterator, or table UI patterns.
4
- * This doc block is consumed by vue-docgen for generated API documentation.
5
- */
6
- import { VCombobox } from 'vuetify/components/VCombobox'
7
- import { defineModel, withDefaults } from 'vue'
8
- import { useLookupList, type LookupProps } from '../../composables/lookupList'
9
- import { useLocalStorageModel, type PersistSlimProps } from '../../composables/localStorageModel'
10
-
11
- interface Props extends /* @vue-ignore */ InstanceType<typeof VCombobox['$props']> {}
12
-
13
- /**
14
- * Public props accepted by ModelCombobox.
15
- * Document each prop field with intent, defaults, and side effects for clear generated docs.
16
- */
17
- const props = withDefaults(defineProps<Props & LookupProps & PersistSlimProps>(), {
18
- fuzzy: false, // Enables fuzzy matching when filtering local options.
19
- showCode: false, // Displays code values alongside labels in option lists.
20
- cache: false, // Enables cached requests; number values represent cache TTL in milliseconds.
21
- serverSearch: false, // Uses remote search requests instead of local filtering.
22
- searchSearchSort: false, // Sorts server-search results based on search relevance.
23
- serverSearchText: 'Type to search…', // Placeholder/help text shown before server search starts.
24
- serverSearchLoadingText: 'Searching…', // Status text shown while server search request is running.
25
- serverSearchDebounce: 500, // Debounce delay in milliseconds before sending server search.
26
-
27
- statusField: 'statusCode', // Field name that indicates active/inactive status in each item.
28
- activeValue: 'active', // Value in statusField treated as active/selectable.
29
- hideInactiveInList: false, // Hides inactive options from the displayed selection list.
30
- preventSelectingInactive: false, // Blocks selecting inactive options even if present in the dataset.
31
- })
32
-
33
- /**
34
- * Custom events emitted by ModelCombobox.
35
- * Parents can listen to these events to react to user actions and internal state changes.
36
- */
37
- const emit = defineEmits<{
38
- (e: 'update:selectedObject', object: any | any[]): void
39
- }>()
40
-
41
- const selectedItems = defineModel<any>()
42
- useLocalStorageModel(selectedItems, props)
43
-
44
- const {
45
- searchData,
46
- computedItems,
47
- computedFilterKeys,
48
- computedPlaceholder,
49
- computedNoDataText,
50
- isLoading,
51
- isErrorLoading,
52
- onUpdateModelValue, // ✅ from composable
53
- } = useLookupList(props as any, emit, selectedItems)
54
- </script>
55
-
56
- <template>
57
- <v-combobox
58
- :model-value="selectedItems"
59
- @update:model-value="onUpdateModelValue"
60
- v-model:search="searchData"
61
- v-bind="$attrs"
62
- :items="computedItems"
63
- :filter-keys="computedFilterKeys"
64
- :no-filter="props.fuzzy || props.serverSearch"
65
- :item-title="props.itemTitle"
66
- :item-value="props.itemValue"
67
- :loading="isLoading"
68
- :placeholder="computedPlaceholder"
69
- :no-data-text="computedNoDataText"
70
- :multiple="props.multiple"
71
- :return-object="false"
72
- >
73
- <!-- passthrough slots -->
74
- <!-- @ts-ignore -->
75
- <template v-for="(_, name, index) in ($slots as {})" :key="index" #[name]="slotData">
76
- <slot :name="name" v-bind="((slotData || {}) as object)" />
77
- </template>
78
-
79
- <template v-if="!$slots.item" #item="{ props: itemProps, item }">
80
- <v-list-item v-bind="itemProps" :title="(props.showCode ? item.value + '-' : '') + item.title" />
81
- </template>
82
-
83
- <template v-if="!$slots.selection && props.showCode" #selection="{ item }">
84
- {{ item.value + '-' + item.title }}
85
- </template>
86
-
87
- <template v-if="isErrorLoading" #append>
88
- <v-icon color="error">mdi mdi-alert</v-icon>
89
- </template>
90
- </v-combobox>
1
+ <script lang="ts" setup>
2
+ /**
3
+ * ModelCombobox connects model metadata to reusable selection, labeling, iterator, or table UI patterns.
4
+ * This doc block is consumed by vue-docgen for generated API documentation.
5
+ */
6
+ import { VCombobox } from 'vuetify/components/VCombobox'
7
+ import { defineModel, withDefaults } from 'vue'
8
+ import { useLookupList, type LookupProps } from '../../composables/lookupList'
9
+ import { useLocalStorageModel, type PersistSlimProps } from '../../composables/localStorageModel'
10
+
11
+ interface Props extends /* @vue-ignore */ InstanceType<typeof VCombobox['$props']> {}
12
+
13
+ /**
14
+ * Public props accepted by ModelCombobox.
15
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
16
+ */
17
+ const props = withDefaults(defineProps<Props & LookupProps & PersistSlimProps>(), {
18
+ fuzzy: false, // Enables fuzzy matching when filtering local options.
19
+ showCode: false, // Displays code values alongside labels in option lists.
20
+ cache: false, // Enables cached requests; number values represent cache TTL in milliseconds.
21
+ serverSearch: false, // Uses remote search requests instead of local filtering.
22
+ searchSearchSort: false, // Sorts server-search results based on search relevance.
23
+ serverSearchText: 'Type to search…', // Placeholder/help text shown before server search starts.
24
+ serverSearchLoadingText: 'Searching…', // Status text shown while server search request is running.
25
+ serverSearchDebounce: 500, // Debounce delay in milliseconds before sending server search.
26
+
27
+ statusField: 'statusCode', // Field name that indicates active/inactive status in each item.
28
+ activeValue: 'active', // Value in statusField treated as active/selectable.
29
+ hideInactiveInList: false, // Hides inactive options from the displayed selection list.
30
+ preventSelectingInactive: false, // Blocks selecting inactive options even if present in the dataset.
31
+ })
32
+
33
+ /**
34
+ * Custom events emitted by ModelCombobox.
35
+ * Parents can listen to these events to react to user actions and internal state changes.
36
+ */
37
+ const emit = defineEmits<{
38
+ (e: 'update:selectedObject', object: any | any[]): void
39
+ }>()
40
+
41
+ const selectedItems = defineModel<any>()
42
+ useLocalStorageModel(selectedItems, props)
43
+
44
+ const {
45
+ searchData,
46
+ computedItems,
47
+ computedFilterKeys,
48
+ computedPlaceholder,
49
+ computedNoDataText,
50
+ isLoading,
51
+ isErrorLoading,
52
+ onUpdateModelValue, // ✅ from composable
53
+ } = useLookupList(props as any, emit, selectedItems)
54
+ </script>
55
+
56
+ <template>
57
+ <v-combobox
58
+ :model-value="selectedItems"
59
+ @update:model-value="onUpdateModelValue"
60
+ v-model:search="searchData"
61
+ v-bind="$attrs"
62
+ :items="computedItems"
63
+ :filter-keys="computedFilterKeys"
64
+ :no-filter="props.fuzzy || props.serverSearch"
65
+ :item-title="props.itemTitle"
66
+ :item-value="props.itemValue"
67
+ :loading="isLoading"
68
+ :placeholder="computedPlaceholder"
69
+ :no-data-text="computedNoDataText"
70
+ :multiple="props.multiple"
71
+ :return-object="false"
72
+ >
73
+ <!-- passthrough slots -->
74
+ <!-- @ts-ignore -->
75
+ <template v-for="(_, name, index) in ($slots as {})" :key="index" #[name]="slotData">
76
+ <slot :name="name" v-bind="((slotData || {}) as object)" />
77
+ </template>
78
+
79
+ <template v-if="!$slots.item" #item="{ props: itemProps, item }">
80
+ <v-list-item v-bind="itemProps" :title="(props.showCode ? item.value + '-' : '') + item.title" />
81
+ </template>
82
+
83
+ <template v-if="!$slots.selection && props.showCode" #selection="{ item }">
84
+ {{ item.value + '-' + item.title }}
85
+ </template>
86
+
87
+ <template v-if="isErrorLoading" #append>
88
+ <v-icon color="error">mdi mdi-alert</v-icon>
89
+ </template>
90
+ </v-combobox>
91
91
  </template>
@@ -1,114 +1,114 @@
1
- <script lang="ts" setup>
2
- /**
3
- * ModelPad connects model metadata to reusable selection, labeling, iterator, or table UI patterns.
4
- * This doc block is consumed by vue-docgen for generated API documentation.
5
- */
6
- import { computed, useTemplateRef, defineExpose } from 'vue'
7
- import { type GraphqlModelItemProps, useGraphqlModelItem } from '../../composables/graphqlModelItem'
8
- import type {FormDialogCallback} from '../../types/formDialog'
9
- import EditPad from '../form/EditPad.vue'
10
- import {useDialog} from "../../composables/dialog";
11
-
12
- defineOptions({
13
- inheritAttrs: false,
14
- })
15
-
16
- interface Props extends /* @vue-ignore */ InstanceType<typeof EditPad['$props']> {
17
- title?: string // Title text displayed in the component header or dialog.
18
- saveCaption?: string // Label text for the save/confirm action button.
19
- cancelCaption?: string // Label text for the cancel action button.
20
- }
21
-
22
- /**
23
- * Public props accepted by ModelPad.
24
- * Document each prop field with intent, defaults, and side effects for clear generated docs.
25
- */
26
- const props = withDefaults(defineProps<Props & GraphqlModelItemProps>(), {
27
- fields: () => ['*'],
28
-
29
- saveCaption: 'บันทึก',
30
- cancelCaption: 'ยกเลิก',
31
- })
32
-
33
- /**
34
- * Custom events emitted by ModelPad.
35
- * Parents can listen to these events to react to user actions and internal state changes.
36
- */
37
- const emit = defineEmits(['create', 'update'])
38
-
39
- const { item,
40
- canCreate, canUpdate,
41
- createItem, updateItem,
42
- reload, isLoading } = useGraphqlModelItem(props)
43
-
44
- const editPad = useTemplateRef<typeof EditPad>("editPadRef")
45
-
46
- const canSave = computed<boolean>(() => { return ((canCreate.value && editPad.value?.operation?.isCreating?.value) || canUpdate.value) as boolean})
47
-
48
- const operation : any = computed(()=>{
49
- return Object.assign({},editPad.value?.operation,{canSave,reload,item})
50
- })
51
-
52
- const onCreateItem = (item: Record<string, any>,callback?: FormDialogCallback)=>{
53
- createItem(item,callback).then(()=>{
54
- useDialog().notify({message: "Data created successfully",type: 'success',title:"Success"})
55
- emit("create",item,callback)
56
- })
57
- }
58
-
59
- const onUpdateItem = (item: Record<string, any>,callback?: FormDialogCallback)=>{
60
- updateItem(item,callback).then(()=>{
61
- useDialog().notify({message: "Data updated successfully",type: 'success',title:"Success"})
62
- emit("update",item,callback)
63
- })
64
- }
65
-
66
- defineExpose({ operation, formPad: editPad.value?.formPad })
67
- </script>
68
-
69
- <template>
70
- <FormEditPad v-bind="$attrs" :form-data="item" ref="editPadRef" @create="onCreateItem" @update="onUpdateItem">
71
- <template #titleToolbar>
72
- <slot name="titleToolbar" :operation="operation">
73
- <VToolbarTitle>
74
- <slot name="title" :operation="operation">
75
- {{ title }}
76
- <v-icon
77
- size="small"
78
- @click="reload"
79
- >
80
- mdi mdi-refresh
81
- </v-icon>
82
- </slot>
83
- </VToolbarTitle>
84
- </slot>
85
- </template>
86
- <template #action="slotData">
87
- <slot name="action" :operation="operation">
88
- <VSpacer />
89
- <VBtn
90
- color="primary"
91
- variant="flat"
92
- :loading="isLoading"
93
- :disabled="!slotData.operation?.isDataChange || !canSave"
94
- @click="slotData.operation?.save"
95
- >
96
- {{ props.saveCaption }}
97
- </VBtn>
98
- <VBtn
99
- color="error"
100
- variant="flat"
101
- :disabled="isLoading"
102
- @click="slotData.operation?.cancel"
103
- >
104
- {{ props.cancelCaption }}
105
- </VBtn>
106
- </slot>
107
- </template>
108
- <template #default="slotData">
109
- <slot
110
- v-bind="slotData"
111
- />
112
- </template>
113
- </FormEditPad>
114
- </template>
1
+ <script lang="ts" setup>
2
+ /**
3
+ * ModelPad connects model metadata to reusable selection, labeling, iterator, or table UI patterns.
4
+ * This doc block is consumed by vue-docgen for generated API documentation.
5
+ */
6
+ import { computed, useTemplateRef, defineExpose } from 'vue'
7
+ import { type GraphqlModelItemProps, useGraphqlModelItem } from '../../composables/graphqlModelItem'
8
+ import type {FormDialogCallback} from '../../types/formDialog'
9
+ import EditPad from '../form/EditPad.vue'
10
+ import {useDialog} from "../../composables/dialog";
11
+
12
+ defineOptions({
13
+ inheritAttrs: false,
14
+ })
15
+
16
+ interface Props extends /* @vue-ignore */ InstanceType<typeof EditPad['$props']> {
17
+ title?: string // Title text displayed in the component header or dialog.
18
+ saveCaption?: string // Label text for the save/confirm action button.
19
+ cancelCaption?: string // Label text for the cancel action button.
20
+ }
21
+
22
+ /**
23
+ * Public props accepted by ModelPad.
24
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
25
+ */
26
+ const props = withDefaults(defineProps<Props & GraphqlModelItemProps>(), {
27
+ fields: () => ['*'],
28
+
29
+ saveCaption: 'บันทึก',
30
+ cancelCaption: 'ยกเลิก',
31
+ })
32
+
33
+ /**
34
+ * Custom events emitted by ModelPad.
35
+ * Parents can listen to these events to react to user actions and internal state changes.
36
+ */
37
+ const emit = defineEmits(['create', 'update'])
38
+
39
+ const { item,
40
+ canCreate, canUpdate,
41
+ createItem, updateItem,
42
+ reload, isLoading } = useGraphqlModelItem(props)
43
+
44
+ const editPad = useTemplateRef<typeof EditPad>("editPadRef")
45
+
46
+ const canSave = computed<boolean>(() => { return ((canCreate.value && editPad.value?.operation?.isCreating?.value) || canUpdate.value) as boolean})
47
+
48
+ const operation : any = computed(()=>{
49
+ return Object.assign({},editPad.value?.operation,{canSave,reload,item})
50
+ })
51
+
52
+ const onCreateItem = (item: Record<string, any>,callback?: FormDialogCallback)=>{
53
+ createItem(item,callback).then(()=>{
54
+ useDialog().notify({message: "Data created successfully",type: 'success',title:"Success"})
55
+ emit("create",item,callback)
56
+ })
57
+ }
58
+
59
+ const onUpdateItem = (item: Record<string, any>,callback?: FormDialogCallback)=>{
60
+ updateItem(item,callback).then(()=>{
61
+ useDialog().notify({message: "Data updated successfully",type: 'success',title:"Success"})
62
+ emit("update",item,callback)
63
+ })
64
+ }
65
+
66
+ defineExpose({ operation, formPad: editPad.value?.formPad })
67
+ </script>
68
+
69
+ <template>
70
+ <FormEditPad v-bind="$attrs" :form-data="item" ref="editPadRef" @create="onCreateItem" @update="onUpdateItem">
71
+ <template #titleToolbar>
72
+ <slot name="titleToolbar" :operation="operation">
73
+ <VToolbarTitle>
74
+ <slot name="title" :operation="operation">
75
+ {{ title }}
76
+ <v-icon
77
+ size="small"
78
+ @click="reload"
79
+ >
80
+ mdi mdi-refresh
81
+ </v-icon>
82
+ </slot>
83
+ </VToolbarTitle>
84
+ </slot>
85
+ </template>
86
+ <template #action="slotData">
87
+ <slot name="action" :operation="operation">
88
+ <VSpacer />
89
+ <VBtn
90
+ color="primary"
91
+ variant="flat"
92
+ :loading="isLoading"
93
+ :disabled="!slotData.operation?.isDataChange || !canSave"
94
+ @click="slotData.operation?.save"
95
+ >
96
+ {{ props.saveCaption }}
97
+ </VBtn>
98
+ <VBtn
99
+ color="error"
100
+ variant="flat"
101
+ :disabled="isLoading"
102
+ @click="slotData.operation?.cancel"
103
+ >
104
+ {{ props.cancelCaption }}
105
+ </VBtn>
106
+ </slot>
107
+ </template>
108
+ <template #default="slotData">
109
+ <slot
110
+ v-bind="slotData"
111
+ />
112
+ </template>
113
+ </FormEditPad>
114
+ </template>
@@ -1,85 +1,79 @@
1
- <script lang="ts" setup>
2
- /**
3
- * ModelSelect connects model metadata to reusable selection, labeling, iterator, or table UI patterns.
4
- * This doc block is consumed by vue-docgen for generated API documentation.
5
- */
6
- import { VCombobox } from 'vuetify/components/VCombobox'
7
- import { defineModel, withDefaults } from 'vue'
8
- import { useLookupList, type StaticLookupProps } from '../../composables/lookupList'
9
- import { useLocalStorageModel, type PersistSlimProps } from '../../composables/localStorageModel'
10
-
11
- interface Props extends /* @vue-ignore */ InstanceType<typeof VCombobox['$props']> {}
12
-
13
- /**
14
- * Public props accepted by ModelSelect.
15
- * Document each prop field with intent, defaults, and side effects for clear generated docs.
16
- */
17
- const props = withDefaults(defineProps<Props & StaticLookupProps & PersistSlimProps>(), {
18
- fuzzy: false, // Enables fuzzy matching when filtering local options.
19
- showCode: false, // Displays code values alongside labels in option lists.
20
- cache: false, // Enables cached requests; number values represent cache TTL in milliseconds.
21
-
22
- statusField: 'statusCode', // Field name that indicates active/inactive status in each item.
23
- activeValue: 'active', // Value in statusField treated as active/selectable.
24
- hideInactiveInList: false, // Hides inactive options from the displayed selection list.
25
- preventSelectingInactive: false, // Blocks selecting inactive options even if present in the dataset.
26
- })
27
-
28
- /**
29
- * Custom events emitted by ModelSelect.
30
- * Parents can listen to these events to react to user actions and internal state changes.
31
- */
32
- const emit = defineEmits<{
33
- (e: 'update:selectedObject', object: any | any[]): void
34
- }>()
35
-
36
- const selectedItems = defineModel<any>()
37
- useLocalStorageModel(selectedItems, props)
38
-
39
- const {
40
- computedItems,
41
- computedFilterKeys,
42
- computedPlaceholder,
43
- computedNoDataText,
44
- isLoading,
45
- isErrorLoading,
46
- searchData,
47
- onUpdateModelValue, // ✅ from composable
48
- } = useLookupList(props as any, emit, selectedItems)
49
- </script>
50
-
51
- <template>
52
- <v-combobox
53
- :model-value="selectedItems"
54
- @update:model-value="onUpdateModelValue"
55
- v-model:search="searchData"
56
- v-bind="$attrs"
57
- :items="computedItems"
58
- :filter-keys="computedFilterKeys"
59
- :item-title="props.itemTitle"
60
- :item-value="props.itemValue"
61
- :loading="isLoading"
62
- :placeholder="computedPlaceholder"
63
- :no-data-text="computedNoDataText"
64
- :multiple="props.multiple"
65
- :return-object="false"
66
- >
67
- <!-- passthrough slots -->
68
- <!-- @ts-ignore -->
69
- <template v-for="(_, name, index) in ($slots as {})" :key="index" #[name]="slotData">
70
- <slot :name="name" v-bind="((slotData || {}) as object)" />
71
- </template>
72
-
73
- <template v-if="!$slots.item" #item="{ props: itemProps, item }">
74
- <v-list-item v-bind="itemProps" :title="(props.showCode ? item.value + '-' : '') + item.title" />
75
- </template>
76
-
77
- <template v-if="!$slots.selection && props.showCode" #selection="{ item }">
78
- {{ item.value + '-' + item.title }}
79
- </template>
80
-
81
- <template v-if="isErrorLoading" #append>
82
- <v-icon color="error">mdi mdi-alert</v-icon>
83
- </template>
84
- </v-combobox>
1
+ <script lang="ts" setup>
2
+ /**
3
+ * ModelSelect connects model metadata to reusable selection, labeling, iterator, or table UI patterns.
4
+ * This doc block is consumed by vue-docgen for generated API documentation.
5
+ */
6
+ import { VSelect } from 'vuetify/components/VSelect'
7
+ import { defineModel, withDefaults } from 'vue'
8
+ import { useLookupList, type StaticLookupProps } from '../../composables/lookupList'
9
+ import { useLocalStorageModel, type PersistSlimProps } from '../../composables/localStorageModel'
10
+
11
+ interface Props extends /* @vue-ignore */ InstanceType<typeof VSelect['$props']> {}
12
+
13
+ /**
14
+ * Public props accepted by ModelSelect.
15
+ * Document each prop field with intent, defaults, and side effects for clear generated docs.
16
+ */
17
+ const props = withDefaults(defineProps<Props & StaticLookupProps & PersistSlimProps>(), {
18
+ fuzzy: false, // Enables fuzzy matching when filtering local options.
19
+ showCode: false, // Displays code values alongside labels in option lists.
20
+ cache: false, // Enables cached requests; number values represent cache TTL in milliseconds.
21
+
22
+ statusField: 'statusCode', // Field name that indicates active/inactive status in each item.
23
+ activeValue: 'active', // Value in statusField treated as active/selectable.
24
+ hideInactiveInList: false, // Hides inactive options from the displayed selection list.
25
+ preventSelectingInactive: false, // Blocks selecting inactive options even if present in the dataset.
26
+ })
27
+
28
+ /**
29
+ * Custom events emitted by ModelSelect.
30
+ * Parents can listen to these events to react to user actions and internal state changes.
31
+ */
32
+ const emit = defineEmits<{
33
+ (e: 'update:selectedObject', object: any | any[]): void
34
+ }>()
35
+
36
+ const selectedItems = defineModel<any>()
37
+ useLocalStorageModel(selectedItems, props)
38
+
39
+ const {
40
+ computedItems,
41
+ computedNoDataText,
42
+ isLoading,
43
+ isErrorLoading,
44
+ onUpdateModelValue,
45
+ } = useLookupList(props as any, emit, selectedItems)
46
+ </script>
47
+
48
+ <template>
49
+ <v-select
50
+ :model-value="selectedItems"
51
+ @update:model-value="onUpdateModelValue"
52
+ v-bind="$attrs"
53
+ :items="computedItems"
54
+ :item-title="props.itemTitle"
55
+ :item-value="props.itemValue"
56
+ :loading="isLoading"
57
+ :no-data-text="computedNoDataText"
58
+ :multiple="props.multiple"
59
+ :return-object="false"
60
+ >
61
+ <!-- passthrough slots -->
62
+ <!-- @ts-ignore -->
63
+ <template v-for="(_, name, index) in ($slots as {})" :key="index" #[name]="slotData">
64
+ <slot :name="name" v-bind="((slotData || {}) as object)" />
65
+ </template>
66
+
67
+ <template v-if="!$slots.item" #item="{ props: itemProps, item }">
68
+ <v-list-item v-bind="itemProps" :title="(props.showCode ? item.value + '-' : '') + item.title" />
69
+ </template>
70
+
71
+ <template v-if="!$slots.selection && props.showCode" #selection="{ item }">
72
+ {{ item.value + '-' + item.title }}
73
+ </template>
74
+
75
+ <template v-if="isErrorLoading" #append>
76
+ <v-icon color="error">mdi mdi-alert</v-icon>
77
+ </template>
78
+ </v-select>
85
79
  </template>