@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

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.

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

@@ -1,78 +0,0 @@
-# Imports Concorde — chemins courts
-
-Toujours préférer le **chemin export le plus court** documenté dans `package.json` de `@supersoniks/concorde` — **dans les projets consommateurs** (apps qui installent le package).
-
-Éviter les chemins `ui/…`, `functional/…`, `core/…` quand un alias racine existe **en dehors du monorepo Concorde**.
-
-## Dans le dépôt Concorde (lib + doc)
-
-Les exports courts (`@supersoniks/concorde/list`, `/menu`, `/queue`, …) **ne résolvent pas** ici : l’alias Vite `@supersoniks/concorde` pointe sur `src/`, pas sur les sous-chemins `package.json`.
-
-| Besoin | ✅ Dans ce repo | ❌ Ne pas utiliser ici |
-|--------|----------------|------------------------|
-| `sonic-list` | `import "../../core/components/functional/list/list"` ou `@supersoniks/concorde/core/components/functional/list/list` | `@supersoniks/concorde/list` |
-| `sonic-queue` | `…/core/components/functional/queue/queue` | `@supersoniks/concorde/queue` |
-| UI (button, input, …) | `…/core/components/ui/…` ou relatif depuis `src/docs` | `@supersoniks/concorde/button`, etc. |
-| `@subscribe`, `@ancestorAttribute` | `@supersoniks/concorde/core/decorators/Subscriber` | — |
-| `DataProviderKey` | `@supersoniks/concorde/core/utils/dataProviderKey` | `@supersoniks/concorde/dataProviderKey` (alias doc seulement si configuré) |
-
-`@supersoniks/concorde/decorators` peut fonctionner (fichier `src/decorators.ts`) ; préférer quand même les chemins `core/…` dans `src/docs/example/**` pour cohérence.
-
-## Composants UI
-
-| Composant | ✅ Préférer | ❌ Éviter |
-|-----------|------------|----------|
-| Menu | `@supersoniks/concorde/menu` | `…/ui/menu` |
-| Menu item | `@supersoniks/concorde/menu-item` | `…/ui/menu-item` |
-| Divider | `@supersoniks/concorde/divider` | `…/ui/divider` |
-| Button | `@supersoniks/concorde/button` | `…/ui/button` |
-| Theme | `@supersoniks/concorde/theme` | `…/ui/theme` |
-| Scope | `@supersoniks/concorde/sonic-scope` | `…/functional/sonic-scope` |
-| Input | `@supersoniks/concorde/input` | `…/ui/form/input` |
-| Select | `@supersoniks/concorde/select` | `…/ui/form/select` |
-| Checkbox | `@supersoniks/concorde/checkbox` | `…/ui/form/checkbox` |
-
-## Composants fonctionnels
-
-| Composant | ✅ Préférer | ❌ Éviter |
-|-----------|------------|----------|
-| List | `@supersoniks/concorde/list` | `…/functional/list` |
-| Queue | `@supersoniks/concorde/queue` | `…/functional/queue` |
-| Router | `@supersoniks/concorde/router` | `…/core/components/functional/router/router` |
-| Fetch | `@supersoniks/concorde/fetch` | `…/functional/fetch` |
-| Value | `@supersoniks/concorde/value` | `…/functional/value` |
-
-## Utilitaires & types
-
-| Besoin | ✅ Préférer | ❌ Éviter |
-|--------|------------|----------|
-| Décorateurs | `@supersoniks/concorde/decorators` | chemins `…/core/decorators/…` |
-| Directives (`sub`) | `@supersoniks/concorde/directives` | — |
-| `get` / `set` / `dp` | `@supersoniks/concorde/utils` | `PublisherManager` |
-| `DataProviderKey` | `@supersoniks/concorde/dataProviderKey` | `…/core/utils/dataProviderKey` |
-| `Endpoint` | `@supersoniks/concorde/utils/endpoint` | `…/core/utils/endpoint` |
-| `APIConfiguration` | `@supersoniks/concorde/utils/api` | `…/core/utils/api` |
-| Vite config | `@supersoniks/concorde/vite-config` | — |
-
-## Exemples
-
-```typescript
-import "@supersoniks/concorde/menu";
-import "@supersoniks/concorde/menu-item";
-import "@supersoniks/concorde/divider";
-import "@supersoniks/concorde/button";
-import "@supersoniks/concorde/theme";
-import "@supersoniks/concorde/input";
-import "@supersoniks/concorde/list";
-import "@supersoniks/concorde/queue";
-import "@supersoniks/concorde/router";
-
-import { subscribe, handle, get } from "@supersoniks/concorde/decorators";
-import { sub } from "@supersoniks/concorde/directives";
-import { get, set } from "@supersoniks/concorde/utils";
-import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
-import { Endpoint } from "@supersoniks/concorde/utils/endpoint";
-import type { APIConfiguration } from "@supersoniks/concorde/utils/api";
-```
-
-Side-effect imports (enregistrement custom elements) : toujours le chemin **composant** court ci-dessus.

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

@@ -1,74 +0,0 @@
----
-name: concorde-menu
-description: >-
-  Menus et navigation Concorde : sonic-menu, sonic-menu-item, sonic-divider.
-  Sidebar, sections, routes pushstate.
----
-
-# Concorde — menus et navigation
-
-Référence doc : `node_modules/@supersoniks/concorde/src/core/components/ui/menu/menu.md`
-
-## Imports
-
-```typescript
-import "@supersoniks/concorde/menu";
-import "@supersoniks/concorde/divider";
-```
-
-## Structure type (navigation latérale)
-
-```html
-<nav aria-label="Navigation latérale">
-  <sonic-menu direction="column" align="left" size="sm" class="w-full">
-    <sonic-menu-item pushstate href="/" autoActive="strict">Accueil</sonic-menu-item>
-
-    <sonic-divider label="Section A" align="left" size="sm"></sonic-divider>
-    <sonic-menu-item pushstate href="/a/page" autoActive="strict">Page A</sonic-menu-item>
-
-    <sonic-divider label="Section B" align="left" size="sm"></sonic-divider>
-    <sonic-menu-item pushstate href="/b/page" autoActive="strict">Page B</sonic-menu-item>
-  </sonic-menu>
-</nav>
-```
-
-## Règles
-
-| Contexte | Composants |
-|----------|------------|
-| Liste de liens / nav | **`sonic-menu`** + **`sonic-menu-item`** |
-| Séparation de sections | **`sonic-divider`** avec `label` |
-| Liens internes (router Concorde) | `pushstate` + `href` sur **`sonic-menu-item`** |
-| Item actif | `autoActive="strict"` sur chaque item de route |
-
-## Interdits pour la navigation
-
-- **Ne pas** empiler des **`sonic-button`** ghost pour simuler un menu latéral.
-- **Ne pas** inventer des séparateurs custom quand **`sonic-divider`** suffit.
-- **Ne pas** oublier `pushstate` sur les liens internes.
-- **Ne pas** mettre `autoActive` sur le **`sonic-menu`** — c’est sur chaque **`sonic-menu-item`**.
-
-## Attributs utiles
-
-### sonic-menu
-
-`direction="column"`, `align="left"`, `size="sm"` pour une sidebar.
-
-### sonic-menu-item
-
-Hérite de **`sonic-button`** : `pushstate`, `href`, `autoActive`, `variant`.
-
-### sonic-divider
-
-`label`, `align="left"`, `size="sm"`.
-
-## Routes fichier
-
-Pas de **tirets** dans les noms de dossiers sous `routes/` — le générateur Concorde produit des identifiants JS invalides (`dpkey-dynamic` → erreur).
-
-## Checklist
-
-- [ ] `sonic-menu` englobe tous les items
-- [ ] Sections séparées par `sonic-divider` avec `label`
-- [ ] Chaque route : `pushstate` + `href` + `autoActive="strict"`
-- [ ] Imports `@supersoniks/concorde/menu`, `/menu-item`, `/divider` (pas `ui/…`)

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

@@ -1,70 +0,0 @@
----
-name: concorde-scope
-description: >-
-  Scope (sonic-scope) — inherited API, form, and icon defaults. Not UI.
-  APIConfiguration via attributes or DataProvider.
----
-
-# Scope — configuration héritée
-
-**Scope** = defaults app-wide via `<sonic-scope>` (light DOM). Les descendants lisent les attributs ancêtres — pas de shadow root.
-
-```typescript
-import "@supersoniks/concorde/sonic-scope";
-```
-
-## Attributs courants
-
-| Zone | Attributs | Consommé par |
-|------|-----------|--------------|
-| API | `serviceURL`, `token`, `credentials`, `userName`, `password` | `@get`, `sonic-list`, `sonic-queue`, `sonic-submit` |
-| Forms | `formDataProvider`, `dataProvider`, `submitResultDataProvider` | champs form, `sonic-submit` |
-| Icons | `customIconLibraryPath`, `customIconDefaultPrefix` | `sonic-icon` `library="custom"` |
-
-## APIConfiguration
-
-Type : `@supersoniks/concorde/utils/api`.
-
-| Champ | Rôle |
-|-------|------|
-| `serviceURL` | URL de base API |
-| `token` | Bearer |
-| `userName` / `password` | Basic auth (si pas de token) |
-| `credentials` | Mode `fetch` (`omit`, `same-origin`, `include`) |
-| `authToken` | Refresh token (attribut scope : `eventsApiToken`) |
-| `tokenProvider` | Chemin pour obtenir un nouveau bearer |
-| `cache`, `blockUntilDone`, `keepAlive`, `addHTTPResponse` | Options avancées fetch |
-
-## Deux façons de configurer l’API
-
-**1. Scope** — attributs sur `<sonic-scope>` ou `<sonic-theme>` (API seulement sur scope recommandé) :
-
-```html
-<sonic-scope serviceURL="https://api.example.com" token="…">
-  …
-</sonic-scope>
-```
-
-```typescript
-@get(usersEndpoint) // pas de 2ᵉ arg — hérite serviceURL
-@state() data: ApiResult<Users> | null = null;
-```
-
-**2. DataProvider** — objet typé :
-
-```typescript
-import type { APIConfiguration } from "@supersoniks/concorde/utils/api";
-
-const apiKey = new DataProviderKey<APIConfiguration>("myApi");
-set(apiKey, { serviceURL: "https://api.example.com", credentials: "same-origin" });
-
-@get(usersEndpoint, apiKey)
-@state() data: ApiResult<Users> | null = null;
-```
-
-Les deux patterns peuvent coexister (scope pour l’URL par défaut, clé explicite quand nécessaire).
-
-## Séparation theme / scope
-
-- **Scope** → API, forms, icônes app-wide
-- **Theme** → couleurs, typo (`concorde-theme`) — **pas** `serviceURL`

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

@@ -1,57 +0,0 @@
----
-name: concorde-theme
-description: >-
-  sonic-theme — design tokens (colors, fonts, dark mode). Not API scope.
----
-
-# Theme — design system
-
-`<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 color font class="block bg-base min-h-screen">
-  …app…
-</sonic-theme>
-
-<!-- dark -->
-<sonic-theme theme="dark" color font class="block bg-base min-h-screen">…</sonic-theme>
-```
-
-## Attributs
-
-| Attribut | Rôle |
-|----------|------|
-| `class="bg-base block"` (Tailwind) | Fond page / surface (`--sc-base`) |
-| `color` | Couleur texte (`--sc-base-content`) |
-| `font` | Famille / graisse (`--sc-font-family-base`) |
-| *(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.
-
-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.
-
-- **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-*`
-
-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.
-
-Palette generator : [concordecolors](https://delanfranchi.github.io/concordecolors/).