@supersoniks/concorde 4.8.0 → 4.9.1

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/.gitlab-ci.yml

@@ -1,5 +1,6 @@
 stages:
   - test
+  - publish
 
 variables:
   GIT_STRATEGY: clone
@@ -21,3 +22,15 @@ tests:
     - when: never
   script:
     - bash gitlab/job_tests.sh
+
+# Miroir GitHub filtré (lib seule — sans doc, captcha, infra interne)
+github-mirror:
+  stage: publish
+  tags:
+    - ssks7
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "master"'
+      when: manual
+    - when: never
+  script:
+    - bash gitlab/job_github_mirror.sh

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

@@ -2,18 +2,23 @@
 
 `@supersoniks/concorde` — framework de composants Web basé sur Lit avec système de thèmes, data binding (décorateurs `@subscribe` / `@publish` / `@handle` / `@bind`...) et composants réutilisables.
 
+- **Documentation** : [concorde.supersoniks.org](https://concorde.supersoniks.org/)
+- **Code source public** : [github.com/supersoniks/concorde](https://github.com/supersoniks/concorde)
+- **Développement interne** : GitLab Supersoniks (Merge Requests)
+
 ## 📚 Documentation
 
-La documentation en ligne (à jour) est disponible ici :
+La documentation en ligne est disponible ici :
 
-👉 **https://doc.concorde.test/**
+👉 **https://concorde.supersoniks.org/**
 
-Elle est générée à partir des fichiers `.md` du code source (`yarn build-docs`).Utilisation à vos risques — contributions et retours bienvenus !**
+Elle est générée à partir des fichiers `.md` du code source (`yarn build-docs`).
 
-## 🤖 Agent IA (Cursor + JetBrains)
+En local : `yarn dev` → `https://localhost:3000`
 
+## 🤖 Agent IA (Cursor + JetBrains)
 
-> **Disclaimer : les règles n'ont encore été vraiment testées et seront msie a jour au fur et a mesure. 
+> **Disclaimer** : les règles n'ont pas encore été vraiment testées et seront mises à jour au fur et à mesure.
 
 Règles et skills installables depuis `ai/` :
 
@@ -77,8 +82,8 @@ flowchart LR
 
 ### Les briques de données
 
-- **`DataProviderKey<T>`** — chemin **typé** en notation pointée vers une structure composite, ex. `new DataProviderKey<Data>("data").items[0]` → `"data.items.0"`. Navigation type-safe, chemins dynamiques via `${prop}`. Import : `@supersoniks/concorde/dataProviderKey`. Voir [la doc DataProviderKey](https://doc.concorde.test/#docs/_misc/dataProviderKey.md/dataProviderKey).
-- **`Endpoint<T, U>`** — un **unique chemin HTTP** (sans notation pointée) portant le type de réponse `T` ; segments dynamiques `${...}`. Consommé par `@get`. Import : `@supersoniks/concorde/utils/endpoint`. Voir [la doc Endpoint](https://doc.concorde.test/#docs/_misc/endpoint.md/endpoint).
+- **`DataProviderKey<T>`** — chemin **typé** en notation pointée vers une structure composite, ex. `new DataProviderKey<Data>("data").items[0]` → `"data.items.0"`. Navigation type-safe, chemins dynamiques via `${prop}`. Import : `@supersoniks/concorde/dataProviderKey`. Voir [la doc DataProviderKey](https://concorde.supersoniks.org/#docs/_misc/dataProviderKey.md/dataProviderKey).
+- **`Endpoint<T, U>`** — un **unique chemin HTTP** (sans notation pointée) portant le type de réponse `T` ; segments dynamiques `${...}`. Consommé par `@get`. Import : `@supersoniks/concorde/utils/endpoint`. Voir [la doc Endpoint](https://concorde.supersoniks.org/#docs/_misc/endpoint.md/endpoint).
 - **DataProvider** — le publisher observable qui notifie ses abonnés à chaque assignation.
 
 ### Les décorateurs (`src/core/decorators/subscriber/`)
@@ -91,7 +96,7 @@ flowchart LR
 | `@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 `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).
+`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://concorde.supersoniks.org/#docs/_decorators/subscribe.md/subscribe).
 
 ## 🛠️ Développement
 
@@ -133,19 +138,28 @@ yarn test:ci    # exécution unique (utilisé par la CI)
 - **Vite** — build / dev server
 - **Vitest** — tests (environnement jsdom)
 
-## 🔁 Intégration continue (GitLab)
+## 🔁 Intégration continue
+
+### GitLab (développement interne)
 
-Le projet est hébergé sur GitLab et la CI est définie dans [.gitlab-ci.yml](.gitlab-ci.yml) :
+CI définie dans [.gitlab-ci.yml](.gitlab-ci.yml) :
 
 - le job `tests` s'exécute sur les **Merge Requests** et sur les push dans **`master`** ;
-- il tourne sur le runner `ssks7` et lance `yarn install` + `yarn test:ci` dans le conteneur `nodejs` (script [gitlab/job_tests.sh](gitlab/job_tests.sh)).
+- il tourne sur le runner `ssks7` et lance `yarn install` + `yarn test:ci` (script [gitlab/job_tests.sh](gitlab/job_tests.sh)).
+
+### GitHub (miroir public)
+
+CI définie dans [.github/workflows/ci.yml](.github/workflows/ci.yml) — exécute `yarn test:ci` sur chaque push et Pull Request.
+
+Le dépôt GitHub est un **export filtré** depuis GitLab (librairie uniquement — pas de site doc, pas de `sonic-captcha`, pas d’infra interne). Voir [OPEN_SOURCE_CHECKPOINT.md](OPEN_SOURCE_CHECKPOINT.md).
 
 ## 🤝 Contribution
 
-1. Créer une branche à partir de `master`.
-2. Faire ses modifications.
-3. Vérifier les tests : `yarn test:ci`.
-4. Ouvrir une **Merge Request** vers `master` (la CI lance les tests automatiquement).
+Voir [CONTRIBUTING.md](CONTRIBUTING.md).
+
+**Résumé** :
+- **Équipe interne** : branche + Merge Request sur GitLab.
+- **Contributeurs externes** : issues sur [GitHub](https://github.com/supersoniks/concorde/issues) ; les PR directes sur le miroir GitHub ne sont pas mergées (le code est intégré via GitLab).
 
 ## 📄 Licence
 

package/build-infos.json

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