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

package/llms/references/components/calendar/calendar.md

@@ -0,0 +1,104 @@
+# calendar
+
+## Import
+
+```typescript
+import { LuCalendarInputComponent } from '@lucca-front/ng/date';
+```
+
+## Basic Usage
+
+```html
+<lu-calendar2 [hideToday]="false" [showOverflow]="true" [enableOverflow]="true" [date]="currentMonth" mode="year" (dateClicked)="selected($event)" />
+```
+
+## API Reference
+
+### LuCalendarInputComponent (component)
+
+**Selector:** `lu-calendar`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `intl` | `intl` | `unknown` | — | — | — | — |
+| `min` | `min` | `D` | — | — | — | — |
+| `max` | `max` | `D` | — | — | — | — |
+| `granularity` | `granularity` | `LuDateGranularity` | `ELuDateGranularity.day` | — | — | — |
+| `startOn` | `startOn` | `D` | — | — | — | — |
+
+### Modules dépréciés
+
+- ⚠️ `LuDateModule` — use `LuCalendarInputComponent, LuDatePickerComponent, LuDateInputDirective, LuDateAdapterPipe, LuDateSelectInputComponent` instead
+
+## Related files
+
+- 📝 [Code & implementation](./calendar.component.md)
+- 🎨 [Design guidelines](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/calendar/calendar.design.md)
+- 🎯 [Figma design tokens](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/calendar/calendar.figma.md)
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-forms-date-calendar--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
+
+~ `min` : unknown → D
+~ `max` : unknown → D
+~ `startOn` : défaut this._adapter.forgeToday() → ∅
+
+### Notes de release (ZeroHeight)
+
+#### 21.1.0
+
+##### Added
+
+- `intl`: added an `intl` input on `lu-calendar` and `lu-calendar2` to override the component's built-in translations.
+
+#### 21.0.3
+
+##### Fixed
+
+- `lu-calendar`: dates disabled by `min`/`max` now display a proper disabled style (dimmed color, strikethrough, non-interactive hover).
+
+#### 21.0.0
+
+##### Deprecated
+
+- `LuCalendarInputModule`: deprecated, import the standalone `LuCalendarInputComponent` instead.
+
+##### Fixed
+
+- `lu-calendar2`: the day grid now always renders a 6th week row so the calendar keeps a consistent height across months.
+
+#### 20.3.0
+
+##### Changed
+
+- `displayMode`: the `lu-calendar2` `displayMode` model now defaults to `null` and falls back to `mode`, letting consumers set the starting display mode without overriding the navigation mode.
+
+#### 20.2.0
+
+##### Fixed
+
+- `lu-calendar2`: improved weekday header accessibility, decorative day initials are now `aria-hidden` while the full day name stays available to screen readers.
+
+#### 19.2.0
+
+##### Added
+
+- `intl`: added translatable previous/next navigation labels on `lu-calendar`.
+
+#### 18.3.0
+
+##### Added
+
+- `lu-calendar2` (`Calendar2Component`): new standalone calendar component built on `date-fns`. Supports day/month/year modes, date ranges, keyboard navigation, overflow-day display and a "today" button. Inputs: `showOverflow`, `enableOverflow`, `hideToday`, `hasTodayButton`, `hideWeekend`, `ranges`, `getCellInfo`; models: `date` (required), `tabbableDate`, `mode`, `displayMode`; outputs: `nextPage`, `previousPage`, `dateClicked`.
+
+#### 18.1.0
+
+##### Changed
+
+- `granularity`: the `lu-calendar` `granularity` input now accepts the `LuDateGranularity` string union (e.g. `'day'`) in addition to the `ELuDateGranularity` enum.

package/llms/references/components/calendar2/calendar2.md

@@ -0,0 +1,64 @@
+# calendar2
+
+## Import
+
+```typescript
+import { Calendar2Component } from '@lucca-front/ng/date2';
+```
+
+## API Reference
+
+### Calendar2Component (component)
+
+**Selector:** `lu-calendar2`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `intl` | `intl` | `unknown` | — | — | — | — |
+| `showOverflow` | `showOverflow` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `enableOverflow` | `enableOverflow` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `removeYearOverflow` | `removeYearOverflow` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `hideToday` | `hideToday` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `hasTodayButton` | `hasTodayButton` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `hideWeekend` | `hideWeekend` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `disableModeChange` | `disableModeChange` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `ranges` | `ranges` | `readonly DateRange[]` | `[]` | — | — | — |
+| `getCellInfo` | `getCellInfo` | `(date: Date, displayMode: CalendarMode \| null) => CellStatus` | `(_date: Date) => ({
+		classes: []` | — | — | — |
+
+#### Outputs
+
+| Property | Binding name | Type | Notes |
+|----------|-------------|------|-------|
+| `nextPage` | `nextPage` | `void` | — |
+| `previousPage` | `previousPage` | `void` | — |
+| `dateClicked` | `dateClicked` | `Date` | — |
+
+#### Models (two-way binding)
+
+| Property | Type | Required | Notes |
+|----------|------|----------|-------|
+| `date` | `Date` | ✅ | — |
+| `tabbableDate` | `Date \| null` | — | — |
+| `mode` | `CalendarMode` | — | — |
+| `displayMode` | `CalendarMode \| null` | — | — |
+| `dateHovered` | `Date \| null` | — | — |
+
+## Related files
+
+## 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
+
+~ `showOverflow` : transform booleanAttribute → luBooleanAttribute
+~ `enableOverflow` : transform booleanAttribute → luBooleanAttribute
+~ `removeYearOverflow` : transform booleanAttribute → luBooleanAttribute
+~ `hideToday` : transform booleanAttribute → luBooleanAttribute
+~ `hasTodayButton` : transform booleanAttribute → luBooleanAttribute
+~ `hideWeekend` : transform booleanAttribute → luBooleanAttribute
+~ `disableModeChange` : transform booleanAttribute → luBooleanAttribute
+~ `getCellInfo` : (date: Date, displayMode: CalendarMode) => CellStatus → (date: Date, displayMode: CalendarMode | null) => CellStatus

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

@@ -0,0 +1,237 @@
+# callout — Code & Implementation
+
+📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-feedback-callout-angular-ai--docs)
+
+## Angular
+
+### Ai action
+
+```js
+import { ButtonComponent } from '@lucca-front/ng/button';
+import { CalloutActionsComponent, CalloutComponent, CalloutFeedbackItemComponent, CalloutFeedbackListComponent } from '@lucca-front/ng/callout';
+import { IconComponent } from '@lucca-front/ng/icon';
+```
+
+```html
+<lu-callout AI iconAlt="Assistant IA" icon="weatherStars">
+	<p>
+		<strong>Achat détecté :</strong>
+		la facture correspond à l’
+		<a href="#">achat nº 832</a>
+	</p>
+	<lu-callout-actions>
+		<button luButton="outlined">Associer</button>
+		<button luButton="outlined">Refuser</button>
+	</lu-callout-actions>
+</lu-callout>
+```
+
+### Ai event
+
+```js
+import { ButtonComponent } from '@lucca-front/ng/button';
+import { CalloutActionsComponent, CalloutComponent, CalloutFeedbackItemComponent, CalloutFeedbackListComponent } from '@lucca-front/ng/callout';
+import { IconComponent } from '@lucca-front/ng/icon';
+```
+
+```html
+<lu-callout AI iconAlt="Assistant IA" icon="weatherStars">
+	<p>Fixer des objectifs SMART</p>
+	<lu-callout-actions inline>
+		<button luButton="outlined">Reformuler les objectifs</button>
+	</lu-callout-actions>
+</lu-callout>
+```
+
+### Ai suggestion
+
+```js
+import { FormsModule, ReactiveFormsModule } from '@angular/forms';
+import { ButtonComponent } from '@lucca-front/ng/button';
+import { CalloutActionsComponent, CalloutComponent, CalloutFeedbackItemComponent, CalloutFeedbackListComponent } from '@lucca-front/ng/callout';
+import { FormFieldComponent } from '@lucca-front/ng/form-field';
+import { TextInputComponent } from '@lucca-front/ng/forms';
+import { IconComponent } from '@lucca-front/ng/icon';
+```
+
+```html
+<div class="suggestion">
+	<lu-form-field label="Intitulé" class="suggestion-form-field">
+		<lu-text-input required type="text" [(ngModel)]="example" />
+	</lu-form-field>
+	<lu-callout AI iconAlt="Assistant IA" icon="weatherStars" class="suggestion-callout">
+		<div class="suggestion-callout-text">
+			<p>Optimiser l’utilisation des composants de formulaire selon les besoins</p>
+		</div>
+		<lu-callout-actions inline>
+			<button luButton="outlined" class="suggestion-callout-accept">
+				<lu-icon icon="signConfirm" alt="Accepter" />
+			</button>
+			<button luButton="outlined" class="suggestion-callout-reject"><lu-icon icon="signClose" alt="Refuser" /></button>
+		</lu-callout-actions>
+	</lu-callout>
+</div>
+```
+
+### Ai
+
+```js
+import { ButtonComponent } from '@lucca-front/ng/button';
+import { CalloutActionsComponent, CalloutComponent, CalloutFeedbackItemComponent, CalloutFeedbackListComponent } from '@lucca-front/ng/callout';
+import { IconComponent } from '@lucca-front/ng/icon';
+```
+
+```html
+<lu-callout AI iconAlt="Assistant IA" icon="weatherStars">
+	<p>Des champs ont été pré-remplis après analyse.</p>
+</lu-callout>
+```
+
+### Basic
+
+Component selector : `lu-callout`
+
+```js
+import { CalloutComponent } from "@lucca-front/ng/callout";
+import { CalloutActionsComponent } from '@lucca-front/ng/callout'; /* [v20.3] Si <lu-callout-action> est utilisé */
+```
+
+```html
+<lu-callout>
+	<p>Feedback description</p>
+</lu-callout>
+```
+
+## HTML/CSS
+
+### Actions
+
+Classe CSS : `.callout`
+
+```css
+@forward '@lucca-front/scss/src/components/callout';
+```
+
+```html
+<div class="callout">
+	<div class="callout-content">
+		<div class="callout-content-description">
+			<p>Feedback description</p>
+			<div class="callout-content-description-actions">
+				<button class="button mod-outlined" type="button">Button</button>
+				<button class="button mod-ghost" type="button">Button</button>
+			</div>
+		</div>
+	</div>
+</div>
+```
+
+### ActionsInline
+
+Classe CSS : `.callout`
+
+```css
+@forward '@lucca-front/scss/src/components/callout';
+```
+
+```html
+<div class="callout">
+	<div class="callout-content">
+		<div class="callout-content-description">
+			<p>Feedback description</p>
+			<div class="callout-content-description-actions mod-inline">
+				<button class="button mod-outlined" type="button">Button</button>
+				<button class="button mod-ghost" type="button">Button</button>
+			</div>
+		</div>
+	</div>
+</div>
+```
+
+### Basic
+
+Classe CSS : `.callout`
+
+```css
+@forward '@lucca-front/scss/src/components/callout';
+```
+
+```html
+<div class="callout">
+	<div class="callout-content">
+		<p class="callout-content-description">Feedback description</p>
+	</div>
+</div>
+```
+
+### Ia
+
+Classe CSS : `.callout`
+
+```css
+@forward '@lucca-front/scss/src/components/callout';
+```
+
+```html
+<div class="callout mod-AI">
+	<div class="callout-icon">
+		<span aria-hidden="true" class="lucca-icon icon-weatherStars"></span>
+	</div>
+	<div class="callout-content">
+		<p class="callout-content-description">Feedback description</p>
+	</div>
+</div>
+```
+
+### Icons
+
+Classe CSS : `.callout`
+
+```css
+@forward '@lucca-front/scss/src/components/callout';
+```
+
+```html
+<div class="callout">
+	<div class="callout-icon">
+		<span aria-hidden="true" class="lucca-icon icon-signHelp"></span>
+	</div>
+	<div class="callout-content">
+		<p class="callout-content-description">Feedback description</p>
+	</div>
+</div>
+```
+
+### Killable
+
+Classe CSS : `.callout`
+
+```css
+@forward '@lucca-front/scss/src/components/callout';
+```
+
+```html
+<div class="callout">
+	<div class="callout-content">
+		<p class="callout-content-description">Feedback description</p>
+	</div>
+	<button type="button" class="callout-kill"></button>
+</div>
+```
+
+### Title
+
+Classe CSS : `.callout`
+
+```css
+@forward '@lucca-front/scss/src/components/callout';
+```
+
+```html
+<div class="callout">
+	<div class="callout-content">
+		<strong class="callout-content-title">Dépense non prise en charge</strong>
+		<p class="callout-content-description">Vous l'avez déclarée comme usage personnel le 29 août 2023.</p>
+	</div>
+</div>
+```

package/llms/references/components/callout/callout.md

@@ -0,0 +1,243 @@
+# callout
+
+## Import
+
+```typescript
+import { CalloutActionsComponent, CalloutFeedbackItemDescriptionDirective, CalloutFeedbackItemComponent, CalloutFeedbackListComponent, CalloutComponent } from '@lucca-front/ng/callout';
+```
+
+## Basic Usage
+
+```html
+<lu-callout> <p>Feedback description</p>
+</lu-callout>
+```
+
+## API Reference
+
+### CalloutActionsComponent (component)
+
+**Selector:** `lu-callout-actions`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `inline` | `inline` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+
+### CalloutFeedbackItemDescriptionDirective (directive)
+
+**Selector:** `lu-feedback-item-description`
+
+### CalloutFeedbackItemComponent (component)
+
+**Selector:** `li[lu-callout-feedback-item]`
+
+### CalloutFeedbackListComponent (component)
+
+**Selector:** `ul[lu-callout-feedback-list]`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `palette` | `palette` | `Palette` | — | — | — | Applique une palette de couleurs au callout. |
+| `size` | `size` | `'M' \| 'S'` | — | — | — | Modifie la taille du callout. |
+
+### CalloutComponent (component)
+
+**Selector:** `lu-callout`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `intl` | `intl` | `unknown` | — | — | — | — |
+| `heading` | `heading` | `PortalContent` | — | — | — | Ajoute un titre au callout. [PortalContent] |
+| `hx` | `hx` | `unknown` | `null` | — | `luNumberAttribute` | — |
+| `palette` | `palette` | `Palette` | `'none'` | — | — | Applique une palette de couleurs au callout. |
+| `size` | `size` | `'M' \| 'S'` | — | — | — | Modifie la taille du callout. |
+| `state` | `state` | `'success' \| 'warning' \| 'error'` | — | — | — | État du callout. |
+| `icon` | `icon` | `LuccaIcon` | — | — | — | Ajoute une icône au callout. |
+| `removable` | `removable` | `boolean` | `false` | — | `luBooleanAttribute` | Ajoute un bouton de suppression au callout. |
+| `removed` | `removed` | `boolean` | `false` | — | `luBooleanAttribute` | Masque le callout. |
+| `iconAlt` | `iconAlt` | `string \| null` | `null` | — | — | Information de l’icône restituée par le lecteur d’écran. |
+| `AI` | `AI` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+
+#### Outputs
+
+| Property | Binding name | Type | Notes |
+|----------|-------------|------|-------|
+| `removedChange` | `removedChange` | `boolean` | — |
+
+### Injection tokens
+
+| Token | Type | Description |
+|-------|------|-------------|
+| `LU_CALLOUT_TRANSLATIONS` | `unknown` | — |
+
+## Type definitions
+
+- [`LuccaIcon`](../../types/LuccaIcon.md) — 585 available values
+
+## Related files
+
+- 📝 [Code & implementation](./callout.component.md)
+- 🎨 [Design guidelines](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/callout/callout.design.md)
+- 🎯 [Figma design tokens](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/callout/callout.figma.md)
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-feedback-callout-angular-ai--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
+
+`CalloutActionsComponent` :
+  ~ `inline` : transform booleanAttribute → luBooleanAttribute
+`CalloutComponent` :
+  ~ `hx` : transform numberAttribute → luNumberAttribute
+  ~ `removable` : transform booleanAttribute → luBooleanAttribute
+  ~ `removed` : transform booleanAttribute → luBooleanAttribute
+  ~ `AI` : transform booleanAttribute → luBooleanAttribute
+
+### Notes de release (ZeroHeight)
+
+#### 21.3.0
+
+##### Added
+
+- `CALLOUT_SIZE`, `CALLOUT_POPOVER_SIZE` and `CALLOUT_HX` constants, together with the `CalloutSize`, `CalloutPopoverSize` and `CalloutHx` types, are now publicly exported and used to type the `size` and `hx` inputs.
+- `AI` palette support for the AI callout styling.
+
+#### 21.2.4
+
+##### Added
+
+- `buttonLabel` on `lu-callout-popover` now also accepts a `number`.
+
+#### 21.2.2
+
+##### Added
+
+- `popoverDisabled` input on `lu-callout-popover` to render the trigger without opening a popover.
+
+##### Fixed
+
+- The callout margin no longer remains visible once the callout has been removed.
+
+#### 21.2.1
+
+##### Fixed
+
+- Button alignment inside a `size="S"` callout.
+
+#### 21.2.0
+
+##### Added
+
+- `popoverPosition` input on `lu-callout-popover` (`above` by default) and `customPopoverPositions` to provide your own connected positions.
+
+#### 21.1.4
+
+##### Added
+
+- `hx` input to set the heading level used by the callout heading.
+- `popoverTrigger` input on `lu-callout-popover` (`click`, `click+hover`, `hover+focus`).
+
+##### Fixed
+
+- Status of the actions displayed inside a callout.
+
+#### 21.1.0
+
+##### Changed
+
+- `intl` input now accepts partial overrides that are merged with the default translations.
+
+#### 21.0.3
+
+##### Fixed
+
+- Callout descriptions are now rendered inside paragraphs to keep a valid DOM structure with inline actions.
+
+#### 21.0.0
+
+##### Added
+
+- `buttonAlt` and `heading` inputs on `lu-callout-popover`, plus `headingHiddenIfSingleItem` on `lu-callout-feedback-list`.
+
+##### Changed
+
+- `lu-callout-popover` is now based on the `popover2` directives.
+
+##### Removed
+
+- Elements deprecated in 18.1.
+
+#### 20.3.0
+
+##### Added
+
+- `AI` input to render the callout with the AI styling (`mod-AI`).
+- `iconAlt` input to provide an alternative text for the callout icon.
+
+#### 20.2.3
+
+##### Fixed
+
+- Padding and font size of the `size="S"` callout.
+
+#### 20.1.3
+
+##### Fixed
+
+- Size of the `XS` callout popover.
+
+#### 20.1.2
+
+##### Fixed
+
+- `lu-callout-popover` no longer loses the icon deduced from its `state` when no `icon` is provided.
+
+#### 20.1.1
+
+##### Added
+
+- `CalloutState` type is now publicly exported.
+
+#### 19.1.0
+
+##### Changed
+
+- Callout actions now use the `neutral` palette by default.
+
+#### 18.3.2
+
+##### Fixed
+
+- Disclosure icon of `lu-callout-disclosure`.
+
+#### 18.2.3
+
+##### Fixed
+
+- `state` input is now taken into account when set several times.
+
+#### 18.1.4
+
+##### Fixed
+
+- `size` no longer produces an invalid `mod-undefined` CSS class when left unset.
+
+#### 18.1.1
+
+##### Fixed
+
+- Close icon size and position.
+
+#### 18.1.0
+
+##### Changed
+
+- Actions are now wrapped in a dedicated container.