fix: date year picker (#84)

| Numéro du ticket | Titre du ticket |
|------------------|-----------------|
|                  |                 |

## Description de la PR

## Modification du .env

## Check list

- [ ] Pas de régression
- [ ] TU/TI/TF rédigée
- [ ] TU/TI/TF OK
- [ ] CHANGELOG modifié

---------

Co-authored-by: admin malio <malio@yuno.malio.fr>
Co-authored-by: THOLOT DECHENE Matthieu <matthieu@yuno.malio.fr>
Co-authored-by: matthieu <matthieu@yuno.malio.fr>
Reviewed-on: #84
Co-authored-by: tristan <tristan@yuno.malio.fr>
Co-committed-by: tristan <tristan@yuno.malio.fr>

app/components/malio/date/internal/CalendarField.vue

@@ -88,7 +88,7 @@
           :current-year="currentYear"
           @prev="goToPrev"
           @next="goToNext"
-          @toggle-view="toggleView"
+          @toggle-view="cycleView"
         />
         <slot
           v-if="viewMode === 'days'"
@@ -97,10 +97,21 @@
           :close="closePopover"
         />
         <MonthPicker
-          v-else
+          v-else-if="viewMode === 'months'"
           :selected-month="currentMonth"
+          :current-year="currentYear"
+          :min="min"
+          :max="max"
           @select="onSelectMonth"
         />
+        <YearPicker
+          v-else
+          :page-start="yearPageStart"
+          :selected-year="currentYear"
+          :min="min"
+          :max="max"
+          @select="onSelectYear"
+        />
       </div>
     </div>
 
@@ -127,6 +138,7 @@ import type {MaskInputOptions} from 'maska'
 import MalioRequiredMark from '../../shared/RequiredMark.vue'
 import CalendarHeader from './CalendarHeader.vue'
 import MonthPicker from './MonthPicker.vue'
+import YearPicker from './YearPicker.vue'
 import {useCalendarPopover} from '../composables/useCalendarPopover'
 import {useCalendarView} from '../composables/useCalendarView'
 import {buildBoundedMask} from '../composables/maskTemplate'
@@ -157,6 +169,8 @@ const props = withDefaults(
     labelClass?: string
     groupClass?: string
     reserveMessageSpace?: boolean
+    min?: string
+    max?: string
   }>(),
   {
     id: '',
@@ -176,6 +190,8 @@ const props = withDefaults(
     labelClass: '',
     groupClass: '',
     reserveMessageSpace: true,
+    min: undefined,
+    max: undefined,
   },
 )
 
@@ -215,8 +231,8 @@ watch(() => props.displayValue, (value) => {
   draft.value = value
 })
 
-const {isOpen, viewMode, open, close: closePopover, toggleView} = useCalendarPopover(root)
-const {currentMonth, currentYear, goToPrev, goToNext, selectMonth, syncToIso} = useCalendarView(viewMode)
+const {isOpen, viewMode, open, close: closePopover, cycleView} = useCalendarPopover(root)
+const {currentMonth, currentYear, yearPageStart, goToPrev, goToNext, selectMonth, selectYear, syncToIso} = useCalendarView(viewMode)
 
 const inputId = computed(() => props.id?.toString() || `malio-date-${generatedId}`)
 const hasError = computed(() => !!props.error)
@@ -323,7 +339,12 @@ watch(() => props.syncTo, (value) => {
 
 const onSelectMonth = (m: number) => {
   selectMonth(m)
-  toggleView()
+  viewMode.value = 'days'
+}
+
+const onSelectYear = (y: number) => {
+  selectYear(y)
+  viewMode.value = 'months'
 }
 
 const mergedGroupClass = computed(() =>

app/components/malio/date/internal/CalendarHeader.vue

@@ -4,7 +4,7 @@
       type="button"
       data-test="header-prev"
       class="ml-2 flex self-start rounded"
-      :aria-label="viewMode === 'days' ? 'Mois précédent' : 'Année précédente'"
+      :aria-label="prevLabel"
       @click="emit('prev')"
     >
       <Icon
@@ -32,7 +32,7 @@
       type="button"
       data-test="header-next"
       class="mr-2 flex self-start rounded"
-      :aria-label="viewMode === 'days' ? 'Mois suivant' : 'Année suivante'"
+      :aria-label="nextLabel"
       @click="emit('next')"
     >
       <Icon
@@ -51,7 +51,7 @@ import {Icon} from '@iconify/vue'
 defineOptions({name: 'MalioDateCalendarHeader'})
 
 const props = defineProps<{
-  viewMode: 'days' | 'months'
+  viewMode: 'days' | 'months' | 'years'
   currentMonth: number
   currentYear: number
 }>()
@@ -63,8 +63,21 @@ const emit = defineEmits<{
 const monthsLong = ['janvier', 'février', 'mars', 'avril', 'mai', 'juin',
   'juillet', 'août', 'septembre', 'octobre', 'novembre', 'décembre']
 
+// Libellé constant « Mois Année » dans toutes les vues (jours/mois/années) :
+// la grille affichée en dessous indique le niveau courant.
 const label = computed(() => {
   const name = monthsLong[props.currentMonth]
   return `${name.charAt(0).toUpperCase()}${name.slice(1)} ${props.currentYear}`
 })
+
+const prevLabel = computed(() =>
+  props.viewMode === 'days' ? 'Mois précédent'
+    : props.viewMode === 'months' ? 'Année précédente'
+      : 'Période précédente',
+)
+const nextLabel = computed(() =>
+  props.viewMode === 'days' ? 'Mois suivant'
+    : props.viewMode === 'months' ? 'Année suivante'
+      : 'Période suivante',
+)
 </script>

app/components/malio/date/internal/MonthPicker.test.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it } from 'vitest'
+import { mount } from '@vue/test-utils'
+import MonthPicker from './MonthPicker.vue'
+
+const mountPicker = (props: { currentYear: number, selectedMonth?: number, min?: string, max?: string }) =>
+  mount(MonthPicker, { props })
+
+describe('MalioDateMonthPicker', () => {
+  it('renders 12 months', () => {
+    const wrapper = mountPicker({ currentYear: 2026 })
+    expect(wrapper.findAll('[data-test="month"]')).toHaveLength(12)
+  })
+
+  it('emits select with the clicked month index', async () => {
+    const wrapper = mountPicker({ currentYear: 2026 })
+    await wrapper.get('[data-test="month"][data-month="0"]').trigger('click')
+    expect(wrapper.emitted('select')?.[0]).toEqual([0])
+  })
+
+  it('disables months before min in the current year and does not emit', async () => {
+    const wrapper = mountPicker({ currentYear: 2026, min: '2026-05-01' })
+    const april = wrapper.get('[data-test="month"][data-month="3"]')
+    expect(april.attributes('disabled')).toBeDefined()
+    await april.trigger('click')
+    expect(wrapper.emitted('select')).toBeUndefined()
+  })
+
+  it('disables months after max in the current year', () => {
+    const wrapper = mountPicker({ currentYear: 2026, max: '2026-05-31' })
+    expect(wrapper.get('[data-test="month"][data-month="5"]').attributes('disabled')).toBeDefined()
+    expect(wrapper.get('[data-test="month"][data-month="4"]').attributes('disabled')).toBeUndefined()
+  })
+})

app/components/malio/date/internal/MonthPicker.vue

@@ -9,14 +9,19 @@
       type="button"
       data-test="month"
       :data-month="index"
+      :disabled="!isMonthInRange(currentYear, index, min, max)"
+      :aria-disabled="!isMonthInRange(currentYear, index, min, max)"
       class="flex h-[45px] w-full items-center justify-center"
+      :class="isMonthInRange(currentYear, index, min, max) ? 'cursor-pointer' : 'cursor-not-allowed'"
       @click="emit('select', index)"
     >
       <span
         class="flex h-[30px] w-full items-center justify-center rounded text-sm transition-colors duration-100"
         :class="index === selectedMonth
           ? 'bg-m-primary text-white'
-          : 'text-black hover:bg-m-primary/10'"
+          : isMonthInRange(currentYear, index, min, max)
+            ? 'text-black hover:bg-m-primary/10'
+            : 'text-m-muted/30'"
       >
         {{ name }}
       </span>
@@ -25,9 +30,16 @@
 </template>
 
 <script setup lang="ts">
+import {isMonthInRange} from '../composables/dateFormat'
+
 defineOptions({name: 'MalioDateMonthPicker'})
 
-defineProps<{selectedMonth?: number}>()
+defineProps<{
+  currentYear: number
+  selectedMonth?: number
+  min?: string
+  max?: string
+}>()
 
 const emit = defineEmits<{(e: 'select', month: number): void}>()
 

app/components/malio/date/internal/YearPicker.test.ts

@@ -0,0 +1,36 @@
+import {describe, expect, it} from 'vitest'
+import {mount} from '@vue/test-utils'
+import YearPicker from './YearPicker.vue'
+
+const mountPicker = (props: {pageStart: number, selectedYear?: number, min?: string, max?: string}) =>
+  mount(YearPicker, {props})
+
+describe('MalioDateYearPicker', () => {
+  it('renders 12 years from pageStart', () => {
+    const wrapper = mountPicker({pageStart: 2021})
+    const years = wrapper.findAll('[data-test="year"]')
+    expect(years).toHaveLength(12)
+    expect(years[0].attributes('data-year')).toBe('2021')
+    expect(years[11].attributes('data-year')).toBe('2032')
+  })
+
+  it('emits select with the clicked year', async () => {
+    const wrapper = mountPicker({pageStart: 2021})
+    await wrapper.get('[data-test="year"][data-year="2026"]').trigger('click')
+    expect(wrapper.emitted('select')?.[0]).toEqual([2026])
+  })
+
+  it('disables years outside [min, max] and does not emit', async () => {
+    const wrapper = mountPicker({pageStart: 2021, min: '2025-01-01', max: '2027-12-31'})
+    const out = wrapper.get('[data-test="year"][data-year="2024"]')
+    expect(out.attributes('disabled')).toBeDefined()
+    await out.trigger('click')
+    expect(wrapper.emitted('select')).toBeUndefined()
+  })
+
+  it('highlights the selected year', () => {
+    const wrapper = mountPicker({pageStart: 2021, selectedYear: 2026})
+    const span = wrapper.get('[data-test="year"][data-year="2026"] span')
+    expect(span.classes()).toContain('bg-m-primary')
+  })
+})

app/components/malio/date/internal/YearPicker.vue

@@ -0,0 +1,48 @@
+<template>
+  <div
+    data-test="year-picker"
+    class="grid grid-cols-3 gap-3"
+  >
+    <button
+      v-for="year in years"
+      :key="year"
+      type="button"
+      data-test="year"
+      :data-year="year"
+      :disabled="!isYearInRange(year, min, max)"
+      :aria-disabled="!isYearInRange(year, min, max)"
+      class="flex h-[45px] w-full items-center justify-center"
+      :class="isYearInRange(year, min, max) ? 'cursor-pointer' : 'cursor-not-allowed'"
+      @click="emit('select', year)"
+    >
+      <span
+        class="flex h-[30px] w-full items-center justify-center rounded text-sm transition-colors duration-100"
+        :class="year === selectedYear
+          ? 'bg-m-primary text-white'
+          : isYearInRange(year, min, max)
+            ? 'text-black hover:bg-m-primary/10'
+            : 'text-m-muted/30'"
+      >
+        {{ year }}
+      </span>
+    </button>
+  </div>
+</template>
+
+<script setup lang="ts">
+import {computed} from 'vue'
+import {isYearInRange} from '../composables/dateFormat'
+
+defineOptions({name: 'MalioDateYearPicker'})
+
+const props = defineProps<{
+  pageStart: number
+  selectedYear?: number
+  min?: string
+  max?: string
+}>()
+
+const emit = defineEmits<{(e: 'select', year: number): void}>()
+
+const years = computed(() => Array.from({length: 12}, (_, i) => props.pageStart + i))
+</script>