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

package/llms/references/components/dialog/dialog.md

@@ -0,0 +1,335 @@
+# dialog
+
+## Import
+
+```typescript
+import { DialogContentComponent, DialogFooterComponent, DialogHeaderAction, DialogHeaderSubtitle, DialogHeaderComponent, DialogRoutingContainerComponent, DialogComponent, DialogCloseDirective, DialogDismissDirective, DialogOpenDirective } from '@lucca-front/ng/dialog';
+```
+
+## Basic Usage
+
+```html
+<div class="dialog_backdrop"></div>
+<div role="dialog" aria-modal="true" aria-labelledby="dialogInsideHeaderTitle1" class="dialog "> <div class="dialog-inside"> <form class="dialog-inside-formOptional"> <header class="dialog-inside-header"> <button type="button" class="dialog-inside-header-button button"> <span class="lucca-icon icon-signClose" aria-hidden="true"></span> <span class="pr-u-mask">Fermer</span> </button> <div class="dialog-inside-header-container"> <h1 class="dialog-inside-header-container-title" id="dialogInsideHeaderTitle1">Title</h1> </div> </header> <div class="dialog-inside-content">dialog</div> <footer class="dialog-inside-footer footer"> <div class="footer-actions"> <button type="submit" class="button">Action</button> <button type="button" class="button mod-ghost">Action</button> </div> </footer> </form> </div>
+</div>
+```
+
+## API Reference
+
+### DialogContentComponent (component)
+
+**Selector:** `lu-dialog-content`
+
+### DialogFooterComponent (component)
+
+**Selector:** `lu-dialog-footer`
+
+### DialogHeaderAction (directive)
+
+**Selector:** `[dialogHeaderAction]`
+
+### DialogHeaderSubtitle (directive)
+
+**Selector:** `[dialogHeaderSubtitle]`
+
+### DialogHeaderComponent (component)
+
+**Selector:** `lu-dialog-header`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `intl` | `intl` | `unknown` | — | — | — | — |
+
+### DialogRoutingContainerComponent (component)
+
+**Selector:** `lu-dialog-routing-container`
+
+### DialogComponent (component)
+
+**Selector:** `lu-dialog`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `stacked` | `stacked` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `fancyIllustration` | `fancyIllustration` | `'approval' \| 'checklist' \| 'email' \| 'install' \| 'mapping' \| 'save' \| 'users' \| 'welcome' \| 'payment-card'` | `'welcome'` | — | — | Modifie l’illustration affichée dans la Fancy dialog. |
+| `fancyIllustrationUrl` | `fancyIllustrationUrl` | `string \| null` | `null` | — | — | Surcharge l’illustration avec une URL personnalisée. |
+
+### DialogCloseDirective (directive)
+
+**Selector:** `[luDialogClose]`
+
+### DialogDismissDirective (directive)
+
+**Selector:** `[luDialogDismiss]`
+
+### DialogOpenDirective (directive)
+
+**Selector:** `[luDialogOpen]`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `dialog` | `luDialogOpen` | `TemplateRef<void>` | — | ✅ | — | — |
+| `luDialogConfig` | `luDialogConfig` | `LuDialogConfig<unknown>` | — | — | — | — |
+
+### Providers
+
+| Fonction | Signature | Description |
+|----------|-----------|-------------|
+| `provideDialogRoutingReuseStrategy` | `(): EnvironmentProviders` | — |
+| `configureLuDialog` | `(): EnvironmentProviders` | — |
+| `provideLuDialog` | `(): Provider` | — |
+
+### Injection tokens
+
+| Token | Type | Description |
+|-------|------|-------------|
+| `LU_DIALOG_HEADER_TRANSLATIONS` | `unknown` | — |
+| `DIALOG_ROUTE_CLOSE_TRIGGER` | `DialogRouteCloseTrigger` | — |
+| `DIALOG_ROUTE_DISMISS_TRIGGER` | `DialogRouteDismissTrigger` | — |
+| `DIALOG_ROUTE_CONFIG` | `DialogRouteConfig<unknown>` | — |
+
+### Services
+
+#### LuDialogService
+
+- `open<C, TData = LuDialogData<C>>(config: LuDialogConfig<C, NoInfer<TData>>): LuDialogRef<C, TData>`
+
+## Related files
+
+- 📝 [Code & implementation](./dialog.component.md)
+- 🎨 [Design guidelines](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/dialog/dialog.design.md)
+- 🎯 [Figma design tokens](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/dialog/dialog.figma.md)
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-overlays-dialog-basic--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
+
+`DialogComponent` :
+  ~ `stacked` : transform booleanAttribute → luBooleanAttribute
+
+### Notes de release (ZeroHeight)
+
+#### 21.3.0
+
+##### Added
+
+- `aria` attributes on the dialog trigger.
+- `DIALOG_FANCY_ILLUSTRATION` constant and `DialogFancyIllustration` type are now publicly exported.
+
+##### Fixed
+
+- Optional form handling inside a dialog.
+
+#### 21.2.3
+
+##### Added
+
+- Subtitle support in the cover layout of the dialog header, through a dedicated slot.
+
+#### 21.2.2
+
+##### Fixed
+
+- Size of the `mod-fancy` dialog.
+
+#### 21.2.1
+
+##### Fixed
+
+- Padding of the `mod-fancy` dialog.
+
+#### 21.2.0
+
+##### Added
+
+- `mod-fancy` dialog variant, with a configurable illustration URL.
+- `maxContent` size, and `fromBottom` behaviour for the `S` drawer.
+
+##### Fixed
+
+- Position of the close button and UI of the dialog buttons.
+
+#### 21.1.3
+
+##### Fixed
+
+- Rendering of stacked dialogs.
+
+#### 21.1.0
+
+##### Added
+
+- `resize()` method on the dialog reference, with an animation option.
+- `provideDialogRoutingReuseStrategy()` provider for dialogs opened through routes.
+
+##### Changed
+
+- `intl` input now accepts partial overrides that are merged with the default translations.
+
+#### 21.0.4
+
+##### Fixed
+
+- Layout of the dialog header.
+- `display` is no longer forced with `!important`.
+- Outlet configuration is applied to the parent route in the dialog factories.
+
+#### 21.0.3
+
+##### Fixed
+
+- Selector used by the dialog routing.
+- Double gap when the dialog has no action.
+
+#### 21.0.0
+
+##### Changed
+
+- Radius, margins and nesting of the dialogs.
+
+#### 20.3.4
+
+##### Changed
+
+- Close button now relies on `luButton`.
+
+##### Fixed
+
+- Overflow of long dialog titles.
+
+#### 20.3.3
+
+##### Fixed
+
+- `canMatch` is applied on the main route so sibling routes are reached correctly.
+
+#### 20.3.1
+
+##### Fixed
+
+- Shadow of the dialog footer.
+
+#### 20.3.0
+
+##### Added
+
+- A dialog can display a component given through the router.
+- `XXL` drawer variant.
+
+##### Fixed
+
+- `canDeactivate` is called the expected number of times.
+
+#### 20.2.2
+
+##### Fixed
+
+- `focus-visible` state while scrolling inside a dialog.
+
+#### 20.2.1
+
+##### Fixed
+
+- `NoInfer` added on the dialog `data` typing.
+
+#### 20.2.0
+
+##### Added
+
+- Content slot for the dialog actions.
+
+#### 20.1.3
+
+##### Fixed
+
+- Scroll inside dialogs opened through routing.
+
+#### 20.1.1
+
+##### Fixed
+
+- Missing public exports.
+
+#### 20.1.0
+
+##### Added
+
+- The `data` config type can now be overridden.
+
+#### 19.3.3
+
+##### Fixed
+
+- Overlay detachments are treated as a dismissal, and the `submitting` event is emitted reliably.
+
+#### 19.3.0
+
+##### Added
+
+- `canDeactivate` guards are supported in `dialogRoutingConfig`.
+
+#### 19.1.1
+
+##### Fixed
+
+- Closing a dialog that contains a popover.
+
+#### 18.3.3
+
+##### Fixed
+
+- `_addAriaLabelledBy` call in the dialog header is now null-safe.
+
+#### 18.3.0
+
+##### Added
+
+- Internal scroll of the dialog content.
+- `mod-neutral` background variant.
+
+##### Changed
+
+- The dialog grid uses a subgrid and handles overflow.
+- `dialogRouteFactory` handles all `Route` config options.
+
+#### 18.2.0
+
+##### Added
+
+- Dialogs can be opened through routes (`dialog-routing`).
+
+##### Fixed
+
+- Footer rendering on Safari.
+
+#### 18.1.4
+
+##### Fixed
+
+- `content` is no longer `null` when using `[luDialogConfig]` in a template-driven approach.
+
+#### 18.1.2
+
+##### Added
+
+- Closing can be disabled specifically for backdrop clicks.
+
+##### Changed
+
+- Long dialog titles break onto several lines.
+- `header` and `footer` roles removed from the dialog markup.
+
+#### 18.1.0
+
+##### Fixed
+
+- Autofocus of the first input when the dialog opens.

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

@@ -0,0 +1,35 @@
+# divider — Code & Implementation
+
+📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-structure-divider-angular--docs)
+
+## Angular
+
+Mots-clés : séparateur, ligne, horizontale, hr
+
+Component selector : `lu-divider`
+
+### Basic
+
+```js
+import { ButtonComponent } from '@lucca-front/ng/button';
+import { DIVIDER_SIZE, DividerComponent } from '@lucca-front/ng/divider';
+import { IconComponent } from '@lucca-front/ng/icon';
+```
+
+```html
+<lu-divider>Text</lu-divider>
+```
+
+## HTML/CSS
+
+Classe CSS : `.divider`
+
+### Basic
+
+```css
+@forward '@lucca-front/scss/src/components/divider';
+```
+
+```html
+<div class="divider">Text</div>
+```

package/llms/references/components/divider/divider.md

@@ -0,0 +1,88 @@
+# divider
+
+## Import
+
+```typescript
+import { DividerComponent } from '@lucca-front/ng/divider';
+```
+
+## Basic Usage
+
+```html
+<lu-divider >Text</lu-divider>
+```
+
+## API Reference
+
+### DividerComponent (component)
+
+**Selector:** `lu-divider`
+
+#### Inputs
+
+| Property | Binding name | Type | Default | Required | Transform | Description |
+|----------|-------------|------|---------|----------|-----------|-------------|
+| `separatorRole` | `separatorRole` | `boolean` | `false` | — | `luBooleanAttribute` | Permet de restituer Divider comme un séparateur natif (hr). Son éventuel contenu textuel ne sera alors plus restitué. |
+| `vertical` | `vertical` | `boolean` | `false` | — | `luBooleanAttribute` | — |
+| `size` | `size` | `DividerSize \| null` | `null` | — | — | — |
+| `withRole` | `withRole` | `boolean` | `false` | — | `luBooleanAttribute` | ⚠️ **Déprécié** : Déprécié.  |
+
+## Related files
+
+- 📝 [Code & implementation](./divider.component.md)
+
+- 🎯 [Figma design tokens](https://lucca-front.lucca.io/v22.0.6-rc.1/storybook/llms/references/components/divider/divider.figma.md)
+- 📖 [Storybook documentation](https://lucca-front.lucca.io/v22.0.0/storybook/?path=/docs/documentation-structure-divider-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
+
+~ `separatorRole` : transform booleanAttribute → luBooleanAttribute
+~ `vertical` : transform booleanAttribute → luBooleanAttribute
+~ `withRole` : transform booleanAttribute → luBooleanAttribute
+
+### Notes de release (ZeroHeight)
+
+#### 21.3.0
+
+##### Added
+
+- `DIVIDER_SIZE` constant and `DividerSize` type are now publicly exported and used to type the `size` input.
+
+#### 20.3.3
+
+##### Fixed
+
+- Host `role` is no longer set to an invalid value when `separatorRole` is not enabled.
+
+#### 20.2.0
+
+##### Fixed
+
+- `mod-vertical` margins are now applied on the inline axis instead of the block axis.
+
+#### 19.3.3
+
+##### Added
+
+- `separatorRole` input, replacing `withRole`.
+
+##### Deprecated
+
+- `withRole` input — use `separatorRole` instead.
+
+#### 19.1.0
+
+##### Added
+
+- `lu-divider` component (`divider`) with the `size`, `vertical` and `withRole` inputs.
+- `--components-divider-*` CSS custom properties to customize the divider.
+
+#### 18.2.0
+
+##### Fixed
+
+- Margins and icon color of the divider.