@supersoniks/concorde 5.0.5 → 5.1.0

package/docs/src/tsconfig.declarations.json

@@ -0,0 +1,22 @@
+{
+  "extends": "./tsconfig-model.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "emitDeclarationOnly": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "../dist/types",
+    "rootDir": "."
+  },
+  "include": ["**/*.ts"],
+  "exclude": [
+    "node_modules/**/*",
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/*.demo.ts",
+    "**/*.stories.ts",
+    "**/*.type-test.ts",
+    "docs.ts",
+    "docs/**/*"
+  ]
+}

package/docs/src/tsconfig.emit.json

@@ -0,0 +1,23 @@
+{
+  "extends": "./tsconfig-model.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "emitDeclarationOnly": false,
+    "declaration": false,
+    "sourceMap": true,
+    "outDir": "../dist/js",
+    "rootDir": ".",
+    "lib": ["ES2021", "DOM", "DOM.Iterable"]
+  },
+  "include": ["**/*.ts"],
+  "exclude": [
+    "node_modules/**/*",
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/*.demo.ts",
+    "**/*.stories.ts",
+    "**/*.type-test.ts",
+    "docs.ts",
+    "docs/**/*"
+  ]
+}

package/docs/src/tsconfig.json

@@ -234,24 +234,6 @@
       "./functional/value": [
         "/sites/concorde/src/core/components/functional/value/value.ts"
       ],
-      "./align": [
-        "/sites/concorde/src/core/components/ui/_css/align.ts"
-      ],
-      "./ui/align": [
-        "/sites/concorde/src/core/components/ui/_css/align.ts"
-      ],
-      "./ui/_css/align": [
-        "/sites/concorde/src/core/components/ui/_css/align.ts"
-      ],
-      "./rounded": [
-        "/sites/concorde/src/core/components/ui/_css/rounded.ts"
-      ],
-      "./ui/rounded": [
-        "/sites/concorde/src/core/components/ui/_css/rounded.ts"
-      ],
-      "./ui/_css/rounded": [
-        "/sites/concorde/src/core/components/ui/_css/rounded.ts"
-      ],
       "./scroll": [
         "/sites/concorde/src/core/components/ui/_css/scroll.ts"
       ],
@@ -288,24 +270,6 @@
       "./ui/_css/type": [
         "/sites/concorde/src/core/components/ui/_css/type.ts"
       ],
-      "./ui-aria-labels": [
-        "/sites/concorde/src/core/components/ui/_i18n/ui-aria-labels.ts"
-      ],
-      "./ui/ui-aria-labels": [
-        "/sites/concorde/src/core/components/ui/_i18n/ui-aria-labels.ts"
-      ],
-      "./ui/_i18n/ui-aria-labels": [
-        "/sites/concorde/src/core/components/ui/_i18n/ui-aria-labels.ts"
-      ],
-      "./alert.spec": [
-        "/sites/concorde/src/core/components/ui/alert/alert.spec.ts"
-      ],
-      "./ui/alert.spec": [
-        "/sites/concorde/src/core/components/ui/alert/alert.spec.ts"
-      ],
-      "./ui/alert/alert.spec": [
-        "/sites/concorde/src/core/components/ui/alert/alert.spec.ts"
-      ],
       "./alert": [
         "/sites/concorde/src/core/components/ui/alert/alert.ts"
       ],
@@ -759,15 +723,6 @@
       "./ui/table": [
         "/sites/concorde/src/core/components/ui/table/table.ts"
       ],
-      "./auto": [
-        "/sites/concorde/src/core/components/ui/theme/theme-collection/auto.ts"
-      ],
-      "./ui/auto": [
-        "/sites/concorde/src/core/components/ui/theme/theme-collection/auto.ts"
-      ],
-      "./ui/theme/auto": [
-        "/sites/concorde/src/core/components/ui/theme/theme-collection/auto.ts"
-      ],
       "./core-variables": [
         "/sites/concorde/src/core/components/ui/theme/theme-collection/core-variables.ts"
       ],
@@ -801,15 +756,6 @@
       "./ui/theme": [
         "/sites/concorde/src/core/components/ui/theme/theme.ts"
       ],
-      "./dismissed": [
-        "/sites/concorde/src/core/components/ui/toast/dismissed.ts"
-      ],
-      "./ui/dismissed": [
-        "/sites/concorde/src/core/components/ui/toast/dismissed.ts"
-      ],
-      "./ui/toast/dismissed": [
-        "/sites/concorde/src/core/components/ui/toast/dismissed.ts"
-      ],
       "./message-subscriber": [
         "/sites/concorde/src/core/components/ui/toast/message-subscriber.ts"
       ],
@@ -945,6 +891,9 @@
       "./directives/Wording": [
         "/sites/concorde/src/core/directives/Wording.ts"
       ],
+      "./directives/stableTemplateContent": [
+        "/sites/concorde/src/core/directives/stableTemplateContent.ts"
+      ],
       "./mixins/Fetcher": [
         "/sites/concorde/src/core/mixins/Fetcher.ts"
       ],
@@ -1020,9 +969,6 @@
       "./utils/derive": [
         "/sites/concorde/src/core/utils/derive.ts"
       ],
-      "./utils/dismissed": [
-        "/sites/concorde/src/core/utils/dismissed.ts"
-      ],
       "./utils/dpOptions.spec": [
         "/sites/concorde/src/core/utils/dpOptions.spec.ts"
       ],
@@ -1038,12 +984,6 @@
       "./utils/jsonataRuntime": [
         "/sites/concorde/src/core/utils/jsonataRuntime.ts"
       ],
-      "./utils/positioning.spec": [
-        "/sites/concorde/src/core/utils/positioning.spec.ts"
-      ],
-      "./utils/positioning": [
-        "/sites/concorde/src/core/utils/positioning.ts"
-      ],
       "./utils/publisherPathKey.spec": [
         "/sites/concorde/src/core/utils/publisherPathKey.spec.ts"
       ],

package/gitlab/job_github_mirror.sh

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# Pousse un export filtré (lib publique) vers GitHub.
+# Remplace le push mirror « tout le dépôt » : pas de doc, pas de captcha, pas de gitlab/.
+#
+# Variables CI requises :
+#   GITHUB_REPO_URL  — ex. https://github.com/supersoniks/concorde.git
+#   GITHUB_TOKEN     — PAT avec scope repo (masqué)
+#
+# Usage manuel (hors CI) :
+#   GITHUB_REPO_URL=https://github.com/supersoniks/concorde.git \
+#   GITHUB_TOKEN=ghp_… \
+#   bash gitlab/job_github_mirror.sh
+#
+set -euo pipefail
+
+EXPORT_DIR="${CI_PROJECT_DIR:-$(cd "$(dirname "$0")/.." && pwd)}/.github-export"
+BRANCH="${GITHUB_BRANCH:-master}"
+
+if [[ -z "${GITHUB_REPO_URL:-}" || -z "${GITHUB_TOKEN:-}" ]]; then
+  echo "❌ GITHUB_REPO_URL et GITHUB_TOKEN sont requis."
+  exit 1
+fi
+
+echo "=== Export filtré ==="
+node "${CI_PROJECT_DIR:-.}/scripts/github-export.mjs" "$EXPORT_DIR"
+
+echo "=== Push vers GitHub ($BRANCH) ==="
+cd "$EXPORT_DIR"
+git init -q
+git config user.email "ci@supersoniks.org"
+git config user.name "GitLab CI"
+git add -A
+git commit -q -m "sync: export lib depuis GitLab ${CI_COMMIT_SHORT_SHA:-local}"
+
+PUSH_URL="${GITHUB_REPO_URL/https:\/\//https://${GITHUB_TOKEN}@}"
+git branch -M "$BRANCH"
+git push -f "$PUSH_URL" "$BRANCH"
+
+echo "=== Miroir GitHub à jour ==="

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersoniks/concorde",
-  "version": "5.0.5",
+  "version": "5.1.0",
   "license": "MIT",
   "type": "module",
   "main": "",
@@ -12,6 +12,7 @@
     "build-docs": "LIB_NAME=docs vite build",
     "postbuild-docs": "node scripts/post-build-docs.js",
     "prepublishOnly": "node scripts/pre-publish.mjs",
+    "generate:sdui-catalog": "node scripts/generate-sdui-catalog.mjs",
     "test": "vitest --reporter verbose --watch",
     "test:ci": "vitest run --reporter verbose",
     "ai-init": "node scripts/ai-init.mjs"
@@ -19,6 +20,8 @@
   "exports": {
     "./core/components/ui/icon/icons.json": "./src/core/components/ui/icon/icons.json",
     "./core/components/functional/sdui/default-library.json": "./src/core/components/functional/sdui/default-library.json",
+    "./core/components/functional/sdui/component-catalog.json": "./src/core/components/functional/sdui/component-catalog.json",
+    "./sdui/component-catalog.json": "./src/core/components/functional/sdui/component-catalog.json",
     "./dataProviderKey": "./src/core/utils/dataProviderKey.ts",
     "./*": "./src/*.ts",
     "./vite-config": "./vite/config.js",
@@ -73,9 +76,39 @@
     "./SDUIDescriptorTransformer": "./src/core/components/functional/sdui/SDUIDescriptorTransformer.ts",
     "./functional/SDUIDescriptorTransformer": "./src/core/components/functional/sdui/SDUIDescriptorTransformer.ts",
     "./functional/sdui/SDUIDescriptorTransformer": "./src/core/components/functional/sdui/SDUIDescriptorTransformer.ts",
+    "./descriptors": "./src/core/components/functional/sdui/__fixtures__/descriptors.ts",
+    "./functional/descriptors": "./src/core/components/functional/sdui/__fixtures__/descriptors.ts",
+    "./functional/sdui/descriptors": "./src/core/components/functional/sdui/__fixtures__/descriptors.ts",
+    "./component-catalog.spec": "./src/core/components/functional/sdui/component-catalog.spec.ts",
+    "./functional/component-catalog.spec": "./src/core/components/functional/sdui/component-catalog.spec.ts",
+    "./functional/sdui/component-catalog.spec": "./src/core/components/functional/sdui/component-catalog.spec.ts",
+    "./sdui-action.spec": "./src/core/components/functional/sdui/sdui-action.spec.ts",
+    "./functional/sdui-action.spec": "./src/core/components/functional/sdui/sdui-action.spec.ts",
+    "./functional/sdui/sdui-action.spec": "./src/core/components/functional/sdui/sdui-action.spec.ts",
+    "./sdui-dom-snapshot": "./src/core/components/functional/sdui/sdui-dom-snapshot.ts",
+    "./functional/sdui-dom-snapshot": "./src/core/components/functional/sdui/sdui-dom-snapshot.ts",
+    "./functional/sdui/sdui-dom-snapshot": "./src/core/components/functional/sdui/sdui-dom-snapshot.ts",
+    "./sdui-incremental.spec": "./src/core/components/functional/sdui/sdui-incremental.spec.ts",
+    "./functional/sdui-incremental.spec": "./src/core/components/functional/sdui/sdui-incremental.spec.ts",
+    "./functional/sdui/sdui-incremental.spec": "./src/core/components/functional/sdui/sdui-incremental.spec.ts",
+    "./sdui-partial.spec": "./src/core/components/functional/sdui/sdui-partial.spec.ts",
+    "./functional/sdui-partial.spec": "./src/core/components/functional/sdui/sdui-partial.spec.ts",
+    "./functional/sdui/sdui-partial.spec": "./src/core/components/functional/sdui/sdui-partial.spec.ts",
+    "./sdui-partial": "./src/core/components/functional/sdui/sdui-partial.ts",
+    "./functional/sdui-partial": "./src/core/components/functional/sdui/sdui-partial.ts",
+    "./functional/sdui/sdui-partial": "./src/core/components/functional/sdui/sdui-partial.ts",
+    "./sdui-safe.spec": "./src/core/components/functional/sdui/sdui-safe.spec.ts",
+    "./functional/sdui-safe.spec": "./src/core/components/functional/sdui/sdui-safe.spec.ts",
+    "./functional/sdui/sdui-safe.spec": "./src/core/components/functional/sdui/sdui-safe.spec.ts",
+    "./sdui-safe": "./src/core/components/functional/sdui/sdui-safe.ts",
+    "./functional/sdui-safe": "./src/core/components/functional/sdui/sdui-safe.ts",
+    "./functional/sdui/sdui-safe": "./src/core/components/functional/sdui/sdui-safe.ts",
     "./sdui-utils": "./src/core/components/functional/sdui/sdui-utils.ts",
     "./functional/sdui-utils": "./src/core/components/functional/sdui/sdui-utils.ts",
     "./functional/sdui/sdui-utils": "./src/core/components/functional/sdui/sdui-utils.ts",
+    "./sdui.regression.spec": "./src/core/components/functional/sdui/sdui.regression.spec.ts",
+    "./functional/sdui.regression.spec": "./src/core/components/functional/sdui/sdui.regression.spec.ts",
+    "./functional/sdui/sdui.regression.spec": "./src/core/components/functional/sdui/sdui.regression.spec.ts",
     "./sdui": "./src/core/components/functional/sdui/sdui.ts",
     "./functional/sdui": "./src/core/components/functional/sdui/sdui.ts",
     "./sonic-scope": "./src/core/components/functional/sonic-scope/sonic-scope.ts",
@@ -426,6 +459,7 @@
     "./TestUtils": "./src/test-utils/TestUtils.ts"
   },
   "devDependencies": {
+    "@custom-elements-manifest/analyzer": "^0.11.0",
     "@tailwindcss/typography": "^0.5.12",
     "@types/node": "^24.5.2",
     "@vitejs/plugin-basic-ssl": "^2.1.0",
@@ -452,4 +486,4 @@
     "url-pattern": "^1.0.3"
   },
   "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
-}
+}

package/scripts/generate-sdui-catalog.mjs

@@ -0,0 +1,250 @@
+/**
+ * Génère un catalogue neutre de composants pour SDUI / agents externes.
+ * Build-only : lit le Custom Elements Manifest + les tagName sources.
+ *
+ * Sorties :
+ * - src/core/components/functional/sdui/component-catalog.json
+ * - src/core/components/functional/sdui/component-catalog.gaps.json
+ */
+import { execFileSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, "..");
+const CEM_DIR = path.join(ROOT, ".tmp-cem");
+const CEM_PATH = path.join(CEM_DIR, "custom-elements.json");
+const OUT_CATALOG = path.join(
+  ROOT,
+  "src/core/components/functional/sdui/component-catalog.json"
+);
+const OUT_GAPS = path.join(
+  ROOT,
+  "src/core/components/functional/sdui/component-catalog.gaps.json"
+);
+
+function extractTagNameFromSource(filePath) {
+  if (!fs.existsSync(filePath)) return undefined;
+  const src = fs.readFileSync(filePath, "utf8");
+  const literal = src.match(/@customElement\(\s*["'`]([^"'`]+)["'`]\s*\)/);
+  if (literal) return literal[1];
+  const constTag = src.match(
+    /(?:const|let|var)\s+tagName\s*=\s*["'`]([^"'`]+)["'`]/
+  );
+  if (constTag && /@customElement\(\s*tagName\s*\)/.test(src)) {
+    return constTag[1];
+  }
+  return undefined;
+}
+
+function parseAllowedValues(typeText) {
+  if (!typeText) return undefined;
+  const values = [...typeText.matchAll(/["']([^"']+)["']/g)].map((m) => m[1]);
+  // Ignore if it looks like a single non-enum string type annotation noise
+  if (values.length < 2) return undefined;
+  return [...new Set(values)];
+}
+
+function stripDefaultQuotes(value) {
+  if (value == null) return undefined;
+  const s = String(value).trim();
+  if (
+    (s.startsWith('"') && s.endsWith('"')) ||
+    (s.startsWith("'") && s.endsWith("'"))
+  ) {
+    return s.slice(1, -1);
+  }
+  return s;
+}
+
+function isPublicProp(member) {
+  if (member.kind !== "field") return false;
+  if (member.privacy === "private" || member.privacy === "protected")
+    return false;
+  if (member.static) return false;
+  // Lit reactive props typically have attribute or are @property
+  return member.attribute != null || member.reflects || member.type;
+}
+
+/**
+ * Transforme un CEM Package en catalogue neutre.
+ * Exportée pour les tests unitaires.
+ */
+export function cemToCatalog(cem, { resolveTagName } = {}) {
+  const components = [];
+  const insufficientAnnotations = [];
+
+  for (const mod of cem.modules || []) {
+    const modulePath = mod.path;
+    for (const decl of mod.declarations || []) {
+      if (decl.kind !== "class" || !decl.customElement) continue;
+
+      const tag =
+        decl.tagName ||
+        (resolveTagName ? resolveTagName(modulePath, decl) : undefined);
+      if (!tag) {
+        insufficientAnnotations.push({
+          className: decl.name,
+          module: modulePath,
+          reasons: ["tagName introuvable (const tagName non résolu par CEM)"],
+        });
+        continue;
+      }
+
+      const props = (decl.members || []).filter(isPublicProp).map((m) => {
+        const typeText = m.type?.text?.replace(/\s+/g, " ").trim();
+        const prop = {
+          name: m.name,
+          attribute: m.attribute ?? m.name,
+          type: typeText || "unknown",
+        };
+        const values = parseAllowedValues(typeText);
+        if (values) prop.values = values;
+        const def = stripDefaultQuotes(m.default);
+        if (def !== undefined) prop.default = def;
+        if (m.description) prop.description = m.description.trim();
+        return prop;
+      });
+
+      const component = {
+        tag,
+        className: decl.name,
+        module: modulePath,
+        description: (decl.description || "").trim() || undefined,
+        props,
+      };
+
+      if (decl.slots?.length) {
+        component.slots = decl.slots.map((s) => ({
+          name: s.name || "",
+          description: s.description?.trim() || undefined,
+        }));
+      }
+      if (decl.events?.length) {
+        component.events = decl.events.map((e) => ({
+          name: e.name,
+          description: e.description?.trim() || undefined,
+          type: e.type?.text || undefined,
+        }));
+      }
+
+      // Exemple : premier @example du JSDoc si le CEM l'expose
+      const example = decl.examples?.[0]?.text || decl.example;
+      if (example) component.example = String(example).trim();
+
+      components.push(component);
+
+      const reasons = [];
+      if (!component.description) reasons.push("pas de description de classe");
+      const propsWithoutDesc = props.filter((p) => !p.description);
+      if (propsWithoutDesc.length > 0) {
+        reasons.push(
+          `${propsWithoutDesc.length} prop(s) sans description (${propsWithoutDesc
+            .slice(0, 5)
+            .map((p) => p.name)
+            .join(", ")}${propsWithoutDesc.length > 5 ? ", …" : ""})`
+        );
+      }
+      const propsUnknownType = props.filter((p) => p.type === "unknown");
+      if (propsUnknownType.length > 0) {
+        reasons.push(
+          `${propsUnknownType.length} prop(s) sans type (${propsUnknownType
+            .slice(0, 5)
+            .map((p) => p.name)
+            .join(", ")})`
+        );
+      }
+      // Pas d'exemple JSDoc : fréquent, non bloquant — omis des gaps.
+      if (reasons.length) {
+        insufficientAnnotations.push({ tag, module: modulePath, reasons });
+      }
+    }
+  }
+
+  components.sort((a, b) => a.tag.localeCompare(b.tag));
+  insufficientAnnotations.sort((a, b) =>
+    (a.tag || a.className || "").localeCompare(b.tag || b.className || "")
+  );
+
+  return {
+    version: 1,
+    generatedAt: new Date().toISOString(),
+    componentCount: components.length,
+    components,
+    insufficientAnnotations,
+  };
+}
+
+function runCem() {
+  fs.mkdirSync(CEM_DIR, { recursive: true });
+  const cemBin = path.join(
+    ROOT,
+    "node_modules/@custom-elements-manifest/analyzer/cem.js"
+  );
+  execFileSync(
+    process.execPath,
+    [
+      cemBin,
+      "analyze",
+      "--config",
+      path.join(ROOT, "custom-elements-manifest.config.mjs"),
+    ],
+    { cwd: ROOT, stdio: ["ignore", "pipe", "pipe"] }
+  );
+  // Ne pas laisser cem écrire customElements dans package.json
+  const pkgPath = path.join(ROOT, "package.json");
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+  if (pkg.customElements) {
+    delete pkg.customElements;
+    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+  }
+}
+
+function main() {
+  console.log("🚀 SDUI component catalog — CEM analyze…");
+  runCem();
+  const cem = JSON.parse(fs.readFileSync(CEM_PATH, "utf8"));
+  const catalog = cemToCatalog(cem, {
+    resolveTagName(modulePath) {
+      const abs = path.isAbsolute(modulePath)
+        ? modulePath
+        : path.join(ROOT, modulePath);
+      return extractTagNameFromSource(abs);
+    },
+  });
+
+  const { insufficientAnnotations, ...published } = catalog;
+  // Garder un résumé léger dans le catalogue publié
+  published.insufficientAnnotationCount = insufficientAnnotations.length;
+
+  fs.writeFileSync(OUT_CATALOG, JSON.stringify(published, null, 2) + "\n");
+  fs.writeFileSync(
+    OUT_GAPS,
+    JSON.stringify(
+      {
+        version: 1,
+        generatedAt: catalog.generatedAt,
+        count: insufficientAnnotations.length,
+        items: insufficientAnnotations,
+      },
+      null,
+      2
+    ) + "\n"
+  );
+
+  console.log(
+    `✅ Catalog: ${published.componentCount} composants → ${path.relative(ROOT, OUT_CATALOG)}`
+  );
+  console.log(
+    `ℹ️  Annotations insuffisantes: ${insufficientAnnotations.length} → ${path.relative(ROOT, OUT_GAPS)}`
+  );
+}
+
+const isMain =
+  process.argv[1] &&
+  path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+
+if (isMain) {
+  main();
+}

package/scripts/generate-sdui-catalog.spec.ts

@@ -0,0 +1,91 @@
+import { describe, expect, it } from "vitest";
+import { cemToCatalog } from "./generate-sdui-catalog.mjs";
+
+const fixtureCem = {
+  schemaVersion: "1.0.0",
+  modules: [
+    {
+      kind: "javascript-module",
+      path: "src/core/components/ui/button/button.ts",
+      declarations: [
+        {
+          kind: "class",
+          customElement: true,
+          name: "Button",
+          description: "Un bouton.",
+          members: [
+            {
+              kind: "field",
+              name: "type",
+              attribute: "type",
+              type: { text: '"default" | "success"' },
+              default: '"default"',
+              description: "Couleur",
+            },
+            {
+              kind: "field",
+              name: "secret",
+              privacy: "private",
+              type: { text: "string" },
+            },
+            {
+              kind: "field",
+              name: "undocumented",
+              attribute: "undocumented",
+              type: { text: "string" },
+            },
+          ],
+          slots: [{ name: "", description: "contenu" }],
+          events: [{ name: "click", type: { text: "Event" } }],
+        },
+      ],
+    },
+  ],
+};
+
+describe("cemToCatalog", () => {
+  it("produit un catalogue neutre avec props publiques", () => {
+    const catalog = cemToCatalog(fixtureCem, {
+      resolveTagName: () => "sonic-button",
+    });
+    expect(catalog.componentCount).toBe(1);
+    const btn = catalog.components[0];
+    expect(btn.tag).toBe("sonic-button");
+    expect(btn.description).toBe("Un bouton.");
+    expect(btn.props.map((p: { name: string }) => p.name)).toEqual([
+      "type",
+      "undocumented",
+    ]);
+    expect(btn.props[0]).toMatchObject({
+      name: "type",
+      attribute: "type",
+      type: '"default" | "success"',
+      values: ["default", "success"],
+      default: "default",
+      description: "Couleur",
+    });
+    expect(btn.slots?.[0].name).toBe("");
+    expect(btn.events?.[0].name).toBe("click");
+  });
+
+  it("liste les annotations insuffisantes", () => {
+    const catalog = cemToCatalog(fixtureCem, {
+      resolveTagName: () => "sonic-button",
+    });
+    const gap = catalog.insufficientAnnotations.find(
+      (g: { tag?: string }) => g.tag === "sonic-button"
+    );
+    expect(gap).toBeTruthy();
+    expect(gap.reasons.some((r: string) => r.includes("sans description"))).toBe(
+      true
+    );
+  });
+
+  it("signale un custom element sans tag résolu", () => {
+    const catalog = cemToCatalog(fixtureCem, {
+      resolveTagName: () => undefined,
+    });
+    expect(catalog.componentCount).toBe(0);
+    expect(catalog.insufficientAnnotations[0].reasons[0]).toMatch(/tagName/);
+  });
+});