@supersoniks/concorde 5.0.5 → 5.1.0

package/scripts/github-export.mjs

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+/**
+ * Prépare une arborescence « lib publique » pour GitHub :
+ * - sans site doc (src/docs, index.html, …)
+ * - sans sonic-captcha (altcha.supersoniks.org)
+ * - sans scripts / jobs GitLab internes
+ *
+ * Usage :
+ *   node scripts/github-export.mjs [répertoire_cible]
+ *
+ * Par défaut : ../concorde-github-export
+ */
+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 IGNORE_FILE = path.join(ROOT, ".github-export-ignore");
+const DEFAULT_OUT = path.resolve(ROOT, "../concorde-github-export");
+
+const EXPORT_FILTER_KEY =
+  /(?:^|\/)(?:docs|mock-api|undefined)(?:\/|$)|captcha|\.demo\.|\.stories\.|TestUtils|\/prism\/|\/search\/|\/tailwind\/|\/header\/|\/navigation\/|\/layout\.ts$|\/code\.ts$|^code$|^docs$|^layout$/;
+
+function readIgnorePatterns() {
+  if (!fs.existsSync(IGNORE_FILE)) return [];
+  return fs
+    .readFileSync(IGNORE_FILE, "utf8")
+    .split("\n")
+    .map((l) => l.trim())
+    .filter((l) => l && !l.startsWith("#"));
+}
+
+function globToRegExp(pattern) {
+  const escaped = pattern
+    .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+    .replace(/\*\*/g, "{{GLOBSTAR}}")
+    .replace(/\*/g, "[^/]*")
+    .replace(/\{\{GLOBSTAR\}\}/g, ".*");
+  return new RegExp(`^${escaped}$`);
+}
+
+function shouldExclude(relativePath, patterns) {
+  const normalized = relativePath.replace(/\\/g, "/");
+  for (const pattern of patterns) {
+    const re = globToRegExp(pattern);
+    if (re.test(normalized)) return true;
+    if (normalized.startsWith(pattern.endsWith("/") ? pattern : `${pattern}/`))
+      return true;
+    if (normalized === pattern) return true;
+  }
+  return false;
+}
+
+function listAllFiles(dir, base = dir) {
+  const out = [];
+  for (const name of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (name.name === ".git" || name.name === "node_modules") continue;
+    const full = path.join(dir, name.name);
+    const rel = path.relative(base, full).replace(/\\/g, "/");
+    if (name.isDirectory()) {
+      if (shouldExclude(rel, ignorePatterns)) continue;
+      out.push(...listAllFiles(full, base));
+    } else {
+      if (!shouldExclude(rel, ignorePatterns)) out.push(rel);
+    }
+  }
+  return out;
+}
+
+function copyFile(rel, destRoot) {
+  const src = path.join(ROOT, rel);
+  const dest = path.join(destRoot, rel);
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+
+function patchUiTs(destRoot) {
+  const uiPath = path.join(
+    destRoot,
+    "src/core/components/ui/ui.ts",
+  );
+  if (!fs.existsSync(uiPath)) return;
+  const content = fs.readFileSync(uiPath, "utf8");
+  const patched = content.replace(
+    /import "\.\/captcha\/captcha";\n?/,
+    "",
+  );
+  fs.writeFileSync(uiPath, patched);
+}
+
+function exportHaystack(value) {
+  if (typeof value === "string") return value;
+  if (value && typeof value === "object") {
+    return `${value.types ?? ""}${value.default ?? ""}`;
+  }
+  return String(value);
+}
+
+function filterPackageJson(destRoot) {
+  const pkgPath = path.join(destRoot, "package.json");
+  if (!fs.existsSync(pkgPath)) return;
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+  if (pkg.exports && typeof pkg.exports === "object") {
+    const next = {};
+    for (const [key, value] of Object.entries(pkg.exports)) {
+      const hay = `${key}:${exportHaystack(value)}`;
+      if (EXPORT_FILTER_KEY.test(hay)) continue;
+      if (exportHaystack(value).includes("/captcha/")) continue;
+      if (exportHaystack(value).includes("/docs/")) continue;
+      if (exportHaystack(value).includes(".demo.")) continue;
+      if (exportHaystack(value).includes(".stories.")) continue;
+      next[key] = value;
+    }
+    pkg.exports = next;
+  }
+  fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+}
+
+function patchReadme(destRoot) {
+  const readmePath = path.join(destRoot, "README.md");
+  if (!fs.existsSync(readmePath)) return;
+  let text = fs.readFileSync(readmePath, "utf8");
+  text = text.replace(
+    /Le dépôt GitHub est un \*\*miroir\*\* synchronisé depuis GitLab \(voir \[OPEN_SOURCE_CHECKPOINT\.md\]\(OPEN_SOURCE_CHECKPOINT\.md\)\)\./,
+    "Le dépôt GitHub est un **export filtré** depuis GitLab (librairie uniquement, sans site doc ni composant captcha — voir [OPEN_SOURCE_CHECKPOINT.md](OPEN_SOURCE_CHECKPOINT.md)).",
+  );
+  fs.writeFileSync(readmePath, text);
+}
+
+const ignorePatterns = readIgnorePatterns();
+const outDir = path.resolve(process.argv[2] || DEFAULT_OUT);
+
+if (fs.existsSync(outDir)) {
+  fs.rmSync(outDir, { recursive: true, force: true });
+}
+fs.mkdirSync(outDir, { recursive: true });
+
+const files = listAllFiles(ROOT);
+for (const rel of files) {
+  copyFile(rel, outDir);
+}
+
+patchUiTs(outDir);
+filterPackageJson(outDir);
+patchReadme(outDir);
+
+console.log(`✅ Export GitHub : ${files.length} fichiers → ${outDir}`);
+console.log("   Exclusions : .github-export-ignore");
+console.log("   Patches    : ui.ts (sans captcha), package.json exports");

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",

package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts

@@ -76,7 +76,7 @@ export default class SDUIDescriptorTransformer {
   nodeMatchesPattern(pattern: SDUINode, node: SDUINode) {
     const patternDynamic = pattern as Record<string, string>;
     const nodeDynamic = node as Record<string, string>;
-    const keys = ["libraryKey", "innerHTML", "prefix", "suffix", "markup"];
+    const keys = ["libraryKey", "innerHTML", "prefix", "suffix", "markup", "textContent"];
     for (const key of keys) {
       if (!this.stringMatchesExpression(nodeDynamic[key], patternDynamic[key])) {
         return false;
@@ -123,7 +123,7 @@ export default class SDUIDescriptorTransformer {
       i++;
     }
     const idx = list[0]?.parent.nodes?.indexOf(list[0].child);
-    if (idx) {
+    if (idx != null && idx >= 0) {
       list[0].parent.nodes?.splice(idx, 1);
       list[0].parent.nodes?.splice(idx, 0, wrapper);
     }
@@ -161,12 +161,12 @@ export default class SDUIDescriptorTransformer {
       const childAttributes = item.child.attributes;
       if (childAttributes) {
         for (const key in childAttributes) {
-          if (!Object.prototype.hasOwnProperty.call(newUI.attributes, "key"))
+          if (!Object.prototype.hasOwnProperty.call(newUI.attributes, key))
             newUI.attributes[key] = childAttributes[key];
         }
       }
 
-      const keys = ["libraryKey", "innerHTML", "prefix", "suffix", "markup"];
+      const keys = ["libraryKey", "innerHTML", "prefix", "suffix", "markup", "textContent"];
       const childDynamic = item.child as Record<string, object | string>;
       const newUIDynamic = newUI as Record<string, object | string>;
       for (const key of keys) {
@@ -183,7 +183,7 @@ export default class SDUIDescriptorTransformer {
           newUI.nodes.push(node);
         }
       }
-      const idx = item.parent.nodes?.indexOf(item.child) || -1;
+      const idx = item.parent.nodes?.indexOf(item.child) ?? -1;
       if (idx != -1) {
         item.parent.nodes?.splice(idx, 1);
         item.parent.nodes?.splice(idx, 0, newUI);

package/src/core/components/functional/sdui/__fixtures__/descriptors.ts

@@ -0,0 +1,251 @@
+import type {
+  SDUIDescriptor,
+  SDUITransformDescription,
+} from "../types";
+
+/** Layout imbriqué : tagName, attributes, nodes (avec innerHTML — non safe). */
+export const layoutNested: SDUIDescriptor = {
+  nodes: [
+    {
+      tagName: "div",
+      attributes: { class: "sdui-layout", "data-role": "root" },
+      nodes: [
+        {
+          tagName: "section",
+          attributes: { class: "sdui-layout__main" },
+          nodes: [
+            { tagName: "h2", innerHTML: "Titre" },
+            {
+              tagName: "p",
+              attributes: { class: "lead" },
+              innerHTML: "Paragraphe",
+            },
+          ],
+        },
+        {
+          tagName: "aside",
+          attributes: { class: "sdui-layout__side" },
+          innerHTML: "Aside",
+        },
+      ],
+    },
+  ],
+};
+
+/**
+ * Layout structurel sans markup/innerHTML/prefix/suffix/js.
+ * Compatible profile="safe" (contenu texte via attributs de composants).
+ */
+export const layoutSafe: SDUIDescriptor = {
+  nodes: [
+    {
+      tagName: "div",
+      attributes: { class: "sdui-layout", "data-role": "root" },
+      nodes: [
+        {
+          tagName: "h2",
+          attributes: { class: "sdui-layout__title" },
+          textContent: "Titre safe",
+        },
+        {
+          tagName: "sonic-input",
+          attributes: { name: "email", label: "Email", type: "text" },
+        },
+        {
+          tagName: "sonic-button",
+          attributes: { type: "success", name: "go", value: "1" },
+          textContent: "Go",
+        },
+      ],
+    },
+  ],
+};
+
+/** markup + innerHTML (canaux HTML libres). */
+export const markupAndInnerHTML: SDUIDescriptor = {
+  nodes: [
+    {
+      markup:
+        'keep shouting <span class="badge">foo</span> <span class="badge">bar</span> !',
+    },
+    {
+      tagName: "div",
+      attributes: { class: "html-block" },
+      innerHTML: 'texte <strong>gras</strong>',
+    },
+  ],
+};
+
+/** prefix / suffix (injection HTML autour du nœud). */
+export const prefixSuffix: SDUIDescriptor = {
+  nodes: [
+    {
+      prefix: '<span class="prefix">avant</span>',
+      suffix: '<span class="suffix">après</span>',
+      tagName: "div",
+      attributes: { class: "core" },
+      innerHTML: "contenu",
+    },
+  ],
+};
+
+/** Library par défaut (submit) + contentElementSelector. */
+export const librarySubmit: SDUIDescriptor = {
+  nodes: [
+    {
+      libraryKey: "submit",
+      innerHTML: "Injected content",
+    },
+  ],
+};
+
+/** Library custom dans le descripteur. */
+export const customLibrary: SDUIDescriptor = {
+  library: {
+    card: {
+      tagName: "div",
+      attributes: { class: "card" },
+      contentElementSelector: ".card__body",
+      nodes: [
+        {
+          tagName: "div",
+          attributes: { class: "card__body" },
+        },
+      ],
+    },
+  },
+  nodes: [
+    {
+      libraryKey: "card",
+      nodes: [{ tagName: "span", innerHTML: "Hello card" }],
+    },
+  ],
+};
+
+/** parentElementSelector (injection ciblée dans le parent). */
+export const parentElementSelector: SDUIDescriptor = {
+  nodes: [
+    {
+      nodes: [
+        {
+          prefix: "👇 Selected parent element",
+          suffix: "☝️ End of selected parent element",
+          tagName: "span",
+        },
+        {
+          parentElementSelector: "span",
+          innerHTML: "Content having a parentElementSelector attribute",
+        },
+      ],
+    },
+  ],
+};
+
+/** Formulaire via library keys (form, fields, actions). */
+export const formFields: SDUIDescriptor = {
+  nodes: [
+    {
+      libraryKey: "form",
+      attributes: {
+        formDataProvider: "sdui-fixture-form",
+        endPoint: "/api/fixture-submit",
+      },
+      nodes: [
+        {
+          libraryKey: "formLayout",
+          nodes: [
+            {
+              libraryKey: "textfield",
+              attributes: { name: "email", label: "Email" },
+            },
+            {
+              libraryKey: "password",
+              attributes: { name: "password", label: "Password" },
+            },
+          ],
+        },
+        {
+          libraryKey: "formActions",
+          nodes: [
+            {
+              libraryKey: "submit",
+              innerHTML: "Envoyer",
+            },
+          ],
+        },
+      ],
+    },
+  ],
+};
+
+/** Nœud sonic-jsonata (structure DOM uniquement pour le snapshot). */
+export const jsonataNode: SDUIDescriptor = {
+  nodes: [
+    {
+      tagName: "sonic-jsonata",
+      attributes: {
+        inputProvider: "sdui-fixture-input",
+        outputProvider: "sdui-fixture-output",
+        expression: "$input.name",
+      },
+    },
+  ],
+};
+
+/** libraryKey inconnu → fallback div (comportement actuel). */
+export const missingLibraryKey: SDUIDescriptor = {
+  nodes: [
+    {
+      libraryKey: "does-not-exist",
+      attributes: { class: "fallback" },
+      innerHTML: "orphan",
+    },
+  ],
+};
+
+/**
+ * Descripteur d’entrée pour le transformer (remap).
+ * Matching via attributes (tagName n’est pas consulté par nodeMatchesPattern).
+ */
+export const transformRemapInput: SDUIDescriptor = {
+  nodes: [
+    {
+      tagName: "legacy-button",
+      attributes: { label: "Go", class: "legacy" },
+      nodes: [{ tagName: "span", innerHTML: "icon" }],
+    },
+    {
+      tagName: "div",
+      attributes: { class: "keep" },
+      innerHTML: "untouched",
+    },
+  ],
+};
+
+/** Description de transformation associée. */
+export const transformRemapDescription: SDUITransformDescription = {
+  transforms: [
+    {
+      action: "remap",
+      patterns: [{ attributes: { class: "legacy" } }],
+      ui: {
+        tagName: "sonic-button",
+        attributes: { type: "success" },
+      },
+    },
+  ],
+};
+
+/** Catalogue des fixtures de rendu (hors transform pur). */
+export const renderFixtures: Record<string, SDUIDescriptor> = {
+  layoutNested,
+  layoutSafe,
+  markupAndInnerHTML,
+  prefixSuffix,
+  librarySubmit,
+  customLibrary,
+  parentElementSelector,
+  formFields,
+  jsonataNode,
+  missingLibraryKey,
+};

package/src/core/components/functional/sdui/__snapshots__/sdui-action.spec.ts.snap

@@ -0,0 +1,73 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`sonic-sdui sdui-action > ne change pas le rendu formulaire (snapshot structurelle) 1`] = `
+[
+  {
+    "attrs": {
+      "endpoint": "/api/fixture-submit",
+      "formdataprovider": "sdui-fixture-form",
+      "onenterkey": "true",
+    },
+    "children": [
+      {
+        "children": [
+          {
+            "attrs": {
+              "label": "Email",
+              "name": "email",
+              "type": "text",
+            },
+            "tag": "sonic-input",
+          },
+          {
+            "attrs": {
+              "label": "Password",
+              "name": "password",
+              "type": "password",
+            },
+            "tag": "sonic-input",
+          },
+        ],
+        "tag": "sonic-form-layout",
+      },
+      {
+        "children": [
+          {
+            "attrs": {
+              "onclick": "true",
+            },
+            "children": [
+              {
+                "attrs": {
+                  "alignitems": "center",
+                  "shape": "default",
+                  "type": "success",
+                  "variant": "default",
+                },
+                "children": [
+                  {
+                    "attrs": {
+                      "aria-hidden": "true",
+                      "name": "check",
+                      "slot": "prefix",
+                    },
+                    "tag": "sonic-icon",
+                  },
+                  "Envoyer",
+                ],
+                "tag": "sonic-button",
+              },
+            ],
+            "tag": "sonic-submit",
+          },
+        ],
+        "tag": "sonic-form-actions",
+      },
+    ],
+    "tag": "sonic-submit",
+  },
+  {
+    "tag": "sonic-toast-message-subscriber",
+  },
+]
+`;

package/src/core/components/functional/sdui/__snapshots__/sdui-incremental.spec.ts.snap

@@ -0,0 +1,50 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`sonic-sdui ops incrémentales > ne régresse pas le chemin descripteur entier 1`] = `
+[
+  {
+    "attrs": {
+      "class": "sdui-layout",
+      "data-role": "root",
+    },
+    "children": [
+      {
+        "attrs": {
+          "class": "sdui-layout__main",
+        },
+        "children": [
+          {
+            "children": [
+              "Titre",
+            ],
+            "tag": "h2",
+          },
+          {
+            "attrs": {
+              "class": "lead",
+            },
+            "children": [
+              "Paragraphe",
+            ],
+            "tag": "p",
+          },
+        ],
+        "tag": "section",
+      },
+      {
+        "attrs": {
+          "class": "sdui-layout__side",
+        },
+        "children": [
+          "Aside",
+        ],
+        "tag": "aside",
+      },
+    ],
+    "tag": "div",
+  },
+  {
+    "tag": "sonic-toast-message-subscriber",
+  },
+]
+`;

package/src/core/components/functional/sdui/__snapshots__/sdui-partial.spec.ts.snap

@@ -0,0 +1,50 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`sonic-sdui rendu partiel > ne régresse pas sur un descripteur classique (snapshot) 1`] = `
+[
+  {
+    "attrs": {
+      "class": "sdui-layout",
+      "data-role": "root",
+    },
+    "children": [
+      {
+        "attrs": {
+          "class": "sdui-layout__main",
+        },
+        "children": [
+          {
+            "children": [
+              "Titre",
+            ],
+            "tag": "h2",
+          },
+          {
+            "attrs": {
+              "class": "lead",
+            },
+            "children": [
+              "Paragraphe",
+            ],
+            "tag": "p",
+          },
+        ],
+        "tag": "section",
+      },
+      {
+        "attrs": {
+          "class": "sdui-layout__side",
+        },
+        "children": [
+          "Aside",
+        ],
+        "tag": "aside",
+      },
+    ],
+    "tag": "div",
+  },
+  {
+    "tag": "sonic-toast-message-subscriber",
+  },
+]
+`;