@cnamts/synapse 1.0.25 → 1.0.27

package/src/components/SyTextArea/tests/SyTextArea.spec.ts

@@ -1,5 +1,8 @@
-import { it, describe, expect } from 'vitest'
+import { it, describe, expect, vi } from 'vitest'
 import { flushPromises, mount } from '@vue/test-utils'
+import { ref } from 'vue'
+import SyForm from '../../Customs/SyForm/SyForm.vue'
+import SyIcon from '../../Customs/SyIcon/SyIcon.vue'
 import SyTextArea from '../SyTextArea.vue'
 
 describe('SyTextArea', () => {
@@ -324,4 +327,449 @@ describe('SyTextArea', () => {
 
 		expect(wrapper.text()).toContain('Succès personnalisé')
 	})
+
+	it('validates only on blur when isValidateOnBlur is true', async () => {
+		const wrapper = mount(SyTextArea, {
+			props: {
+				modelValue: '',
+				label: 'Description des symptomes',
+				isValidateOnBlur: true,
+				customRules: [
+					{
+						type: 'custom',
+						options: {
+							validate: (value: string) => value !== 'interdit',
+							message: 'Erreur isValidateOnBlur',
+						},
+					},
+				],
+			},
+		})
+
+		const textarea = wrapper.find('textarea')
+		await textarea.trigger('focus')
+		await textarea.setValue('interdit')
+		await flushPromises()
+
+		expect(wrapper.text()).not.toContain('Erreur isValidateOnBlur')
+
+		await textarea.trigger('blur')
+		await flushPromises()
+
+		expect(wrapper.text()).toContain('Erreur isValidateOnBlur')
+	})
+
+	it('keeps success visual state but hides success text when showSuccessMessages is false', async () => {
+		const wrapper = mount(SyTextArea, {
+			props: {
+				modelValue: '',
+				label: 'Description des symptomes',
+				isValidateOnBlur: false,
+				showSuccessMessages: false,
+				customSuccessRules: [
+					{
+						type: 'custom',
+						options: {
+							successMessage: 'Succès masqué',
+							validate: () => true,
+						},
+					},
+				],
+			},
+		})
+
+		const textarea = wrapper.find('textarea')
+		await textarea.trigger('focus')
+		await textarea.setValue('valeur')
+		await textarea.trigger('blur')
+		await flushPromises()
+
+		// eslint-disable-next-line @typescript-eslint/no-explicit-any
+		expect((wrapper.vm as any).hasSuccess).toBe(true)
+		expect(wrapper.find('.success-field').exists()).toBe(true)
+		expect(wrapper.find('.sy-textarea__state-icon').exists()).toBe(true)
+		expect(wrapper.findComponent(SyIcon).props('color')).toBe('onSuccessVariant')
+		expect(wrapper.text()).not.toContain('Succès masqué')
+	})
+
+	it('applies warning visual state and warning icon when warning rules fail', async () => {
+		const wrapper = mount(SyTextArea, {
+			props: {
+				modelValue: '',
+				label: 'Description des symptomes',
+				isValidateOnBlur: false,
+				customWarningRules: [
+					{
+						type: 'custom',
+						options: {
+							warningMessage: 'Avertissement visuel',
+							validate: () => false,
+						},
+					},
+				],
+			},
+		})
+
+		const textarea = wrapper.find('textarea')
+		await textarea.trigger('focus')
+		await textarea.setValue('valeur')
+		await textarea.trigger('blur')
+		await flushPromises()
+
+		expect(wrapper.find('.warning-field').exists()).toBe(true)
+		expect(wrapper.find('.sy-textarea__state-icon').exists()).toBe(true)
+		expect(wrapper.findComponent(SyIcon).props('color')).toBe('onWarningVariant')
+	})
+
+	it('applies error visual state and error icon when validation fails', async () => {
+		const wrapper = mount(SyTextArea, {
+			props: {
+				modelValue: '',
+				label: 'Description des symptomes',
+				required: true,
+			},
+		})
+
+		const textarea = wrapper.find('textarea')
+		await textarea.trigger('focus')
+		await textarea.trigger('blur')
+		await flushPromises()
+
+		expect(wrapper.find('.error-field').exists()).toBe(true)
+		expect(wrapper.find('.sy-textarea__state-icon').exists()).toBe(true)
+		expect(wrapper.findComponent(SyIcon).props('color')).toBe('error')
+	})
+
+	describe('Affichage de l\'astérisque', () => {
+		it('affiche l\'astérisque quand displayAsterisk et required sont true', () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Test Label',
+					displayAsterisk: true,
+					required: true,
+				},
+			})
+
+			expect(wrapper.html()).toContain('Test Label *')
+		})
+
+		it('n\'affiche pas l\'astérisque quand displayAsterisk est false', () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Test Label',
+					displayAsterisk: false,
+					required: true,
+				},
+			})
+
+			expect(wrapper.html()).not.toContain('Test Label *')
+			expect(wrapper.html()).toContain('Test Label')
+		})
+
+		it('n\'affiche pas l\'astérisque quand required est false', () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Test Label',
+					displayAsterisk: true,
+					required: false,
+				},
+			})
+
+			expect(wrapper.html()).not.toContain('Test Label *')
+		})
+	})
+
+	describe('helpText', () => {
+		it('affiche le helpText quand aucun message de validation n\'est présent', () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					helpText: 'Texte d\'aide',
+				},
+			})
+
+			expect(wrapper.text()).toContain('Texte d\'aide')
+		})
+
+		it('masque le helpText quand des erreurs sont présentes', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					helpText: 'Texte d\'aide',
+					required: true,
+				},
+			})
+
+			const textarea = wrapper.find('textarea')
+			await textarea.trigger('focus')
+			await textarea.trigger('blur')
+
+			expect(wrapper.text()).not.toContain('Texte d\'aide')
+			expect(wrapper.text()).toContain('Ce champ est requis')
+		})
+	})
+
+	describe('hideDetails', () => {
+		it('masque la zone des messages quand hideDetails est true et qu\'il n\'y a pas de messages', () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					hideDetails: true,
+				},
+			})
+
+			expect(wrapper.find('.v-messages').exists()).toBe(false)
+		})
+
+		it('affiche la zone des messages quand hideDetails est true mais qu\'il y a des erreurs', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					hideDetails: true,
+					required: true,
+				},
+			})
+
+			const textarea = wrapper.find('textarea')
+			await textarea.trigger('focus')
+			await textarea.trigger('blur')
+
+			expect(wrapper.find('.v-messages').exists()).toBe(true)
+			expect(wrapper.text()).toContain('Ce champ est requis')
+		})
+
+		it('affiche la zone des messages par défaut (hideDetails vaut false)', () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+				},
+			})
+
+			expect(wrapper.find('.v-messages').exists()).toBe(true)
+		})
+	})
+
+	describe('clearable', () => {
+		it('affiche le bouton de suppression quand clearable est true et qu\'une valeur est saisie', () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: 'contenu',
+					label: 'Description',
+					clearable: true,
+				},
+				attachTo: document.body,
+			})
+
+			expect(wrapper.find('.sy-textarea__clear-button').exists()).toBe(true)
+
+			wrapper.unmount()
+		})
+
+		it('n\'affiche pas le bouton de suppression quand clearable est false', () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: 'contenu',
+					label: 'Description',
+					clearable: false,
+				},
+				attachTo: document.body,
+			})
+
+			expect(wrapper.find('.sy-textarea__clear-button').exists()).toBe(false)
+
+			wrapper.unmount()
+		})
+
+		it('vide le champ au clic sur le bouton de suppression', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: 'contenu',
+					label: 'Description',
+					clearable: true,
+				},
+				attachTo: document.body,
+			})
+
+			const clearButton = wrapper.find('.sy-textarea__clear-button')
+			await clearButton.trigger('click')
+			await flushPromises()
+
+			expect(wrapper.emitted('update:modelValue')).toBeTruthy()
+			const emittedValues = wrapper.emitted('update:modelValue') as string[][]
+			expect(emittedValues[emittedValues.length - 1]).toEqual([''])
+
+			wrapper.unmount()
+		})
+	})
+
+	describe('disableErrorHandling', () => {
+		it('n\'affiche pas d\'erreur pour un champ requis sans valeur quand disableErrorHandling est true', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					required: true,
+					disableErrorHandling: true,
+				},
+			})
+
+			const textarea = wrapper.find('textarea')
+			await textarea.trigger('focus')
+			await textarea.trigger('blur')
+
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			expect((wrapper.vm as any).hasError).toBe(false)
+			expect(wrapper.text()).not.toContain('Ce champ est requis')
+		})
+
+		it('affiche les erreurs normalement quand disableErrorHandling est false', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					required: true,
+					disableErrorHandling: false,
+				},
+			})
+
+			const textarea = wrapper.find('textarea')
+			await textarea.trigger('focus')
+			await textarea.trigger('blur')
+
+			expect(wrapper.text()).toContain('Ce champ est requis')
+		})
+	})
+
+	describe('validateOnSubmit / clearValidation', () => {
+		it('validateOnSubmit retourne true quand le champ est valide', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: 'valeur',
+					label: 'Description',
+					required: true,
+				},
+			})
+
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			const isValid = await (wrapper.vm as any).validateOnSubmit()
+			await flushPromises()
+
+			expect(isValid).toBe(true)
+		})
+
+		it('validateOnSubmit retourne false quand le champ est invalide', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					isValidateOnBlur: false,
+					customRules: [{
+						type: 'custom',
+						options: {
+							validate: (value: string) => value.length <= 5,
+							message: 'Valeur trop longue.',
+						},
+					}],
+				},
+			})
+
+			const textarea = wrapper.find('textarea')
+			await textarea.trigger('focus')
+			await textarea.setValue('valeur trop longue')
+			await textarea.trigger('blur')
+			await flushPromises()
+
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			const isValid = await (wrapper.vm as any).validateOnSubmit()
+			await flushPromises()
+
+			expect(isValid).toBe(false)
+			expect(wrapper.text()).toContain('Valeur trop longue.')
+		})
+
+		it('validateOnSubmit retourne false quand un champ requis est vide', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					required: true,
+				},
+			})
+
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			const isValid = await (wrapper.vm as any).validateOnSubmit()
+			await flushPromises()
+
+			expect(isValid).toBe(false)
+			expect(wrapper.text()).toContain('Ce champ est requis')
+		})
+
+		it('clearValidation remet l\'état d\'erreur à zéro', async () => {
+			const wrapper = mount(SyTextArea, {
+				props: {
+					modelValue: '',
+					label: 'Description',
+					isValidateOnBlur: false,
+					customRules: [{
+						type: 'custom',
+						options: {
+							validate: (value: string) => value.length <= 5,
+							message: 'Valeur trop longue.',
+						},
+					}],
+				},
+			})
+
+			const textarea = wrapper.find('textarea')
+			await textarea.trigger('focus')
+			await textarea.setValue('valeur trop longue')
+			await textarea.trigger('blur')
+			await flushPromises()
+
+			expect(wrapper.text()).toContain('Valeur trop longue.')
+
+			// eslint-disable-next-line @typescript-eslint/no-explicit-any
+			const instance = wrapper.vm as any
+			instance.clearValidation()
+			await flushPromises()
+			expect(wrapper.find('.v-messages__message').exists()).toBe(false)
+		})
+	})
+
+	describe('SyForm integration', () => {
+		it('valide un champ requis vide lors de la soumission sans interaction préalable', async () => {
+			const onSubmit = vi.fn()
+			const wrapper = mount({
+				components: { SyForm, SyTextArea },
+				setup() {
+					const value = ref('')
+					return { onSubmit, value }
+				},
+				template: `
+					<SyForm @submit="onSubmit">
+						<SyTextArea
+							v-model="value"
+							label="Description"
+							required
+						/>
+						<button type="submit">Soumettre</button>
+					</SyForm>
+				`,
+			})
+
+			await wrapper.find('form').trigger('submit')
+			await flushPromises()
+
+			expect(onSubmit).toHaveBeenCalledWith({ isValid: false })
+			expect(wrapper.text()).toContain('Ce champ est requis')
+		})
+	})
 })

package/src/components/SyTextArea/useDefaultValidationRules.ts

@@ -40,14 +40,9 @@ export function useDefaultValidationRules(params: {
 
 		if (params.required.value) {
 			rules.push({
-				type: 'custom',
+				type: 'required',
 				options: {
-					validate: (value: string) => {
-						if (!params.hasInteracted.value) {
-							return true
-						}
-						return !!value || locales.required
-					},
+					message: locales.required,
 				},
 			})
 		}