@supersoniks/concorde 5.1.1 → 5.1.3

package/.agents/skills/concorde-component-docs/SKILL.md

@@ -1,194 +0,0 @@
----
-name: concorde-component-docs
-description: >-
-  Writes and edits Concorde UI component documentation pages (*.md) in English
-  with consistent structure, tone, sonic-code examples, and API tables. Use when
-  creating or updating component docs under src/core/components/ui/, when
-  uniformizing documentation, or when the user references alert.md-style docs.
----
-
-# Concorde component documentation
-
-Apply this skill when **creating** or **editing** a component doc page (typically `src/core/components/ui/<component>/<component>.md`).
-
-Canonical examples: `alert.md`, `badge.md`, `link.md`, `image.md`.
-
-## Workflow
-
-### Creating a new page
-
-1. Read the component implementation (`.ts` / props, slots, reflected attributes, defaults).
-2. Draft the **intro** (what it does, when to use it, 1–2 critical APIs).
-3. Add **feature sections** in order of reader need (basic → variants → composition → edge cases → a11y).
-4. Add one **`<sonic-code>`** example per section; group enum variants in a single demo when practical.
-5. End with **`## API reference`** (attributes table, slots table if any).
-6. Run the [quality checklist](#quality-checklist).
-
-### Editing an existing page
-
-1. Preserve working examples; only change prose/structure to match this guide.
-2. Do not duplicate `## API reference` blocks—merge into one.
-3. Align intro tone and section titles with sibling docs; add missing API rows from source.
-4. Keep demo markup valid; avoid unrelated refactors in examples.
-
-## Page structure
-
-```markdown
-# ComponentName
-
-[Intro paragraph: 1–3 sentences. Purpose, primary use case, key props/slots.]
-
-## Basic example
-[or first topical section, e.g. ## Type, ## Href, ## Rounded]
-
-[Optional short prose before the example.]
-
-<sonic-code>
-  <template>
-    ...
-  </template>
-</sonic-code>
-
-## [Feature or variant name]
-
-...
-
-## API reference
-
-| Attribute | Values | Description |
-|----------|---------|-------------|
-| ... | ... | ... |
-
-| Slot | Description |
-|------|-------------|
-| ... | ... |
-```
-
-### Title (`#`)
-
-- Singular component name, Title Case: `# Alert`, `# Badge`, `# Link`, `# Image`.
-- Match the public tag name conceptually (`sonic-alert` → Alert).
-
-### Intro (required for new-style docs)
-
-One tight paragraph immediately after the title:
-
-- State **what** the component does and **when** to choose it.
-- Call out **defaults** and **constraints** only if they prevent misuse.
-- Formatting:
-  - **Bold** for emphasis on behavior (not for every noun).
-  - API names and tags in backticks; when listing several, **do not put commas between inline-code spans** (rendered as adjacent `<code>`). Join with **`/`**, **`and`**, or separate clauses—e.g. `` `label` `` / `` `text` ``, not `` `label` ``, `` `text` ``.
-  - Cross-link related components in prose: “aligned with **`sonic-button`**”, “pair with **`ratio="1/1"`**”.
-
-Avoid marketing fluff, long tutorials, and repeating the API table in the intro.
-
-### Section headings (`##` / `###`)
-
-- **Sentence case** or short Title Case; be consistent within one file.
-- Name sections after **one concern**: `Status`, `Size`, `Dismissible`, `Accessibility (\`announce\`)`, `Prefix and suffix slots`.
-- Use `###` for sub-variants of the same feature (e.g. `### AutoActive Strict vs partial`).
-- Put **`## API reference`** last—never in the middle.
-
-Suggested order (omit what does not apply):
-
-1. Basic example / primary API
-2. Visual variants (`type` / `status` / `variant` / `size` / …)
-3. Content model (slots, `label` / `text`, rich content)
-4. Composition patterns (inside buttons, with links, …)
-5. Behavioral flags (`dismissible` / `announce` / `cover` / …)
-6. Accessibility (dedicated section when non-obvious)
-7. API reference
-
-### Prose before examples
-
-- **Default first**: “With no `status`, behavior is `default`.” “Default **`loading`** is `lazy`.”
-- **Enums inline** when short: `` `outline` `` — border and text in the `type` color.
-- **Requirements**: stable `` `id` `` required for `dismissForever`; parent must constrain width for `ellipsis`.
-- **Implementation notes** only when they change usage: `localStorage`; `role="alert"`; remount to replay transitions.
-- Length: 0–4 sentences per section; longer only for accessibility or non-obvious behavior.
-
-## Live examples (`<sonic-code>`)
-
-Wrap all demos:
-
-```html
-<sonic-code>
-  <template>
-    <!-- demo markup -->
-  </template>
-</sonic-code>
-```
-
-Conventions:
-
-- Use Tailwind layout utilities already used in the design system docs: `grid gap-4` / `flex flex-wrap gap-2` / `items-center`.
-- Show **all enum values** in one row/grid when demonstrating `type`, `status`, or `size`.
-- Label variants in the UI (badge text, caption `<p class="mt-2">`) when comparison matters.
-- Prefer realistic copy over “Lorem ipsum” unless demonstrating truncation or length.
-- Interactive demos (buttons that mutate DOM) are allowed when they teach behavior—add one sentence explaining what to click.
-- Do not wrap API tables or long prose inside `<sonic-code>`.
-
-## API reference
-
-### Attributes table
-
-```markdown
-| Attribute | Values | Description |
-|----------|---------|-------------|
-| `name` | `a` · `b` (default `a`) | One line: behavior + default + interaction with other props |
-```
-
-- Column headers exactly: **Attribute**, **Values**, **Description**.
-- **Values**: list allowed literals separated by **middle dot (` · `)** or **`…`** for ranges (`2xs` … `2xl`)—**never commas between backtick spans**. Put **(default `…`)** in this column or in Description—be consistent within the file.
-- **Description**: imperative, factual; mention side effects (`removes from DOM`, `ignored when \`cover\` is set`).
-- Document boolean attributes as boolean in the table; no need to say “true/false” unless ambiguous.
-
-### Slots table
-
-```markdown
-| Slot | Description |
-|------|-------------|
-| *(default)* | Main label / message body |
-| `icon` | Replaces the default `sonic-icon` |
-```
-
-- If the component has **no slots**, state it in prose under the attributes table (see `image.md`).
-- Use *(default)* for the unnamed slot.
-
-### Single API block
-
-One `## API reference` section per file. If the source doc has duplicates, consolidate without losing rows.
-
-## Voice and language
-
-- **English only** for user-facing doc text.
-- Present tense, second person avoided; address the integrator (“Set **`announce`** when…”).
-- Prefer precise verbs: surface, navigate, truncate, persist, intercept.
-- Do not document internal CSS class names unless the doc already uses them for styling hooks (`[&[active]]:text-success` in examples is OK).
-
-## Quality checklist
-
-Before finishing, verify:
-
-- [ ] `#` title + intro paragraph present (for new or modernized pages).
-- [ ] Every `##` section (except API) has a `<sonic-code>` example unless it is pure sub-prose under a parent demo.
-- [ ] Defaults and required attributes are stated in prose or API table.
-- [ ] Accessibility called out where behavior affects AT (roles, `alt`, decorative icons).
-- [ ] Exactly one `## API reference`; attributes and slots match the component source.
-- [ ] No duplicate sections; heading levels skip only when using `###` under `##`.
-- [ ] Attribute/slot names match the implementation (camelCase in docs).
-- [ ] No comma-separated lists of inline-code terms in prose or API **Values** cells.
-
-## Anti-patterns
-
-- Long narrative guides, installation steps, or changelog in component `.md` files.
-- Examples without `<sonic-code>` wrappers.
-- API tables at the top of the page.
-- Mixing French and English in the same page.
-- Vague intros (“This component is very useful”) without API hints.
-- Separate micro-sections per enum value when one grid demo suffices.
-- Comma chains of inline code: `` `a` ``, `` `b` ``, and `` `c` `` (use `/`, ` · `, or `and` instead).
-
-## Reference template
-
-See [template.md](template.md) for a copy-paste skeleton.

package/ai/AGENTS.md

@@ -1,56 +0,0 @@
-# Agents — Concorde
-
-Guide pour les agents IA sur un projet **Concorde** (Lit + DataProvider).
-
-## Skills / rules (après installation)
-
-| Fichier | Rôle |
-|---------|------|
-| `.cursor/skills/concorde/SKILL.md` | Patterns framework |
-| `.cursor/skills/concorde-imports/SKILL.md` | Imports courts |
-| `.cursor/skills/concorde-scope/SKILL.md` | Scope + APIConfiguration |
-| `.cursor/skills/concorde-theme/SKILL.md` | Design tokens sonic-theme |
-| `.cursor/skills/concorde-menu/SKILL.md` | Navigation sonic-menu |
-| `.cursor/skills/concorde-get-set-dp/SKILL.md` | Migration get/set/dp + DataProviderKey statique |
-| `.cursor/rules/concorde.mdc` | Règles Cursor (patterns) |
-| `.aiassistant/rules/concorde.md` | Règles JetBrains AI Assistant |
-
-Installation :
-
-```bash
-node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
-```
-
-Source : `@supersoniks/concorde/ai/`
-
-## Imports dans ce dépôt (lib + doc)
-
-Les chemins courts (`@supersoniks/concorde/list`, `/menu`, `/queue`, …) sont des **exports npm** pour les apps **externes**. Dans le repo Concorde (`src/docs`, `src/core`, démos), utiliser les chemins **réels** :
-
-- Composants : `@supersoniks/concorde/core/components/…` ou import relatif (`../../core/components/functional/list/list`)
-- Décorateurs : `@supersoniks/concorde/core/decorators/Subscriber` (ou `src/decorators.ts` via `@supersoniks/concorde/decorators` si résolu par l’alias Vite racine)
-- `DataProviderKey` : `@supersoniks/concorde/core/utils/dataProviderKey`
-
-Skill **`concorde-imports`** : section « Dans le dépôt Concorde ».
-
-## Conventions impératives
-
-- Toujours **DataProvider**, accès via **`get` / `set`**
-- Pas de **`sonic-fetch`**, pas de **`PublisherManager`**
-- Pas de `@onAssign` — **`@handle`** + `DataProviderKey`
-- Pas de **`@bind`** sur les composants métier — **`@subscribe`** + `DataProviderKey<T, U>` (type + contraintes hôte `${…}`)
-- Formulaires : **`formDataProvider`** + `name` sur `sonic-input`
-- Listes : templates **Lit** (`.items`, `.separator`, `.noItems`, `.skeleton`) — pas de promotion des `<template>` HTML
-- **Scope** (API/forms) ≠ **theme** (couleurs) — skills `concorde-scope` / `concorde-theme`
-
-## Migration get / set / dp
-
-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-menu.mdc

@@ -1,15 +0,0 @@
----
-description: Navigation Concorde — sonic-menu, sonic-menu-item, sonic-divider
-globs: **/{layout,sidebar,nav,docs-shell,routes}/**
-alwaysApply: false
----
-
-# Navigation Concorde
-
-1. **`sonic-menu`** + **`sonic-menu-item`** — pas une liste de boutons ghost.
-2. Sections : **`sonic-divider`** (`label`, `align="left"`, `size="sm"`).
-3. Liens internes : `pushstate` + `href` + `autoActive="strict"`.
-
-Référence : `.cursor/skills/concorde-menu/SKILL.md`
-
-Pas de tirets dans les noms de dossiers de routes (générateur Concorde).

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

@@ -1,14 +0,0 @@
----
-description: Scope — inherited API, form, icon defaults (not theme)
-globs: **/*.{ts,tsx,html}
-alwaysApply: false
----
-
-# Scope
-
-Skill **`concorde-scope`**
-
-- `<sonic-scope>` — light DOM, attributes inherited by descendants
-- API: `serviceURL`, `token`, `credentials` → `@get`, list, queue
-- Or: `DataProviderKey<APIConfiguration>` as 2nd arg to `@get`
-- Not for colors/fonts — use **`concorde-theme`**

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

@@ -1,13 +0,0 @@
----
-description: sonic-theme — design tokens, not API scope
-globs: **/*.{ts,tsx,css,html}
-alwaysApply: false
----
-
-# Theme
-
-Skill **`concorde-theme`**
-
-- `<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

@@ -1,66 +0,0 @@
----
-description: Patterns Concorde — DataProvider, décorateurs, templates Lit list/queue, pas sonic-fetch
-globs: **/*.{ts,tsx,js,mjs}
-alwaysApply: false
----
-
-# Concorde — patterns
-
-Référence : `.cursor/skills/concorde/SKILL.md` + `.cursor/skills/concorde-imports/SKILL.md`
-Migration get/set/dp : `.cursor/skills/concorde-get-set-dp/SKILL.md`
-
-## Imports
-
-**Apps externes** : chemins courts (`@supersoniks/concorde/list`, `/menu`, `/decorators`, …) — voir skill `concorde-imports`.
-
-**Dépôt Concorde (lib + doc)** : chemins longs ou relatifs — ex. `core/components/functional/list/list`, `core/decorators/Subscriber`, `core/utils/dataProviderKey`. Pas `@supersoniks/concorde/list` ici.
-
-## Vocabulaire
-
-- **DataProvider** (jamais « publisher »)
-- 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)
-
-- `sonic-fetch` → `sonic-queue` + filtre, ou `@get`
-- Les décorateurs API (`@get`, `@post`, `@put`, `@patch`) s'adaptent aux
-  propriétés et aux méthodes
-- `@onAssign` → `@handle` + `DataProviderKey`
-- `@bind` → `@subscribe` + `DataProviderKey<T, U>` (pas sur composants métier)
-- `data-bind` HTML → `@subscribe` / `sub()`
-- `sonic-input` + `@input` → `formDataProvider` + `name`
-- Templates HTML sur list/queue → `.items`, `.separator`, `.noItems`, `.skeleton`
-
-## DataProviderKey dynamique
-
-```typescript
-new DataProviderKey<T, { userIndex: number }>("users.${userIndex}")
-```
-
-Placeholder `${prop}` = chaîne normale, résolu depuis le composant hôte.
-
-## get / set / dp vs sub()
-
-- **`get` / `set` / `dp`** : pas de `${` / `{$` dans la string passée (clé statique ou chemin JS évalué).
-- **`sub(chemin | DataProviderKey)`** : dynamique OK dans les templates (placeholders `${…}` sur l’hôte).
-- Clé dynamique → décorateur ou `dp(idRésolu)`, pas `dp(cléAvecPlaceholder)`.
-
-## Scope / theme
-
-- **Scope** : `<sonic-scope serviceURL="…">` · `@get(endpoint)` ou `@get(endpoint, apiConfigKey)` — skills `concorde-scope`
-- **GET + handler** : `@get(endpoint)` sur une méthode ; le handler reçoit
-  `result`, `response`, `request`, ou `undefined`. Conserver le handle retourné
-  par `get` pour `refetch`.
-- **Write + handler** : même modèle avec `post`, `put`, `patch` ; `@send`
-  reste le déclencheur explicite.
-- **Theme** : `<sonic-theme color font class="block bg-base">` · `--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

@@ -1,53 +0,0 @@
-# Concorde — patterns agent
-
-Référence doc : fichiers `.md` dans `node_modules/@supersoniks/concorde/src/`.
-
-## Imports
-
-**Apps externes** : chemins courts (`/menu`, `/list`, `/decorators`, `/dataProviderKey`, …).
-
-**Dépôt Concorde (lib + doc)** : `core/components/functional/list/list`, `core/decorators/Subscriber`, `core/utils/dataProviderKey` — pas `@supersoniks/concorde/list` ici.
-
-## Vocabulaire
-
-- **DataProvider** (jamais « publisher »)
-- Accès : **get / set** — pas PublisherManager
-
-## Interdits (nouveau code)
-
-- sonic-fetch → sonic-queue + filtre, ou @get
-- Les décorateurs API (@get, @post, @put, @patch) s'adaptent aux propriétés
-  et aux méthodes
-- @onAssign → @handle + DataProviderKey
-- data-bind HTML → @subscribe / sub()
-- sonic-input + @input → formDataProvider + name
-- Templates HTML list/queue → .items, .separator, .noItems, .skeleton
-- Chemins longs ui/…, functional/…, core/… quand un alias racine existe
-
-## DataProviderKey dynamique
-
-Placeholder `${prop}` dans une chaîne normale : `"users.${userIndex}"`.
-
-## Scope vs theme
-
-- **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
-- `@get(endpoint)` sur une méthode reçoit `result`, `response`, `request`, ou
-  `undefined` ; conserver le handle retourné par `get` pour `refetch`
-- Même modèle avec `post`, `put`, `patch` ; `@send` reste le déclencheur
-  explicite de l'opération
-- 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
-
-sonic-menu + sonic-menu-item + sonic-divider. pushstate + autoActive="strict".
-
-Pas de tirets dans les noms de dossiers routes.

package/ai/skills/concorde-get-set-dp/SKILL.md

@@ -1,194 +0,0 @@
----
-name: concorde-get-set-dp
-description: >-
-  Migration et usage de get/set/dp avec DataProviderKey statique.
-  Rejet des placeholders ${} par resolveStaticPublisherPath ; sub() et
-  décorateurs pour le dynamique.
----
-
-# Concorde — get / set / dp (chemins statiques)
-
-Skill de **migration** vers Concorde ≥ 4.6 avec `resolveStaticPublisherPath`.
-À activer quand un projet monte de version ou refactorise vers `DataProviderKey`.
-
-Référence framework : skill **`concorde`**, doc `src/docs/_misc/dataProviderKey.md`.
-
-## Quand utiliser cette skill
-
-- Monter `@supersoniks/concorde` avec garde statique sur `get` / `set` / `dp`.
-- Auditer un codebase TypeScript existant avant/après upgrade.
-- Distinguer **chemin évalué en JS** vs **placeholder Concorde** `${prop}` / `{$prop}`.
-- Choisir entre API programmatique (`get/set/dp`) et réactivité (`sub`, décorateurs).
-
-## Règle de rejet (runtime)
-
-`resolveStaticPublisherPath` lève une erreur si la string passée à `get`, `set` ou `dp` contient **`${`** ou **`{$`** :
-
-| Appel | Résultat |
-|-------|----------|
-| `dp(new DataProviderKey("users.${userIndex}"))` | **throw** |
-| `get("users.${userIndex}")` | **throw** |
-| `dp(staticKey.path)` si `.path` contient `${` | **throw** |
-
-**OK** — le chemin est résolu **avant** l'appel (pas de placeholder littéral) :
-
-```typescript
-set(`app.pages.${index}.isComplete`, true); // → "app.pages.2.isComplete"
-dp(`${this.formDataProvider}/fieldName`); // → "checkoutForm/email"
-```
-
-**Faux positif fréquent** : grep `${` dans les sources TS ne suffit pas — vérifier la **valeur runtime** passée à `get/set/dp`.
-
-## Rétrocompatibilité
-
-| Avant | Après (recommandé) | Statut |
-|-------|-------------------|--------|
-| `dp(key.path)` | `dp(key)` | Équivalent si clé statique |
-| `set(key.path, v)` | `set(key, v)` | Équivalent |
-| `get("myCounter.count")` | `get(key.count)` | Typage amélioré |
-| `key.path` dans attribut HTML | Inchangé | Toujours valide |
-| `@onAssign(key.path)` | `@handle(key.leaf)` | Migration parallèle (skill `concorde`) |
-
-Aucune rupture pour le code qui passait déjà des **strings résolues** ou des clés **statiques**.
-
-## Trois niveaux d'accès DataProvider
-
-| Mécanisme | Contexte | Dynamique |
-|-----------|----------|-----------|
-| **`get` / `set` / `dp`** | Code impératif, snapshot instant T | **Non** (placeholder `${` interdit) |
-| **`sub(chemin \| clé)`** | Template Lit, réactivité | **Oui** — string, concat JS, ou `DataProviderKey` avec `${prop}` |
-| **`@subscribe` / `@publish` / `@handle`** | Propriétés composant | **Oui** — `DataProviderKey<T, U>` avec `"base.${prop}"` |
-| **`@bind`** | Legacy / bidirectionnel | Éviter sur composants métier — préférer `@subscribe` |
-
-### `sub()` — dynamique OK (clés incluses), ne pas migrer vers `get()`
-
-`sub()` accepte `string | DataProviderKey`, résout les placeholders `${prop}` depuis le **composant hôte** du template (comme `@subscribe`), et se ré-abonne quand les props observées changent.
-
-```typescript
-const userKey = new DataProviderKey<User, { userIndex: number }>("users.${userIndex}");
-
-html`<p>${sub(userKey.name)}</p>`
-html`<p>${sub(counterKey.count)}</p>`
-html`<p>${sub(this.formDataProvider + ".email")}</p>`
-```
-
-Doc : `src/docs/_directives/sub.md`.
-
-**Anti-pattern** : remplacer `sub(…)` par `get(…)` dans un template → perte de réactivité (snapshot unique).
-
-### Clé dynamique Concorde → décorateur ou factory
-
-```typescript
-export const resourceKey = new DataProviderKey<ResourceData, { resourceId: string }>(
-  "${resourceId}",
-);
-
-// ❌ dp(resourceKey) ou dp(resourceKey.path) → throw
-export const resourceProvider = (id: string) => dp<ResourceData>(id);
-
-@handle(resourceKey.conf.mode)
-onMode(mode: Mode) { /* … */ }
-```
-
-## Patterns avant / après
-
-### Statique typé (nouveau code)
-
-```typescript
-const cartKey = new DataProviderKey<Cart>("cart");
-set(cartKey, { items: [] });
-dp(cartKey.items[0].qty).set(1);
-```
-
-### ID runtime (string pure, pas placeholder Concorde)
-
-```typescript
-dp(resolvedId); // ex. "resource-abc123"
-set(`forms/${formId}`, formData);
-```
-
-### Index ou segment dynamique via JS (compatible)
-
-**Avant** :
-
-```typescript
-set(`app.pages.${index}.isComplete`, isComplete);
-return get(`app.labels.${language}.${key}`);
-```
-
-**Après** (option typée, même runtime) :
-
-```typescript
-const pagesKey = new DataProviderKey<AppState["pages"]>("app.pages");
-set(pagesKey[index].isComplete, isComplete);
-
-const labelsKey = new DataProviderKey<AppState["labels"]>("app.labels");
-return get(labelsKey[language][key]);
-```
-
-**Helper générique** — conserver si le suffixe ne contient jamais `${` :
-
-```typescript
-export const appSet = <P extends string>(path: P, value: AppValue<P>) => {
-  set(`app.${path}`, value);
-};
-```
-
-### Chemins entièrement statiques
-
-**Avant** :
-
-```typescript
-set("app.widget.computed", value);
-const publisher = dp("app.widget.distance");
-```
-
-**Après** :
-
-```typescript
-const widgetKey = new DataProviderKey<AppState["widget"]>("app.widget");
-set(widgetKey.computed, value);
-const publisher = dp(widgetKey.distance);
-```
-
-## Profils de risque (générique)
-
-| Profil codebase | Risque | Indice |
-|-----------------|--------|--------|
-| Strings JS uniquement, pas de `DataProviderKey` | Très faible | Chemins déjà résolus avant `get/set/dp` |
-| Mix `DataProviderKey` statique + `.path` | Faible | Simplifier `dp(key)` progressivement |
-| Clés avec `"${prop}"` passées à `dp()` | **Élevé** | Remplacer par factory `dp(idRésolu)` ou décorateur |
-| Templates avec `sub()` | Aucun | Ne pas « migrer » vers `get()` |
-
-Migrations **distinctes** (hors scope) : `PublisherManager`, `@onAssign` → `@handle`.
-
-## Checklist migration (agent)
-
-1. [ ] Confirmer version Concorde avec `resolveStaticPublisherPath` dans `dataProviderKey.ts`.
-2. [ ] Chercher `DataProviderKey(` dont le constructeur contient `${` ou `{$`.
-3. [ ] Pour chaque hit : si `get` / `set` / `dp` reçoit la clé → factory `dp(idRésolu)` ou décorateur.
-4. [ ] Simplifier `dp(staticKey.path)` → `dp(staticKey)` sur clés statiques.
-5. [ ] **Ne pas** toucher `sub(...)` ni décorateurs dynamiques sans raison.
-6. [ ] Distinguer grep `${` (source) vs valeur runtime.
-7. [ ] Tests manuels sur les flux métier qui utilisent clés dynamiques et formulaires `sub()`.
-
-## Anti-patterns
-
-| Anti-pattern | Pourquoi |
-|--------------|----------|
-| `dp(key)` sur clé `"${resourceId}"` | Throw immédiat |
-| `sub()` → `get()` dans template | Perte réactivité |
-| Refactor global `.path` → clé sur toutes les clés sans tri statique/dynamique | Régressions |
-| Confondre migration get/set/dp et suppression `PublisherManager` | Périmètres différents |
-
-## Fichiers de référence (package Concorde)
-
-- `src/core/utils/dataProviderKey.ts` — `resolveStaticPublisherPath`
-- `src/core/utils/PublisherProxy.ts` — overloads `get` / `set` / `dp`
-- `src/core/utils/publisherPathKey.spec.ts` — tests
-- `src/core/directives/DataProvider.ts` — `sub()`
-- `src/docs/_misc/dataProviderKey.md`
-
-## Maintenance
-
-Mettre à jour quand l'API Concorde évolue ou que de nouveaux cas edge sont documentés dans les specs.