@supersoniks/concorde 5.0.5 → 5.1.1

package/docs/index.html

@@ -10,7 +10,7 @@
     <!-- <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
      -->
     <script src="https://cdn.jsdelivr.net/npm/marked@13.0.3"></script>
-    <script type="module" crossorigin src="./assets/index-wVZpLVYW.js"></script>
+    <script type="module" crossorigin src="./assets/index-Bb-_LRyY.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-CD4WyL6o.css">
   </head>
   <body class="px-6 lg:px-20">

package/index.html

@@ -5,15 +5,20 @@
     <link rel="icon" type="image/svg+xml" href="./svg/favicon.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Concorde - A supersonic design system</title>
-    <link rel="stylesheet" href="https://use.typekit.net/eda3clw.css" />
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Schibsted+Grotesk:wght@400;600;800&display=swap"
+      rel="stylesheet"
+    />
     <script src="https://cdn.jsdelivr.net/npm/fuzzysort@2.0.1/fuzzysort.min.js"></script>
     <!-- <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
      -->
     <script src="https://cdn.jsdelivr.net/npm/marked@13.0.3"></script>
     <script type="module" src="./src/docs.ts"></script>
-    <link href="./src/docs/tailwind/css/tailwind.css" rel="stylesheet" />
+    <link href="./src/docs/tailwind/css/docs.css" rel="stylesheet" />
   </head>
-  <body class="px-6 lg:px-20">
+  <body class="px-4 sm:px-6 lg:px-10 2xl:px-20">
     <sonic-theme
       customIconLibraryPath="https://cdn.supersoniks.com/concorde/icons/fontawesome/v6/$prefix/$name.svg"
       customIconDefaultPrefix="regular"
@@ -22,73 +27,32 @@
       <sonic-docs-header></sonic-docs-header>
       <sonic-router>
         <template data-route="^((?!.md).)*$">
-          <div class="col-span-full">
-            <div
-              class="font-headings text-4xl leading-none md:text-5xl lg:text-7xl xl:text-8xl max-w-[29ch] lg:max-w-[19ch] mt-9 mb-10 text-neutral-900"
-            >
-              webcomponents for
-              <div class="animated-text font-medium">
-                &nbsp;
-                <span> scoped </span>
-                <span> consistent </span>
-                <span> shareable </span>
-              </div>
-              user interfaces
-            </div>
-            <div class="text-base mt-6 relative z-2 mb-40">
-              <div
-                class="inline-flex gap-3 w-full text-lg leading-none flex-col lg:flex-row items-start lg:items-center"
-              >
-                <sonic-button
-                  size="2xl"
-                  variant="outline"
-                  type="primary"
-                  href="#docs/_getting-started/start.md/start"
-                >
-                  <sonic-icon
-                    name="airplane"
-                    library="iconoir"
-                    class="rotate-90 inline-block mr-1"
-                  ></sonic-icon
-                  ><span class="font-bold">Get Started</span>
-                </sonic-button>
-                <sonic-code language="bash" inline noEdit class="max-w-full">
-                  <template>
-                    npx @supersoniks/create-concorde-ts-starter "MyProject"
-                  </template></sonic-code
-                >
-              </div>
-            </div>
-            <img
-              src="./img/concorde_seuil.png.webp"
-              alt=""
-              loading="lazy"
-              class="w-full block dark:hidden"
-            />
-            <img
-              src="./img/concorde_seuil_invert.png"
-              alt=""
-              loading="lazy"
-              class="w-full hidden dark:block dark:opacity-60"
-            />
-          </div>
+          <docs-home></docs-home>
         </template>
       </sonic-router>
 
       <div
-        class="[[data-home]_&]:hidden grid grid-cols-[minmax(10rem,15rem)_minmax(0,1fr)] gap-8"
+        class="[[data-home]_&]:hidden grid grid-cols-1 lg:grid-cols-[14rem_minmax(0,1fr)] xl:grid-cols-[15rem_minmax(0,1fr)_13rem] gap-8 xl:gap-12"
       >
-        <div>
+        <aside class="hidden lg:block">
           <docs-navigation
-            class="sticky top-[4.2rem] max-h-[calc(100vh_-_4.2rem)] block overflow-auto py-4 custom-scroll"
+            class="sticky top-[4.2rem] max-h-[calc(100svh_-_4.2rem)] block overflow-auto py-4 custom-scroll"
           ></docs-navigation>
-        </div>
-        <div class="min-h-[100vh] pt-3">
-          <docs-page
-            noShadowDom
-            class="prose max-w-prose block py-8 prose-li:my-[.2em] leading-[1.5] lg:leading-[1.5] prose-h1:font-normal prose-h1:text-[3.25em] prose-code:before:content-none prose-code:after:content-none prose-pre:font-mono"
-          ></docs-page>
-        </div>
+        </aside>
+        <main class="min-w-0 min-h-[100svh] pt-3">
+          <div class="max-w-prose mx-auto xl:mx-0 justify-self-center">
+            <docs-page
+              noShadowDom
+              class="prose max-w-none block py-8 prose-li:my-[.2em] leading-[1.5] lg:leading-[1.5] prose-h1:text-[2.4em] sm:prose-h1:text-[3.25em] prose-code:before:content-none prose-code:after:content-none prose-pre:font-mono"
+            ></docs-page>
+            <docs-pager class="block mt-8 pb-16"></docs-pager>
+          </div>
+        </main>
+        <aside class="hidden xl:block">
+          <docs-toc
+            class="sticky top-[4.2rem] max-h-[calc(100svh_-_4.2rem)] block overflow-auto py-4 custom-scroll"
+          ></docs-toc>
+        </aside>
       </div>
     </sonic-theme>
   </body>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supersoniks/concorde",
-  "version": "5.0.5",
+  "version": "5.1.1",
   "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",
@@ -392,6 +425,7 @@
     "./example/decorators-demo-subscribe-publish-get-demos": "./src/docs/example/decorators-demo-subscribe-publish-get-demos.ts",
     "./example/decorators-demo": "./src/docs/example/decorators-demo.ts",
     "./example/docs-api-config-demos": "./src/docs/example/docs-api-config-demos.ts",
+    "./example/docs-boarding-pass-demo": "./src/docs/example/docs-boarding-pass-demo.ts",
     "./example/docs-input-autocomplete-demos": "./src/docs/example/docs-input-autocomplete-demos.ts",
     "./example/docs-joke-demos": "./src/docs/example/docs-joke-demos.ts",
     "./example/docs-jsonata-demos": "./src/docs/example/docs-jsonata-demos.ts",
@@ -405,6 +439,9 @@
     "./example/docs-users-list": "./src/docs/example/docs-users-list.ts",
     "./example/users": "./src/docs/example/users.ts",
     "./header/header": "./src/docs/header/header.ts",
+    "./home/catalog": "./src/docs/home/catalog.ts",
+    "./home/home": "./src/docs/home/home.ts",
+    "./home/mach-stage": "./src/docs/home/mach-stage.ts",
     "./layout": "./src/docs/layout.ts",
     "./mock-api/api-config-mock": "./src/docs/mock-api/api-config-mock.ts",
     "./mock-api/fixtures-jsonata": "./src/docs/mock-api/fixtures-jsonata.ts",
@@ -413,19 +450,23 @@
     "./mock-api/router": "./src/docs/mock-api/router.ts",
     "./mock-api/service-worker": "./src/docs/mock-api/service-worker.ts",
     "./mock-api/urls": "./src/docs/mock-api/urls.ts",
+    "./navigation/components-index": "./src/docs/navigation/components-index.ts",
     "./navigation/navigation": "./src/docs/navigation/navigation.ts",
-    "./prism/index": "./src/docs/prism/index.ts",
+    "./navigation/pager": "./src/docs/navigation/pager.ts",
+    "./navigation/toc": "./src/docs/navigation/toc.ts",
     "./search/markdown-renderer": "./src/docs/search/markdown-renderer.ts",
     "./search/page": "./src/docs/search/page.ts",
     "./search/search": "./src/docs/search/search.ts",
     "./search/sonic-code-markdown.spec": "./src/docs/search/sonic-code-markdown.spec.ts",
     "./search/sonic-code-markdown": "./src/docs/search/sonic-code-markdown.ts",
+    "./shiki/index": "./src/docs/shiki/index.ts",
     "./tailwind/css/tailwind.d": "./src/docs/tailwind/css/tailwind.d.ts",
     "./tailwind/css.d": "./src/docs/tailwind/css.d.ts",
     "./tailwind/index": "./src/docs/tailwind/index.ts",
     "./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",
@@ -437,7 +478,7 @@
     "marked": "^12.0.1",
     "marked-gfm-heading-id": "^3.1.3",
     "postcss": "^8.4.38",
-    "prismjs": "^1.29.0",
+    "shiki": "^3.23.0",
     "rollup-plugin-postcss-lit": "^2.1.0",
     "tailwindcss": "^3.4.3",
     "typescript": "^5.4.3",

package/public/img/archive/credits.json

@@ -0,0 +1,28 @@
+[
+  {
+    "file": "public/img/archive/concorde-red-arrows-2002.webm",
+    "media": "video",
+    "poster": "public/img/archive/concorde-red-arrows-2002-poster.jpg",
+    "ref": "commons:191164291",
+    "title": "Concorde & Red Arrows 2002",
+    "creator": "Steve Elliott from UK",
+    "creatorUrl": null,
+    "date": "2002",
+    "license": "CC BY-SA 2.0",
+    "licenseCode": "by-sa",
+    "licenseUrl": "https://creativecommons.org/licenses/by-sa/2.0",
+    "creditRequired": true,
+    "page": "https://commons.wikimedia.org/wiki/File:Concorde_%26_Red_Arrows_2002.webm",
+    "via": "Wikimedia Commons",
+    "video": "https://upload.wikimedia.org/wikipedia/commons/0/07/Concorde_%26_Red_Arrows_2002.webm",
+    "width": 640,
+    "height": 360,
+    "duration": 10.4,
+    "bytes": 402387,
+    "credit": "\"Concorde & Red Arrows 2002\" by Steve Elliott from UK, CC BY-SA 2.0, via Wikimedia Commons",
+    "notes": [
+      "Share-alike: an altered version (recoloured, combined with other pictures) must be shared under the same licence."
+    ],
+    "saved": "2026-10-25T16:21:03.878Z"
+  }
+]

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/);
+  });
+});

package/scripts/pre-build.mjs

@@ -1,5 +1,6 @@
 // console.log("hey");
 
+import { execFileSync } from "child_process";
 import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -25,6 +26,16 @@ fs.writeFileSync(
   JSON.stringify(icons)
 );
 
+console.log("🚀 Catalogue SDUI (CEM → component-catalog.json)");
+execFileSync(
+  process.execPath,
+  [path.resolve(__dirname, "generate-sdui-catalog.mjs")],
+  {
+    cwd: path.resolve(__dirname, ".."),
+    stdio: "inherit",
+  }
+);
+
 console.log("🚀 Maintenance des shortPath");
 function listFiles(dir) {
   let files = [];
@@ -116,6 +127,10 @@ const pExports = {
     "./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",