refactor(DsfrHeader): ♻️ améliore defineSlots et met à jour imports Storybook

- Améliore DsfrHeader avec JSDoc pour defineSlots existants et supprime les commentaires HTML obsolètes
- Met à jour les imports Storybook depuis 'storybook/test' vers '@storybook/test'
- Améliore la documentation des slots (default, operator, mainnav, before-quick-links, after-quick-links) avec JSDoc

- Ajoute JSDoc à defineSlots existant dans DsfrHeader.vue
- Supprime les commentaires HTML <!-- @slot --> remplacés par la JSDoc
- Met à jour les imports avec Meta et StoryObj depuis @storybook/vue3-vite
- Transforme export default en const meta avec satisfies Meta<typeof DsfrHeader>
- Ajoute le type Story = StoryObj<typeof meta>
- Corrige l'import expect/within/fn depuis @storybook/test
- Corrige les apostrophes échappées dans les descriptions

Author: laruiss

src/components/DsfrHeader/DsfrHeader.stories.ts

@@ -1,6 +1,7 @@
+import type { Meta, StoryObj } from '@storybook/vue3-vite'
 import type { DsfrLanguageSelectorElement } from '../DsfrLanguageSelector/DsfrLanguageSelector.types'
 
-import { expect, fn, within } from 'storybook/test'
+import { expect, fn, within } from '@storybook/test'
 
 import DsfrNavigation from '../DsfrNavigation/DsfrNavigation.vue'
 
@@ -10,9 +11,9 @@ const delay = (timeout = 100) =>
   new Promise((resolve) => setTimeout(resolve, timeout))
 
 /**
- * [Voir quand l’utiliser sur la documentation du DSFR](https://www.systeme-de-design.gouv.fr/version-courante/fr/composants/en-tete)
+ * [Voir quand l\'utiliser sur la documentation du DSFR](https://www.systeme-de-design.gouv.fr/version-courante/fr/composants/en-tete)
  */
-export default {
+const meta = {
   component: DsfrHeader,
   title: 'Composants/DsfrHeader',
   argTypes: {
@@ -112,7 +113,11 @@ export default {
         'Label de l\'accueil composant le titre du lien présentant le service.',
     },
   },
-}
+} satisfies Meta<typeof DsfrHeader>
+
+export default meta
+
+type Story = StoryObj<typeof meta>
 
 export const EnTeteSimple = (args) => ({
   components: {

src/components/DsfrHeader/DsfrHeader.vue

@@ -42,6 +42,13 @@ const emit = defineEmits<{
   (e: 'languageSelect', payload: DsfrLanguageSelectorElement): void
 }>()
 
+/**
+ * @slot default - Slot par défaut pour le contenu du fieldset (sera dans `<div class="fr-header__body-row">`)
+ * @slot operator - Slot nommé operator pour le logo opérateur. Sera dans `<div class="fr-header__operator">`
+ * @slot mainnav - Slot nommé mainnav pour le menu de navigation principal
+ * @slot before-quick-links - Slot pour du contenu avant les liens rapides
+ * @slot after-quick-links - Slot pour du contenu après les liens rapides
+ */
 const slots = defineSlots<{
   default: () => any
   operator: () => any
@@ -131,7 +138,6 @@ provide(registerNavigationLinkKey, () => {
                 v-if="isWithSlotOperator"
                 class="fr-header__operator"
               >
-                <!-- @slot Slot nommé operator pour le logo opérateur. Sera dans `<div class="fr-header__operator">` -->
                 <slot name="operator">
                   <img
                     v-if="operatorImgSrc"
@@ -313,7 +319,6 @@ provide(registerNavigationLinkKey, () => {
             </div>
           </div>
         </FocusTrap>
-        <!-- @slot Slot par défaut pour le contenu du fieldset (sera dans `<div class="fr-header__body-row">`) -->
         <slot />
       </div>
     </div>
@@ -322,7 +327,6 @@ provide(registerNavigationLinkKey, () => {
         v-if="isWithSlotNav && !modalOpened"
         class="fr-container"
       >
-        <!-- @slot Slot nommé mainnav pour le menu de navigation principal -->
         <slot
           name="mainnav"
           :hidemodal="hideModal"