@besaitech/ng-design-system-mcp 0.0.5 → 0.0.7

package/data/docs.json

@@ -1,10 +1,10 @@
 {
   "schemaVersion": "1.0.0",
-  "libraryVersion": "0.0.29",
+  "libraryVersion": "0.0.34",
   "packageName": "@besaitech/ng-design-system",
   "devImport": "saitech-design-system",
-  "generatedAt": "2026-08-31T22:12:44.950Z",
-  "componentCount": 30,
+  "generatedAt": "2026-09-02T09:32:28.288Z",
+  "componentCount": 31,
   "components": [
     {
       "className": "SdsAccordion",
@@ -415,6 +415,15 @@
           "alias": null,
           "jsdoc": null
         },
+        {
+          "name": "shape",
+          "type": "SdsButtonShape",
+          "default": "'control'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "`pill` fully rounds the button. It is the shape a consumer-facing surface tends to want for its\nprimary action, and the same axis {@link SdsInput} exposes — a design system with pill inputs and\nno pill buttons would force any app that wants one back onto hand-rolled classes for its single\nmost important control."
+        },
         {
           "name": "type",
           "type": "'button' | 'submit' | 'reset'",
@@ -481,6 +490,11 @@
           "name": "SdsButtonSize",
           "kind": "union",
           "body": "'sm' | 'md' | 'lg'"
+        },
+        {
+          "name": "SdsButtonShape",
+          "kind": "union",
+          "body": "'control' | 'pill'"
         }
       ],
       "projectionSlots": [
@@ -610,6 +624,51 @@
           "transform": null,
           "alias": null,
           "jsdoc": null
+        },
+        {
+          "name": "calendarLabel",
+          "type": "string",
+          "default": "'Calendrier'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the calendar container. French default so existing consumers are unchanged,\nbut an app serving more than one language MUST translate it."
+        },
+        {
+          "name": "previousLabel",
+          "type": "string",
+          "default": "'Précédent'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the \"previous\" nav button. It is icon-only, so this string is its ONLY\naccessible name — a hardcoded French one is simply wrong in every other locale. Translate it in\nthe consuming app."
+        },
+        {
+          "name": "nextLabel",
+          "type": "string",
+          "default": "'Suivant'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the icon-only \"next\" nav button. See {@link previousLabel}."
+        },
+        {
+          "name": "todayActionLabel",
+          "type": "string",
+          "default": "\"Aujourd'hui\"",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Visible text of the \"today\" action (shown when {@link showActions} is true). Translate it in the\nconsuming app — the library ships no i18n of its own."
+        },
+        {
+          "name": "clearActionLabel",
+          "type": "string",
+          "default": "'Effacer'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Visible text of the \"clear\" action. See {@link todayActionLabel}."
         }
       ],
       "outputs": [
@@ -922,6 +981,87 @@
           "transform": null,
           "alias": null,
           "jsdoc": "Custom display formatter (default dd/MM/yyyy)."
+        },
+        {
+          "name": "clearLabel",
+          "type": "string",
+          "default": "'Effacer la date'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the clear button. French default so existing consumers are unchanged, but an\napp serving more than one language MUST translate it — it is an icon-only control, so this string\nis its only name."
+        },
+        {
+          "name": "openCalendarLabel",
+          "type": "string",
+          "default": "'Ouvrir le calendrier'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the icon-only calendar toggle while the panel is CLOSED. See\n{@link clearLabel} for why this has to be translatable."
+        },
+        {
+          "name": "closeCalendarLabel",
+          "type": "string",
+          "default": "'Fermer le calendrier'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the calendar toggle while the panel is OPEN. See {@link openCalendarLabel}."
+        },
+        {
+          "name": "panelLabel",
+          "type": "string",
+          "default": "'Sélection de date'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the overlay dialog that holds the calendar."
+        },
+        {
+          "name": "calendarLabel",
+          "type": "string",
+          "default": "'Calendrier'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Labels forwarded to the embedded <sds-calendar>. They live here because the picker is how the\ncalendar is normally reached — without forwarding, a consumer could translate the field but not\nthe panel it opens. Defaults match SdsCalendar's own, so nothing changes for existing consumers."
+        },
+        {
+          "name": "previousLabel",
+          "type": "string",
+          "default": "'Précédent'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "nextLabel",
+          "type": "string",
+          "default": "'Suivant'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "todayActionLabel",
+          "type": "string",
+          "default": "\"Aujourd'hui\"",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "clearActionLabel",
+          "type": "string",
+          "default": "'Effacer'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
         }
       ],
       "outputs": [],
@@ -1724,6 +1864,179 @@
       },
       "examples": []
     },
+    {
+      "className": "SdsOtpInput",
+      "selector": "sds-otp-input",
+      "kind": "component",
+      "group": "primitive",
+      "importName": "SdsOtpInput",
+      "description": "Champ de code à usage unique segmenté : une case par caractère, pour les courts codes numériques envoyés par e-mail ou SMS. Saisie automatique de case en case, collage réparti, navigation au clavier. Implémente ControlValueAccessor — utilisable avec les formulaires réactifs ou [(ngModel)] ; la valeur est la chaîne concaténée.",
+      "overviewDescription": "Code à usage unique segmenté : saisie auto, collage, clavier.",
+      "jsdoc": "A segmented one-time-code field: one box per character, for the short numeric codes emailed or\ntexted for sign-in and verification. Implements ControlValueAccessor — bind\n`formControlName`/`[(ngModel)]`; the value is the concatenated string (e.g. `\"483920\"`), and\n{@link completed} fires the moment every box is filled.\n\n<p>Only digits are accepted (`inputMode` is `numeric` by default). Typing auto-advances,\nBackspace steps back and clears, the arrow keys move between boxes, and pasting a whole code\ndistributes it across the boxes from the focused one — so a user can paste `483920` into the\nfirst box and have it land correctly.",
+      "example": null,
+      "cva": true,
+      "usesNgModel": true,
+      "inputs": [
+        {
+          "name": "length",
+          "type": "number",
+          "default": "6",
+          "required": false,
+          "transform": "numberAttribute",
+          "alias": null,
+          "jsdoc": "How many boxes / characters the code has."
+        },
+        {
+          "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 for the whole group when no visible [label] is provided."
+        },
+        {
+          "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": "SdsOtpInputSize",
+          "default": "'md'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "inputMode",
+          "type": "'numeric' | 'text'",
+          "default": "'numeric'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "`numeric` for digit codes (the default); `text` for alphanumeric codes."
+        },
+        {
+          "name": "disabled",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "autoFocus",
+          "type": "boolean",
+          "default": "false",
+          "required": false,
+          "transform": "booleanAttribute",
+          "alias": null,
+          "jsdoc": "Focus the first box on first render."
+        },
+        {
+          "name": "cellLabel",
+          "type": "string",
+          "default": "'Chiffre'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for an individual box, suffixed with its 1-based position (\"Digit 1\", \"Digit\n2\", …). French default so existing consumers are unchanged; translate it in an app serving more\nthan one language, since each box is an icon-less control whose only name this is."
+        }
+      ],
+      "outputs": [
+        {
+          "name": "completed",
+          "type": "string",
+          "fromModel": false
+        }
+      ],
+      "exportedTypes": [
+        {
+          "name": "SdsOtpInputSize",
+          "kind": "union",
+          "body": "'md' | 'lg'"
+        }
+      ],
+      "projectionSlots": [],
+      "hostBindings": {
+        "class": "block"
+      },
+      "examples": [
+        {
+          "sectionTitle": "Basique",
+          "sectionDescription": "Six cases, code numérique.",
+          "code": "<sds-otp-input label=\"Code de vérification\" [(ngModel)]=\"code\" />",
+          "runnableExample": "<sds-otp-input label=\"Code de vérification\" [(ngModel)]=\"code\" />\n          <p class=\"text-sm text-ink-soft\">\n            Valeur : <span class=\"font-mono font-medium text-ink\">{{ code() || '—' }}</span>\n          </p>",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Longueur",
+          "sectionDescription": "Le nombre de cases est réglable.",
+          "code": "<sds-otp-input label=\"Code à 4 chiffres\" [length]=\"4\" />",
+          "runnableExample": "<sds-otp-input label=\"Code à 4 chiffres\" [length]=\"4\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Avec aide",
+          "sectionDescription": null,
+          "code": "<sds-otp-input\n  label=\"Entrez le code\"\n  hint=\"Nous avons envoyé un code à 6 chiffres à votre adresse e-mail.\"\n/>",
+          "runnableExample": "<sds-otp-input\n            label=\"Entrez le code\"\n            hint=\"Nous avons envoyé un code à 6 chiffres à votre adresse e-mail.\"\n          />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Erreur",
+          "sectionDescription": null,
+          "code": "<sds-otp-input label=\"Code de vérification\" error=\"Code invalide ou expiré.\" />",
+          "runnableExample": "<sds-otp-input label=\"Code de vérification\" error=\"Code invalide ou expiré.\" />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Désactivé",
+          "sectionDescription": null,
+          "code": "<sds-otp-input label=\"Code de vérification\" [ngModel]=\"'12'\" disabled />",
+          "runnableExample": "<sds-otp-input label=\"Code de vérification\" [ngModel]=\"'12'\" disabled />",
+          "stack": true,
+          "dark": false
+        },
+        {
+          "sectionTitle": "Événement completed",
+          "sectionDescription": "Émis dès que la dernière case est remplie.",
+          "code": "<sds-otp-input label=\"Code de vérification\" (completed)=\"onCompleted($event)\" />",
+          "runnableExample": "<sds-otp-input label=\"Code de vérification\" (completed)=\"onCompleted($event)\" />\n          <p class=\"text-sm text-ink-soft\">\n            Dernier code complet :\n            <span class=\"font-mono font-medium text-ink\">{{ lastCompleted() || '—' }}</span>\n          </p>",
+          "stack": true,
+          "dark": false
+        }
+      ]
+    },
     {
       "className": "SdsPaginator",
       "selector": "sds-paginator",
@@ -1845,6 +2158,69 @@
           "alias": null,
           "jsdoc": null
         },
+        {
+          "name": "paginationLabel",
+          "type": "string",
+          "default": "'Pagination'",
+          "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."
+        },
+        {
+          "name": "firstPageLabel",
+          "type": "string",
+          "default": "'Première page'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "previousPageLabel",
+          "type": "string",
+          "default": "'Page précédente'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "nextPageLabel",
+          "type": "string",
+          "default": "'Page suivante'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "lastPageLabel",
+          "type": "string",
+          "default": "'Dernière 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 replaced with the 1-based page number —\na token rather than a prefix because word order is not the same in every language."
+        },
+        {
+          "name": "jumpToPageAriaLabel",
+          "type": "string",
+          "default": "'Aller à la 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."
+        },
         {
           "name": "size",
           "type": "SdsPaginatorSize",
@@ -2076,6 +2452,87 @@
           "transform": null,
           "alias": null,
           "jsdoc": null
+        },
+        {
+          "name": "countryLabel",
+          "type": "string",
+          "default": "'Indicatif pays : {country}'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name of the country selector. `{country}` is replaced with the selected country's\nname. A token rather than a prefix because word order differs per language. French default so\nexisting consumers are unchanged; translate it in any app serving more than one language.\n\nNote the interpolated country NAME still comes from the library's built-in country table, which\nis French-only — translating this template fixes the wrapper, not the name inside it."
+        },
+        {
+          "name": "clearLabel",
+          "type": "string",
+          "default": "'Effacer'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the clear button. It is icon-only, so this string is its ONLY accessible\nname — a hardcoded French one is simply wrong in every other locale."
+        },
+        {
+          "name": "searchLabel",
+          "type": "string",
+          "default": "'Rechercher un pays'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Accessible name for the country-search field inside the dropdown."
+        },
+        {
+          "name": "searchPlaceholder",
+          "type": "string",
+          "default": "'Rechercher un pays…'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Placeholder text of the country-search field."
+        },
+        {
+          "name": "noResultsLabel",
+          "type": "string",
+          "default": "'Aucun pays'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Shown in place of the list when no country matches the filter."
+        },
+        {
+          "name": "incompleteMessage",
+          "type": "string",
+          "default": "'Numéro incomplet — {lengths} chiffres attendus'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Built-in validation messages. `{lengths}` is replaced with the country's accepted national\nlengths, joined with {@link lengthSeparator}. Siblings of {@link requiredMessage}, which was\nalready translatable — these two were not, so an English or Dutch app showed French errors."
+        },
+        {
+          "name": "invalidMessage",
+          "type": "string",
+          "default": "'Numéro invalide — {lengths} chiffres attendus'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": null
+        },
+        {
+          "name": "lengthSeparator",
+          "type": "string",
+          "default": "' ou '",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Joins the accepted lengths when a country allows more than one (e.g. \"8 ou 9\")."
+        },
+        {
+          "name": "exampleHintTemplate",
+          "type": "string",
+          "default": "'Ex. {number}'",
+          "required": false,
+          "transform": null,
+          "alias": null,
+          "jsdoc": "Auto-generated example hint (see {@link showExampleHint}). `{number}` is replaced with the\nformatted international example number."
         }
       ],
       "outputs": [

package/dist/doc-index.schema.js

@@ -112,7 +112,9 @@ export const TokenSchema = z.object({
     semanticNote: z.string().nullable(),
 });
 export const InstallSchema = z.object({
-    npmrc: z.string(),
+    /** Legacy: the private-registry .npmrc block. The package is on public npm, so nothing emits this
+        any more. Kept optional rather than removed so an older generated docs.json still validates. */
+    npmrc: z.string().optional(),
     installCommand: z.string(),
     tailwindImport: z.string(),
     sourceDirective: z.string(),

package/dist/render.js

@@ -59,14 +59,13 @@ export function renderLlmsTxt(index) {
     const out = [];
     out.push(`# saitech-design-system (${index.packageName}) v${index.libraryVersion}`);
     out.push('');
-    out.push('> Angular 20 standalone component library (StaffKit / Cliniques universitaires Saitech), ' +
-        'styled with Tailwind CSS v4. Components are `Sds*` classes with `sds-*` selectors. ' +
-        'Generated from source; do not hand-edit.');
+    out.push('> Angular standalone component library styled with Tailwind CSS v4. Components are `Sds*` ' +
+        'classes with `sds-*` selectors. Generated from source; do not hand-edit.');
     out.push('');
     out.push('## Setup');
-    out.push(`- Install: \`${index.install.installCommand}\` (private GitLab registry — see .npmrc below)`);
+    out.push(`- Install: \`${index.install.installCommand}\` (public npm registry)`);
     out.push(`- Import: \`import { SdsButton } from '${index.packageName}';\``);
-    out.push('- Tailwind v4 is required in the consuming app: `@import "tailwindcss";`, the `@source` directive for the package, and the full `@theme` token block — otherwise components render unstyled.');
+    out.push('- Tailwind v4 is required in the consuming app: `@import "tailwindcss";`, the `@source` directive for the package, and a brand theme preset (`themes/saitech.css` or `themes/belvigo.css`) imported AFTER it — otherwise components render unstyled.');
     out.push('');
     const groups = ['primitive', 'form', 'layout', 'data'];
     out.push('## Components');

package/dist/server.js

@@ -133,7 +133,7 @@ export function buildServer(loaded) {
     });
     server.registerTool('sds_get_setup', {
         title: 'Get saitech-design-system install & Tailwind setup',
-        description: 'The install + Tailwind v4 setup checklist (registry .npmrc, install command, @import/@source/@theme, peer deps, standalone usage). The #1 source of "components render unstyled" issues.',
+        description: 'The install + Tailwind v4 setup checklist (install command, @import/@source, brand theme preset, peer deps, standalone usage). The #1 source of "components render unstyled" issues.',
         inputSchema: {
             context: z.enum(['consumer', 'contributor']).optional().describe('Audience (default: consumer).'),
         },

package/package.json

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