@supersoniks/concorde 4.7.3 → 4.8.0

package/README.md

@@ -89,7 +89,7 @@ flowchart LR
 | `@publish(key)` | Liaison **écriture seule** : assigner la propriété publie vers le chemin | `DataProviderKey<T>` |
 | `@bind(path)` | Liaison **bidirectionnelle** (accepte aussi un chemin string) | chemin / clé |
 | `@handle(...keys)` | Appelle une **méthode typée** à chaque assignation (effets de bord, calculs) | jusqu'à 3 `DataProviderKey<T>` |
-| `@get(endpoint)` | Charge des données via l'API ; la propriété devient `ApiGetResult<T> \| null` | `Endpoint<T>` |
+| `@get(endpoint)` | Charge des données via l'API ; la propriété devient `ApiResult<T> \| null` | `Endpoint<T>` |
 
 `DataProviderKey` est la pierre angulaire : c'est lui qui fournit les chemins **typés** utilisés par `@subscribe`, `@publish`, `@bind` et `@handle`, tandis que `Endpoint` fait le pont avec les données distantes via `@get`. Détails et exemples sur la [documentation des décorateurs](https://doc.concorde.test/#docs/_decorators/subscribe.md/subscribe).
 

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

@@ -18,7 +18,7 @@ Migration get/set/dp : `.cursor/skills/concorde-get-set-dp/SKILL.md`
 ## Vocabulaire
 
 - **DataProvider** (jamais « publisher »)
-- Accès : **`get` / `set`** — pas `PublisherManager`
+- Accès impératif : **`dp(clé).get()` / `.set()` / `.invalidate()`** ou `get(clé)` / `set(clé, v)` — **jamais** `PublisherManager.getInstance()` ni `PublisherManager.get()` dans le code métier (bootstrap `dp.ts` excepté)
 
 ## Interdits (nouveau code)
 
@@ -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

@@ -195,6 +195,32 @@ Après `initPublisher`, refléter le chemin résolu sur l’attribut (ex. `app/c
 
 **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
@@ -254,9 +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)` (métier seul) | `LitElement` + `@subscribe` feuille par feuille / `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/ai/skills/concorde-scope/SKILL.md

@@ -47,7 +47,7 @@ Type : `@supersoniks/concorde/utils/api`.
 
 ```typescript
 @get(usersEndpoint) // pas de 2ᵉ arg — hérite serviceURL
-@state() data: ApiGetResult<Users> | null = null;
+@state() data: ApiResult<Users> | null = null;
 ```
 
 **2. DataProvider** — objet typé :
@@ -59,7 +59,7 @@ const apiKey = new DataProviderKey<APIConfiguration>("myApi");
 set(apiKey, { serviceURL: "https://api.example.com", credentials: "same-origin" });
 
 @get(usersEndpoint, apiKey)
-@state() data: ApiGetResult<Users> | null = null;
+@state() data: ApiResult<Users> | null = null;
 ```
 
 Les deux patterns peuvent coexister (scope pour l’URL par défaut, clé explicite quand nécessaire).

package/build-infos.json

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