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

package/llms/references/components/multilanguagefield/multilanguagefield.md

@@ -0,0 +1,362 @@
+# multilanguagefield
+
+## Import
+
+```typescript
+import { MultilanguageInputComponent } from '@lucca-front/ng/forms';
+```
+
+## API Reference
+
+### MultilanguageInputComponent (component)
+
+**Selector:** `lu-multilanguage-input`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `intl` | `intl` | `unknown` | — | — | — | — |
+| `placeholder` | `placeholder` | `string` | `''` | — | — | Modifie le placeholder au champ. |
+| `openOnFocus` | `openOnFocus` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `autocomplete` | `autocomplete` | `AutoFill` | `'off'` | — | — | — |
+| `hasNoInvariant` | `hasNoInvariant` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `hasAIButtons` | `hasAIButtons` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `displayLocale` | `displayLocale` | `string` | `''` | — | — | — |
+
+#### Outputs
+
+| Property | Binding name | Type | Notes |
+|----------|-------------|------|-------|
+| `translateWithAI` | `translateWithAI` | `string` | — |
+
+## Related files
+
+- 📝 [Code & implementation](./multilanguagefield.component.md)
+- 🎨 [Design guidelines](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/multilanguagefield/multilanguagefield.design.md)
+- 🎯 [Figma design tokens](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/multilanguagefield/multilanguagefield.figma.md)
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-forms-fields-multilanguagefield-angular--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
+
+~ `openOnFocus` : transform booleanAttribute → luBooleanAttribute
+~ `hasNoInvariant` : transform booleanAttribute → luBooleanAttribute
+~ `hasAIButtons` : transform booleanAttribute → luBooleanAttribute
+
+### Notes de release (ZeroHeight)
+
+#### 21.3.1
+
+##### Added
+
+- `departments`: use a dedicated API call to fetch the total count of departments.
+
+##### Fixed
+
+- `panel overlay`: keep connected overlays out of the push-panel zone so the panel is positioned correctly.
+- `search`: allow `Ctrl`/`Cmd` + `V` paste in the search field.
+
+#### 21.3.0
+
+##### Fixed
+
+- `displayer`: fix the value displayer rendering.
+- `option highlight`: keep the highlighted option consistent when navigating with both mouse and keyboard.
+- `select-all header`: do not display the select-all header when there are no values.
+- `assistive technologies`: fix the value announced to assistive technologies.
+
+#### 21.2.4
+
+##### Fixed
+
+- `users`: fix the response type used to read the total count of the users directive.
+
+#### 21.2.3
+
+##### Fixed
+
+- `departments`: no longer load infinitely when the API returns a multiple of `pageSize` items.
+
+#### 21.2.2
+
+##### Fixed
+
+- `panel`: fix the loading state of the panel.
+
+#### 21.2.1
+
+##### Removed
+
+- `former employees`: remove the `panelHeader` setting used to display the former employees clue.
+
+#### 21.1.3
+
+##### Fixed
+
+- `displayer`: fix ellipsis on the multi-value displayer.
+- `empty value`: display the empty value the same way as other inputs.
+- `optionComparer`: do not compare options when the value is nil.
+
+#### 21.1.1
+
+##### Fixed
+
+- `intl`: the `intl` inputs are now public.
+
+#### 21.1.0
+
+##### Added
+
+- `intl`: allow overriding translations per instance through the `intl` input.
+- `presentation`: support the presentation display mode when used inside a form field.
+
+##### Fixed
+
+- `presentation`: fix typo and tooltip in presentation mode.
+
+#### 21.0.4
+
+##### Fixed
+
+- `option highlight`: take panel elements into account when computing the highlighted option.
+
+#### 21.0.3
+
+##### Changed
+
+- `panel`: constrain the panel to a max width aligned with the input.
+
+##### Fixed
+
+- `placeholder`: keep the input focused and hide the placeholder when all options are selected.
+
+#### 21.0.2
+
+##### Changed
+
+- `api directives`: select directives are consolidated around a common implementation.
+
+##### Fixed
+
+- `select-all`: do not open the panel when `withSelectAll` is set on init.
+
+#### 21.0.0
+
+##### Added
+
+- `lu-multi-select-content-displayer`: new displayer component that projects arbitrary content for the selected values.
+- `placeholder`: add a default placeholder for the multi-select.
+- `occupation-category`: new select directive, with its mock data.
+
+##### Changed
+
+- `select-all displayer`: render selected values with `lu-chip`.
+- `no result`: show a more specific message when a search returns no result.
+
+#### 20.3.3
+
+##### Fixed
+
+- `select-all displayer`: fix the numeric badge not showing when the displayer uses text.
+
+#### 20.3.2
+
+##### Fixed
+
+- `grouping`: wait for establishment grouping calls before fetching options.
+- `grouping`: fix a change detection issue on the grouping property.
+
+#### 20.3.1
+
+##### Fixed
+
+- `select-all displayer`: fix the wrong total count shown in the displayer.
+- `filter pill`: fix the filter pill displayer when using select-all.
+- `panel`: improve panel placement update logic.
+
+#### 20.2.2
+
+##### Fixed
+
+- `select-all`: properly handle toggling options of disabled groups.
+- `panel header`: `luSelectPanelHeader` now works with `lu-multi-select`.
+- `departments`: fix the total count in tree mode.
+
+#### 20.2.1
+
+##### Fixed
+
+- `users`: add the missing `uniqueOperationIds` for the `me` lookup.
+
+#### 20.2.0
+
+##### Added
+
+- `tree mode`: display options as a tree, with `Ctrl+Enter` to select the parent only and `Shift+Enter` to select children only.
+
+##### Fixed
+
+- `a11y`: accessibility audit fixes.
+
+#### 20.1.2
+
+##### Fixed
+
+- `homonyms`: additional data was missing when searching.
+
+#### 20.1.1
+
+##### Fixed
+
+- `filter pill`: make the displayed value match the selected value.
+
+#### 20.1.0
+
+##### Added
+
+- `panel header / footer`: support custom panel headers and footers, with accessibility for the select-all control.
+
+##### Changed
+
+- `autocomplete`: turn browser autocomplete off by default on the search field.
+
+#### 19.3.4
+
+##### Added
+
+- `optionComparer`: can be overridden for the API v4 directives.
+
+#### 19.3.0
+
+##### Added
+
+- `users`: support a custom user option template.
+
+#### 19.2.6
+
+##### Fixed
+
+- `grouping`: fix the group template not being displayed when a clue was used.
+- `filter pill`: make the filter pill clearable.
+
+#### 19.2.4
+
+##### Fixed
+
+- `api v4`: improve the initialization logic to prevent useless API calls.
+- `grouping`: fix the option id when grouping.
+
+#### 19.2.2
+
+##### Fixed
+
+- `displayer`: fix ellipsis on the displayer.
+
+#### 19.2.1
+
+##### Changed
+
+- `inputs`: accept readonly arrays.
+
+#### 19.2.0
+
+##### Added
+
+- `filter pill mode`: integrate with filter pills, including a `filterPillLabelPlural` input for the pill label.
+- `noClue`: new directive to disable the API v3/v4 search.
+
+##### Changed
+
+- `search icon`: display a search icon when the component is searchable.
+- `select-all displayer`: option to disable the numeric badge tooltip.
+
+##### Fixed
+
+- `placeholder`: remove the placeholder when the search input is not used.
+
+#### 19.1.6
+
+##### Fixed
+
+- `select-all`: fix wrong selection/unselection when manually selecting or unselecting all options.
+
+#### 19.1.5
+
+##### Added
+
+- `api directives`: new `uniqueOperationIds` input on the establishments and users directives.
+
+#### 19.1.4
+
+##### Fixed
+
+- `numeric badge`: fix the multi-establishment numeric badge in size S.
+- `users`: fix the wrong API used for the users count, and stop overriding `panelHeaderTpl`.
+
+#### 19.1.0
+
+##### Added
+
+- `LuMultiSelectionValidators`: new `required` validator for the multi-selection control.
+
+#### 18.3.3
+
+##### Changed
+
+- `overlay`: the select no longer overrides the overlay container.
+
+##### Fixed
+
+- `panel`: fix the searchable state when using `luOptionGroup`.
+
+#### 18.3.2
+
+##### Added
+
+- `keepSearchAfterSelection`: new input to keep the search clue after a value is selected instead of clearing it.
+
+##### Fixed
+
+- `select-all`: emit mode `none` when selecting all then unselecting each option.
+- `displayer`: fix error display and ARIA attributes on the displayer.
+
+#### 18.3.1
+
+##### Fixed
+
+- `initial value`: take initial values into account.
+- `select-all`: multiple select-all fixes.
+
+#### 18.3.0
+
+##### Added
+
+- `withSelectAll`: new `lu-multi-select[withSelectAll]` directive (`LuMultiSelectWithSelectAllDirective`) enabling a select-all mode, with the `lu-multi-select-all-displayer` and `lu-multi-select-all-header` components.
+- `users`: support `enableFormerEmployees` on the users select directive.
+
+#### 18.2.3
+
+##### Fixed
+
+- `ui`: multi-select UI fixes.
+
+#### 18.1.2
+
+##### Fixed
+
+- `option highlight`: fix the no-highlighted-option issue.
+- `option highlight`: fix the highlighted item not updating after a clue change.
+
+#### 18.1.0
+
+##### Added
+
+- `lu-multi-select-counter-displayer`: new displayer component showing a counter of selected values.
+
+##### Fixed
+
+- `chip`: fix the "+N" chip in size S.

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

@@ -0,0 +1,23 @@
+# newbadge — Code & Implementation
+
+📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-texts-newbadge-angular-basic--docs)
+
+## Angular
+
+Mots-clés : nouveau, nouveauté
+
+Component selector : `lu-new-badge`
+
+## HTML/CSS
+
+Classe CSS : `.newBadge`
+
+### Badge
+
+```css
+@forward '@lucca-front/scss/src/components/newBadge';
+```
+
+```html
+<span class="newBadge">New</span>
+```

package/llms/references/components/newbadge/newbadge.md

@@ -0,0 +1,38 @@
+# newbadge
+
+## Import
+
+```typescript
+import { NewBadgeComponent } from '@lucca-front/ng/new-badge';
+```
+
+## API Reference
+
+### NewBadgeComponent (component)
+
+**Selector:** `lu-new-badge`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `label` | `label` | `string` | — | ✅ | — | Modifie le texte affiché par le composant. |
+
+## Related files
+
+- 📝 [Code & implementation](./newbadge.component.md)
+- 🎨 [Design guidelines](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/newbadge/newbadge.design.md)
+- 🎯 [Figma design tokens](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/newbadge/newbadge.figma.md)
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-texts-newbadge-angular-basic--docs)
+
+## Changelog
+
+_Aucun changement d'API entre v21.4.2 et v22.0.0._
+
+### Notes de release (ZeroHeight)
+
+#### 19.3.0
+
+##### Added
+
+- `mod-inverted` modifier to display the badge with inverted colors (brand background/text swapped) for use on dark surfaces such as the side navigation.

package/llms/references/components/number-format-input/number-format-input.md

@@ -0,0 +1,46 @@
+# number-format-input
+
+## Import
+
+```typescript
+import { NumberFormatInputComponent } from '@lucca-front/ng/forms';
+```
+
+## API Reference
+
+### NumberFormatInputComponent (component)
+
+**Selector:** `lu-number-format-input`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `formatStyle` | `formatStyle` | `NumberFormatStyle` | `'decimal'` | — | — | — |
+| `useAutoPrefixSuffix` | `useAutoPrefixSuffix` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `prefix` | `prefix` | `TextInputAddon \| undefined` | `undefined` | — | — | — |
+| `suffix` | `suffix` | `TextInputAddon \| undefined` | `undefined` | — | — | — |
+| `currency` | `currency` | `string \| undefined` | `undefined` | — | — | — |
+| `currencyDisplay` | `currencyDisplay` | `NumberFormatCurrencyDisplay \| undefined` | `undefined` | — | — | — |
+| `unit` | `unit` | `NumberFormatUnit \| undefined` | `undefined` | — | — | — |
+| `unitDisplay` | `unitDisplay` | `NumberFormatUnitDisplay \| undefined` | `undefined` | — | — | — |
+| `min` | `min` | `unknown` | `undefined` | — | `luOptionalNumberAttribute` | — |
+| `max` | `max` | `unknown` | `undefined` | — | `luOptionalNumberAttribute` | — |
+| `placeholder` | `placeholder` | `string` | `''` | — | — | — |
+| `hasClearer` | `hasClearer` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `valueAlignRight` | `valueAlignRight` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `intl` | `intl` | `unknown` | — | — | — | — |
+
+## 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
+
+~ `useAutoPrefixSuffix` : transform booleanAttribute → luBooleanAttribute
+~ `min` : number | undefined → unknown, transform ∅ → luOptionalNumberAttribute
+~ `max` : number | undefined → unknown, transform ∅ → luOptionalNumberAttribute
+~ `hasClearer` : transform booleanAttribute → luBooleanAttribute
+~ `valueAlignRight` : transform booleanAttribute → luBooleanAttribute

package/llms/references/components/number-input/number-input.md

@@ -0,0 +1,49 @@
+# number-input
+
+## Import
+
+```typescript
+import { NumberInputComponent } from '@lucca-front/ng/forms';
+```
+
+## API Reference
+
+### NumberInputComponent (component)
+
+**Selector:** `lu-number-input`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `placeholder` | `placeholder` | `string` | `''` | — | — | — |
+| `step` | `step` | `number` | `1` | — | `luNumberAttribute` | — |
+| `noSpinButtons` | `noSpinButtons` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `hasClearer` | `hasClearer` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `prefix` | `prefix` | `TextfieldIconAddon \| TextfieldTextAddon` | — | — | — | — |
+| `suffix` | `suffix` | `TextfieldIconAddon \| TextfieldTextAddon` | — | — | — | — |
+| `min` | `min` | `unknown` | `undefined` | — | `luOptionalNumberAttribute` | — |
+| `max` | `max` | `unknown` | `undefined` | — | `luOptionalNumberAttribute` | — |
+| `valueAlignRight` | `valueAlignRight` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `intl` | `intl` | `unknown` | — | — | — | — |
+
+### Injection tokens
+
+| Token | Type | Description |
+|-------|------|-------------|
+| `LU_NUMBERFIELD_TRANSLATIONS` | `unknown` | — |
+
+## 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
+
+~ `step` : number, number → number, transform numberAttribute → luNumberAttribute
+~ `noSpinButtons` : transform booleanAttribute → luBooleanAttribute
+~ `hasClearer` : transform booleanAttribute → luBooleanAttribute
+~ `min` : number → unknown, défaut ∅ → undefined, transform ∅ → luOptionalNumberAttribute
+~ `max` : number → unknown, défaut ∅ → undefined, transform ∅ → luOptionalNumberAttribute
+~ `valueAlignRight` : transform booleanAttribute → luBooleanAttribute

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

@@ -0,0 +1,46 @@
+# numbers — Code & Implementation
+
+📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-toolbox-numbers-basic--docs)
+
+## Angular
+
+### Numbers
+
+```js
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { LuNumberPipe } from '@lucca-front/ng/number';
+```
+
+```html
+<table class="table">
+	<thead class="table-head">
+		<tr class="table-head-row">
+			<th class="table-head-row-cell">Number</th>
+			<th class="table-head-row-cell mod-alignRight">Value</th>
+			<th class="table-head-row-cell mod-alignRight">Value aligned</th>
+		</tr>
+	</thead>
+	<tbody class="table-body">
+		<tr class="table-body-row">
+			<td class="table-body-row-cell">π</td>
+			<td class="table-body-row-cell mod-alignRight">{{ pi }}</td>
+			<td class="table-body-row-cell mod-alignRight" [innerHtml]="pi | luNumber"></td>
+		</tr>
+		<tr class="table-body-row">
+			<td class="table-body-row-cell">Dix</td>
+			<td class="table-body-row-cell mod-alignRight">{{ ten }}</td>
+			<td class="table-body-row-cell mod-alignRight" [innerHtml]="ten | luNumber"></td>
+		</tr>
+		<tr class="table-body-row">
+			<td class="table-body-row-cell"><span>e</span></td>
+			<td class="table-body-row-cell mod-alignRight">{{ e }}</td>
+			<td class="table-body-row-cell mod-alignRight" [innerHtml]="e | luNumber"></td>
+		</tr>
+		<tr class="table-body-row">
+			<td class="table-body-row-cell">Milliers</td>
+			<td class="table-body-row-cell mod-alignRight">{{ thousands }}</td>
+			<td class="table-body-row-cell mod-alignRight" [innerHtml]="thousands | luNumber"></td>
+		</tr>
+	</tbody>
+</table>
+```

package/llms/references/components/numbers/numbers.md

@@ -0,0 +1,7 @@
+# numbers
+
+## Related files
+
+- 📝 [Code & implementation](./numbers.component.md)
+
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-toolbox-numbers-basic--docs)

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

@@ -0,0 +1,66 @@
+# numericbadge — Code & Implementation
+
+📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-texts-numericbadge-angular-basic--docs)
+
+## Angular
+
+Mots-clés : badge, numérique, compteur, count
+
+Component selector : `lu-numeric-badge`
+
+### Badge
+
+```js
+import { NUMERIC_BADGE_SIZE, NumericBadgeComponent } from '@lucca-front/ng/numeric-badge';
+import { PALETTE } from '@lucca/prisme/core';
+```
+
+```html
+<lu-numeric-badge maxValue="999" [value]="7" />
+```
+
+## HTML/CSS
+
+Classe CSS : `.numericBadge`
+
+### Badge basic
+
+```css
+@forward '@lucca-front/scss/src/components/numericBadge';
+```
+
+```html
+<span class="numericBadge">7</span>
+```
+
+### Badge loading
+
+```css
+@forward '@lucca-front/scss/src/components/numericBadge';
+```
+
+```html
+<span class="numericBadge is-loading" aria-hidden="true">7</span>
+```
+
+### Badge palette
+
+```css
+@forward '@lucca-front/scss/src/components/numericBadge';
+```
+
+```html
+<span class="numericBadge palette-product">7</span>
+```
+
+### Badge size
+
+```css
+@forward '@lucca-front/scss/src/components/numericBadge';
+```
+
+```html
+<span class="numericBadge">7</span>
+<span class="numericBadge mod-S">7</span>
+<span class="numericBadge mod-XS">7</span>
+```