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

package/data/docs.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": "1.0.0",
-  "libraryVersion": "0.0.40",
+  "libraryVersion": "0.0.41",
   "packageName": "@besaitech/ng-design-system",
   "devImport": "saitech-design-system",
-  "generatedAt": "2026-09-14T10:04:34.403Z",
-  "componentCount": 31,
+  "generatedAt": "2026-09-15T12:45:18.055Z",
+  "componentCount": 33,
   "components": [
     {
       "className": "SdsAccordion",
@@ -1576,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",
@@ -3053,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
         }
@@ -4013,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",
@@ -4395,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.10",
+  "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": {