@supersoniks/concorde 4.7.0 → 4.7.3

package/ai/skills/concorde/SKILL.md

@@ -3,6 +3,7 @@ name: concorde
 description: >-
   Composants Web Concorde (Lit) : DataProvider, scope, theme, Endpoint,
   formDataProvider, sonic-list/sonic-queue, @subscribe/@handle/@get.
+  @subscribe feuille par feuille (pas d’objet parent + getters).
   Imports courts (@supersoniks/concorde/menu, /list, /utils…).
 ---
 
@@ -143,6 +144,57 @@ count = 0;
 subscribedCount = 0;
 ```
 
+### Règle impérative — une souscription par valeur affichée
+
+Sur un composant **`LitElement`** métier, chaque donnée lue dans `render()` doit avoir **son propre** `@subscribe` + `@state()` (ou `@property` si besoin explicite) sur le **publisher feuille** — jamais un abonnement à l’objet parent + getters.
+
+| Anti-pattern | Pourquoi |
+|--------------|----------|
+| `@subscribe(dpKeys.currentSession)` + `get edito()` | Si seul `edito` change (même référence `Session`), Lit peut **ne pas** re-rendre |
+| `@subscribe` sur un parent + `sub()` enfant pour le détail | Mélange deux modèles ; préférer des feuilles cohérentes |
+
+```typescript
+// ❌ — re-render non garanti sur sous-clés
+@subscribe(dpKeys.currentSession)
+@state() session?: Session;
+get edito() { return this.session?.edito; }
+
+// ✅ — une propriété réactive par champ du template
+@subscribe(dpKeys.currentSession.slug)
+@state() slug = "";
+
+@subscribe(dpKeys.currentSession.edito)
+@state() edito: Edito | null = null;
+
+@subscribe(dpKeys.currentSession.settings)
+@state() settings: SettingsSessionAPI | null = null;
+```
+
+**Navigation typée** : chaîner `DataProviderKey` — `dpKeys.currentSession.edito` → `"app.currentSession.edito"`.
+
+**Granularité** : descendre jusqu’à la **feuille** réellement affichée si les mutations ne remplacent pas l’objet intermédiaire (ex. `@subscribe(dpKeys.currentSession.edito.title)` si seul `title` change sans nouvel objet `edito`).
+
+**Templates** : même règle avec `sub(dpKeys.currentSession.edito.title)` plutôt que `sub(dpKeys.currentSession)` + accès JS.
+
+### Cas hybride — hôte `Subscriber` + enfants sonic
+
+Des composants catalogue (`sonic-event-location-hall`, `sonic-date`, `sonic-product-title`, …) remontent l’arbre pour `dataProvider` et utilisent le **template filling** du mixin `Subscriber` — pas un `@subscribe` local.
+
+| Situation | Approche |
+|-----------|----------|
+| Composant métier **sans** enfants `Subscriber` | `LitElement` + `@subscribe` **feuille par feuille** |
+| Composant **hôte** d’enfants sonic `Subscriber` | `extends Subscriber(LitElement)` + `@property` remplies par template filling ; **exposer** `dataProvider` aux descendants |
+
+**`dataProvider` imbriqué** (éviter la clé plate `"app.currentSession"`) :
+
+```html
+<mon-composant-hote dataProvider="app" subDataProvider="currentSession"></mon-composant-hote>
+```
+
+Après `initPublisher`, refléter le chemin résolu sur l’attribut (ex. `app/currentSession`) pour que les **enfants** héritent le bon publisher — ils ne lisent pas `subDataProvider` sur l’ancêtre.
+
+**Liste / queue** : chaque ligne a son publisher — l’hôte **hérite** de l’ancêtre ; ne pas forcer `app.currentSession` sur un item de liste.
+
 ## formDataProvider
 
 ```html
@@ -189,7 +241,7 @@ Propriétés Lit (recommandé) :
 
 | Besoin | API |
 |--------|-----|
-| Lire | `@subscribe(dpKey.field)` + `@state()` |
+| Lire (affichage Lit) | `@subscribe(dpKey.leaf)` + `@state()` — **une fois par champ** du `render()` |
 | Effet typé | `@handle(dpKey.a, …)` |
 | API HTTP | `@get(Endpoint)` ou `@get(Endpoint, apiConfigKey)` |
 | Écriture classe (hors form) | `@publish` |
@@ -203,7 +255,8 @@ Propriétés Lit (recommandé) :
 | « publisher » | DataProvider |
 | `sonic-input` + `@input` | `formDataProvider` + `name` |
 | `sonic-fetch` | `sonic-queue` + filtre, ou `@get` |
-| `extends Subscriber(LitElement)` | `LitElement` + `@subscribe` / `sub()` |
+| `extends Subscriber(LitElement)` (métier seul) | `LitElement` + `@subscribe` feuille par feuille / `sub()` |
+| `extends Subscriber` (hôte d’enfants sonic) | Conserver `Subscriber` + `dataProvider` / `subDataProvider` corrects |
 | `data-bind` HTML | `@subscribe` / `sub()` |
 | `@bind` décorateur | `@subscribe` + `DataProviderKey` (lecture) ou `@publish` (écriture) |
 | `@onAssign` | `@handle` + `DataProviderKey` |

package/build-infos.json

@@ -1 +1 @@
-{"date":1780500767}
+{"date":1780507582}