@supersoniks/concorde 5.0.2 → 5.0.4

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/build-infos.json

@@ -1 +1 @@
-{"date":1790843159}
+{"date":1790855624}