@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

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

@@ -105,7 +105,7 @@ The library is named after Concorde: every example tells a small aviation story.
 
 ### Images
 
-Use `img/concorde/plane_XX.jpg` (relative path, served from `public/`). Always set a meaningful `alt`.
+Use `/img/concorde/plane_XX.jpg` (absolute from the site root, files in `public/img/`). Always set a meaningful `alt`.
 
 | File | Subject | Fits |
 |------|---------|------|

package/.claude/skills

@@ -0,0 +1 @@
+../.agents/skills

package/.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: yarn
+
+      - run: yarn install --frozen-lockfile
+      - run: yarn test:ci

package/.github-export-ignore

@@ -0,0 +1,30 @@
+# Arborescence exclue du miroir public GitHub (GitLab reste complet).
+# Syntaxe : une entrée par ligne, # = commentaire.
+
+# Site doc
+index.html
+src/docs.ts
+src/docs/
+docs/
+img/
+scripts/create-search.js
+scripts/post-build-docs.js
+scripts/docs-mock-api-vite-plugin.ts
+scripts/docs-open-in-editor-plugin.ts
+public/docs-mock-api-sw.js
+public/docs-mock-api-sw.js.map
+
+# Captcha (dépend de altcha.supersoniks.org)
+src/core/components/ui/captcha/
+
+# Démos intégrées à la doc
+**/*.demo.ts
+
+# CI / infra interne
+gitlab/
+
+# Artefacts locaux
+dist/
+build-infos.json
+concorde-core.bundle.js
+concorde-core.es.js

package/CONTRIBUTING.md

@@ -0,0 +1,59 @@
+# Contribuer à Concorde
+
+Merci de votre intérêt pour `@supersoniks/concorde` !
+
+## Modèle de contribution (phase 1)
+
+Concorde utilise un dépôt **GitLab interne** comme source complète, avec un **export public filtré** sur GitHub (librairie uniquement — pas le site doc, pas le composant captcha lié à l’infra Supersoniks).
+
+| Qui | Où | Comment |
+|-----|-----|---------|
+| Équipe Supersoniks | GitLab | Branche + **Merge Request** vers `master` |
+| Contributeurs externes | GitHub | **Issues** pour signaler bugs ou proposer des améliorations |
+| Contributeurs externes (code) | GitHub / email | Décrire le changement dans une issue, ou proposer un patch que l'équipe intègre sur GitLab |
+
+> Les Pull Requests sur le dépôt GitHub public **ne sont pas mergées directement** : le miroir GitLab → GitHub écraserait ces changements. Ouvrez une issue pour discuter avant d'investir du temps.
+
+## Prérequis
+
+- Node.js 20+ (22 recommandé)
+- Yarn 1.22 (`packageManager` dans `package.json`)
+
+## Workflow développeur interne
+
+```bash
+git checkout -b ma-branche
+yarn install
+# … modifications …
+yarn test:ci
+# Ouvrir une Merge Request vers master sur GitLab
+```
+
+## Tests
+
+```bash
+yarn test       # watch (développement)
+yarn test:ci    # exécution unique (CI)
+```
+
+## Build
+
+```bash
+yarn build        # librairie → dist/
+yarn build-docs   # documentation statique → docs/
+yarn dev          # serveur de doc local (https://localhost:3000)
+```
+
+## Conventions
+
+- Suivre les patterns existants (Lit, décorateurs, DataProviderKey).
+- Pas de `console.log` oubliés (bloqué par `prepublishOnly`).
+- Documentation : fichiers `.md` colocalisés avec les composants dans `src/`.
+
+## Signaler un problème de sécurité
+
+Ne pas ouvrir d'issue publique. Contacter l'équipe Supersoniks directement.
+
+## Évolution prévue
+
+Si des contributions externes deviennent fréquentes, le dépôt GitHub pourra devenir la source canonique (modèle inversé). En attendant, GitLab reste le point d'entrée pour le code.

package/DEV.md

@@ -0,0 +1,54 @@
+# Développement local — consommer Concorde depuis un autre projet
+
+## Recommandé : `file:` (sans `yarn link`)
+
+Dans le projet consommateur (la-billetterie, etc.) :
+
+```bash
+yarn add @supersoniks/concorde@file:../../concorde
+```
+
+- Pas de `yarn link` / `yarn unlink` à gérer
+- Comportement proche d’un install registry
+- Après modification de Concorde : `yarn build` dans concorde (génère `dist/js/` + `dist/types/`), puis rebuild du consommateur
+
+## Alternative : `yarn link`
+
+Toujours supporté. Dans Concorde :
+
+```bash
+yarn link
+```
+
+Dans le consommateur :
+
+```bash
+yarn link @supersoniks/concorde
+```
+
+### Pourquoi `vite-config` exclut Concorde du pre-bundle
+
+Dans `vite/config.js`, quand un `tsconfig` est passé :
+
+```js
+optimizeDeps: {
+  exclude: ["@supersoniks/concorde"],
+  // ...
+}
+```
+
+**Toujours utile** avec `yarn link` ou `file:` : Vite ne met pas Concorde en cache dans `node_modules/.vite`, donc les changements dans `dist/js/` (après `yarn build` dans Concorde) sont pris en compte au prochain HMR / rebuild.
+
+Les exports npm pointent vers `dist/js/` (runtime) et `dist/types/` (types) — le source `src/` sert au développement de Concorde lui-même.
+
+## Types (`.d.ts`) et runtime (`.js`)
+
+`yarn build` exécute `prebuild` (exports) → bundle Vite → `postbuild` (génération de `dist/types/` + `dist/js/`).
+
+`yarn build:types` / `yarn build:js` restent disponibles pour régénérer uniquement les déclarations ou le JS.
+
+## Scripts la-billetterie
+
+`link:concorde` / `unlink:concorde` dans `la-billetterie/concorde/package.json` restent valides.
+
+`test:concorde-lib` pointe vers un fichier `resolvePublisher.spec.ts` **supprimé** — script obsolète à nettoyer côté billetterie.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Supersoniks
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/OPEN_SOURCE_CHECKPOINT.md

@@ -0,0 +1,133 @@
+# Point d'étape — Open Source Concorde
+
+> Modèle retenu (phase 1) : **GitLab = source complète**, **GitHub = export filtré** (librairie seule).
+
+Dernière mise à jour : juin 2025.
+
+---
+
+## ✅ Fait (dans ce dépôt GitLab)
+
+| Élément | Fichier / action |
+|---------|------------------|
+| Licence MIT | `LICENSE` |
+| Retrait Typekit inutilisé | `index.html` |
+| Métadonnées npm (repo, homepage, bugs) | `package.json` |
+| README mis à jour | `README.md` |
+| Guide contributeurs | `CONTRIBUTING.md` |
+| CI GitHub Actions | `.github/workflows/ci.yml` |
+| **Liste d'exclusion GitHub** | `.github-export-ignore` |
+| **Script d'export filtré** | `scripts/github-export.mjs` |
+| **Job CI miroir GitHub** | `gitlab/job_github_mirror.sh` |
+
+### Ce qui reste sur GitLab uniquement (pas sur GitHub)
+
+| Exclu | Raison |
+|-------|--------|
+| `index.html`, `src/docs/`, `src/docs.ts` | Site doc → [concorde.supersoniks.org](https://concorde.supersoniks.org/) |
+| `src/core/components/ui/captcha/` | Dépend de `altcha.supersoniks.org` |
+| `**/*.demo.ts` | Démos intégrées à la doc |
+| `gitlab/` | CI / infra interne |
+
+Le script retire aussi l'import captcha dans `ui.ts` et filtre les `exports` npm liés à la doc/captcha.
+
+---
+
+## ⏳ À faire de votre côté
+
+### 1. Merger ces changements sur GitLab
+
+```bash
+git add LICENSE README.md CONTRIBUTING.md OPEN_SOURCE_CHECKPOINT.md \
+        .github-export-ignore scripts/github-export.mjs \
+        .github/workflows/ci.yml .gitlab-ci.yml \
+        gitlab/job_github_mirror.sh package.json index.html
+git commit -m "Open source : export GitHub filtré (sans doc ni captcha)"
+# MR vers master
+```
+
+### 2. Créer le dépôt GitHub public
+
+1. https://github.com/organizations/supersoniks → **New repository** → `concorde`
+2. **Public**, sans README initial
+
+### 3. Variables CI GitLab
+
+**Settings → CI/CD → Variables** (masquées) :
+
+| Variable | Exemple |
+|----------|---------|
+| `GITHUB_REPO_URL` | `https://github.com/supersoniks/concorde.git` |
+| `GITHUB_TOKEN` | PAT GitHub scope `repo` |
+
+### 4. Premier export (manuel ou CI)
+
+**En local :**
+
+```bash
+node scripts/github-export.mjs /tmp/concorde-github
+cd /tmp/concorde-github
+git init && git add -A && git commit -m "Initial export lib"
+git remote add origin git@github.com:supersoniks/concorde.git
+git push -u origin master
+```
+
+**Via GitLab CI** (après merge sur `master`) :
+
+- Lancer le job manuel **`github-mirror`** dans la pipeline
+
+> **Ne pas** utiliser le push mirror GitLab natif (il enverrait tout, doc + captcha inclus).
+
+### 5. Vérifier GitHub
+
+```bash
+git clone https://github.com/supersoniks/concorde.git
+cd concorde
+yarn install && yarn test:ci
+```
+
+- Pas de `index.html`, pas de `src/docs/`, pas de `captcha.ts`
+- Pas de référence à `cdn.supersoniks.com` ni `altcha.supersoniks.org` dans le tree
+
+### 6. npm
+
+```bash
+yarn build
+npm publish --access public
+```
+
+(idéalement depuis l'export filtré ou après avoir aligné `files` / `exports` npm)
+
+### 7. Documentation en ligne
+
+Doc hébergée sur **https://concorde.supersoniks.org/** (build depuis GitLab, pas depuis GitHub).
+
+---
+
+## Schéma
+
+```
+┌──────────────────────────────────────────┐
+│  GitLab (interne) — tout le dépôt         │
+│  doc + captcha + dev (yarn dev) + CI      │
+└──────────────────┬───────────────────────┘
+                   │ scripts/github-export.mjs
+                   │ (job github-mirror)
+                   ▼
+┌──────────────────────────────────────────┐
+│  GitHub (public) — librairie seule        │
+│  src/core, décorateurs, tests, CI Actions │
+└──────────────────────────────────────────┘
+
+Doc en ligne : concorde.supersoniks.org  (déployée depuis GitLab)
+```
+
+---
+
+## Checklist finale
+
+- [ ] Export GitHub sans `cdn.supersoniks` / `altcha.supersoniks`
+- [ ] `yarn test:ci` OK sur clone GitHub
+- [ ] Job `github-mirror` configuré
+- [ ] npm `@supersoniks/concorde` publié
+- [ ] Doc accessible sur concorde.supersoniks.org

package/README.md

@@ -23,7 +23,7 @@ yarn ai-init
 node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
 ```
 
-Installe `.cursor/skills`, `.cursor/rules`, `.aiassistant/rules` et `AGENTS.md`. Voir [ai/README.md](ai/README.md).
+Installe la skill `concorde` dans `.agents/skills` (liée depuis `.claude/skills` et `.junie/skills`). `AGENTS.md` n’est jamais touché. Voir [ai/README.md](ai/README.md).
 
 ## 📁 Structure du projet
 

package/ai/README.md

@@ -1,58 +1,46 @@
 # Agent IA — Concorde
 
-Fichiers installables pour **Cursor** et **JetBrains AI Assistant**.
+Une skill unique, `concorde` (format [Agent Skills](https://agentskills.io)), installable dans un projet : Cursor, Claude Code, JetBrains Junie et tout agent qui lit `.agents/skills`.
 
-## Installation dans un projet
-
-```bash
-node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
-```
-
-Options :
+## Structure
 
-- `--overlay <dir>` — couche projet ; lit `AGENTS.concorde.md` (legacy : `AGENTS.overlay.md`, `AGENTS.starter.md`)
-- `--skip-agents` — n’écrit jamais `AGENTS.md` (skills / rules seulement)
-- `--merge-agents` — opt-in : conserve le préambule projet et ajoute / rafraîchit le bloc Concorde
-- `--force-agents` — opt-in : **remplace** tout `AGENTS.md` (destructif)
-- `--cursor-only` / `--jetbrains-only`
+Sur le modèle de la skill shadcn : un point d’entrée court, des fichiers de règles lus à la demande.
 
-Depuis le dépôt Concorde (dev) : `yarn ai-init`
+```text
+skills/concorde/
+  SKILL.md            point d’entrée : sources (projet, doc, custom-elements.json), règles critiques, imports
+  rules/data.md       store, DataProviderKey, décorateurs, sub(), get / set / dp
+  rules/http.md       Endpoint, @get / @post, configuration API
+  rules/lists-forms.md
+  rules/styling.md    thème, tokens, règles de style
+  rules/composition.md  parties des composants composés, états intégrés
+  rules/troubleshooting.md  symptôme → cause → correction
+```
 
-## Politique `AGENTS.md` (non invasive)
+Ajouter un sujet = un fichier dans `rules/` + une ligne dans le tableau « Rules files » de `SKILL.md`. Pas de nouvelle skill sauf besoin vraiment distinct.
 
-| Situation | Comportement par défaut |
-|-----------|-------------------------|
-| Pas de `AGENTS.md` | Création du guide Concorde |
-| Fichier avec `<!-- concorde-ai -->` | Rafraîchit la zone gérée seulement |
-| Fichier **sans** marker (notes projet) | **Laissé intact** — skills / rules suffisent |
-| `--merge-agents` | Préambule projet + bloc Concorde après le marker |
-| `--force-agents` | Remplacement complet |
-| `--skip-agents` | Jamais d’écriture `AGENTS.md` |
+## Installation dans un projet
 
-```text
-[optional project preamble — short, project-only]
-<!-- concorde-ai -->
-<package ai/AGENTS.md>
-[--- + overlay AGENTS.concorde.md]
+```bash
+node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
 ```
 
-- Tout **après** `<!-- concorde-ai -->` est **régénéré** à chaque run (pas d’empilement).
-- Ne pas recopier le guide Concorde dans le préambule : notes projet → `overlay/AGENTS.concorde.md`.
-- Si le préambule duplique `ai/AGENTS.md`, `ai-init` le **allège / drop** et affiche un warning.
-- Legacy : `AGENTS.overlay.md` / `AGENTS.starter.md` encore lus si `AGENTS.concorde.md` est absent (warning de dépréciation).
+Depuis le dépôt Concorde : `yarn ai-init`.
+
+| Source | Cible dans le projet |
+|--------|---------------------|
+| `skills/<nom>/` | `.agents/skills/<nom>/` (copie ; lue directement par Cursor) |
+| — | `.claude/skills/<nom>` et `.junie/skills/<nom>` : liens symboliques (copie si les liens sont interdits) |
 
-## Contenu
+Options :
 
-| Dossier | Cible |
-|---------|--------|
-| `skills/` | `.cursor/skills/` (concorde, imports, scope, theme, menu) |
-| `cursor/rules/` | `.cursor/rules/` |
-| `jetbrains/rules/` | `.aiassistant/rules/` |
-| `AGENTS.md` | racine du projet **seulement** si absent, déjà marqué, ou via `--merge-agents` / `--force-agents` |
+- `--overlay <dir>` — skills supplémentaires d’un kit projet (`<dir>/skills/<nom>/`)
+- `--no-links` — `.agents/skills` seulement
+- `--project-root <dir>`, `--concorde-ai <dir>`
 
-## Template starter
+**`AGENTS.md` appartient au projet** : `ai-init` ne le lit ni ne l’écrit. Les agents trouvent la skill seuls, par sa description.
 
-Le package `create-concorde-ts-starter` ajoute un overlay via `yarn ai:sync`.
+Seules les skills du package sont remplacées ; une skill du projet portant le même nom n’est jamais écrasée. Si `.claude/skills` pointe déjà vers `.agents/skills`, aucun lien par skill n’est créé.
 
 ## Tests