@obsidiane/meridiane 2.0.6 → 2.0.7

package/README.md

@@ -1,8 +1,8 @@
 # @obsidiane/meridiane
 
-CLI pour générer un bridge Angular (API Platform + Mercure) depuis une spec OpenAPI.
+CLI pour générer un bridge Angular (runtime + models TypeScript) depuis une spec OpenAPI (API Platform + Mercure).
 
-Documentation complète (repo) : `docs/guide-bridge.md`.
+Documentation complète du repo : `docs/guide-bridge.md`.
 
 ## Installation
 
@@ -10,17 +10,11 @@ Documentation complète (repo) : `docs/guide-bridge.md`.
 npm i -D @obsidiane/meridiane
 ```
 
-Ou en global :
-
-```bash
-npm i -g @obsidiane/meridiane
-```
-
 ## Commandes
 
 ### `meridiane generate <packageName>`
 
-Génère uniquement les fichiers du bridge dans le workspace courant (pas de build, pas de `npm pack`).
+Génère uniquement les sources du bridge dans le workspace courant.
 
 ```bash
 npx meridiane generate @acme/backend-bridge --spec ./openapi.json
@@ -30,7 +24,7 @@ Sortie par défaut : `projects/<libName>/` (modifiable via `--out`).
 
 ### `meridiane dev [packageName]`
 
-Build standalone + installation locale dans `node_modules`.
+Génération + build standalone + `npm pack` + installation locale dans `node_modules`.
 
 ```bash
 npx meridiane dev @acme/backend-bridge --spec http://localhost:8000/api/docs.json
@@ -42,10 +36,10 @@ Sorties :
 
 ### `meridiane build <packageName>`
 
-Build standalone + `npm pack` (artefact publiable).
+Génération + build standalone + `npm pack` (artefact publiable).
 
 ```bash
-npx meridiane build @acme/backend-bridge --version 0.1.0 --spec https://staging.example/api/docs.json
+npx meridiane build @acme/backend-bridge --version 1.2.3 --spec https://staging.example/api/docs.json
 ```
 
 Sorties :
@@ -54,20 +48,21 @@ Sorties :
 
 ## Options
 
-- `--spec <url|file>` : source OpenAPI (URL ou fichier JSON local) ; requis sauf `--no-models`.
-- `--formats <mimeTypes>` : répétable ou liste `,` (ordre significatif). Active le mode contract-driven.
-- `--include/--exclude <substr>` : filtrer des noms de schémas OpenAPI.
-- `--no-models` : ne génère que le runtime (pas de models).
-- `--version <semver>` : version écrite dans le `package.json` (`build` + `generate`).
-- `--out <dir>` : répertoire de sortie pour `generate` (défaut `projects/<libName>`).
-- `--debug` : logs détaillés.
+- `--spec <url|file>` : URL OpenAPI ou fichier JSON local (requis sauf `--no-models`)
+- `--formats <mimeTypes>` : répétable ou liste `,` ; défaut `application/ld+json`
+- `--include <substr>` / `--exclude <substr>` : filtres de noms de schémas (répétables, support `,`)
+- `--no-models` : runtime only
+- `--version <semver>` : `build` et `generate` (défaut `0.0.0`)
+- `--out <dir>` : uniquement `generate`
+- `--debug` : logs détaillés
 
 ## Notes importantes
 
-- `--formats` active un mode contract-driven : seuls les schemas réellement utilisés par les endpoints/paths sont générés.
-- Les modèles `*.jsonMergePatch` ne sont jamais générés (`PATCH` est typé en `Partial<T>`).
-- Meridiane **ne publie pas** : utilisez `npm publish` côté CI.
+- fallback automatique `.../api/docs.json` -> `.../api/docs.jsonopenapi` si nécessaire
+- mode contract-driven : uniquement les schémas atteignables via `paths` pour les formats sélectionnés
+- modèles `*jsonMergePatch*` non générés (`PATCH` typé `Partial<T>`)
+- Meridiane ne publie pas : publication via `npm publish` côté CI
 
-## Note (repo Meridiane)
+## Spécifique à ce repo
 
-Dans ce repo, `meridiane dev` peut être exécutée sans `packageName` et cible l’app sandbox (`apps/sandbox`).
+Dans ce monorepo, `meridiane dev` peut être exécuté sans `packageName` et cible alors `@obsidiane/bridge-sandbox` (app `apps/sandbox`).

package/package.json

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