@supersoniks/concorde 4.9.2 → 4.9.4

package/scripts/pre-build.mjs

@@ -137,6 +137,7 @@ const packageJsonPath = path.resolve(__dirname, "../package.json");
 let packageJson = JSON.parse(fs.readFileSync(packageJsonPath));
 
 const pExports = {
+  "./bundle": "./concorde-core.bundle.js",
   "./core/components/ui/icon/icons.json":
     "./src/core/components/ui/icon/icons.json",
   "./core/components/functional/sdui/default-library.json":

package/src/core/components/ui/icon/icon.ts

@@ -1,4 +1,5 @@
 import Icons from "@supersoniks/concorde/core/components/ui/icon/icons";
+import { ancestorAttribute } from "@supersoniks/concorde/core/decorators/Subscriber";
 import {
   css,
   LitElement,
@@ -82,6 +83,8 @@ export class Icon extends LitElement {
       name: this.name,
       prefix: this.prefix,
       library: this.library,
+      customLibraryPath: this.customIconLibraryPath,
+      customLibraryDefaultPrefix: this.customIconDefaultPrefix,
     });
   }
 
@@ -102,6 +105,14 @@ export class Icon extends LitElement {
    */
   @property({ type: String }) library = "";
 
+  @ancestorAttribute("customIconLibraryPath", { dynamic: true })
+  @state()
+  customIconLibraryPath: string | null = null;
+
+  @ancestorAttribute("customIconDefaultPrefix", { dynamic: true })
+  @state()
+  customIconDefaultPrefix: string | null = null;
+
   connectedCallback() {
     this.setAttribute("aria-hidden", "true");
     super.connectedCallback();
@@ -110,7 +121,10 @@ export class Icon extends LitElement {
     if (
       changedProperties.has("name") ||
       changedProperties.has("prefix") ||
-      changedProperties.has("library")
+      changedProperties.has("library") ||
+      (this.library === "custom" &&
+        (changedProperties.has("customIconLibraryPath") ||
+          changedProperties.has("customIconDefaultPrefix")))
     ) {
       this.updateIcon();
     }

package/src/core/components/ui/icon/icons.ts

@@ -43,22 +43,38 @@ const libraries = {
 type Libraries = typeof libraries;
 type LibraryKey = keyof Libraries;
 type Library = Partial<{ url: string; defaultPrefix: string }>;
-let hasEnabledCustomLibrary = false;
-function enableCustomLibrary() {
-  if (hasEnabledCustomLibrary) return;
 
-  libraries.custom.url =
-    document
-      .querySelector("[customIconLibraryPath]")
-      ?.getAttribute("customIconLibraryPath") || "";
-  libraries.custom.defaultPrefix =
-    document
-      .querySelector("[customIconDefaultPrefix]")
-      ?.getAttribute("customIconDefaultPrefix") || "";
+function resolveCustomLibraryConfig(params: IconConf): Library {
+  let url = params.customLibraryPath;
+  let defaultPrefix = params.customLibraryDefaultPrefix;
 
-  if (libraries.custom.url) {
-    hasEnabledCustomLibrary = true;
+  // Attribut optionnel : peut être défini sur un ancêtre (scope / theme) ou,
+  // en secours, n'importe où dans le document (ex. config globale au boot).
+  if (url == null) {
+    const globalEl = document.querySelector("[customIconLibraryPath]");
+    url = globalEl?.getAttribute("customIconLibraryPath") ?? "";
+    if (defaultPrefix == null) {
+      defaultPrefix =
+        globalEl?.getAttribute("customIconDefaultPrefix") ??
+        document
+          .querySelector("[customIconDefaultPrefix]")
+          ?.getAttribute("customIconDefaultPrefix") ??
+        "";
+    }
   }
+
+  return {
+    url: url || "",
+    defaultPrefix: defaultPrefix || "",
+  };
+}
+
+function resolveLibraryItem(library: string, params: IconConf): Library | null {
+  if (!(library in libraries)) return null;
+  if (library !== "custom") {
+    return libraries[library as LibraryKey] as Library;
+  }
+  return resolveCustomLibraryConfig(params);
 }
 const iconCachStr = sessionStorage.getItem("sonicIconsCache");
 const iconCache = iconCachStr
@@ -70,6 +86,8 @@ export declare type IconConf = {
   name: string;
   prefix?: string;
   library?: string;
+  customLibraryPath?: string | null;
+  customLibraryDefaultPrefix?: string | null;
 };
 export default class Icons {
   static default = {
@@ -81,15 +99,23 @@ export default class Icons {
       /**
        * SVGS en ligne
        */
-      if (library == "custom") {
-        enableCustomLibrary();
+      if (!library) {
+        return unsafeHTML(iconsAsRecord["core"][params.name] || "");
       }
-      if (library && library in libraries) {
-        const libraryItem = libraries[library as LibraryKey] as Library;
+      const libraryItem = resolveLibraryItem(library, params);
+      if (libraryItem) {
+        // Pas d'URL encore (ancêtre ou config globale pas prête) : on attend
+        // sans fetch ni cache ; @ancestorAttribute relancera le chargement.
+        if (library === "custom" && !libraryItem.url) {
+          return "";
+        }
         const prefix: string = params.prefix || libraryItem.defaultPrefix || "";
         const libIcons = iconsAsRecord[library] || ({} as Library);
         iconsAsRecord[library] = libIcons;
-        const libIconsKey = prefix + "-" + name;
+        const libIconsKey =
+          library === "custom"
+            ? `${libraryItem.url}|${prefix}-${name}`
+            : `${prefix}-${name}`;
 
         /**
          * Si l'icone a déjà été chargée on ne la recharge pas

package/src/docs/_getting-started/ai-agents.md

@@ -26,16 +26,36 @@ node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
 
 | Flag | Effect |
 |------|--------|
-| `--merge-agents` | Append to an existing `AGENTS.md` instead of replacing it |
-| `--overlay <dir>` | Copy extra rules/skills from another layer (e.g. starter kit) |
+| `--skip-agents` | Never write `AGENTS.md` (skills / rules only) |
+| `--merge-agents` | Opt-in: keep the project preamble and append / refresh the Concorde block |
+| `--force-agents` | Opt-in: **replace** the whole `AGENTS.md` (destructive) |
+| `--overlay <dir>` | Extra rules/skills + optional `AGENTS.starter.md` for project-only agent notes |
 | `--cursor-only` | Install only `.cursor/skills` and `.cursor/rules` |
 | `--jetbrains-only` | Install only `.aiassistant/rules/` |
 
+## `AGENTS.md` policy (non-invasive)
+
+| Situation | Default |
+|-----------|---------|
+| No `AGENTS.md` | Create the Concorde guide |
+| File with `<!-- concorde-ai -->` | Refresh the managed zone only |
+| File **without** marker (project notes) | **Left untouched** — skills / rules are enough |
+| `--merge-agents` / `--force-agents` / `--skip-agents` | See flags above |
+
+```text
+[optional project preamble — short, project-only]
+<!-- concorde-ai -->
+<package ai/AGENTS.md>
+[--- + overlay AGENTS.starter.md]
+```
+
+Everything **after** `<!-- concorde-ai -->` is replaced on each `ai-init` run (idempotent). Do not paste a full copy of the Concorde guide above the marker — put project-specific notes in `AGENTS.starter.md` (overlay). If the preamble duplicates package `AGENTS.md`, `ai-init` slims or drops it and prints a warning.
+
 ## What gets installed
 
 | Path | Role |
 |------|------|
-| `AGENTS.md` | Project-level guide for agents (Concorde conventions) |
+| `AGENTS.md` | Created only if missing; existing project-owned files are left alone unless `--merge-agents` / `--force-agents` |
 | `.cursor/skills/concorde/` | Core Lit + DataProvider patterns |
 | `.cursor/skills/concorde-imports/` | Short `@supersoniks/concorde/…` import paths |
 | `.cursor/skills/concorde-scope/` | `serviceURL`, `formDataProvider`, API configuration |
@@ -49,7 +69,7 @@ node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
 
 1. **Starter project:** [Installation](#docs/_getting-started/concorde-outside.md/concorde-outside) — `yarn ai:sync` is wired in the kit.
 2. **Existing / manual Vite project:** [Manual installation](#docs/_getting-started/concorde-manual-install.md/concorde-manual-install), then **`ai-init`** after `yarn add @supersoniks/concorde`.
-3. Commit `AGENTS.md`, `.cursor/`, and `.aiassistant/` if your team shares agent settings.
+3. Commit `.cursor/` and `.aiassistant/` (and `AGENTS.md` only if you opted in / it was created) if your team shares agent settings.
 4. Re-run the same command when you bump `@supersoniks/concorde` to refresh skills from `node_modules/@supersoniks/concorde/ai/`.
 5. In Cursor, skills under `.cursor/skills/` are picked up automatically; mention a skill in chat for focused tasks (e.g. migration → `concorde-get-set-dp`).