docs(DsfrMultiselect): 📝 ajoute la JSDoc pour les slots

- Pour améliorer la documentation et l'expérience de développement en fournissant une description claire de chaque slot directement dans le composant.
- Pour suivre les conventions de documentation du projet.

- Remplacement de l'import `DsfrMultiSelectSlots` par une définition en ligne dans `defineSlots`.
- Ajout de commentaires JSDoc détaillés pour chaque slot (`label`, `required-tip`, `hint`, `button-label`, `legend`, `checkbox-label`, `no-results`).
- Suppression de l'import inutilisé `DsfrMultiSelectSlots` du fichier de types.

Author: laruiss

src/components/DsfrMultiselect/DsfrMultiSelect.stories.ts

@@ -1,4 +1,5 @@
 import type { Meta, StoryObj } from '@storybook/vue3'
+
 import { fn } from '@storybook/test'
 import { ref, watch } from 'vue'
 
@@ -10,7 +11,7 @@ import DsfrMultiSelect from './DsfrMultiselect.vue'
 const meta = {
   component: DsfrMultiSelect,
   title: 'Composants/DsfrMultiSelect',
-  tags: ['autodocs', 'formulaire'],
+  tags: ['formulaire'],
   argTypes: {
     selectId: {
       control: 'text',

src/components/DsfrMultiselect/DsfrMultiselect.types.ts

@@ -1,5 +1,3 @@
-import type { VNode } from 'vue'
-
 export type DsfrMultiSelectProps<T> = {
   modelValue: (string | number)[]
   options: T[]
@@ -24,13 +22,3 @@ export type DsfrMultiSelectProps<T> = {
   filteringKeys?: (keyof T)[]
   maxOverflowHeight?: CSSStyleDeclaration['maxHeight']
 }
-
-export type DsfrMultiSelectSlots<T> = {
-  label?: () => VNode
-  'required-tip'?: () => VNode
-  hint?: () => VNode
-  'button-label'?: () => VNode
-  legend?: () => VNode
-  'checkbox-label'?: (props: { option: T }) => VNode
-  'no-results'?: () => VNode
-}

src/components/DsfrMultiselect/DsfrMultiselect.vue

@@ -1,5 +1,6 @@
 <script lang="ts" setup generic="T extends Object | string | number">
-import type { DsfrMultiSelectProps, DsfrMultiSelectSlots } from './DsfrMultiselect.types'
+import type { DsfrMultiSelectProps } from './DsfrMultiselect.types'
+import type { VNode } from 'vue'
 
 import { computed, onUnmounted, ref } from 'vue'
 
@@ -36,7 +37,36 @@ const props = withDefaults(
   },
 )
 
-defineSlots<DsfrMultiSelectSlots<T>>()
+defineSlots<{
+  /**
+   * Slot pour personnaliser le label.
+   */
+  label?: () => VNode
+  /**
+   * Slot pour personnaliser l'indicateur de champ requis.
+   */
+  'required-tip'?: () => VNode
+  /**
+   * Slot pour ajouter un texte d'aide.
+   */
+  hint?: () => VNode
+  /**
+   * Slot pour personnaliser le label du bouton.
+   */
+  'button-label'?: () => VNode
+  /**
+   * Slot pour ajouter une légende au fieldset des cases à cocher.
+   */
+  legend?: () => VNode
+  /**
+   * Slot pour personnaliser le label de chaque case à cocher.
+   */
+  'checkbox-label'?: (props: { option: T }) => VNode
+  /**
+   * Slot pour afficher un message quand il n'y a pas de résultats de recherche.
+   */
+  'no-results'?: () => VNode
+}>()
 
 const isObjectWithIdKey = (
   option: unknown,