@besaitech/ng-design-system-mcp 0.0.9 → 0.0.11

package/data/docs.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": "1.0.0",
-  "libraryVersion": "0.0.36",
+  "libraryVersion": "0.0.41",
   "packageName": "@besaitech/ng-design-system",
   "devImport": "saitech-design-system",
-  "generatedAt": "2026-09-02T22:09:02.222Z",
-  "componentCount": 31,
+  "generatedAt": "2026-09-15T12:45:18.055Z",
+  "componentCount": 33,
   "components": [
     {
       "className": "SdsAccordion",
@@ -625,6 +625,60 @@
           "alias": null,
           "jsdoc": null
         },
+        {
+          "name": "showTime",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": "When true, a time editor (HH:mm, 24h) is shown and the value keeps its time-of-day."
+        },
+        {
+          "name": "showDone",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": "When true, a \"done\" action is shown (used by the overlay picker to close the panel)."
+        },
+        {
+          "name": "timeLabel",
+          "type": "string",
+          "default": "'Heure'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Visible label of the time editor. Translate it in the consuming app."
+        },
+        {
+          "name": "hoursLabel",
+          "type": "string",
+          "default": "'Heures'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name of the hours field (it is a bare numeric input)."
+        },
+        {
+          "name": "minutesLabel",
+          "type": "string",
+          "default": "'Minutes'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name of the minutes field."
+        },
+        {
+          "name": "doneLabel",
+          "type": "string",
+          "default": "'Terminé'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Visible text of the \"done\" action (shown when {@link showDone} is true)."
+        },
         {
           "name": "calendarLabel",
           "type": "string",
@@ -681,6 +735,11 @@
           "name": "dateSelect",
           "type": "Date",
           "fromModel": false
+        },
+        {
+          "name": "done",
+          "type": "void",
+          "fromModel": false
         }
       ],
       "exportedTypes": [],
@@ -973,6 +1032,15 @@
           "alias": null,
           "jsdoc": null
         },
+        {
+          "name": "showTime",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": "When true, the calendar shows a time editor (HH:mm, 24h), the value keeps its time-of-day, and\nthe field displays date + time. The overlay stays open on day-select so the time can be set;\na \"done\" action (and click-away / Escape) closes it."
+        },
         {
           "name": "format",
           "type": "(d: Date) => string",
@@ -980,7 +1048,43 @@
           "required": false,
           "transform": null,
           "alias": null,
-          "jsdoc": "Custom display formatter (default dd/MM/yyyy)."
+          "jsdoc": "Custom display formatter for the DATE part (default dd/MM/yyyy). The time is appended as HH:mm."
+        },
+        {
+          "name": "timeLabel",
+          "type": "string",
+          "default": "'Heure'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Visible label of the time editor (forwarded to the calendar). See {@link showTime}."
+        },
+        {
+          "name": "hoursLabel",
+          "type": "string",
+          "default": "'Heures'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name of the hours field (forwarded to the calendar)."
+        },
+        {
+          "name": "minutesLabel",
+          "type": "string",
+          "default": "'Minutes'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name of the minutes field (forwarded to the calendar)."
+        },
+        {
+          "name": "doneLabel",
+          "type": "string",
+          "default": "'Terminé'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Visible text of the calendar's \"done\" action, shown in the overlay when {@link showTime}."
         },
         {
           "name": "clearLabel",
@@ -1076,7 +1180,7 @@
       "hostBindings": {
         "class": "block",
         "(document:click)": "onDocumentClick($event)",
-        "(keydown.escape)": "close(true)"
+        "(keydown.escape)": "onEscape($event)"
       },
       "examples": [
         {
@@ -1103,6 +1207,14 @@
           "stack": true,
           "dark": false
         },
+        {
+          "sectionTitle": "Date et heure (showTime)",
+          "sectionDescription": "Ajoute un éditeur d'heure (HH:mm, 24h) ; la valeur conserve son heure. La surimpression reste ouverte après le choix du jour pour régler l'heure.",
+          "code": "<sds-date-picker label=\"Ouverture des inscriptions\" showTime [(ngModel)]=\"dateTime\" />\n<p>Sélection : {{ dateTime ? displayTime(dateTime) : '—' }}</p>\n\n// dateTime: Date | null = null;",
+          "runnableExample": "<sds-date-picker label=\"Ouverture des inscriptions\" showTime [(ngModel)]=\"dateTime\" />\n          <p class=\"text-sm text-ink-soft\">\n            Sélection :\n            <span class=\"font-medium text-ink\">{{ dateTime ? displayTime(dateTime) : '—' }}</span>\n          </p>",
+          "stack": true,
+          "dark": false
+        },
         {
           "sectionTitle": "Calendrier en ligne (inline)",
           "sectionDescription": null,
@@ -1464,6 +1576,179 @@
         }
       ]
     },
+    {
+      "className": "SdsLocalizedInput",
+      "selector": "sds-localized-input",
+      "kind": "component",
+      "group": "primitive",
+      "importName": "SdsLocalizedInput",
+      "description": "Un seul champ pour saisir un texte traduit (titre, libellé, description) dans plusieurs langues. Un sélecteur compact bascule la traduction éditée ; une pastille marque les langues déjà renseignées. Le champ s'ouvre sur currentLanguage (sinon la première langue). Implémente ControlValueAccessor sur la map { langue: texte }.",
+      "overviewDescription": null,
+      "jsdoc": "One language-aware text field for editing a translated value (a {@link SdsLocalizedValue} — a title,\nlabel or description in several languages). Only one language is edited at a time; a compact switcher\nsitting **inside the field** flips which translation you are editing, and a dot marks the languages that\nalready have content, so a partially-translated value is obvious at a glance.\n\nThe active language defaults to {@link currentLanguage} when it is one of {@link languages}, otherwise the\nfirst accepted language — so the field \"opens on the language you are working in\". Empty translations are\npruned from the emitted value, keeping the stored map clean.\n\nImplements ControlValueAccessor over the map — use with reactive forms or `[(ngModel)]`:\n`<sds-localized-input [languages]=\"['fr','nl','en']\" [(ngModel)]=\"title\" />`.",
+      "example": null,
+      "cva": true,
+      "usesNgModel": true,
+      "inputs": [
+        {
+          "name": "label",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "hint",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "placeholder",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "languages",
+          "type": "string[]",
+          "default": "[]",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "The accepted language codes, in display order (e.g. `['fr','nl','en']`)."
+        },
+        {
+          "name": "currentLanguage",
+          "type": "string | null",
+          "default": "null",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Language to pre-select; used when it is one of {@link languages}, else the first accepted language."
+        },
+        {
+          "name": "multiline",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "rows",
+          "type": "number",
+          "default": "3",
+          "required": false,
+          "transform": "numberAttribute",
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "size",
+          "type": "SdsLocalizedInputSize",
+          "default": "'md'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "languageSwitcherLabel",
+          "type": "string",
+          "default": "'Langue'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the in-field language switcher, and the \"no translation yet\" title suffix on each\nlanguage button. French defaults so existing consumers are unchanged; translate them in a multi-language\napp (the buttons are letter-only, so the title carries their meaning)."
+        },
+        {
+          "name": "untranslatedLabel",
+          "type": "string",
+          "default": "'à traduire'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        }
+      ],
+      "outputs": [],
+      "exportedTypes": [
+        {
+          "name": "SdsLocalizedValue",
+          "kind": "type",
+          "body": "Record<string, string>"
+        },
+        {
+          "name": "SdsLocalizedInputSize",
+          "kind": "union",
+          "body": "'sm' | 'md' | 'lg'"
+        }
+      ],
+      "projectionSlots": [],
+      "hostBindings": {
+        "class": "block"
+      },
+      "examples": [
+        {
+          "sectionTitle": "Basique",
+          "sectionDescription": "Passez les langues acceptées ; le champ s'ouvre sur la langue courante et n'édite qu'une langue à la fois.",
+          "code": "<sds-localized-input\n  label=\"Titre\"\n  [languages]=\"['fr', 'nl', 'en']\"\n  [(ngModel)]=\"title\"\n/>\n\n// title: SdsLocalizedValue = {};  // e.g. { fr: 'Signaler un incident' }",
+          "runnableExample": "<sds-localized-input label=\"Titre\" [languages]=\"['fr', 'nl', 'en']\" [(ngModel)]=\"title\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Valeur partiellement traduite",
+          "sectionDescription": "Une pastille pleine marque les langues renseignées, une pastille creuse celles qui restent à traduire.",
+          "code": "label = { fr: 'Applications & logiciels', en: 'Applications & software' };\n\n<sds-localized-input\n  label=\"Libellé de catégorie\"\n  [languages]=\"['fr', 'nl', 'en']\"\n  [(ngModel)]=\"label\"\n/>",
+          "runnableExample": "<sds-localized-input\n            label=\"Libellé de catégorie\"\n            [languages]=\"['fr', 'nl', 'en']\"\n            [(ngModel)]=\"label\"\n          />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Langue pré-sélectionnée",
+          "sectionDescription": "currentLanguage ouvre le champ sur une langue précise quand elle fait partie des langues acceptées.",
+          "code": "<sds-localized-input\n  label=\"Titre\"\n  [languages]=\"['fr', 'nl', 'en']\"\n  currentLanguage=\"nl\"\n  [(ngModel)]=\"title\"\n/>",
+          "runnableExample": "<sds-localized-input\n            label=\"Titre\"\n            [languages]=\"['fr', 'nl', 'en']\"\n            currentLanguage=\"nl\"\n            [(ngModel)]=\"titleNl\"\n          />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Multiligne",
+          "sectionDescription": "multiline rend une zone de texte au lieu d'un champ simple.",
+          "code": "<sds-localized-input\n  label=\"Description\"\n  [languages]=\"['fr', 'nl', 'en']\"\n  multiline\n  [rows]=\"3\"\n  [(ngModel)]=\"description\"\n/>",
+          "runnableExample": "<sds-localized-input\n            label=\"Description\"\n            [languages]=\"['fr', 'nl', 'en']\"\n            multiline\n            [rows]=\"3\"\n            [(ngModel)]=\"description\"\n          />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Désactivé",
+          "sectionDescription": null,
+          "code": "<sds-localized-input\n  label=\"Titre\"\n  [languages]=\"['fr', 'nl', 'en']\"\n  [(ngModel)]=\"value\"\n  disabled\n/>",
+          "runnableExample": "<sds-localized-input\n            label=\"Titre\"\n            [languages]=\"['fr', 'nl', 'en']\"\n            [ngModel]=\"label\"\n            disabled\n          />",
+          "stack": true,
+          "dark": false
+        }
+      ]
+    },
     {
       "className": "SdsMultiSelect",
       "selector": "sds-multi-select",
@@ -2125,7 +2410,7 @@
         {
           "name": "currentPageReportTemplate",
           "type": "string",
-          "default": "'{first} – {last} sur {totalRecords}'",
+          "default": "'{first} – {last} of {totalRecords}'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -2143,7 +2428,7 @@
         {
           "name": "rowsPerPageLabel",
           "type": "string",
-          "default": "'Lignes par page'",
+          "default": "'Rows per page'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -2152,7 +2437,7 @@
         {
           "name": "jumpToPageLabel",
           "type": "string",
-          "default": "'Aller à'",
+          "default": "'Go to'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -2165,12 +2450,12 @@
           "required": false,
           "transform": null,
           "alias": null,
-          "jsdoc": "Accessible name for the <nav> wrapping the page controls, and for the four icon-only\nfirst/prev/next/last buttons. Those buttons have no text, so these strings are their ONLY\naccessible names — the French defaults keep existing consumers unchanged, but an app serving more\nthan one language MUST pass translated values."
+          "jsdoc": "Accessible name for the <nav> wrapping the page controls, and for the four icon-only\nfirst/prev/next/last buttons. Those buttons have no text, so these strings are their ONLY\naccessible names — the English defaults suit an English-first app, but an app serving more than\none language MUST pass translated values."
         },
         {
           "name": "firstPageLabel",
           "type": "string",
-          "default": "'Première page'",
+          "default": "'First page'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -2179,7 +2464,7 @@
         {
           "name": "previousPageLabel",
           "type": "string",
-          "default": "'Page précédente'",
+          "default": "'Previous page'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -2188,7 +2473,7 @@
         {
           "name": "nextPageLabel",
           "type": "string",
-          "default": "'Page suivante'",
+          "default": "'Next page'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -2197,7 +2482,7 @@
         {
           "name": "lastPageLabel",
           "type": "string",
-          "default": "'Dernière page'",
+          "default": "'Last page'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -2215,11 +2500,11 @@
         {
           "name": "jumpToPageAriaLabel",
           "type": "string",
-          "default": "'Aller à la page'",
+          "default": "'Go to page'",
           "required": false,
           "transform": null,
           "alias": null,
-          "jsdoc": "Accessible name of the jump-to-page field. Separate from the visible {@link jumpToPageLabel}\n(\"Aller à\") on purpose: the visible text is terse because it sits next to the field, while the\naccessible name has to stand alone."
+          "jsdoc": "Accessible name of the jump-to-page field. Separate from the visible {@link jumpToPageLabel}\n(\"Go to\") on purpose: the visible text is terse because it sits next to the field, while the\naccessible name has to stand alone."
         },
         {
           "name": "size",
@@ -2722,6 +3007,15 @@
           "alias": null,
           "jsdoc": null
         },
+        {
+          "name": "appearance",
+          "type": "SdsSelectAppearance",
+          "default": "'default'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
         {
           "name": "disabled",
           "type": "boolean",
@@ -2774,6 +3068,11 @@
           "name": "SdsSelectSize",
           "kind": "union",
           "body": "'sm' | 'md' | 'lg'"
+        },
+        {
+          "name": "SdsSelectAppearance",
+          "kind": "union",
+          "body": "'default' | 'filled' | 'on-brand'"
         }
       ],
       "projectionSlots": [],
@@ -2927,7 +3226,7 @@
           "sectionTitle": "Navigation",
           "sectionDescription": "Les items acceptent [link] (routerLink avec état actif automatique) ; ici active est défini manuellement pour la démo.",
           "code": "<sds-sidebar>\n  <sds-nav-group>\n    <sds-nav-item icon=\"home\" label=\"Accueil\" link=\"/\" exact />\n  </sds-nav-group>\n\n  <sds-nav-group label=\"Membres\">\n    <sds-nav-item icon=\"user-plus\" label=\"Créer un membre\" link=\"/membres/creer\" />\n    <sds-nav-item icon=\"building-2\" label=\"Recherche Occupants\" link=\"/membres/occupants\" />\n  </sds-nav-group>\n\n  <div sdsFooter>\n    <sds-badge variant=\"warning\" dot>TEST V.1.0.0</sds-badge>\n  </div>\n</sds-sidebar>",
-          "runnableExample": "<div class=\"h-[460px] w-fit overflow-hidden rounded-card border border-border\">\n            <sds-sidebar>\n              <sds-nav-group>\n                <sds-nav-item icon=\"home\" label=\"Accueil\" active />\n              </sds-nav-group>\n\n              <sds-nav-group label=\"Membres\">\n                <sds-nav-item icon=\"user-plus\" label=\"Créer un membre\" />\n                <sds-nav-item icon=\"building-2\" label=\"Recherche Occupants\" />\n              </sds-nav-group>\n\n              <sds-nav-group label=\"Dotations\">\n                <sds-nav-item icon=\"package-plus\" label=\"Créer une dotation\" />\n                <sds-nav-item icon=\"rotate-ccw\" label=\"Retour de dotation\" />\n              </sds-nav-group>\n\n              <div sdsFooter>\n                <sds-badge variant=\"warning\" dot>TEST V.1.0.0</sds-badge>\n              </div>\n            </sds-sidebar>\n          </div>",
+          "runnableExample": "<div class=\"h-[460px] w-fit overflow-hidden rounded-card border border-border\">\n            <sds-sidebar>\n              <sds-nav-group>\n                <sds-nav-item icon=\"home\" label=\"Accueil\" active />\n              </sds-nav-group>\n\n              <sds-nav-group label=\"Membres\">\n                <sds-nav-item icon=\"user-plus\" label=\"Créer un membre\" />\n                <sds-nav-item icon=\"building-2\" label=\"Recherche Occupants\" />\n              </sds-nav-group>\n\n              <sds-nav-group label=\"Dotations\">\n                <sds-nav-item icon=\"package-plus\" label=\"Créer une dotation\" />\n                <sds-nav-item icon=\"rotate-ccw\" label=\"Retour de dotation\" />\n              </sds-nav-group>\n\n              <div sdsFooter class=\"text-[0.68rem] text-white/40 flex justify-center items-center\">\n                <div class=\"font-mono\">Saitech Design System v{{ version }}</div>\n              </div>\n            </sds-sidebar>\n          </div>",
           "stack": true,
           "dark": false
         }
@@ -3094,6 +3393,78 @@
           "alias": null,
           "jsdoc": null
         },
+        {
+          "name": "currentPageReportTemplate",
+          "type": "string",
+          "default": "'{first} – {last} of {totalRecords}'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Paginator labels, forwarded to the inner <sds-paginator>. English defaults suit an English-first\napp; an app serving more than one language MUST pass translated values (the four nav labels and\n{@link pageLinkLabel} name icon-only controls, so they are their ONLY accessible name).\n{@link currentPageReportTemplate} tokens: {first} {last} {totalRecords} {currentPage} {totalPages} {rows}."
+        },
+        {
+          "name": "rowsPerPageLabel",
+          "type": "string",
+          "default": "'Rows per page'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "paginationLabel",
+          "type": "string",
+          "default": "'Pagination'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "firstPageLabel",
+          "type": "string",
+          "default": "'First page'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "previousPageLabel",
+          "type": "string",
+          "default": "'Previous page'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "nextPageLabel",
+          "type": "string",
+          "default": "'Next page'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "lastPageLabel",
+          "type": "string",
+          "default": "'Last page'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "pageLinkLabel",
+          "type": "string",
+          "default": "'Page {page}'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name of a numbered page link; `{page}` is the 1-based page number."
+        },
         {
           "name": "globalFilter",
           "type": "boolean",
@@ -3106,7 +3477,7 @@
         {
           "name": "globalFilterPlaceholder",
           "type": "string",
-          "default": "'Rechercher…'",
+          "default": "'Search…'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -3115,7 +3486,7 @@
         {
           "name": "globalFilterAriaLabel",
           "type": "string",
-          "default": "'Rechercher dans le tableau'",
+          "default": "'Search the table'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -3160,7 +3531,7 @@
         {
           "name": "emptyMessage",
           "type": "string",
-          "default": "'Aucune donnée'",
+          "default": "'No data'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -3178,7 +3549,7 @@
         {
           "name": "ariaLabel",
           "type": "string",
-          "default": "'Tableau de données'",
+          "default": "'Data table'",
           "required": false,
           "transform": null,
           "alias": null,
@@ -3815,6 +4186,52 @@
         }
       ]
     },
+    {
+      "className": "SdsToastHost",
+      "selector": "sds-toast-host",
+      "kind": "component",
+      "group": "primitive",
+      "importName": "SdsToastService, SdsToastHost",
+      "description": "Notifications transitoires. Le code applicatif appelle SdsToastService.success / error / info après une action ; un unique <sds-toast-host> monté dans le shell affiche la file et chaque toast disparaît tout seul. Régions live accessibles : les erreurs interrompent (assertive), les succès/infos patientent (polite).",
+      "overviewDescription": null,
+      "jsdoc": "Renders the {@link SdsToastService} queue, fixed bottom-centre. Mount it once, in the app shell:\n`<sds-toast-host />`. Application code pushes toasts through the injected service.\n\nAccessibility: the two live regions are ALWAYS in the DOM (even when empty), because a live region must\npre-exist for its later content changes to be announced. Errors go to an assertive `role=\"alert\"` region\nso a failure interrupts; success/info go to a polite region so they queue.",
+      "example": null,
+      "cva": false,
+      "usesNgModel": false,
+      "inputs": [
+        {
+          "name": "closeLabel",
+          "type": "string",
+          "default": "'Fermer'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for each toast's close button. French default so existing consumers are unchanged; the\nbutton is icon-only, so an app serving more than one language MUST translate it."
+        }
+      ],
+      "outputs": [],
+      "exportedTypes": [],
+      "projectionSlots": [],
+      "hostBindings": {},
+      "examples": [
+        {
+          "sectionTitle": "Déclencher",
+          "sectionDescription": "Injectez SdsToastService et appelez success / error / info. Les erreurs restent affichées plus longtemps.",
+          "code": "private readonly toasts = inject(SdsToastService);\n\nsave(): void {\n  this.api.save(form).subscribe({\n    next: () => this.toasts.success('Formulaire enregistré.'),\n    error: () => this.toasts.error('Échec de l’enregistrement.'),\n  });\n}",
+          "runnableExample": "<div class=\"flex flex-wrap gap-2\">\n            <sds-button variant=\"secondary\" (click)=\"toasts.success('Formulaire enregistré.')\">\n              Succès\n            </sds-button>\n            <sds-button variant=\"secondary\" (click)=\"toasts.error('Échec de l’enregistrement.')\">\n              Erreur\n            </sds-button>\n            <sds-button variant=\"secondary\" (click)=\"toasts.info('Synchronisation en cours…')\">\n              Info\n            </sds-button>\n          </div>",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Mise en place",
+          "sectionDescription": "Montez l'hôte une seule fois (dans le shell de l'application), puis poussez des toasts depuis n'importe quel service ou composant.",
+          "code": "// Shell / app root — mount the host once:\n@Component({\n  imports: [SdsToastHost /* … */],\n  template: `\n    <sds-shell> … </sds-shell>\n    <sds-toast-host />\n  `,\n})\nexport class AppShell {}",
+          "runnableExample": "<p class=\"text-sm text-ink-soft\">\n            <code class=\"rounded bg-muted px-1.5 py-0.5 text-xs\">&lt;sds-toast-host /&gt;</code>\n            est monté une fois en haut de l'application ; il n'a pas de rendu propre tant qu'aucun toast n'est\n            actif.\n          </p>",
+          "stack": true,
+          "dark": false
+        }
+      ]
+    },
     {
       "className": "SdsToggleSwitch",
       "selector": "sds-toggle-switch",
@@ -4197,6 +4614,18 @@
       ],
       "jsdoc": "Coordinates a single <sds-tabs> instance: holds the active value (shared from\nthe host's two-way model), tracks registered tabs for default selection and\ngenerates the ARIA ids that link each tab to its panel.\n\nProvided at the <sds-tabs> component level so every tab set is isolated."
     },
+    {
+      "className": "SdsToastService",
+      "providedIn": "root",
+      "exports": [
+        "toasts",
+        "success()",
+        "error()",
+        "info()",
+        "dismiss()"
+      ],
+      "jsdoc": "A tiny transient-notification bus. Application code calls {@link success} / {@link error} / {@link info}\nafter an action; a single {@link SdsToastHost} mounted in the app shell renders the queue and each toast\nauto-dismisses. Deliberately minimal — no positions, no actions-in-toast — because it exists to confirm\nan action, not to be a notification centre.\n\n`providedIn: 'root'`, so injecting it anywhere shares one queue:\n\n```ts\nprivate readonly toasts = inject(SdsToastService);\nthis.toasts.success('Enregistré.');\n```\n\nMount the host once (e.g. in the shell): `<sds-toast-host />`."
+    },
     {
       "className": "SidebarStore",
       "providedIn": "root",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@besaitech/ng-design-system-mcp",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "MCP server that exposes the @besaitech/ng-design-system Angular component library documentation (API, examples, tokens, icons, setup) to AI coding tools.",
   "type": "module",
   "bin": {