@besaitech/ng-design-system-mcp 0.0.10 → 0.0.12

package/data/docs.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": "1.0.0",
-  "libraryVersion": "0.0.40",
+  "libraryVersion": "0.0.42",
   "packageName": "@besaitech/ng-design-system",
   "devImport": "saitech-design-system",
-  "generatedAt": "2026-09-14T10:04:34.403Z",
-  "componentCount": 31,
+  "generatedAt": "2026-09-19T16:33:04.483Z",
+  "componentCount": 34,
   "components": [
     {
       "className": "SdsAccordion",
@@ -1576,6 +1576,578 @@
         }
       ]
     },
+    {
+      "className": "SdsInputNumber",
+      "selector": "sds-input-number",
+      "kind": "component",
+      "group": "form",
+      "importName": "SdsInputNumber",
+      "description": "Champ numérique avec formatage localisé, devise, préfixe/suffixe, bornes min/max/pas et boutons d'incrément. La valeur est un number | null via ControlValueAccessor. Le formatage est appliqué en direct pendant la saisie : symbole monétaire, séparateurs de milliers et affixes restent visibles, et le curseur est préservé.",
+      "overviewDescription": "Saisie numérique : devise, préfixe/suffixe, bornes et incrémenteur.",
+      "jsdoc": "Numeric input with locale-aware formatting, optional currency, prefix/suffix affixes, min/max/step\nboundaries and spinner buttons — the design-system counterpart of PrimeNG's `InputNumber`.\n\nThe value is a `number | null` bound through ControlValueAccessor, so it works with reactive forms\nor `[(ngModel)]`: `<sds-input-number [(ngModel)]=\"amount\" mode=\"currency\" currency=\"EUR\" />`.\n\nThe field formats **live as you type**: the currency symbol, grouping separators and prefix/suffix\nstay visible on every keystroke, and the caret is kept where it belongs. The value is clamped to\n{@link min}/{@link max} on blur and on every spinner step; ArrowUp / ArrowDown also step it.",
+      "example": null,
+      "cva": true,
+      "usesNgModel": true,
+      "inputs": [
+        {
+          "name": "label",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "ariaLabel",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name used when no visible [label] is provided."
+        },
+        {
+          "name": "placeholder",
+          "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": "error",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "size",
+          "type": "SdsInputNumberSize",
+          "default": "'md'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "appearance",
+          "type": "SdsInputNumberAppearance",
+          "default": "'default'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "`filled` is a borderless field on a muted ground; `default` is the bordered white field."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "readonly",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": "Read-only: the value is shown and selectable but cannot be typed or stepped."
+        },
+        {
+          "name": "mode",
+          "type": "SdsInputNumberMode",
+          "default": "'decimal'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "locale",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "BCP 47 locale for grouping/decimal symbols (e.g. `fr-FR`). Empty follows the runtime locale."
+        },
+        {
+          "name": "currency",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "ISO 4217 code, required when {@link mode} is `currency` (e.g. `EUR`, `USD`)."
+        },
+        {
+          "name": "currencyDisplay",
+          "type": "SdsInputNumberCurrencyDisplay",
+          "default": "'symbol'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "useGrouping",
+          "type": "boolean",
+          "default": "true",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": "Thousands/grouping separators."
+        },
+        {
+          "name": "minFractionDigits",
+          "type": "number | null",
+          "default": "null",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "maxFractionDigits",
+          "type": "number | null",
+          "default": "null",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "prefix",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Text shown before the value (e.g. `↑ `)."
+        },
+        {
+          "name": "suffix",
+          "type": "string",
+          "default": "''",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Text shown after the value (e.g. ` kg`, `%`)."
+        },
+        {
+          "name": "min",
+          "type": "number | null",
+          "default": "null",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "max",
+          "type": "number | null",
+          "default": "null",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "step",
+          "type": "number",
+          "default": "1",
+          "required": false,
+          "transform": "numberAttribute",
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "showButtons",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": "Show the increment/decrement spinner buttons."
+        },
+        {
+          "name": "buttonLayout",
+          "type": "SdsInputNumberButtonLayout",
+          "default": "'stacked'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "incrementIcon",
+          "type": "SdsIconName | null",
+          "default": "null",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Override the increment button icon (defaults: chevron-up when stacked, plus otherwise)."
+        },
+        {
+          "name": "decrementIcon",
+          "type": "SdsIconName | null",
+          "default": "null",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Override the decrement button icon (defaults: chevron-down when stacked, minus otherwise)."
+        },
+        {
+          "name": "allowEmpty",
+          "type": "boolean",
+          "default": "true",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": "Allow an empty (null) value. When false, blurring an empty field falls back to {@link min} or 0."
+        },
+        {
+          "name": "clearable",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "clearLabel",
+          "type": "string",
+          "default": "'Effacer'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible names for the icon-only controls. French defaults so existing consumers are unchanged;\ntranslate them in a multi-language app."
+        },
+        {
+          "name": "incrementLabel",
+          "type": "string",
+          "default": "'Augmenter'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "decrementLabel",
+          "type": "string",
+          "default": "'Diminuer'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        }
+      ],
+      "outputs": [],
+      "exportedTypes": [
+        {
+          "name": "SdsInputNumberSize",
+          "kind": "union",
+          "body": "'sm' | 'md' | 'lg'"
+        },
+        {
+          "name": "SdsInputNumberAppearance",
+          "kind": "union",
+          "body": "'default' | 'filled'"
+        },
+        {
+          "name": "SdsInputNumberMode",
+          "kind": "union",
+          "body": "'decimal' | 'currency'"
+        },
+        {
+          "name": "SdsInputNumberCurrencyDisplay",
+          "kind": "union",
+          "body": "'symbol' | 'code' | 'name'"
+        },
+        {
+          "name": "SdsInputNumberButtonLayout",
+          "kind": "union",
+          "body": "'stacked' | 'horizontal' | 'vertical'"
+        }
+      ],
+      "projectionSlots": [],
+      "hostBindings": {
+        "class": "block"
+      },
+      "examples": [
+        {
+          "sectionTitle": "Basique",
+          "sectionDescription": "Regroupement des milliers selon la locale ; la valeur émise reste un nombre simple.",
+          "code": "<sds-input-number label=\"Lits disponibles\" [(ngModel)]=\"beds\" />\n\n// beds = 42723;  →  affiché « 42 723 »",
+          "runnableExample": "<sds-input-number label=\"Lits disponibles\" [(ngModel)]=\"beds\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Devise",
+          "sectionDescription": "mode='currency' avec un code ISO 4217 ; currencyDisplay choisit le symbole, le code ou le nom.",
+          "code": "<sds-input-number\n  label=\"Budget mensuel\"\n  mode=\"currency\"\n  currency=\"EUR\"\n  locale=\"fr-FR\"\n  [(ngModel)]=\"budget\"\n/>\n<sds-input-number\n  label=\"Facturation (US)\"\n  mode=\"currency\"\n  currency=\"USD\"\n  currencyDisplay=\"code\"\n  locale=\"en-US\"\n  [(ngModel)]=\"invoice\"\n/>",
+          "runnableExample": "<sds-input-number\n            label=\"Budget mensuel\"\n            mode=\"currency\"\n            currency=\"EUR\"\n            locale=\"fr-FR\"\n            [(ngModel)]=\"budget\"\n          />\n          <sds-input-number\n            label=\"Facturation (US)\"\n            mode=\"currency\"\n            currency=\"USD\"\n            currencyDisplay=\"code\"\n            locale=\"en-US\"\n            [(ngModel)]=\"invoice\"\n          />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Préfixe & suffixe",
+          "sectionDescription": "Des affixes texte pour les pourcentages, unités ou libellés — sur un nombre simple.",
+          "code": "<sds-input-number label=\"Taux d'occupation\" suffix=\" %\" [min]=\"0\" [max]=\"100\" [(ngModel)]=\"occupancy\" />\n<sds-input-number label=\"Poids du patient\" suffix=\" kg\" [minFractionDigits]=\"1\" [(ngModel)]=\"weight\" />\n<sds-input-number label=\"Température\" prefix=\"↑ \" suffix=\" ℃\" [(ngModel)]=\"temperature\" />",
+          "runnableExample": "<sds-input-number label=\"Taux d'occupation\" suffix=\" %\" [min]=\"0\" [max]=\"100\" [(ngModel)]=\"occupancy\" />\n          <sds-input-number label=\"Poids du patient\" suffix=\" kg\" [minFractionDigits]=\"1\" [(ngModel)]=\"weight\" />\n          <sds-input-number label=\"Température\" prefix=\"↑ \" suffix=\" ℃\" [(ngModel)]=\"temperature\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Bornes & pas",
+          "sectionDescription": "min, max et step encadrent la valeur ; le dépassement est corrigé à la validation et à chaque incrément.",
+          "code": "<sds-input-number\n  label=\"Dose (0–10, pas 0,5)\"\n  [min]=\"0\"\n  [max]=\"10\"\n  [step]=\"0.5\"\n  showButtons\n  [(ngModel)]=\"dose\"\n/>",
+          "runnableExample": "<sds-input-number\n            label=\"Dose (0–10, pas 0,5)\"\n            [min]=\"0\"\n            [max]=\"10\"\n            [step]=\"0.5\"\n            showButtons\n            [(ngModel)]=\"dose\"\n          />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Boutons",
+          "sectionDescription": "showButtons ajoute un incrémenteur ; buttonLayout le dispose en pile, à l'horizontale ou à la verticale.",
+          "code": "<sds-input-number label=\"Empilé\" showButtons [(ngModel)]=\"qty\" />\n<sds-input-number label=\"Horizontal\" showButtons buttonLayout=\"horizontal\" [(ngModel)]=\"qty\" />\n<sds-input-number label=\"Vertical\" showButtons buttonLayout=\"vertical\" [(ngModel)]=\"qty\" />",
+          "runnableExample": "<sds-input-number label=\"Empilé\" showButtons [(ngModel)]=\"qtyStacked\" />\n          <sds-input-number label=\"Horizontal\" showButtons buttonLayout=\"horizontal\" [(ngModel)]=\"qtyHorizontal\" />\n          <sds-input-number label=\"Vertical\" showButtons buttonLayout=\"vertical\" [(ngModel)]=\"qtyVertical\" />",
+          "stack": false,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Décimales & groupement",
+          "sectionDescription": "minFractionDigits / maxFractionDigits contrôlent la précision ; useGrouping='false' retire les séparateurs.",
+          "code": "<sds-input-number\n  label=\"Résultat de laboratoire\"\n  [minFractionDigits]=\"2\"\n  [maxFractionDigits]=\"4\"\n  [(ngModel)]=\"labResult\"\n/>\n<sds-input-number label=\"Référence dossier\" [useGrouping]=\"false\" [(ngModel)]=\"reference\" />",
+          "runnableExample": "<sds-input-number\n            label=\"Résultat de laboratoire\"\n            [minFractionDigits]=\"2\"\n            [maxFractionDigits]=\"4\"\n            [(ngModel)]=\"labResult\"\n          />\n          <sds-input-number label=\"Référence dossier\" [useGrouping]=\"false\" [(ngModel)]=\"reference\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Effaçable",
+          "sectionDescription": "clearable affiche un bouton d'effacement quand une valeur est saisie.",
+          "code": "<sds-input-number\n  label=\"Plafond de dépense\"\n  mode=\"currency\"\n  currency=\"EUR\"\n  locale=\"fr-FR\"\n  clearable\n  [(ngModel)]=\"cap\"\n/>",
+          "runnableExample": "<sds-input-number label=\"Plafond de dépense\" mode=\"currency\" currency=\"EUR\" locale=\"fr-FR\" clearable [(ngModel)]=\"cap\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Tailles",
+          "sectionDescription": null,
+          "code": "<sds-input-number size=\"sm\" label=\"Petit (sm)\" [(ngModel)]=\"value\" />\n<sds-input-number size=\"md\" label=\"Moyen (md)\" [(ngModel)]=\"value\" />\n<sds-input-number size=\"lg\" label=\"Grand (lg)\" [(ngModel)]=\"value\" />",
+          "runnableExample": "<sds-input-number size=\"sm\" label=\"Petit (sm)\" [(ngModel)]=\"sizeSm\" />\n          <sds-input-number size=\"md\" label=\"Moyen (md)\" [(ngModel)]=\"sizeMd\" />\n          <sds-input-number size=\"lg\" label=\"Grand (lg)\" [(ngModel)]=\"sizeLg\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Rempli & erreur",
+          "sectionDescription": null,
+          "code": "<sds-input-number appearance=\"filled\" label=\"Rempli\" [(ngModel)]=\"value\" />\n<sds-input-number label=\"Nombre requis\" [error]=\"'Veuillez saisir un nombre.'\" [(ngModel)]=\"value\" />",
+          "runnableExample": "<sds-input-number appearance=\"filled\" label=\"Rempli\" [(ngModel)]=\"filled\" />\n          <sds-input-number label=\"Nombre requis\" [error]=\"'Veuillez saisir un nombre.'\" [(ngModel)]=\"required\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Désactivé",
+          "sectionDescription": null,
+          "code": "<sds-input-number label=\"Capacité verrouillée\" [ngModel]=\"120\" disabled />",
+          "runnableExample": "<sds-input-number label=\"Capacité verrouillée\" [ngModel]=\"120\" disabled />",
+          "stack": true,
+          "dark": false
+        }
+      ]
+    },
+    {
+      "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",
@@ -3053,7 +3625,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
         }
@@ -4013,6 +4585,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",
@@ -4395,6 +5013,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",
@@ -4431,6 +5061,7 @@
       "chevron-down",
       "chevron-left",
       "chevron-right",
+      "chevron-up",
       "chevrons-left",
       "chevrons-right",
       "chevrons-up-down",
@@ -4455,6 +5086,7 @@
       "map-pin",
       "megaphone",
       "menu",
+      "minus",
       "monitor",
       "package",
       "package-open",
@@ -4466,6 +5098,7 @@
       "panel-top",
       "panels-top-left",
       "phone",
+      "plus",
       "refresh-cw",
       "rotate-ccw",
       "rows-3",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@besaitech/ng-design-system-mcp",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "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": {