@supersoniks/concorde 5.0.5 → 5.1.1

package/src/docs/search/docs-search.json

@@ -527,6 +527,16 @@
           }
         }
       },
+      "docs/_getting-started/components.md": {
+        "title": "Components",
+        "hashes": {
+          "components": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      },
       "docs/_misc/api-configuration.md": {
         "title": "API configuration",
         "hashes": {
@@ -1359,6 +1369,126 @@
       }
     }
   },
+  {
+    "search": "SDUI — points d’extension publics",
+    "files": {
+      "core/components/functional/sdui/sdui-extension-points.md": {
+        "title": "SDUI — points d’extension publics",
+        "hashes": {
+          "sdui--points-dextension-publics": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Aide-mémoire pour les dépôts externes (adaptateurs, shells).Pas une page de la doc site — à lire dans le package npm(node_modules/@supersoniks/concorde/src/core/components/functional/sdui/sdui-extension-points.md).La doc utilisateur / crawl reste sdui.md (auto-suffisante).\n",
+    "files": {
+      "core/components/functional/sdui/sdui-extension-points.md": {
+        "title": "SDUI — points d’extension publics",
+        "hashes": {
+          "sdui--points-dextension-publics": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Aucune mention de protocoles tiers ici : uniquement les API génériques Concorde.\n",
+    "files": {
+      "core/components/functional/sdui/sdui-extension-points.md": {
+        "title": "SDUI — points d’extension publics",
+        "hashes": {
+          "sdui--points-dextension-publics": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Sur un nœud :\n",
+    "files": {
+      "core/components/functional/sdui/sdui-extension-points.md": {
+        "title": "SDUI — points d’extension publics",
+        "hashes": {
+          "2-événement-sdui-action": {
+            "count": 1,
+            "title": "2. Événement `sdui-action`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Au clic, sonic-sdui émet :\n",
+    "files": {
+      "core/components/functional/sdui/sdui-extension-points.md": {
+        "title": "SDUI — points d’extension publics",
+        "hashes": {
+          "2-événement-sdui-action": {
+            "count": 1,
+            "title": "2. Événement `sdui-action`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Ne remplace pas sonic-submit / POST / messagesKey.\n",
+    "files": {
+      "core/components/functional/sdui/sdui-extension-points.md": {
+        "title": "SDUI — points d’extension publics",
+        "hashes": {
+          "2-événement-sdui-action": {
+            "count": 1,
+            "title": "2. Événement `sdui-action`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Le descripteur entier + rebuild reste le chemin par défaut. Les ops mutent un descripteur local et mettent à jour le DOM chirurgicalement (frères préservés : focus, valeurs d’input, état composants).\n",
+    "files": {
+      "core/components/functional/sdui/sdui-extension-points.md": {
+        "title": "SDUI — points d’extension publics",
+        "hashes": {
+          "5-ops-incrémentales-opt-in-chemin-à-côté": {
+            "count": 1,
+            "title": "5. Ops incrémentales (opt-in, chemin à côté)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Attribut opsDataProvider : chaque valeur assignée (SDUIOp ou SDUIOp[]) est passée à applyOp.\n",
+    "files": {
+      "core/components/functional/sdui/sdui-extension-points.md": {
+        "title": "SDUI — points d’extension publics",
+        "hashes": {
+          "flux-optionnel": {
+            "count": 1,
+            "title": "Flux optionnel",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "SDUI",
     "files": {
@@ -1464,6 +1594,156 @@
       }
     }
   },
+  {
+    "search": "Set profile="safe" on sonic-sdui to refuse untrusted HTML/JS from the descriptor:\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "safe-profile-opt-in": {
+            "count": 1,
+            "title": "Safe profile (opt-in)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use the pure helper validateSafeDescriptor(descriptor) (from sdui-safe) to list violations server-side or in a custom validator — it returns { path, field, message }[] and has no side effects.\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "safe-profile-opt-in": {
+            "count": 1,
+            "title": "Safe profile (opt-in)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "At build time, Concorde generates a neutral JSON catalog of custom elements for SDUI / external agents:\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "component-catalog-build-only": {
+            "count": 1,
+            "title": "Component catalog (build-only)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Each entry includes tag, props (name, attribute, type, allowed values when detectable, default, description), plus slots/events when present.\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "component-catalog-build-only": {
+            "count": 1,
+            "title": "Component catalog (build-only)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Components with thin JSDoc are listed in component-catalog.gaps.json (same folder) — annotations are not mass-rewritten in this step.\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "component-catalog-build-only": {
+            "count": 1,
+            "title": "Component catalog (build-only)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Beside the full-descriptor rebuild path, sonic-sdui exposes surgical ops (siblings keep DOM state):\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "incremental-operations-opt-in": {
+            "count": 1,
+            "title": "Incremental operations (opt-in)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Public extension surface (also covered above): profile="safe", textContent, sdui-action / action, component catalog JSON, partial + childNodeIds / nodeById, and these incremental ops.\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "incremental-operations-opt-in": {
+            "count": 1,
+            "title": "Incremental operations (opt-in)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Set the boolean attribute partial on sonic-sdui to tolerate missing child references:\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "partial-rendering-opt-in": {
+            "count": 1,
+            "title": "Partial rendering (opt-in)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Declarative opt-in on a node: set action: { name, context? } (and optionally nodeId).\nA click on the rendered element dispatches a CustomEvent named sdui-action on sonic-sdui with:\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "actions-sdui-action": {
+            "count": 1,
+            "title": "Actions (`sdui-action`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "This does not replace form submit (sonic-submit / POST / messagesKey). Those keep working as before; only nodes that declare action emit sdui-action.\n",
+    "files": {
+      "core/components/functional/sdui/sdui.md": {
+        "title": "SDUI",
+        "hashes": {
+          "actions-sdui-action": {
+            "count": 1,
+            "title": "Actions (`sdui-action`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "An SDUINode represents an HTMLElement.\n",
     "files": {
@@ -9849,6 +10129,36 @@
       }
     }
   },
+  {
+    "search": "Components",
+    "files": {
+      "docs/_getting-started/components.md": {
+        "title": "Components",
+        "hashes": {
+          "components": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Every Concorde web component, grouped like the sidebar. Pick one to see its live demos, attributes and import path.\n",
+    "files": {
+      "docs/_getting-started/components.md": {
+        "title": "Components",
+        "hashes": {
+          "components": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Manual installation (Vite)",
     "files": {
@@ -11100,12 +11410,12 @@
     }
   },
   {
-    "search": "Customization",
+    "search": "Theming",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
-          "customization": {
+          "theming": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -11118,7 +11428,7 @@
     "search": "Concorde components ship with default styles (fallback values in each component and in <sonic-theme>).You do not need to define any CSS variables to get a usable UI.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "theme-first-customization": {
             "count": 1,
@@ -11133,7 +11443,7 @@
     "search": "To align the kit with your brand, override only the essential theme tokens on <sonic-theme>, on :root, or in a project stylesheet.Concorde derives radius steps, button/input rounding, shadows, and most per-component layout from these primitives—do not copy long lists of derived variables unless you have a specific need.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "theme-first-customization": {
             "count": 1,
@@ -11148,7 +11458,7 @@
     "search": "Popovers, modals, and toasts mount under the nearest <sonic-theme>.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "theme-first-customization": {
             "count": 1,
@@ -11163,7 +11473,7 @@
     "search": "Example (full brand override on <sonic-theme> or :root). Set every essential token below; derived radii and shadows still come from the theme engine—only --sc-rounded is listed here.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11178,7 +11488,7 @@
     "search": "  /* Text/icons on semantic fills */\n  --sc-primary-content: #fff;\n  --sc-secondary-content: #fff;\n  --sc-info-content: #fff;\n  --sc-danger-content: #fff;\n  --sc-warning-content: #fff;\n  --sc-success-content: #fff;\n  --sc-contrast-content: #fff;\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11193,7 +11503,7 @@
     "search": "  /* Neutral fills */\n  --sc-base: #fff;\n  --sc-base-50: #f6f6f5;\n  --sc-base-100: #ededec;\n  --sc-base-200: #d7d7d4;\n  --sc-base-300: #c8c7c4;\n  --sc-base-400: #a8a7a2;\n  --sc-base-500: #94938c;\n  --sc-base-600: #76756c;\n  --sc-base-700: #59584e;\n  --sc-base-800: #47463b;\n  --sc-base-900: #353429;\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11208,7 +11518,7 @@
     "search": "  /* Text/icons on neutral surfaces */\n  --sc-base-content: var(--sc-base-900);\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11223,7 +11533,7 @@
     "search": "  /* Typography */\n  --sc-font-family-base: "Oswald", system-ui, -apple-system, "Segoe UI", Roboto,\n    "Helvetica Neue", Arial, sans-serif;\n  --sc-headings-font-family: "alternate-gothic-compressed", system-ui, sans-serif;\n  --sc-headings-line-height: 1.1;\n  --sc-headings-font-weight: bold;\n  --sc-headings-text-transform: none;\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11238,7 +11548,7 @@
     "search": "  /* Shape (primitive only) */\n  --sc-rounded: 0;\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11253,7 +11563,7 @@
     "search": "  /* Forms */\n  --sc-border-width: 0.2rem;\n  --sc-form-height: 2em;\n  --sc-input-bg: var(--sc-base);\n  --sc-input-color: var(--sc-base-content);\n  --sc-input-border-color: var(--sc-input-color);\n  --sc-input-active-bg: var(--sc-primary);\n  --sc-input-active-color: var(--sc-primary-content);\n  --sc-input-active-border-color: var(--sc-primary);\n}\n  \n\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11268,7 +11578,7 @@
     "search": " Palette generator: concordecolors\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11283,7 +11593,7 @@
     "search": "Without these overrides, components keep Concorde’s per-component fallbacks. Built-in light/dark palettes apply only when you set theme="light", theme="dark", or theme="auto".\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11298,7 +11608,7 @@
     "search": "What we intentionally avoid: large public --sc-alert-* / --sc-badge-* APIs or ::part() styling hooks on most components. Prefer attributes (type, status, size, …) and the theme tokens above.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "customization-example": {
             "count": 1,
@@ -11313,7 +11623,7 @@
     "search": "These are the smallest set we recommend customizing. Everything else should stay internal to the theme or to components (--sc_* private variables, attributes like type, size, variant).\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "only-essential-css-variables-public-theme-api": {
             "count": 1,
@@ -11328,7 +11638,7 @@
     "search": "Tokens without a -content suffix are fill / background colors.Tokens with -content are text and icons on top of the matching fill (solid buttons, badges, alerts, etc.).\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "surfaces-and-foreground": {
             "count": 1,
@@ -11343,7 +11653,7 @@
     "search": "Interactive controls expose a few extra theme-level tokens; prefer these over styling individual inputs from outside.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "forms-only-if-you-customize-inputs-globally": {
             "count": 1,
@@ -11358,7 +11668,7 @@
     "search": "Set tailwind.config.js to match concorde style token in your custom component.\n",
     "files": {
       "docs/_getting-started/theming.md": {
-        "title": "Customization",
+        "title": "Theming",
         "hashes": {
           "tailwind-in-new-components-": {
             "count": 1,

package/src/docs/search/markdown-renderer.ts

@@ -5,6 +5,8 @@ import { Subscriber } from "@supersoniks/concorde/mixins";
 import { Marked } from "marked-ts";
 import { gfmHeadingId } from "marked-gfm-heading-id";
 import { parseMarkdownWithSonicCode } from "./sonic-code-markdown";
+import { DOCS_PAGE_RENDERED } from "../navigation/toc";
+import { parseDocsLocation } from "../docs-location";
 declare const window: { marked: Marked };
 const tagName = "docs-markdown-renderer"; // For Astro.build
 const marked = window.marked;
@@ -25,9 +27,12 @@ export class DocsMakdownRenderer extends Subscriber(LitElement) {
     this.requestUpdate();
     setTimeout(() => {
       this.appendImport();
-      const anchor = this.querySelector("#" + this.anchor) as HTMLElement;
+      window.dispatchEvent(new CustomEvent(DOCS_PAGE_RENDERED));
+      const anchor = this.anchor
+        ? (this.querySelector("#" + CSS.escape(this.anchor)) as HTMLElement)
+        : null;
       if (anchor) {
-        document.documentElement.scrollTop = anchor.offsetTop - 95;
+        anchor.scrollIntoView({ block: "start" });
       } else if (!(this.anchor && this.anchor.indexOf("#") != -1)) {
         document.documentElement.scrollTop = 0;
       }
@@ -41,7 +46,10 @@ export class DocsMakdownRenderer extends Subscriber(LitElement) {
     if (this.querySelector("h1 + sonic-code")) return;
 
     const locationHash = document.location.hash;
-    const isComponent = locationHash.includes("components");
+    // Only real component pages (core/components/…), not any URL mentioning "components"
+    const isComponent = parseDocsLocation(locationHash).url.startsWith(
+      "core/components/",
+    );
 
     if (isComponent) {
       const split = locationHash.split("/");

package/src/docs/shiki/index.ts

@@ -0,0 +1,109 @@
+import { css } from "lit";
+import { createHighlighterCore, type HighlighterCore } from "shiki/core";
+import { createJavaScriptRegexEngine } from "shiki/engine/javascript";
+import bash from "shiki/langs/bash.mjs";
+import cssLang from "shiki/langs/css.mjs";
+import html from "shiki/langs/html.mjs";
+import javascript from "shiki/langs/javascript.mjs";
+import json from "shiki/langs/json.mjs";
+import typescript from "shiki/langs/typescript.mjs";
+import githubDark from "shiki/themes/github-dark.mjs";
+import githubLight from "shiki/themes/github-light.mjs";
+
+let highlighter: Promise<HighlighterCore> | null = null;
+
+function getHighlighter() {
+  highlighter ??= createHighlighterCore({
+    themes: [githubLight, githubDark],
+    langs: [html, typescript, javascript, json, bash, cssLang],
+    engine: createJavaScriptRegexEngine(),
+  });
+  return highlighter;
+}
+
+export function normalizeDocsCodeLanguage(language: string): string {
+  if (language === "html" || language === "markup") return "html";
+  if (language === "shell") return "bash";
+  if (language === "js") return "javascript";
+  return language;
+}
+
+function normalizeDocsSource(source: string): string {
+  // Drop blank edge lines only: trimming would also eat the first line's
+  // indentation and make the dedent below a no-op.
+  let text = source
+    .replace(/\r\n?/g, "\n")
+    .replace(/^(?:[\t ]*\n)+/, "")
+    .trimEnd();
+  const lines = text.split("\n");
+  const indents = lines
+    .filter((l) => l.trim())
+    .map((l) => l.match(/^[\t ]*/)?.[0].length ?? 0);
+  const min = Math.min(...indents);
+  if (min > 0) text = lines.map((l) => l.slice(min)).join("\n");
+  return text
+    .replaceAll('=""', "")
+    .replaceAll("&quot;", '"')
+    .replaceAll('"{', "'{")
+    .replaceAll('}"', "}'")
+    .replaceAll("&amp;", "&");
+}
+
+function escapeHtml(text: string): string {
+  return text
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;");
+}
+
+export async function highlightDocsCode(
+  source: string,
+  language: string,
+): Promise<string> {
+  const code = normalizeDocsSource(source);
+  if (!code) return "";
+
+  const lang = normalizeDocsCodeLanguage(language);
+  const h = await getHighlighter();
+  if (!h.getLoadedLanguages().includes(lang)) return escapeHtml(code);
+
+  try {
+    return h.codeToHtml(code, {
+      lang,
+      themes: { light: "github-light", dark: "github-dark" },
+      defaultColor: false,
+      structure: "inline",
+    });
+  } catch {
+    return escapeHtml(code);
+  }
+}
+
+export const docsCodeCSS = css`
+  pre {
+    margin: 0;
+    padding: 1em;
+    overflow: auto;
+    font-size: 13px;
+    line-height: 1.55;
+    tab-size: 2;
+    color: var(--sc-base-content);
+    background: var(--sc-base-100);
+    border: 1px solid var(--sc-base-200);
+    border-radius: var(--sc-rounded, 0.5rem);
+    font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+  }
+
+  code {
+    display: block;
+    font-family: inherit;
+  }
+
+  code span {
+    color: var(--shiki-light);
+  }
+
+  :host-context([data-concorde-theme="dark"]) code span {
+    color: var(--shiki-dark);
+  }
+`;

package/src/docs/tailwind/css/base/scrollbar.css

@@ -0,0 +1,22 @@
+/* CUSTOM SCROLL */
+.custom-scroll {
+  overflow: auto !important;
+}
+
+.custom-scroll:hover::-webkit-scrollbar-thumb {
+  box-shadow: /* taste-skill-ignore: scrollbar thumb fill, not an elevation */ inset 0 0 2rem 2rem var(--sc-base-900);
+}
+
+.custom-scroll::-webkit-scrollbar {
+  width: 0.5rem;
+  height: 0.5rem;
+  border: solid 0.15rem transparent;
+  border-radius: var(--sc-rounded);
+  background: transparent;
+}
+
+.custom-scroll::-webkit-scrollbar-thumb {
+  opacity: 0;
+  transition: box-shadow 0.2s;
+  border: solid 0.15rem transparent;
+}