@obsidiane/meridiane 3.0.0 → 3.0.1

package/README.md

@@ -1,17 +1,21 @@
 # @obsidiane/meridiane
 
-Génère, depuis le contrat OpenAPI d'API Platform, une librairie Angular (« le bridge ») :
+Connecte une application Angular à une API API Platform, en HTTP et en temps réel (Mercure 1.0).
+
+Le CLI lit le contrat OpenAPI de l'API et génère une librairie Angular, **le bridge** :
 
 - les **modèles TypeScript** de vos ressources ;
-- un **client HTTP** aux conventions API Platform (JSON-LD, Hydra, merge-patch) ;
+- une **façade HTTP** par ressource, aux conventions d'API Platform (JSON-LD, Hydra, merge-patch) ;
 - le **temps réel Mercure 1.0** : abonnement à une ressource ou à un item, connexions partagées, autorisation par cookie.
 
-Le bridge gère la connexion ; la gestion des données reste dans votre application. Il est compatible avec Angular 20, 21 et 22.
+Le bridge gère la communication avec l'API ; la gestion des données reste dans votre application. Il est compatible avec Angular 20, 21 et 22, API Platform 5 et un hub Mercure 1.x.
 
 ## En bref
 
 ```bash
-npx @obsidiane/meridiane@3 generate @app/bridge --spec http://localhost:8000/api/docs.json --out bridge
+# Contrat exporté par Symfony, puis génération dans l'application Angular
+docker compose exec php bin/console api:openapi:export --output=openapi.json
+npx @obsidiane/meridiane@3 generate @app/bridge --spec ../api/openapi.json --out bridge
 ```
 
 ```ts
@@ -28,6 +32,8 @@ list$ = this.projects.getCollection$({page: 1, itemsPerPage: 20});   // Collecti
 changes$ = this.projects.watch$();                                    // Project | ResourceDeletion, en direct
 ```
 
+Le backend publie ses entités sur Mercure (`#[ApiResource(mercure: true)]`) et sert le front, l'API et le hub sur la même origine : voir la [configuration de référence](https://github.com/obsidiane-lab/meridiane/blob/master/docs/backend.md).
+
 ## Commandes
 
 | Commande | Produit |
@@ -40,8 +46,7 @@ Options : `--spec`, `--include`, `--exclude`, `--no-models`, `--version`, `--out
 
 ## Documentation
 
-- [Démarrage](https://github.com/obsidiane-lab/meridiane/blob/master/docs/demarrage.md)
-- [Configuration (cookies, auth, Mercure)](https://github.com/obsidiane-lab/meridiane/blob/master/docs/configuration.md)
-- [HTTP](https://github.com/obsidiane-lab/meridiane/blob/master/docs/http.md) · [Temps réel](https://github.com/obsidiane-lab/meridiane/blob/master/docs/temps-reel.md) · [Backend](https://github.com/obsidiane-lab/meridiane/blob/master/docs/backend.md)
-- [Recettes](https://github.com/obsidiane-lab/meridiane/blob/master/docs/recettes.md) · [Référence](https://github.com/obsidiane-lab/meridiane/blob/master/docs/reference.md) · [CLI](https://github.com/obsidiane-lab/meridiane/blob/master/docs/cli.md)
-- [Dépannage](https://github.com/obsidiane-lab/meridiane/blob/master/docs/depannage.md) · [Migration 2.x → 3.0](https://github.com/obsidiane-lab/meridiane/blob/master/docs/migration-3.0.md)
+- [Backend](https://github.com/obsidiane-lab/meridiane/blob/master/docs/backend.md) : FrankenPHP, Mercure, Symfony et API Platform
+- [Démarrage](https://github.com/obsidiane-lab/meridiane/blob/master/docs/demarrage.md) · [Configuration Angular](https://github.com/obsidiane-lab/meridiane/blob/master/docs/configuration.md)
+- [HTTP](https://github.com/obsidiane-lab/meridiane/blob/master/docs/http.md) · [Temps réel](https://github.com/obsidiane-lab/meridiane/blob/master/docs/temps-reel.md) · [Recettes](https://github.com/obsidiane-lab/meridiane/blob/master/docs/recettes.md)
+- [Référence](https://github.com/obsidiane-lab/meridiane/blob/master/docs/reference.md) · [CLI](https://github.com/obsidiane-lab/meridiane/blob/master/docs/cli.md) · [Dépannage](https://github.com/obsidiane-lab/meridiane/blob/master/docs/depannage.md) · [Migration 2.x → 3.0](https://github.com/obsidiane-lab/meridiane/blob/master/docs/migration-3.0.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@obsidiane/meridiane",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "Générateur de librairie Angular et modèles TypeScript (OpenAPI) pour un bridge Symfony/API Platform + Mercure.",
   "repository": {
     "type": "git",

package/src/README.md

@@ -1,9 +0,0 @@
-# Sources internes du générateur
-
-- `application/` orchestre les workflows du CLI ;
-- `domain/` contient les règles et la normalisation des options ;
-- `infrastructure/` gère fichiers, processus, specs, workspaces et installation locale ;
-- `generators/bridge/` écrit les fichiers du runtime Angular ;
-- `generators/models/` transforme OpenAPI et écrit les modèles TypeScript.
-
-Le runtime Angular généré se trouve dans `../templates/angular-bridge/`.