@lucca-front/ng 22.0.5 → 22.0.6-rc.1

package/llms/references/components/dateinput/dateinput.md

@@ -0,0 +1,198 @@
+# dateinput
+
+## Import
+
+```typescript
+import { DateInputComponent } from '@lucca-front/ng/date2';
+```
+
+## API Reference
+
+### DateInputComponent (component)
+
+**Selector:** `lu-date-input`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `intl` | `intl` | `unknown` | — | — | — | — |
+| `format` | `format` | `(typeof DATE_FORMAT)[keyof typeof DATE_FORMAT]` | `DATE_FORMAT.DATE` | — | — | Modifie le format de date. |
+| `ranges` | `ranges` | `unknown` | `[]` | — | — | — |
+| `hideToday` | `hideToday` | `boolean` | `false` | — | `luBooleanAttribute` | Retire la mise en valeur de la date du jour. |
+| `hasTodayButton` | `hasTodayButton` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `clearable` | `clearable` | `unknown` | `null` | — | `luNullableBooleanAttribute` | Ajoute un bouton de suppression lorsqu’une date est sélectionnée. |
+| `clearBehavior` | `clearBehavior` | `'clear' \| 'reset'` | `'clear'` | — | — | [v20.1] Change le comportement au clic sur la croix de suppression |
+| `hideWeekend` | `hideWeekend` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `mode` | `mode` | `'day' \| 'week' \| 'month' \| 'year'` | `'day'` | — | — | Modifie le mode de sélection au mois ou à l'année. |
+| `getCellInfo` | `getCellInfo` | `((day: Date, mode: CalendarMode) => CellStatus) \| null` | — | — | — | — |
+| `min` | `min` | `unknown` | `new Date('1/1/1000')` | — | `transformDateInputToDate` | Définit une date minimum de sélection. |
+| `max` | `max` | `unknown` | `null` | — | `transformDateInputToDate` | Définit une date maximum de sélection. |
+| `focusedDate` | `focusedDate` | `unknown` | `null` | — | `transformDateInputToDate` | — |
+| `autocomplete` | `autocomplete` | `AutoFill` | `'off'` | — | — | — |
+| `placeholder` | `placeholder` | `string` | — | — | — | — |
+| `disableOverflow` | `disableOverflow` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `hideOverflow` | `hideOverflow` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `widthAuto` | `widthAuto` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+
+#### Outputs
+
+| Property | Binding name | Type | Notes |
+|----------|-------------|------|-------|
+| `panelOpened` | `panelOpened` | `void` | — |
+| `panelClosed` | `panelClosed` | `void` | — |
+
+#### Models (two-way binding)
+
+| Property | Type | Required | Notes |
+|----------|------|----------|-------|
+| `calendarMode` | `CalendarMode \| null` | — | — |
+
+## Related files
+
+- 📝 [Code & implementation](./dateinput.component.md)
+- 🎨 [Design guidelines](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/dateinput/dateinput.design.md)
+- 🎯 [Figma design tokens](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/dateinput/dateinput.figma.md)
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-forms-date2-dateinput--docs)
+
+## Changelog
+
+> Diff structurel de l'API (selectors, inputs, outputs, models) entre versions stables, depuis `v21.4.2` jusqu'à `v22.0.0`. Les versions sans changement d'API sont omises.
+
+### 22.0.0
+
+~ `hideToday` : transform booleanAttribute → luBooleanAttribute
+~ `hasTodayButton` : transform booleanAttribute → luBooleanAttribute
+~ `clearable` : transform booleanAttribute → luNullableBooleanAttribute
+~ `hideWeekend` : transform booleanAttribute → luBooleanAttribute
+~ `mode` : 'day' | 'month' | 'year' → 'day' | 'week' | 'month' | 'year'
+~ `disableOverflow` : transform booleanAttribute → luBooleanAttribute
+~ `hideOverflow` : transform booleanAttribute → luBooleanAttribute
+~ `widthAuto` : transform booleanAttribute → luBooleanAttribute
+~ (model) `calendarMode` : CalendarMode → CalendarMode | null
+
+### Notes de release (ZeroHeight)
+
+#### 21.2.3
+
+##### Fixed
+
+- `lu-date-input`: validation error state and value are now correctly triggered on write value.
+
+#### 21.2.0
+
+##### Fixed
+
+- `lu-date-input`: no longer marks the control as touched when the text input changes.
+
+#### 21.1.0
+
+##### Added
+
+- `intl`: new input on `lu-date-input` and `input[luDateInput]` to override component translations.
+- `*luPresentationDisplay`: `lu-date-input` now supports the form-field presentation display mode.
+
+##### Fixed
+
+- `lu-date-input`: parsing now uses the mode-specific date format (`dateFormatWithMode`) so values are read according to the current mode.
+
+#### 21.0.0
+
+##### Deprecated
+
+- `LuDatePickerModule`: deprecated, import the standalone `LuDatePickerComponent` directly instead.
+
+#### 20.3.1
+
+##### Fixed
+
+- `lu-date-input`: the calendar display mode is now kept in sync with the `mode` input.
+
+#### 20.3.0
+
+##### Added
+
+- `panelOpened` / `panelClosed`: new outputs on `lu-date-input` emitted when the calendar panel opens or closes.
+
+##### Fixed
+
+- `lu-date-input`: better handling of single-digit input in month and day segments.
+
+#### 20.1.0
+
+##### Added
+
+- `clearBehavior`: new input on `lu-date-input` (`'clear'` | `'reset'`) allowing the clear button to reset to the initial value instead of emptying the field, along with a public `reset()` method.
+
+#### 19.3.4
+
+##### Fixed
+
+- `lu-date-input`: invalid text input is now converted correctly to a date ISO value.
+
+#### 19.3.3
+
+##### Added
+
+- `widthAuto`: new boolean input on `lu-date-input` to size the field to its content.
+
+##### Fixed
+
+- `lu-date-input`: `writeValue` no longer calls `onChange`.
+
+#### 19.3.1
+
+##### Fixed
+
+- `lu-date-input`: selecting an initial value after a change is now reflected on the model.
+
+#### 19.2.6
+
+##### Fixed
+
+- `lu-date-input`: correct handling of `min`/`max` in month mode.
+- `lu-date-input`: disabled state now uses a signal so the view re-renders correctly.
+- `lu-date-input`: clearing now sends `null` on change and moves the calendar accordingly.
+
+#### 19.2.5
+
+##### Fixed
+
+- `lu-date-input`: the disabled state of the date picker panel is now updated correctly.
+
+#### 19.2.3
+
+##### Fixed
+
+- `lu-date-input`: a `null` value at initialisation is now handled correctly.
+
+#### 19.2.2
+
+##### Added
+
+- `inDateISOFormat`: `lu-date-input` can now emit and consume date ISO string values instead of `Date` objects.
+
+#### 18.3.3
+
+##### Fixed
+
+- `lu-date-input`: `min`/`max` are now handled properly in a month picker configuration.
+- `lu-date-input`: validators logic fixes for `min`/`max`.
+
+#### 18.3.2
+
+##### Fixed
+
+- `lu-date-input`: now accepts `null` as a value.
+
+#### 18.3.0
+
+##### Added
+
+- `lu-date-input`: new date input component built on the calendar2 stack. Exposes inputs such as `format`, `mode`, `min`, `max`, `ranges`, `clearable`, `hideToday`, `hasTodayButton`, `disableOverflow` and `hideOverflow`.
+
+#### 18.1.0
+
+##### Changed
+
+- `granularity`: on `lu-date-picker` and `input[luDateInput]`, the input now also accepts the `LuDateGranularity` string union type in addition to the `ELuDateGranularity` enum.

package/llms/references/components/daterangeinput/daterangeinput.component.md

@@ -0,0 +1,49 @@
+# daterangeinput — Code & Implementation
+
+📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-forms-date2-daterangeinput--docs)
+
+## Angular
+
+Component selector : `lu-date-range-input`
+
+### Range input
+
+```js
+import { LOCALE_ID } from '@angular/core';
+import { FormsModule } from '@angular/forms';
+import { CALENDAR_MODE, CalendarShortcut, DATE2_CLEAR_BEHAVIOR, DATE_FORMAT_CONST, DateRange, DateRangeInputComponent, PremadeShortcuts } from '@lucca-front/ng/date2';
+import { FormFieldComponent } from '@lucca-front/ng/form-field';
+```
+
+```ts
+shortcuts: [
+	{
+		label: 'Since start of week',
+		range: PremadeShortcuts['SinceStartOfWeek']('fr'),
+	},
+	{
+		label: 'Last week',
+		range: PremadeShortcuts['LastWeek']('fr'),
+	},
+	{
+		label: 'Last month',
+		range: PremadeShortcuts['LastMonth']('fr'),
+	},
+]
+```
+
+```html
+<lu-form-field label="Date range input example" inlineMessage="Inline message example">
+	<lu-date-range-input [(ngModel)]="selected" [min]="min" [max]="max" [focusedDate]="focusedDate" format="date" />
+</lu-form-field>
+
+<pr-story-model-display>{{ selected | json }}</pr-story-model-display>
+```
+
+```html
+<lu-form-field label="Date range input example" inlineMessage="Inline message example">
+	<lu-date-range-input [(ngModel)]="selected" [min]="min" [max]="max" [shortcuts]="shortcuts" />
+</lu-form-field>
+
+<pr-story-model-display>{{ selected | json }}</pr-story-model-display>
+```

package/llms/references/components/daterangeinput/daterangeinput.md

@@ -0,0 +1,186 @@
+# daterangeinput
+
+## Import
+
+```typescript
+import { DateRangeInputComponent } from '@lucca-front/ng/date2';
+```
+
+## API Reference
+
+### DateRangeInputComponent (component)
+
+**Selector:** `lu-date-range-input`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `intl` | `intl` | `unknown` | — | — | — | — |
+| `format` | `format` | `(typeof DATE_FORMAT)[keyof typeof DATE_FORMAT]` | `DATE_FORMAT.DATE` | — | — | Modifie le format de date. |
+| `ranges` | `ranges` | `unknown` | `[]` | — | — | — |
+| `hideToday` | `hideToday` | `boolean` | `false` | — | `luBooleanAttribute` | Retire la mise en valeur de la date du jour. |
+| `hasTodayButton` | `hasTodayButton` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `clearable` | `clearable` | `unknown` | `null` | — | `luNullableBooleanAttribute` | Ajoute un bouton de suppression lorsqu’une date est sélectionnée. |
+| `clearBehavior` | `clearBehavior` | `'clear' \| 'reset'` | `'clear'` | — | — | [v20.1] Change le comportement au clic sur la croix de suppression |
+| `hideWeekend` | `hideWeekend` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `mode` | `mode` | `'day' \| 'week' \| 'month' \| 'year'` | `'day'` | — | — | Modifie le mode de sélection au mois ou à l'année. |
+| `getCellInfo` | `getCellInfo` | `((day: Date, mode: CalendarMode) => CellStatus) \| null` | — | — | — | — |
+| `min` | `min` | `unknown` | `new Date('1/1/1000')` | — | `transformDateInputToDate` | Définit une date minimum de sélection. |
+| `max` | `max` | `unknown` | `null` | — | `transformDateInputToDate` | Définit une date maximum de sélection. |
+| `focusedDate` | `focusedDate` | `unknown` | `null` | — | `transformDateInputToDate` | Définit la date préselectionnée à l’ouverture du calendrier. |
+| `placeholder` | `placeholder` | `string` | — | — | — | — |
+| `widthAuto` | `widthAuto` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `shortcuts` | `shortcuts` | `readonly CalendarShortcut[]` | — | — | — | — |
+| `autocomplete` | `autocomplete` | `AutoFill` | `'off'` | — | — | — |
+
+#### Outputs
+
+| Property | Binding name | Type | Notes |
+|----------|-------------|------|-------|
+| `panelOpened` | `panelOpened` | `void` | — |
+| `panelClosed` | `panelClosed` | `void` | — |
+
+#### Models (two-way binding)
+
+| Property | Type | Required | Notes |
+|----------|------|----------|-------|
+| `calendarMode` | `CalendarMode \| null` | — | — |
+
+## Related files
+
+- 📝 [Code & implementation](./daterangeinput.component.md)
+- 🎨 [Design guidelines](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/daterangeinput/daterangeinput.design.md)
+- 🎯 [Figma design tokens](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/daterangeinput/daterangeinput.figma.md)
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-forms-date2-daterangeinput--docs)
+
+## Changelog
+
+> Diff structurel de l'API (selectors, inputs, outputs, models) entre versions stables, depuis `v21.4.2` jusqu'à `v22.0.0`. Les versions sans changement d'API sont omises.
+
+### 22.0.0
+
+~ `hideToday` : transform booleanAttribute → luBooleanAttribute
+~ `hasTodayButton` : transform booleanAttribute → luBooleanAttribute
+~ `clearable` : transform booleanAttribute → luNullableBooleanAttribute
+~ `hideWeekend` : transform booleanAttribute → luBooleanAttribute
+~ `mode` : 'day' | 'month' | 'year' → 'day' | 'week' | 'month' | 'year'
+~ `widthAuto` : transform booleanAttribute → luBooleanAttribute
+~ (model) `calendarMode` : CalendarMode → CalendarMode | null
+
+### Notes de release (ZeroHeight)
+
+#### 21.3.0
+
+##### Changed
+
+- `presentation display` uses plain text separators (`from`/`to` labels) instead of a masked span and arrow icon in the read-only presentation mode.
+
+#### 21.2.1
+
+##### Fixed
+
+- `segment width` corrected the width calculation of the start/end input segments.
+
+#### 21.1.4
+
+##### Fixed
+
+- `end input` the end field's input event now reads its own value instead of the start field's value.
+
+#### 21.1.3
+
+##### Fixed
+
+- `empty value` empty value display now matches the other inputs, showing a dash placeholder.
+
+#### 21.1.1
+
+##### Fixed
+
+- `filled label` the label is now correctly considered as filled even when the field is not static.
+
+#### 21.1.0
+
+##### Added
+
+- `intl` translation override support: every label and message can now be overridden through the `intl` inputs.
+- `presentation` presentation display mode for the range input, rendering a read-only formatted value inside a presentation form field.
+
+##### Changed
+
+- `empty presentation` displays a dash (`–`) when a presentation value is empty.
+
+##### Fixed
+
+- `keyboard input` typing in the field no longer moves the caret once the value is parsed.
+
+#### 21.0.0
+
+##### Fixed
+
+- `filter pill reset` fixed the reset of the value when used inside a filter pill.
+
+#### 20.3.0
+
+##### Added
+
+- `panelOpened` / `panelClosed` outputs emitted when the calendar panel opens and closes.
+
+#### 20.2.3
+
+##### Fixed
+
+- `value emission` removed an internal effect that could emit a spurious `null` value.
+
+#### 20.1.0
+
+##### Added
+
+- `clearBehavior` input accepting `reset` to restore the initial value instead of clearing to `null` when the clear button is used.
+
+#### 19.3.3
+
+##### Added
+
+- `widthAuto` input to let the field size itself to its content instead of taking the full available width.
+
+#### 19.3.1
+
+##### Fixed
+
+- `disabled state` fixed the input always being rendered as disabled.
+
+#### 19.2.6
+
+##### Fixed
+
+- `filter pill clearable` fixed the clearable behaviour when hosted in a filter pill.
+
+#### 19.2.5
+
+##### Fixed
+
+- `disabled state` the date picker disabled state is now kept in sync with the control.
+
+#### 19.2.2
+
+##### Changed
+
+- `inDateISOFormat` the value accessor now accepts and emits ISO date string ranges when the ISO format is enabled.
+
+#### 19.2.0
+
+##### Added
+
+- `filter pill` support for being used as a filter pill input, integrating with `filter-pills` / `filter-pills-bar`.
+
+##### Fixed
+
+- `keyboard navigation` fixed period keyboard navigation when used as a filter pill.
+
+#### 19.1.0
+
+##### Added
+
+- `lu-date-range-input` new component providing a date range picker input with a dual-calendar panel, `shortcuts`, `placeholder`, `mode` (day / month / year), min/max bounds and calendar cell customization.

package/llms/references/components/departmentselect/departmentselect.component.md

@@ -0,0 +1,43 @@
+# departmentselect — Code & Implementation
+
+📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-forms-departmentselect--docs)
+
+## Angular
+
+### Select
+
+```js
+import { provideHttpClient } from '@angular/common/http';
+import { ChangeDetectionStrategy, Component, input } from '@angular/core';
+import { provideAnimations } from '@angular/platform-browser/animations';
+import { LuDepartmentSelectInputComponent } from '@lucca-front/ng/department';
+```
+
+```html
+<label class="textfield mod-inline">
+	<lu-department-select
+		class="textfield-input"
+		[appInstanceId]="appInstanceId()"
+		[operations]="operations()"
+		[filters]="filters()"
+		[uniqueOperation]="uniqueOperation()"
+		placeholder="Select a departement"
+		data-testid="lu-select"
+	/>
+	<div class="textfield-label">Departement</div>
+</label>
+
+<label class="textfield mod-inline">
+	<lu-department-select
+		class="textfield-input"
+		[appInstanceId]="appInstanceId()"
+		[operations]="operations()"
+		[filters]="filters()"
+		[uniqueOperation]="uniqueOperation()"
+		placeholder="Select a departement"
+		multiple="true"
+		data-testid="lu-select"
+	/>
+	<div class="textfield-label">Departement multiple</div>
+</label>
+```

package/llms/references/components/departmentselect/departmentselect.md

@@ -0,0 +1,43 @@
+# departmentselect
+
+## Import
+
+```typescript
+import { LuDepartmentSelectInputComponent } from '@lucca-front/ng/department';
+```
+
+## API Reference
+
+### LuDepartmentSelectInputComponent (component)
+
+**Selector:** `lu-department-select`
+
+> ⚠️ **Déprécié** : Déprécié.
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `intl` | `intl` | `unknown` | — | — | — | — |
+| `appInstanceId` | `appInstanceId` | `number \| string` | — | — | — | — |
+| `operations` | `operations` | `number[]` | — | — | — | — |
+| `filters` | `filters` | `string[]` | `[]` | — | — | — |
+| `uniqueOperation` | `uniqueOperation` | `number` | — | — | — | — |
+
+### Injection tokens
+
+| Token | Type | Description |
+|-------|------|-------------|
+| `LU_DEPARTMENT_SELECT_INPUT_TRANSLATIONS` | `unknown` | — |
+
+### Modules dépréciés
+
+- ⚠️ `LuDepartmentModule` — use `LuDepartmentFeederComponent, LuDepartmentSelectInputComponent` instead
+- ⚠️ `LuDepartmentSelectModule` — use `LuDepartmentFeederComponent, LuDepartmentSelectInputComponent` instead
+- ⚠️ `LuDepartmentSelectInputModule` — use `LuDepartmentSelectInputComponent` instead
+
+## Related files
+
+- 📝 [Code & implementation](./departmentselect.component.md)
+
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-forms-departmentselect--docs)