@signal24/vue-foundation 4.25.3 → 4.25.5

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@signal24/vue-foundation",
     "type": "module",
-    "version": "4.25.3",
+    "version": "4.25.5",
     "description": "Common components, directives, and helpers for Vue 3 apps",
     "module": "./dist/vue-foundation.es.js",
     "exports": {

package/src/components/vf-smart-select.vue

@@ -51,7 +51,9 @@
 
 <script lang="ts" setup generic="T, V = T">
 import { debounce, groupBy, isEqual, uniq } from 'lodash';
-import { computed, onMounted, type Ref, ref, watch } from 'vue';
+import { computed, onMounted, ref, watch } from 'vue';
+
+import { isNotNullOrUndefined } from '@/helpers';
 
 import { escapeHtml } from '../helpers/string';
 import type { VfSmartSelectOptionDescriptor } from './vf-smart-select.types';
@@ -63,6 +65,7 @@ const VALID_KEYS = `\`1234567890-=[]\\;',./~!@#$%^&*()_+{}|:"<>?qwertyuiopasdfgh
 
 const props = defineProps<{
     modelValue: V | null;
+    loadingText?: string;
     loadOptions?: (searchText: string | null) => Promise<T[]>;
     options?: T[];
     prependOptions?: T[];
@@ -82,6 +85,7 @@ const props = defineProps<{
     formatter?: (option: T) => string;
     subtitleFormatter?: (option: T) => string;
     classForOption?: (option: T) => string;
+    selectionFormatter?: (option: T) => string;
     nullTitle?: string;
     noResultsText?: string;
     disabled?: boolean;
@@ -108,7 +112,7 @@ const optionsContainer = ref<HTMLDivElement>();
 
 const isLoading = ref(false);
 const isLoaded = ref(false);
-const loadedOptions = ref<T[]>([]) as Ref<T[]>;
+const loadedOptions = ref<T[]>();
 const isSearching = ref(false);
 const searchText = ref('');
 const selectedOption = ref<T | null>(null);
@@ -120,7 +124,7 @@ const shouldShowCreateTextOnNewItem = computed(() => props.showCreateTextOnNewIt
 
 const effectivePrependOptions = computed(() => props.prependOptions ?? []);
 const effectiveAppendOptions = computed(() => props.appendOptions ?? []);
-const effectiveDisabled = computed(() => !!props.disabled);
+const effectiveDisabled = computed(() => !!props.disabled || (!props.options && !loadedOptions.value));
 const effectivePlaceholder = computed(() => {
     if (!isLoaded.value && props.preload) return 'Loading...';
     if (props.nullTitle) return props.nullTitle;
@@ -149,8 +153,12 @@ const effectiveFormatter = computed(() => {
     if (props.labelField) return (option: T) => String(option[props.labelField!]);
     return (option: T) => String(option);
 });
+const effectiveSelectionFormatter = computed(() => {
+    if (props.selectionFormatter) return props.selectionFormatter;
+    return effectiveFormatter.value;
+});
 
-const allOptions = computed(() => [...effectivePrependOptions.value, ...loadedOptions.value, ...effectiveAppendOptions.value]);
+const allOptions = computed(() => [...effectivePrependOptions.value, ...(loadedOptions.value ?? []), ...effectiveAppendOptions.value]);
 const isGrouped = computed(() => !!(props.groupField || props.groupFormatter));
 
 const optionsDescriptors = computed(() => {
@@ -249,7 +257,7 @@ watch(() => props.modelValue, handleValueChanged);
 watch(
     () => props.options,
     () => {
-        loadedOptions.value = props.options ?? [];
+        loadedOptions.value = props.options;
         isLoaded.value = true;
     }
 );
@@ -301,17 +309,21 @@ onMounted(async () => {
     if (props.options) {
         loadedOptions.value = [...props.options];
         isLoaded.value = true;
-    } else if (props.preload) {
+    } else if (props.loadOptions && props.preload) {
         await loadRemoteOptions();
     }
 
-    handleValueChanged();
+    if (!props.options && (props.valueField || props.valueExtractor)) {
+        searchText.value = props.loadingText ?? '...';
+    } else {
+        handleValueChanged();
+    }
 
     watch(selectedOption, () => {
         if (selectedOption.value !== props.modelValue) {
             emit(
                 'update:modelValue',
-                selectedOption.value !== null && effectiveValueExtractor.value !== null
+                isNotNullOrUndefined(selectedOption.value) && effectiveValueExtractor.value !== null
                     ? effectiveValueExtractor.value(selectedOption.value)
                     : selectedOption.value
             );
@@ -536,7 +548,7 @@ function selectOption(option: VfSmartSelectOptionDescriptor<T>) {
         const selectedDecoratedOption = optionsDescriptors.value.find(decoratedOption => decoratedOption.key == option.key);
         const realOption = selectedDecoratedOption!.ref;
         selectedOption.value = realOption!;
-        selectedOptionTitle.value = effectiveFormatter.value(realOption!);
+        selectedOptionTitle.value = effectiveSelectionFormatter.value(realOption!);
         searchText.value = selectedOptionTitle.value ?? '';
     }
 
@@ -549,7 +561,7 @@ function handleValueChanged() {
         selectedOption.value = effectiveValueExtractor.value
             ? allOptions.value.find(o => props.modelValue === effectiveValueExtractor.value!(o))
             : props.modelValue;
-        selectedOptionTitle.value = selectedOption.value !== null ? effectiveFormatter.value(selectedOption.value) : null;
+        selectedOptionTitle.value = isNotNullOrUndefined(selectedOption.value) ? effectiveSelectionFormatter.value(selectedOption.value) : null;
         searchText.value = selectedOptionTitle.value ?? '';
     } else {
         selectedOption.value = null;
@@ -559,7 +571,7 @@ function handleValueChanged() {
 }
 
 function addRemoteOption(option: T) {
-    loadedOptions.value.unshift(option);
+    loadedOptions.value!.unshift(option);
 }
 
 function focusNextInput() {

package/src/helpers/object.ts

@@ -18,3 +18,7 @@ export function nullifyEmptyInputs<T extends Record<string, unknown>, K extends
     }
     return result;
 }
+
+export function isNotNullOrUndefined<T>(value: T | null | undefined): value is T {
+    return value !== null && value !== undefined;
+}