@supersoniks/concorde 4.7.0 → 4.7.4

package/ai/AGENTS.md

@@ -47,6 +47,10 @@ Skill **`concorde-imports`** : section « Dans le dépôt Concorde ».
 
 Skill **`concorde-get-set-dp`** : chemins sans placeholder **`${…}`** / **`{$…}`** pour `get` / `set` / `dp` ; chemins JS évalués OK ; clés dynamiques → décorateurs, `dp(idRésolu)`, ou **`sub(clé)`** dans les templates Lit.
 
+## Migration Subscriber / sonic-fetch
+
+Skill **`concorde`** — section **« Piège migration Subscriber → LitElement »** : ne pas laisser des `@property` orphelines après retrait du mixin ; `@get` + `@subscribe` feuille ; `apiConfigKey` en modale ; sync des noms de props pour les `Endpoint` dynamiques.
+
 ## Documentation
 
 Fichiers `.md` dans le package : `node_modules/@supersoniks/concorde/src/` (composants, décorateurs, getting-started).

package/ai/cursor/rules/concorde.mdc

@@ -47,3 +47,13 @@ Placeholder `${prop}` = chaîne normale, résolu depuis le composant hôte.
 
 - **Scope** : `<sonic-scope serviceURL="…">` · `@get(endpoint)` ou `@get(endpoint, apiConfigKey)` — skills `concorde-scope`
 - **Theme** : `<sonic-theme background color font>` · `--sc-*` — skill `concorde-theme`
+
+## Migration Subscriber / sonic-fetch (piège fréquent)
+
+- Retirer `extends Subscriber` **sans** `@subscribe` sur chaque champ affiché → UI vide (props orphelines).
+- Remplacer `sonic-fetch` : `@get` + alimenter le DP ; UI en `@subscribe` feuille ou hôte `Subscriber` + `dataProvider`/`subDataProvider`.
+- `@get` + placeholders `${prop}` : propriétés homonymes sur l'hôte (ou sync dans `willUpdate`).
+- Modale / portal : `@get(endpoint, apiConfigKey)` si pas de `serviceURL` ascendant.
+- `@subscribe` → préférer `@state()`, pas `@property`.
+
+Détail : skill `concorde` — section « Piège migration Subscriber → LitElement ».

package/ai/jetbrains/rules/concorde.md

@@ -31,6 +31,14 @@ Placeholder `${prop}` dans une chaîne normale : `"users.${userIndex}"`.
 - **Scope** (`sonic-scope`) : `serviceURL`, `formDataProvider`, icônes — skill `concorde-scope`
 - **Theme** (`sonic-theme`) : `--sc-*` tokens, dark mode — skill `concorde-theme`
 - `@get(endpoint)` sans clé config → hérite scope ; `@get(endpoint, apiConfigKey)` → DataProvider
+- Modale / portal : préférer `apiConfigKey` si pas de scope DOM fiable
+
+## Migration Subscriber / sonic-fetch
+
+- Ne pas retirer `Subscriber` sans `@subscribe` feuille par feuille sur chaque champ du `render()`.
+- `sonic-fetch` → `@get` + DP ; `@subscribe` ou hôte `Subscriber` avec `dataProvider`/`subDataProvider`.
+- Placeholders Endpoint = propriétés homonymes sur l'hôte (`checkCode` → copier vers `code` si besoin).
+- `@subscribe` + `@state()`, pas `@property` pour la lecture DP.
 
 ## Navigation
 

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,83 @@ 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.
+
+### Piège migration `Subscriber` → `LitElement` (checklist)
+
+Lors du remplacement de `sonic-fetch` ou du retrait du mixin `Subscriber` sur un composant **métier** :
+
+| Étape | Vérification |
+|-------|----------------|
+| Champs affichés dans `render()` | Chaque `@property` autrefois remplie par template filling → **`@subscribe(dpKey.feuille)` + `@state()`** (pas laisser des `@property` orphelins) |
+| Enfant d’un `@get` | `@get` + `@publish`/`@handle` vers le DataProvider cible ; l’UI lit ce DP via `@subscribe`, pas via des props vides |
+| Placeholders `Endpoint` | Les noms `${prop}` doivent exister sur l’hôte (`@property` ou copie dans `willUpdate` si le scan utilise un autre nom, ex. `checkCode` → `code`) |
+| Modale / portal | `@get(endpoint, apiConfigKey)` si pas de `serviceURL` ascendant fiable (`Modal` → `Theme.getPopContainer()`) |
+| Remplacement `sonic-fetch` | Expliciter `dataProvider` + `subDataProvider` sur les hôtes `Subscriber` enfants (ex. `app` + `currentScanTicket`) |
+
+```typescript
+// ❌ — Subscriber retiré, props jamais alimentées
+export class TicketInfos extends LitElement {
+  @property({ type: Object }) owner = {};
+  render() { return html`${this.owner?.firstName}`; }
+}
+
+// ✅ — une souscription par champ affiché
+@subscribe(dpKeys.currentScanTicket.owner)
+@state() owner: Contact = {};
+```
+
+**`@subscribe` + décorateur Lit** : préférer **`@state()`** (pas `@property`) pour les champs purement lus depuis le DataProvider.
+
 ## formDataProvider
 
 ```html
@@ -189,7 +267,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` |
@@ -202,8 +280,10 @@ Propriétés Lit (recommandé) :
 | `PublisherManager.get(…)` | `get(…)` ou `set(…)` |
 | « publisher » | DataProvider |
 | `sonic-input` + `@input` | `formDataProvider` + `name` |
-| `sonic-fetch` | `sonic-queue` + filtre, ou `@get` |
-| `extends Subscriber(LitElement)` | `LitElement` + `@subscribe` / `sub()` |
+| `sonic-fetch` | `sonic-queue` + filtre, ou `@get` + `@publish`/`@handle` + `@subscribe` / hôte `Subscriber` |
+| `extends Subscriber(LitElement)` (métier seul) | `LitElement` + `@subscribe` feuille par feuille / `sub()` — **ne pas oublier** les champs template-filled |
+| `extends Subscriber` (hôte d’enfants sonic) | Conserver `Subscriber` + `dataProvider` / `subDataProvider` corrects |
+| `@get` dans modale | `@get(endpoint, apiConfigKey)` si config API hors scope DOM |
 | `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":1780585258}