@supersoniks/concorde 5.0.4 → 5.1.0

package/ai/cursor/rules/concorde-theme.mdc

@@ -8,6 +8,6 @@ alwaysApply: false
 
 Skill **`concorde-theme`**
 
-- `<sonic-theme background color font>` + `--sc-*` CSS variables
+- `<sonic-theme color font class="block bg-base">` + `--sc-*` CSS variables
 - `theme="dark"` for built-in dark palette
 - Not for `serviceURL` / API — use **`concorde-scope`**

package/ai/cursor/rules/concorde.mdc

@@ -53,7 +53,7 @@ Placeholder `${prop}` = chaîne normale, résolu depuis le composant hôte.
   par `get` pour `refetch`.
 - **Write + handler** : même modèle avec `post`, `put`, `patch` ; `@send`
   reste le déclencheur explicite.
-- **Theme** : `<sonic-theme background color font>` · `--sc-*` — skill `concorde-theme`
+- **Theme** : `<sonic-theme color font class="block bg-base">` · `--sc-*` — skill `concorde-theme`
 
 ## Migration Subscriber / sonic-fetch (piège fréquent)
 

package/ai/skills/concorde/SKILL.md

@@ -170,7 +170,7 @@ Avancés : `cache`, `blockUntilDone`, `keepAlive`, `addHTTPResponse`.
 
 Skill dédié : **`concorde-theme`**.
 
-`<sonic-theme background color font>` + variables CSS `--sc-*` (surfaces, sémantique, typo). Pas pour l’API.
+`<sonic-theme color font class="block bg-base">` + variables CSS `--sc-*` (surfaces, sémantique, typo). Pas pour l’API.
 
 ```typescript
 import "@supersoniks/concorde/theme";

package/ai/skills/concorde-theme/SKILL.md

@@ -8,37 +8,48 @@ description: >-
 
 `<sonic-theme>` définit la base visuelle Concorde. **Pas** pour l’API (`serviceURL` → scope, skill `concorde-scope`).
 
+Les composants ont un **rendu par défaut** sans override : fallbacks dans chaque composant + presets `light` / `dark`. Ne documenter que le **plus petit ensemble** de variables publiques `--sc-*` pour personnaliser un thème.
+
 ```typescript
 import "@supersoniks/concorde/theme";
 ```
 
 ```html
-<sonic-theme background color font>
+<sonic-theme color font class="block bg-base min-h-screen">
   …app…
 </sonic-theme>
 
 <!-- dark -->
-<sonic-theme theme="dark" background color font>…</sonic-theme>
+<sonic-theme theme="dark" color font class="block bg-base min-h-screen">…</sonic-theme>
 ```
 
 ## Attributs
 
 | Attribut | Rôle |
 |----------|------|
-| `background` | Fond page / surface (`--sc-base`) |
+| `class="bg-base block"` (Tailwind) | Fond page / surface (`--sc-base`) |
 | `color` | Couleur texte (`--sc-base-content`) |
 | `font` | Famille / graisse (`--sc-font-family-base`) |
-| `theme="light"` \| `"dark"` | Palette built-in |
+| *(omit)* \| `theme="custom"` | Défaut : tokens core + vos `--sc-*` ; pas de palette light/dark built-in |
+| `theme="light"` \| `"dark"` \| `"auto"` | Presets opt-in ; `auto` suit `prefers-color-scheme` |
+
+## Variables CSS essentielles (API publique)
+
+Override dans `:root`, sur `sonic-theme`, ou fichier CSS projet. **Ne pas** recopier les dérivées (`--sc-rounded-sm`, `--sc-btn-rounded`, …) : elles sont calculées par le thème à partir des primitives.
 
-## Variables CSS
+Convention : **sans suffixe `-content`** = couleur de **fond / surface / remplissage** ; **avec `-content`** = **texte et icônes** posés sur cette surface (boutons pleins, badges, etc.). Ne pas mélanger les deux rôles.
 
-Override dans `:root` ou fichier CSS projet :
+- **Surfaces neutres (fonds)** : `--sc-base`, `--sc-base-50` … `--sc-base-900`
+- **Texte sur surfaces neutres** : `--sc-base-content` (défaut UI, corps de page)
+- **Couleurs sémantiques (fonds)** : `--sc-primary`, `--sc-secondary` (si utilisé), `--sc-success`, `--sc-warning`, `--sc-danger`, `--sc-info`, `--sc-contrast`
+- **Texte sur fond sémantique** : `--sc-primary-content`, `--sc-secondary-content`, `--sc-success-content`, `--sc-warning-content`, `--sc-danger-content`, `--sc-info-content`, `--sc-contrast-content`
+- **Forme** : `--sc-rounded` (primitive unique pour les rayons)
+- **Typo** : `--sc-font-family-base`, `--sc-headings-font-family`, etc.
+- **Formulaires (optionnel, global)** : `--sc-border-width`, `--sc-form-height`, `--sc-input-bg`, `--sc-input-color`, `--sc-input-border-color`, états actifs `--sc-input-active-*`
 
-- Surfaces : `--sc-base`, `--sc-base-content`, `--sc-base-50` … `--sc-base-900`
-- Sémantique : `--sc-primary`, `--sc-success`, `--sc-warning`, `--sc-danger`, `--sc-info` (+ `-content`)
-- Forme : `--sc-rounded`, `--sc-btn-rounded`, `--sc-border-width`
-- Typo : `--sc-font-family-base`, `--sc-headings-font-family`
+Privé côté composants : `--sc_*`, `--sc-_color`, … — pas d’API par composant ni `::part()` sauf exceptions documentées.
 
+Doc utilisateur : `#docs/_getting-started/theming.md/theming`.  
 Doc composant : `node_modules/@supersoniks/concorde/src/core/components/ui/theme/`.
 
 Popovers, modals, toasts se montent sous le `<sonic-theme>` le plus proche.

package/build-infos.json

@@ -1 +1 @@
-{"date":1790855624}
+{"date":1791460056}