@supersoniks/concorde 5.0.1 → 5.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (50) hide show
  1. package/build-infos.json +1 -1
  2. package/concorde-core.bundle.js +519 -586
  3. package/concorde-core.es.js +3783 -3689
  4. package/dist/concorde-core.bundle.js +519 -586
  5. package/dist/concorde-core.es.js +3783 -3689
  6. package/index.html +2 -2
  7. package/package.json +14 -1
  8. package/src/core/components/ui/_css/rounded.ts +36 -0
  9. package/src/core/components/ui/_css/type.ts +49 -0
  10. package/src/core/components/ui/_i18n/ui-aria-labels.ts +104 -0
  11. package/src/core/components/ui/alert/alert.md +128 -72
  12. package/src/core/components/ui/alert/alert.spec.ts +145 -0
  13. package/src/core/components/ui/alert/alert.ts +86 -91
  14. package/src/core/components/ui/alert-messages/alert-messages.ts +1 -1
  15. package/src/core/components/ui/badge/badge.md +126 -78
  16. package/src/core/components/ui/badge/badge.ts +29 -81
  17. package/src/core/components/ui/button/button.md +1 -0
  18. package/src/core/components/ui/button/button.ts +11 -8
  19. package/src/core/components/ui/card/card-header.ts +7 -2
  20. package/src/core/components/ui/card/card.md +120 -65
  21. package/src/core/components/ui/divider/divider.ts +4 -9
  22. package/src/core/components/ui/form/fieldset/legend-description.ts +1 -1
  23. package/src/core/components/ui/form/fieldset/legend.ts +1 -1
  24. package/src/core/components/ui/form/input/input.md +1 -1
  25. package/src/core/components/ui/form/input/input.ts +19 -15
  26. package/src/core/components/ui/form/textarea/textarea.md +1 -1
  27. package/src/core/components/ui/image/image.md +147 -53
  28. package/src/core/components/ui/image/image.ts +10 -44
  29. package/src/core/components/ui/link/link.md +2 -2
  30. package/src/core/components/ui/link/link.ts +42 -37
  31. package/src/core/components/ui/modal/modal-close.ts +8 -12
  32. package/src/core/components/ui/modal/modal.ts +18 -18
  33. package/src/core/components/ui/pop/pop.md +7 -5
  34. package/src/core/components/ui/pop/pop.ts +78 -38
  35. package/src/core/components/ui/table/table.ts +2 -8
  36. package/src/core/components/ui/toast/dismissed.ts +14 -0
  37. package/src/core/components/ui/toast/toast-item.ts +139 -91
  38. package/src/core/components/ui/toast/toast.ts +4 -7
  39. package/src/core/components/ui/tooltip/tooltip.ts +6 -8
  40. package/src/core/utils/LocationHandler.ts +12 -5
  41. package/src/core/utils/dismissed.ts +22 -0
  42. package/src/core/utils/positioning.spec.ts +28 -0
  43. package/src/core/utils/positioning.ts +19 -0
  44. package/src/docs/_getting-started/concorde-outside.md +3 -3
  45. package/src/docs/code.ts +3 -1
  46. package/src/docs/search/docs-search.json +541 -1
  47. package/src/docs/tailwind/css/tailwind.css +6 -0
  48. package/src/tsconfig.json +422 -383
  49. package/src/tsconfig.tsbuildinfo +1 -1
  50. package/tailwind.config.js +50 -3
package/index.html CHANGED
@@ -1,4 +1,4 @@
1
- <!DOCTYPE html>
1
+ <!doctype html>
2
2
  <html lang="fr">
3
3
  <head>
4
4
  <meta charset="UTF-8" />
@@ -84,7 +84,7 @@
84
84
  <div class="min-h-[100vh] pt-3">
85
85
  <docs-page
86
86
  noShadowDom
87
- class="prose lg:prose-lg max-w-prose block py-8 prose-li:my-[.2em] leading-[1.5] lg:leading-[1.5] prose-h1:font-normal prose-h1:text-[4.2em]"
87
+ class="prose max-w-prose block py-8 prose-li:my-[.2em] leading-[1.5] lg:leading-[1.5] prose-h1:font-normal prose-h1:text-[3.25em] prose-code:before:content-none prose-code:after:content-none prose-pre:font-mono"
88
88
  ></docs-page>
89
89
  </div>
90
90
  </div>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@supersoniks/concorde",
3
- "version": "5.0.1",
3
+ "version": "5.0.2",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "",
@@ -96,6 +96,9 @@
96
96
  "./functional/translation": "./src/core/components/functional/translation/translation.ts",
97
97
  "./value": "./src/core/components/functional/value/value.ts",
98
98
  "./functional/value": "./src/core/components/functional/value/value.ts",
99
+ "./rounded": "./src/core/components/ui/_css/rounded.ts",
100
+ "./ui/rounded": "./src/core/components/ui/_css/rounded.ts",
101
+ "./ui/_css/rounded": "./src/core/components/ui/_css/rounded.ts",
99
102
  "./scroll": "./src/core/components/ui/_css/scroll.ts",
100
103
  "./ui/scroll": "./src/core/components/ui/_css/scroll.ts",
101
104
  "./ui/_css/scroll": "./src/core/components/ui/_css/scroll.ts",
@@ -108,6 +111,12 @@
108
111
  "./type": "./src/core/components/ui/_css/type.ts",
109
112
  "./ui/type": "./src/core/components/ui/_css/type.ts",
110
113
  "./ui/_css/type": "./src/core/components/ui/_css/type.ts",
114
+ "./ui-aria-labels": "./src/core/components/ui/_i18n/ui-aria-labels.ts",
115
+ "./ui/ui-aria-labels": "./src/core/components/ui/_i18n/ui-aria-labels.ts",
116
+ "./ui/_i18n/ui-aria-labels": "./src/core/components/ui/_i18n/ui-aria-labels.ts",
117
+ "./alert.spec": "./src/core/components/ui/alert/alert.spec.ts",
118
+ "./ui/alert.spec": "./src/core/components/ui/alert/alert.spec.ts",
119
+ "./ui/alert/alert.spec": "./src/core/components/ui/alert/alert.spec.ts",
111
120
  "./alert": "./src/core/components/ui/alert/alert.ts",
112
121
  "./ui/alert": "./src/core/components/ui/alert/alert.ts",
113
122
  "./alert-messages": "./src/core/components/ui/alert-messages/alert-messages.ts",
@@ -270,6 +279,9 @@
270
279
  "./ui/theme/light": "./src/core/components/ui/theme/theme-collection/light.ts",
271
280
  "./theme": "./src/core/components/ui/theme/theme.ts",
272
281
  "./ui/theme": "./src/core/components/ui/theme/theme.ts",
282
+ "./dismissed": "./src/core/components/ui/toast/dismissed.ts",
283
+ "./ui/dismissed": "./src/core/components/ui/toast/dismissed.ts",
284
+ "./ui/toast/dismissed": "./src/core/components/ui/toast/dismissed.ts",
273
285
  "./message-subscriber": "./src/core/components/ui/toast/message-subscriber.ts",
274
286
  "./ui/message-subscriber": "./src/core/components/ui/toast/message-subscriber.ts",
275
287
  "./ui/toast/message-subscriber": "./src/core/components/ui/toast/message-subscriber.ts",
@@ -340,6 +352,7 @@
340
352
  "./utils/dataProviderKey": "./src/core/utils/dataProviderKey.ts",
341
353
  "./utils/derive.spec": "./src/core/utils/derive.spec.ts",
342
354
  "./utils/derive": "./src/core/utils/derive.ts",
355
+ "./utils/dismissed": "./src/core/utils/dismissed.ts",
343
356
  "./utils/dpOptions.spec": "./src/core/utils/dpOptions.spec.ts",
344
357
  "./utils/endpoint.spec": "./src/core/utils/endpoint.spec.ts",
345
358
  "./utils/endpoint": "./src/core/utils/endpoint.ts",
@@ -0,0 +1,36 @@
1
+ import { css } from "lit";
2
+
3
+ export type Rounded = "" | "base" | "none" | "full" | "sm" | "md" | "lg" | "xl";
4
+
5
+ export const hostRounded = css`
6
+ :host {
7
+ --sc-_rounded: 0;
8
+ border-radius: var(--sc-_rounded);
9
+ }
10
+ :host([rounded]),
11
+ :host([rounded="base"]) {
12
+ --sc-_rounded: var(--sc-rounded);
13
+ overflow: hidden;
14
+ }
15
+ :host([rounded="sm"]) {
16
+ --sc-_rounded: var(--sc-rounded-sm);
17
+ }
18
+
19
+ :host([rounded="md"]) {
20
+ --sc-_rounded: var(--sc-rounded-md);
21
+ }
22
+
23
+ :host([rounded="lg"]) {
24
+ --sc-_rounded: var(--sc-rounded-lg);
25
+ }
26
+ :host([rounded="xl"]) {
27
+ --sc-_rounded: var(--sc-rounded-xl);
28
+ }
29
+
30
+ :host([rounded="full"]) {
31
+ --sc-_rounded: 50% !important;
32
+ }
33
+ :host([rounded="none"]) {
34
+ --sc-_rounded: 0 !important;
35
+ }
36
+ `;
@@ -1,5 +1,54 @@
1
1
  import { css } from "lit";
2
2
 
3
+ /** Icônes pour les composants à `status` (API messages, alert, toast). */
4
+ export const statusIcon = {
5
+ default: "info-empty",
6
+ info: "info-empty",
7
+ success: "check-circled-outline",
8
+ warning: "warning-circled-outline",
9
+ error: "warning-circled-outline",
10
+ };
11
+
12
+ export type StatusIconKey = keyof typeof statusIcon;
13
+
14
+ export function toStatus(value?: string): StatusIconKey | undefined {
15
+ if (!value) return undefined;
16
+ if (value === "danger") return "error";
17
+ return value in statusIcon ? (value as StatusIconKey) : undefined;
18
+ }
19
+
20
+ export function statusAriaRole(status?: StatusIconKey): "alert" | "status" {
21
+ return status === "error" ? "alert" : "status";
22
+ }
23
+
24
+ export function statusAriaLive(status?: StatusIconKey): "polite" | null {
25
+ return status === "error" ? null : "polite";
26
+ }
27
+
28
+ export const statusColor = css`
29
+ :host {
30
+ --sc-_color: var(--sc-base-content, #000);
31
+ color: var(--sc-_color);
32
+ }
33
+
34
+ :host([status="warning"]) {
35
+ --sc-_color: var(--sc-warning, var(--sc-base-content, #000));
36
+ }
37
+ :host([status="error"]) {
38
+ --sc-_color: var(--sc-danger, var(--sc-base-content, #000));
39
+ }
40
+ :host([status="info"]) {
41
+ --sc-_color: var(--sc-info, var(--sc-base-content, #000));
42
+ }
43
+ :host([status="success"]) {
44
+ --sc-_color: var(--sc-success, var(--sc-base-content, #000));
45
+ }
46
+
47
+ .inherit-color {
48
+ color: var(--sc-_color);
49
+ }
50
+ `;
51
+
3
52
  export const typeColor = css`
4
53
  :host {
5
54
  --sc-_color: inherit;
@@ -0,0 +1,104 @@
1
+ import HTML from "@supersoniks/concorde/core/utils/HTML";
2
+
3
+ /** Langues supportées pour les libellés ARIA UI (anglais par défaut). */
4
+ export type UiLang = "en" | "fr" | "de" | "nl" | "es" | "it";
5
+
6
+ export type UiLabelDict = Partial<Record<UiLang, string>> & { en: string };
7
+
8
+ const supported = new Set<string>(["en", "fr", "de", "nl", "es", "it"]);
9
+
10
+ /** Lit la langue courante à chaque appel (pas d'état par composant). */
11
+ export function resolveUiLabel(dict: UiLabelDict, lang?: string): string {
12
+ const code = (lang ?? HTML.getLanguage() ?? "en").split("-")[0].toLowerCase();
13
+ if (supported.has(code) && dict[code as UiLang]) {
14
+ return dict[code as UiLang]!;
15
+ }
16
+ return dict.en;
17
+ }
18
+
19
+ export const uiAriaLabels = {
20
+ closeWindow: {
21
+ en: "Close window",
22
+ fr: "Fermer la fenêtre",
23
+ de: "Fenster schließen",
24
+ nl: "Venster sluiten",
25
+ es: "Cerrar ventana",
26
+ it: "Chiudi finestra",
27
+ },
28
+ closeAlert: {
29
+ en: "Close",
30
+ fr: "Fermer",
31
+ de: "Schließen",
32
+ nl: "Sluiten",
33
+ es: "Cerrar",
34
+ it: "Chiudi",
35
+ },
36
+ showPassword: {
37
+ en: "Show password",
38
+ fr: "Afficher le mot de passe",
39
+ de: "Passwort anzeigen",
40
+ nl: "Wachtwoord tonen",
41
+ es: "Mostrar contraseña",
42
+ it: "Mostra password",
43
+ },
44
+ hidePassword: {
45
+ en: "Hide password",
46
+ fr: "Masquer le mot de passe",
47
+ de: "Passwort ausblenden",
48
+ nl: "Wachtwoord verbergen",
49
+ es: "Ocultar contraseña",
50
+ it: "Nascondi password",
51
+ },
52
+ closeToast: {
53
+ en: "Close notification",
54
+ fr: "Fermer la notification",
55
+ de: "Benachrichtigung schließen",
56
+ nl: "Melding sluiten",
57
+ es: "Cerrar notificación",
58
+ it: "Chiudi notifica",
59
+ },
60
+ closeToastError: {
61
+ en: "Close error message",
62
+ fr: "Fermer le message d'erreur",
63
+ de: "Fehlermeldung schließen",
64
+ nl: "Foutmelding sluiten",
65
+ es: "Cerrar mensaje de error",
66
+ it: "Chiudi messaggio di errore",
67
+ },
68
+ closeToastWarning: {
69
+ en: "Close warning",
70
+ fr: "Fermer l'avertissement",
71
+ de: "Warnung schließen",
72
+ nl: "Waarschuwing sluiten",
73
+ es: "Cerrar advertencia",
74
+ it: "Chiudi avviso",
75
+ },
76
+ closeToastSuccess: {
77
+ en: "Close success message",
78
+ fr: "Fermer le message de succès",
79
+ de: "Erfolgsmeldung schließen",
80
+ nl: "Succesmelding sluiten",
81
+ es: "Cerrar mensaje de éxito",
82
+ it: "Chiudi messaggio di successo",
83
+ },
84
+ closeToastInfo: {
85
+ en: "Close information message",
86
+ fr: "Fermer l'information",
87
+ de: "Information schließen",
88
+ nl: "Informatie sluiten",
89
+ es: "Cerrar información",
90
+ it: "Chiudi informazione",
91
+ },
92
+ } as const satisfies Record<string, UiLabelDict>;
93
+
94
+ const toastCloseByStatus: Record<string, UiLabelDict> = {
95
+ error: uiAriaLabels.closeToastError,
96
+ warning: uiAriaLabels.closeToastWarning,
97
+ success: uiAriaLabels.closeToastSuccess,
98
+ info: uiAriaLabels.closeToastInfo,
99
+ };
100
+
101
+ export function resolveToastCloseLabel(status?: string): string {
102
+ const dict = status ? toastCloseByStatus[status] : undefined;
103
+ return resolveUiLabel(dict ?? uiAriaLabels.closeToast);
104
+ }
@@ -1,5 +1,9 @@
1
1
  # Alert
2
2
 
3
+ Inline message in the page: title (`label`), body (`text` or default slot), icon from `status`. For HTML or actions, use the slot instead of `label` / `text` (plain text only).
4
+
5
+ Use **`status`**: `default`, `info`, `success`, `warning`, `error`.
6
+
3
7
  <sonic-code>
4
8
  <template>
5
9
  <sonic-alert status="error" label="Email error" text="This address is already in use" background></sonic-alert>
@@ -8,15 +12,52 @@
8
12
 
9
13
  ## Status
10
14
 
15
+ Color and icon follow `status`. With no `status`, behavior is `default`.
16
+
11
17
  <sonic-code>
12
18
  <template>
13
- <div class="grid gap-4">
14
- <sonic-alert label="Default"> This address is already in use. </sonic-alert>
15
- <sonic-alert status="success" label="Success"> This address is already in use. </sonic-alert>
16
- <sonic-alert status="error" label="Error"> This address is already in use. </sonic-alert>
17
- <sonic-alert status="warning" label="Warning"> This address is already in use. </sonic-alert>
18
- <sonic-alert status="info" label="Info"> This address is already in use. </sonic-alert>
19
- </div>
19
+ <div class="grid gap-4">
20
+ <sonic-alert label="Default">This address is already in use.</sonic-alert>
21
+ <sonic-alert status="success" label="Success">This address is already in use.</sonic-alert>
22
+ <sonic-alert status="error" label="Error">This address is already in use.</sonic-alert>
23
+ <sonic-alert status="warning" label="Warning">This address is already in use.</sonic-alert>
24
+ <sonic-alert status="info" label="Info">This address is already in use.</sonic-alert>
25
+ </div>
26
+ </template>
27
+ </sonic-code>
28
+
29
+ ## Accessibility (`announce`)
30
+
31
+ By default, an alert already in the DOM is **not** announced (no `role` / `aria-live`). Set **`announce`** when the message appears **after** user action (API response, validation, etc.): screen readers get `role="alert"` for `error`, otherwise `role="status"` and `aria-live="polite"`.
32
+
33
+ `sonic-alert-messages` sets `announce` on every rendered alert.
34
+
35
+ <sonic-code>
36
+ <template>
37
+ <sonic-alert announce status="success" label="Saved" text="Your changes were saved."></sonic-alert>
38
+ </template>
39
+ </sonic-code>
40
+
41
+ ## Content and icon
42
+
43
+ `label` and `text` accept plain text only. The default slot is rendered after `text`. Use the **`icon`** slot to replace the default `sonic-icon`. **`noIcon`** hides the icon.
44
+
45
+ <sonic-code>
46
+ <template>
47
+ <sonic-alert status="info" noIcon label="No icon" text="Informational message."></sonic-alert>
48
+ </template>
49
+ </sonic-code>
50
+
51
+ ## Custom icon slot
52
+
53
+ Project any markup into **`slot="icon"`** (emoji, image, custom component). Keep it decorative with `aria-hidden="true"` when the message text already conveys meaning.
54
+
55
+ <sonic-code>
56
+ <template>
57
+ <sonic-alert status="success" label="Achievement unlocked" background>
58
+ <span slot="icon" aria-hidden="true" class="text-lg leading-none">🎉</span>
59
+ You unlocked a new badge.
60
+ </sonic-alert>
20
61
  </template>
21
62
  </sonic-code>
22
63
 
@@ -24,98 +65,113 @@
24
65
 
25
66
  <sonic-code>
26
67
  <template>
27
- <div class="grid gap-4">
28
- <sonic-alert status="error" label="Email error" size="2xs">
29
- This address is already in use. Lorem ipsum dolor sit amet.
30
- </sonic-alert>
31
- <sonic-alert status="error" label="Email error" size="xs">
32
- This address is already in use. Lorem ipsum dolor sit amet.
33
- </sonic-alert>
34
- <sonic-alert status="error" label="Email error" size="sm">
35
- This address is already in use. Lorem ipsum dolor sit amet.
36
- </sonic-alert>
37
- <sonic-alert status="error" label="Email error">
38
- This address is already in use. Lorem ipsum dolor sit amet.
39
- </sonic-alert>
40
- <sonic-alert status="error" label="Email error" size="lg">
41
- This address is already in use. Lorem ipsum dolor sit amet.
42
- </sonic-alert>
43
- <sonic-alert status="error" label="Email error" size="xl">
44
- This address is already in use. Lorem ipsum dolor sit amet.
45
- </sonic-alert>
46
- <sonic-alert status="error" label="Email error" size="2xl">
47
- This address is already in use. Lorem ipsum dolor sit amet.
48
- </sonic-alert>
49
- </div>
68
+ <div class="grid gap-4">
69
+ <sonic-alert status="error" label="Email error" size="2xs">
70
+ This address is already in use. Lorem ipsum dolor sit amet.
71
+ </sonic-alert>
72
+ <sonic-alert status="error" label="Email error" size="xs">
73
+ This address is already in use. Lorem ipsum dolor sit amet.
74
+ </sonic-alert>
75
+ <sonic-alert status="error" label="Email error" size="sm">
76
+ This address is already in use. Lorem ipsum dolor sit amet.
77
+ </sonic-alert>
78
+ <sonic-alert status="error" label="Email error">
79
+ This address is already in use. Lorem ipsum dolor sit amet.
80
+ </sonic-alert>
81
+ <sonic-alert status="error" label="Email error" size="lg">
82
+ This address is already in use. Lorem ipsum dolor sit amet.
83
+ </sonic-alert>
84
+ <sonic-alert status="error" label="Email error" size="xl">
85
+ This address is already in use. Lorem ipsum dolor sit amet.
86
+ </sonic-alert>
87
+ <sonic-alert status="error" label="Email error" size="2xl">
88
+ This address is already in use. Lorem ipsum dolor sit amet.
89
+ </sonic-alert>
90
+ </div>
50
91
  </template>
51
92
  </sonic-code>
52
93
 
53
94
  ## Alert with link
54
95
 
96
+ Rich content in the slot (buttons, links).
97
+
55
98
  <sonic-code>
56
99
  <template>
57
- <sonic-alert status="info" label="New messages !">
58
- You have 2 unread messages<br />
59
- <div class="flex gap-2 mt-1">
60
- <sonic-button variant="outline" type="info" size="xs">See messages</sonic-button>
61
- <sonic-button variant="ghost" type="info" size="xs">dismiss</sonic-button>
62
- </div>
63
- </sonic-alert>
100
+ <sonic-alert status="info" label="New messages !">
101
+ You have 2 unread messages<br />
102
+ <div class="flex gap-2 mt-1">
103
+ <sonic-button variant="outline" type="info" size="xs">See messages</sonic-button>
104
+ <sonic-button variant="ghost" type="info" size="xs">Dismiss</sonic-button>
105
+ </div>
106
+ </sonic-alert>
64
107
  </template>
65
108
  </sonic-code>
66
109
 
67
110
  ## Background
68
111
 
112
+ Tinted background from the `status` color (`color-mix` on `currentColor`).
113
+
69
114
  <sonic-code>
70
115
  <template>
71
- <div class="grid gap-4">
72
- <sonic-alert background label="Lorem ipsum dolor">
73
- This address is already in use.
74
- </sonic-alert>
75
- <sonic-alert status="success" background label="Lorem ipsum dolor">
76
- This address is already in use.
77
- </sonic-alert>
78
- <sonic-alert status="error" background label="Lorem ipsum dolor">
79
- This address is already in use.
80
- </sonic-alert>
81
- <sonic-alert status="warning" background label="Lorem ipsum dolor">
82
- This address is already in use.
83
- </sonic-alert>
84
- <sonic-alert status="info" background label="Lorem ipsum dolor">
85
- This address is already in use.
86
- </sonic-alert>
87
- </div>
116
+ <div class="grid gap-4">
117
+ <sonic-alert background label="Lorem ipsum dolor">This address is already in use.</sonic-alert>
118
+ <sonic-alert status="success" background label="Lorem ipsum dolor">
119
+ This address is already in use.
120
+ </sonic-alert>
121
+ <sonic-alert status="error" background label="Lorem ipsum dolor">
122
+ This address is already in use.
123
+ </sonic-alert>
124
+ <sonic-alert status="warning" background label="Lorem ipsum dolor">
125
+ This address is already in use.
126
+ </sonic-alert>
127
+ <sonic-alert status="info" background label="Lorem ipsum dolor">
128
+ This address is already in use.
129
+ </sonic-alert>
130
+ </div>
88
131
  </template>
89
132
  </sonic-code>
90
133
 
91
134
  ## Dismissible
92
135
 
136
+ `dismissible` removes the alert from the DOM when the close control is clicked (i18n aria label). **`dismissible`** and **`background`** are independent: without `background`, close sits at the end of the row; with `background`, top-right.
137
+
93
138
  <sonic-code>
94
139
  <template>
95
- <sonic-alert class="mb-3" dismissible label="Lorem ipsum dolor">
96
- This address is already in use.
97
- </sonic-alert>
98
- <sonic-alert status="success" class="mb-3" dismissible label="Lorem ipsum dolor">
99
- This address is already in use.
100
- </sonic-alert>
101
- <sonic-alert status="error" class="mb-3" dismissible label="Lorem ipsum dolor">
102
- This address is already in use.
103
- </sonic-alert>
104
- <sonic-alert status="warning" class="mb-3" dismissible label="Lorem ipsum dolor">
105
- This address is already in use.
106
- </sonic-alert>
107
- <sonic-alert status="info" class="mb-3" dismissible label="Lorem ipsum dolor">
108
- This address is already in use.
109
- </sonic-alert>
140
+ <sonic-alert status="info" class="mb-3" dismissible label="This address is already in use.">
141
+ </sonic-alert>
142
+ <sonic-alert class="mb-3" dismissible background label="Lorem ipsum dolor">
143
+ This address is already in use.
144
+ </sonic-alert>
145
+ <sonic-alert status="success" class="mb-3" dismissible background label="Lorem ipsum dolor">
146
+ This address is already in use.
147
+ </sonic-alert>
148
+ <sonic-alert status="error" class="mb-3" dismissible background label="Lorem ipsum dolor">
149
+ This address is already in use.
150
+ </sonic-alert>
151
+ <sonic-alert status="warning" class="mb-3" dismissible background label="Lorem ipsum dolor">
152
+ This address is already in use.
153
+ </sonic-alert>
154
+ <sonic-alert status="info" class="mb-3" dismissible background label="Lorem ipsum dolor">
155
+ This address is already in use.
156
+ </sonic-alert>
110
157
  </template>
111
158
  </sonic-code>
112
159
 
113
160
  ## Dismiss forever
114
161
 
162
+ With **`dismissForever`**, dismissal is stored in `localStorage` (key `sonic-alert-dismissed`). A stable **`id`** on the element is **required**; without `id`, a warning is logged and nothing is persisted.
163
+
115
164
  <sonic-code>
116
165
  <template>
117
- <sonic-alert class="mb-3" dismissible dismissForever label="Lorem ipsum dolor" id="addressUniqueId">
118
- This address is already in use.
119
- </sonic-alert>
166
+ <sonic-alert
167
+ class="mb-3"
168
+ dismissible
169
+ background
170
+ dismissForever
171
+ label="Lorem ipsum dolor"
172
+ id="addressUniqueId"
173
+ >
174
+ This address is already in use.
175
+ </sonic-alert>
120
176
  </template>
121
177
  </sonic-code>
@@ -0,0 +1,145 @@
1
+ import { expect, vi } from "vitest";
2
+ import TestUtils from "@supersoniks/concorde/test-utils/TestUtils";
3
+ import "./alert";
4
+ import { Alert } from "./alert";
5
+
6
+ async function create(attributes: string) {
7
+ const element = TestUtils.bootstrap(
8
+ `<sonic-alert ${attributes}></sonic-alert>`
9
+ )[0] as Alert;
10
+ await element.updateComplete;
11
+ return element;
12
+ }
13
+
14
+ describe("SonicAlert", () => {
15
+ it("utilise status=default par défaut", async () => {
16
+ const elt = await create("");
17
+ expect(elt.getAttribute("status")).toBe("default");
18
+ });
19
+
20
+ it("conserve status=error", async () => {
21
+ const elt = await create('status="error"');
22
+ expect(elt.status).toBe("error");
23
+ expect(elt.getAttribute("status")).toBe("error");
24
+ });
25
+
26
+ it.each(["warning", "success", "info"])(
27
+ "accepte status=%s",
28
+ async (value) => {
29
+ const elt = await create(`status="${value}"`);
30
+ expect(elt.getAttribute("status")).toBe(value);
31
+ }
32
+ );
33
+
34
+ it("n'expose pas role ni aria-live sans announce", async () => {
35
+ const elt = await create('status="error"');
36
+ expect(elt.hasAttribute("role")).toBe(false);
37
+ expect(elt.hasAttribute("aria-live")).toBe(false);
38
+ });
39
+
40
+ it("avec announce, role=alert pour error sans aria-live explicite", async () => {
41
+ const error = await create('announce status="error"');
42
+ expect(error.getAttribute("role")).toBe("alert");
43
+ expect(error.hasAttribute("aria-live")).toBe(false);
44
+ });
45
+
46
+ it("avec announce, role=status et aria-live=polite pour les autres status", async () => {
47
+ const info = await create('announce status="info"');
48
+ expect(info.getAttribute("role")).toBe("status");
49
+ expect(info.getAttribute("aria-live")).toBe("polite");
50
+ });
51
+
52
+ it("retire role et aria-live quand announce repasse à false", async () => {
53
+ const elt = await create("announce status=info");
54
+ expect(elt.getAttribute("role")).toBe("status");
55
+ elt.announce = false;
56
+ await elt.updateComplete;
57
+ expect(elt.hasAttribute("role")).toBe(false);
58
+ expect(elt.hasAttribute("aria-live")).toBe(false);
59
+ });
60
+
61
+ it("affiche un bouton de fermeture uniquement si dismissible", async () => {
62
+ const dismissible = await create("dismissible");
63
+ expect(dismissible.shadowRoot?.querySelector(".close-btn")).not.toBeNull();
64
+ const plain = await create("");
65
+ expect(plain.shadowRoot?.querySelector(".close-btn")).toBeNull();
66
+ });
67
+
68
+ it("retire l'alerte au clic sur le bouton dismissible", async () => {
69
+ const container = document.createElement("div");
70
+ document.body.appendChild(container);
71
+ container.innerHTML = '<sonic-alert dismissible text="msg"></sonic-alert>';
72
+ const elt = container.querySelector("sonic-alert") as Alert;
73
+ await elt.updateComplete;
74
+ const closeBtn = elt.shadowRoot?.querySelector(
75
+ ".close-btn"
76
+ ) as HTMLElement | null;
77
+ expect(closeBtn).not.toBeNull();
78
+ closeBtn!.click();
79
+ expect(container.querySelector("sonic-alert")).toBeNull();
80
+ container.remove();
81
+ });
82
+
83
+ it("masque l'icône décorative aux lecteurs d'écran", async () => {
84
+ const elt = await create('status="info"');
85
+ expect(
86
+ elt.shadowRoot?.querySelector("sonic-icon")?.getAttribute("aria-hidden")
87
+ ).toBe("true");
88
+ });
89
+
90
+ it("n'affiche pas l'icône si noIcon", async () => {
91
+ const elt = await create("noIcon");
92
+ expect(elt.shadowRoot?.querySelector("sonic-icon")).toBeNull();
93
+ });
94
+
95
+ it("traduit le libellé de fermeture selon la langue du document", async () => {
96
+ const previous = document.documentElement.lang;
97
+ document.documentElement.lang = "fr";
98
+ const fr = await create("dismissible");
99
+ expect(
100
+ (fr.shadowRoot?.querySelector(".close-btn") as HTMLElement & {
101
+ ariaLabel?: string;
102
+ })?.ariaLabel
103
+ ).toBe("Fermer");
104
+ document.documentElement.lang = "it";
105
+ const it = await create("dismissible");
106
+ expect(
107
+ (it.shadowRoot?.querySelector(".close-btn") as HTMLElement & {
108
+ ariaLabel?: string;
109
+ })?.ariaLabel
110
+ ).toBe("Chiudi");
111
+ document.documentElement.lang = previous;
112
+ });
113
+
114
+ it("n'interprète pas le HTML du label", async () => {
115
+ const elt = await create('label="<b>x</b>"');
116
+ expect(elt.shadowRoot?.querySelector(".label b")).toBeNull();
117
+ expect(elt.shadowRoot?.querySelector(".label")?.textContent).toBe(
118
+ "<b>x</b>"
119
+ );
120
+ });
121
+
122
+ it("mémorise la fermeture avec dismissForever et un id", async () => {
123
+ localStorage.clear();
124
+ const elt = await create('dismissForever id="my-alert"');
125
+ elt.close();
126
+ expect(JSON.parse(localStorage.getItem("sonic-alert-dismissed")!)).toEqual(
127
+ { "my-alert": true }
128
+ );
129
+ const children = TestUtils.bootstrap(
130
+ '<sonic-alert dismissForever id="my-alert"></sonic-alert>'
131
+ );
132
+ expect(children.length).toBe(0);
133
+ });
134
+
135
+ it("ne mémorise rien avec dismissForever sans id", async () => {
136
+ localStorage.clear();
137
+ const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
138
+ const elt = await create("dismissForever");
139
+ elt.close();
140
+ expect(localStorage.getItem("sonic-alert-dismissed")).toBeNull();
141
+ expect(warn).toHaveBeenCalled();
142
+ warn.mockRestore();
143
+ });
144
+
145
+ });