@fraza/core 0.3.4 → 0.3.6

package/CHANGELOG.md

@@ -4,7 +4,17 @@ Historique des versions publiées de `@fraza/core`.
 
 Ce fichier est généré par `fraza-module changelog` à partir des messages de commit. Ne pas le modifier à la main.
 
-## 0.3.4 (2026-10-25)
+## 0.3.6 (2026-10-25)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.3.5 (2026-10-25)
+
+### Refontes
+
+- **docs, src/tools, test/tools** : update documentation and CLI for version intermediately published on Fraza registry (0595be8)
+
+## 0.3.4 (2026-10-24)
 
 ### Refontes
 

package/THIRD-PARTY-NOTICES.md

@@ -19,7 +19,7 @@ Il est généré par `fraza-module notices` à partir de l'arbre réellement ins
 
 | Paquet | Version | Licence |
 |---|---|---|
-| `@fraza/icons` | 0.3.7 | MIT |
+| `@fraza/icons` | 0.3.9 | MIT |
 | `node-cron` | 4.2.1 | ISC |
 | `pg` | 8.20.0 | MIT |
 | `pg-cloudflare` | 1.3.0 | MIT |
@@ -146,11 +146,33 @@ OTHER DEALINGS IN THE FONT SOFTWARE.
 
 ## Textes de licence
 
-### @fraza/icons@0.3.7
+### @fraza/icons@0.3.9
 
 Licence : MIT
 
-Aucun fichier de licence livré par le paquet. Se référer à la licence `MIT` déclarée dans son `package.json`.
+```
+MIT License
+
+Copyright (c) 2026 HYKO
+
+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.
+```
 
 ### node-cron@4.2.1
 

package/changelog.json

@@ -2,13 +2,41 @@
   "name": "@fraza/core",
   "versions": [
     {
-      "version": "0.3.4",
+      "version": "0.3.6",
+      "date": "2026-10-25",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "templateChanged": [],
+      "action": [],
+      "entries": []
+    },
+    {
+      "version": "0.3.5",
       "date": "2026-10-25",
       "breaking": [],
       "envAdded": [],
       "envRemoved": [],
       "templateChanged": [],
       "action": [],
+      "entries": [
+        {
+          "type": "refactor",
+          "scope": "docs, src/tools, test/tools",
+          "subject": "update documentation and CLI for version intermediately published on Fraza registry",
+          "hash": "0595be8",
+          "breaking": false
+        }
+      ]
+    },
+    {
+      "version": "0.3.4",
+      "date": "2026-10-24",
+      "breaking": [],
+      "envAdded": [],
+      "envRemoved": [],
+      "templateChanged": [],
+      "action": [],
       "entries": [
         {
           "type": "refactor",

package/dist/docs/02-guides/basculer-sur-le-registre-de-secours.md

@@ -12,7 +12,7 @@ Ce guide s'adresse à qui doit installer ou déployer un projet Fraza pendant qu
 
 ## Pourquoi c'est possible
 
-Le core, `@fraza/start` et les modules gratuits sont publiés sur npmjs, d'où un projet les installe par défaut. Chaque version est aussi publiée sur `https://registry.fraza.ca/`, en copie de secours, en lecture libre.
+Le core, `@fraza/start` et les modules gratuits sont publiés sur npmjs, d'où un projet les installe par défaut. Chaque version publiée sur npmjs l'est aussi sur `https://registry.fraza.ca/`, en copie de secours, en lecture libre. Ce registre porte en plus des versions intermédiaires, publiées pour tester un changement, qui ne vont pas sur npmjs.
 
 Les deux registres reçoivent le même fichier, octet pour octet : la commande de publication construit un seul tarball et l'envoie aux deux. Le `package-lock.json` vérifie l'empreinte (`integrity`) de chaque paquet installé. Comme l'empreinte est la même sur les deux registres, le lockfile reste valable après la bascule.
 
@@ -57,6 +57,8 @@ La commande retire la ligne `@fraza:registry` du `.npmrc` et remet les adresses
 
 Un projet créé avant la publication sur npmjs pointe encore `@fraza` vers `https://registry.fraza.ca/`. La même commande le fait passer sur npmjs, à condition que ses versions de `@fraza/*` y soient publiées : lancer d'abord `npx fraza-update` si elles sont anciennes.
 
+Un `npx fraza-update` lancé pendant la bascule peut installer une version intermédiaire, présente sur `registry.fraza.ca` seulement. Le lockfile la désigne alors, et `npm ci` échouerait après le retour sur npmjs. Dans ce cas, attendre que cette version ou une plus récente soit sur npmjs, puis relancer `npx fraza-update` après le retour.
+
 ## Diagnostiquer
 
 | Symptôme | Cause probable |

package/dist/docs/03-reference/05-cli/fraza-module.md

@@ -169,6 +169,7 @@ npx fraza-module release
 npx fraza-module release minor
 npx fraza-module release 0.2.1
 npx fraza-module release --dry-run
+npx fraza-module release -g
 ```
 
 Au lieu d'un niveau, un numéro exact `X.Y.Z` fixe la version, par exemple pour aligner le core, start et les modules sur un même numéro. Il doit être une version stable, supérieure à la version actuelle.
@@ -177,41 +178,47 @@ Publie une nouvelle version du paquet en une commande. Le seul choix qui reste a
 
 Chaque paquet la lance par son script `release`, en un seul appel, pour que les arguments de `npm run release -- minor` arrivent à la commande.
 
+Sans `-g`, la version part sur `registry.fraza.ca` seulement : c'est le mode des versions qui servent à tester un changement dans un projet. Avec `-g`, un paquet `@fraza/*` part aussi sur npmjs, d'où les sites installent. Un module `@fraza-pro/*` ne va jamais sur npmjs : `-g` ne change rien pour lui, et la commande le dit.
+
 Les étapes s'enchaînent dans cet ordre, et la première qui échoue arrête la commande :
 
-1. **Vérifications, avant toute écriture.** Le paquet est dans un dépôt git, sur une branche qui suit une branche distante, affichée en tête. La commande lance `git fetch` sur le dépôt distant de cette branche et refuse une branche en retard sur lui : sans cela, la publication partirait et seul `git push`, à la fin, serait refusé. Sans réseau, elle s'arrête là. Aucune publication précédente n'est restée arrêtée après son commit de version. L'arbre de travail est propre, l'étiquette `v<nouvelle version>` n'existe ni en local ni sur le dépôt distant, `CHANGELOG.md` et `changelog.json` sont déclarés dans `files`, et `publishConfig` est conforme (voir [`publish`](#publish)). Puis la commande installe la dernière version publiée de chaque dépendance Fraza du paquet (`npm install --no-save @fraza/…@latest`, sans toucher à `package.json` ni au lockfile), et lance `npm run build`, `check` pour un module, `npm test` quand le paquet déclare ce script, et l'arbre doit être resté propre après le build. Un échec ici laisse le dépôt exactement dans son état d'avant.
+1. **Vérifications, avant toute écriture.** Le paquet est dans un dépôt git, sur une branche qui suit une branche distante, affichée en tête. La commande lance `git fetch` sur le dépôt distant de cette branche et refuse une branche en retard sur lui : sans cela, la publication partirait et seul `git push`, à la fin, serait refusé. Sans réseau, elle s'arrête là. Aucune publication précédente n'est restée arrêtée après son commit de version. L'arbre de travail est propre, l'étiquette `v<nouvelle version>` n'existe ni en local ni sur le dépôt distant, `CHANGELOG.md` et `changelog.json` sont déclarés dans `files`, et `publishConfig` est conforme (voir [`publish`](#publish)). Puis la commande installe la dernière version publiée de chaque dépendance Fraza du paquet (`npm install --no-save @fraza/…@latest`, sans toucher à `package.json` ni au lockfile). Le registre suit la publication, jamais `~/.npmrc` : `registry.fraza.ca` par défaut, qui porte les dernières versions de test, npmjs avec `-g`, pour vérifier le paquet contre les versions qu'un site recevra avec lui. Elle lance ensuite `npm run build`, `check` pour un module, `npm test` quand le paquet déclare ce script, et l'arbre doit être resté propre après le build. Un échec ici laisse le dépôt exactement dans son état d'avant.
 2. **Montée de version.** La commande affiche `ancienne → nouvelle`, écrit la version dans `package.json` et dans les entrées racine de `package-lock.json`, régénère le module de version (`sync-version`) et les notes de version (`changelog`), relance `npm run build`, puis committe ces fichiers seuls avec le message `chore: bump version to X.Y.Z`. `THIRD-PARTY-NOTICES.md`, que le build régénère d'après les paquets installés, part dans ce même commit : il change quand une dépendance Fraza vient d'avancer. Un échec avant le commit remet ces fichiers dans leur état d'avant.
-3. **Publication sur chaque registre**, par [`publish`](#publish) : `prepublishOnly` relance le build et les contrôles du paquet, puis le même tarball part vers npmjs et `registry.fraza.ca` pour `@fraza/*`, vers `registry.fraza.ca` seulement pour `@fraza-pro/*`.
+3. **Publication sur chaque registre**, par [`publish`](#publish) : `prepublishOnly` relance le build et les contrôles du paquet, puis le même tarball part vers `registry.fraza.ca`, précédé de npmjs avec `-g` pour un paquet `@fraza/*`.
 4. **Étiquette et envoi, seulement si chaque registre a accepté la version.** `git tag -a v<version> -m v<version>`, puis `git push --atomic --follow-tags`, qui envoie la branche et l'étiquette ensemble ou aucune des deux.
 
 Le lockfile est modifié comme un fichier JSON, pas par `npm install` : un module se construit souvent contre un core installé avec `--no-save`, qu'une installation inscrirait dans son lockfile.
 
-Un échec après le commit ne s'annule pas en silence. La commande s'arrête et dit où en est la publication : commit de version fait en local, aucune étiquette, rien de poussé quand un registre a refusé la version, et la liste des registres qui l'ont et de ceux où elle manque. Elle affiche les commandes pour reprendre (`npm run release:publish`, qui ne publie que là où la version manque, puis l'étiquette et l'envoi), et `git reset --hard HEAD~1` pour annuler la montée de version tant qu'aucun registre ne l'a reçue. Quand seul l'envoi échoue, elle dit si l'étiquette a atteint le dépôt distant, et propose `git pull --no-rebase` avant de pousser à nouveau : un rebase réécrirait le commit de version, que l'étiquette publiée désigne. Relancer `npm run release` à ce stade monterait la version une deuxième fois : la commande refuse de partir quand `HEAD` est le commit de version de la version courante, pas encore sur le dépôt distant, et redonne les commandes pour reprendre ou annuler.
+Un échec après le commit ne s'annule pas en silence. La commande s'arrête et dit où en est la publication : commit de version fait en local, aucune étiquette, rien de poussé quand un registre a refusé la version, et la liste des registres qui l'ont et de ceux où elle manque. Elle affiche les commandes pour reprendre (`npm run release:publish`, avec `-g` si la publication visait npmjs, qui ne publie que là où la version manque, puis l'étiquette et l'envoi), et `git reset --hard HEAD~1` pour annuler la montée de version tant qu'aucun registre ne l'a reçue. Quand seul l'envoi échoue, elle dit si l'étiquette a atteint le dépôt distant, et propose `git pull --no-rebase` avant de pousser à nouveau : un rebase réécrirait le commit de version, que l'étiquette publiée désigne. Relancer `npm run release` à ce stade monterait la version une deuxième fois : la commande refuse de partir quand `HEAD` est le commit de version de la version courante, pas encore sur le dépôt distant, et redonne les commandes pour reprendre ou annuler.
 
 | Option | Effet |
 |---|---|
 | `patch`, `minor`, `major` | Niveau de la montée de version. `patch` par défaut. |
 | `X.Y.Z` | Version exacte, à la place d'un niveau. |
 | `--dry-run` | Fait les vérifications, build et tests compris, calcule la nouvelle version, puis affiche chaque étape qui aurait suivi. N'écrit rien dans le dépôt : aucun commit, aucune étiquette, aucun envoi, aucune publication. Seul le `git fetch` des vérifications met à jour les branches distantes suivies. |
+| `-g`, `--global` | Publie aussi sur npmjs, en premier, un paquet `@fraza/*`. Les dépendances Fraza des vérifications viennent alors de npmjs. |
 
 `npm run release --dry-run`, sans `--`, donne l'option à npm et non au script. La commande le détecte et simule aussi : sans cela, `npm publish` ne ferait que simuler alors que l'étiquette et l'envoi auraient lieu.
 
+`npm run release -g` donne de même `-g` à npm, qui le transmet au script comme `npm_config_global`. La commande le lit comme une demande de publication sur npmjs, puis le retire de son environnement : chaque `npm` qu'elle lance en hériterait, et `npm install --no-save` installerait en global.
+
 ## `publish`
 
 ```bash
 npx fraza-module publish
 npx fraza-module publish --dry-run
+npx fraza-module publish -g
 ```
 
 Publie la version actuelle de `package.json`, sans la monter, sur chaque registre du paquet où elle manque. [`release`](#release) l'appelle à son étape 3. Chaque paquet Fraza l'expose aussi par son script `release:publish`, pour terminer une publication interrompue. Le core et `@fraza/start` n'installent pas `fraza-module` comme dépendance : `npm run release:publish` y lance le CLI du dépôt.
 
 | Scope | Registres, dans l'ordre |
 |---|---|
-| `@fraza/*` | npmjs, avec `--access=public`, puis `https://registry.fraza.ca/`. |
-| `@fraza-pro/*` | `https://registry.fraza.ca/` seulement. |
+| `@fraza/*` | `https://registry.fraza.ca/`. Avec `-g` : npmjs, avec `--access=public`, puis `https://registry.fraza.ca/`. |
+| `@fraza-pro/*` | `https://registry.fraza.ca/` seulement, `-g` ou non. |
 | Autre | `npm publish` dans le dossier, vers le registre de sa propre configuration. |
 
-npmjs passe en premier : c'est le registre d'où les sites installent, et le plus strict, puisqu'un numéro de version n'y est jamais réutilisable. Un refus de npmjs arrête la publication avant que le secours ne reçoive une version que npmjs n'a pas.
+Avec `-g`, npmjs passe en premier : c'est le registre d'où les sites installent, et le plus strict, puisqu'un numéro de version n'y est jamais réutilisable. Un refus de npmjs arrête la publication avant que le secours ne reçoive une version que npmjs n'a pas.
 
 Les étapes :
 
@@ -224,13 +231,14 @@ Les deux registres reçoivent ainsi le même fichier, octet pour octet. Le `pack
 
 Le registre est passé par scope, `--@fraza:registry=<adresse>`, jamais par `--registry` : npm choisit une ligne de scope de `~/.npmrc` avant `--registry`, et la machine d'un mainteneur pointe souvent `@fraza` vers `registry.fraza.ca`. Les options de ligne de commande passent avant `publishConfig`.
 
-La commande se relance sans risque : un registre qui a déjà la version est sauté. C'est aussi ainsi qu'une version publiée sur un seul registre est copiée sur l'autre.
+La commande se relance sans risque : un registre qui a déjà la version est sauté. C'est aussi ainsi qu'une version publiée sur `registry.fraza.ca` seulement est portée sur npmjs, avec `-g` : son tarball est téléchargé et envoyé tel quel.
 
 npm peut demander un code à usage unique quand le compte npmjs a la double authentification : la sortie de npm s'affiche telle quelle et le code se saisit dans le terminal.
 
 | Option | Effet |
 |---|---|
 | `--dry-run` | Interroge les registres et dit où la version partirait, et depuis quel tarball. Ne construit et ne publie rien. |
+| `-g`, `--global` | Ajoute npmjs, en premier, aux registres d'un paquet `@fraza/*`. `npm run release:publish -g` fonctionne sans `--`. |
 
 ### Dépendances Fraza
 

package/dist/docs/05-contribution/05-publication.md

@@ -1,6 +1,6 @@
 ---
 title: Publication
-description: Checklist avant publication, versionnage semver, et publication sur npmjs et le registre Fraza en une commande.
+description: Checklist avant publication, versionnage semver, publication sur le registre Fraza par défaut, et sur npmjs avec -g.
 related:
   title: Étapes suivantes
   links:
@@ -12,8 +12,8 @@ Les paquets Fraza vivent sur deux registres :
 
 | Scope | Registres | Rôle |
 |---|---|---|
-| `@fraza/*` (core, `@fraza/start`, modules gratuits) | npmjs, puis `https://registry.fraza.ca/` | npmjs est le registre d'où les sites installent. `registry.fraza.ca` garde une copie complète, en secours. |
-| `@fraza-pro/*` (modules Pro) | `https://registry.fraza.ca/` seulement | Le registre est la barrière de la licence. |
+| `@fraza/*` (core, `@fraza/start`, modules gratuits) | `https://registry.fraza.ca/` par défaut, npmjs en plus avec `-g` | npmjs est le registre d'où les sites installent. `registry.fraza.ca` reçoit chaque version, y compris celles qui servent à tester un changement dans un projet, et garde une copie complète de npmjs, en secours. |
+| `@fraza-pro/*` (modules Pro) | `https://registry.fraza.ca/` seulement, `-g` ou non | Le registre est la barrière de la licence. |
 
 Une seule commande publie aux bons endroits. La lecture est libre partout sauf pour `@fraza-pro`, la publication demande un compte sur chaque registre. Le dépôt source est hébergé sur Gitea, en dépôt privé.
 
@@ -73,17 +73,44 @@ Une seule commande, dans le paquet modifié :
 npm run release
 ```
 
-La commande ne publie que ce paquet. Pour un autre niveau que `patch`, le donner en argument :
+La commande ne publie que ce paquet, et seulement sur `registry.fraza.ca`. La version est disponible tout de suite pour un projet de test dont `@fraza` pointe vers ce registre. Les sites, qui installent depuis npmjs, ne la voient pas.
+
+Chaque dépôt de paquet Fraza (core, `@fraza/start`, `@fraza/icons`, modules) porte un `.npmrc` qui pointe `@fraza` vers le registre Fraza :
+
+```ini
+@fraza:registry=https://registry.fraza.ca/
+```
+
+En développement, `npm install` et `npm update` y prennent donc `@fraza/core` et `@fraza/icons`, versions de test comprises. npm n'inclut jamais un `.npmrc` dans un paquet publié, et `@fraza/start` écrit celui d'un nouveau projet sans copier le sien : cette ligne ne sort pas du dépôt. Un module Pro garde en plus sa ligne `@fraza-pro`. `@fraza/icons` ne suit pas son `.npmrc` dans git, parce qu'il porte le jeton Hugeicons : la ligne s'y ajoute à la main sur chaque machine.
+
+Pour qu'un projet de test reçoive les versions de test, pointer aussi `@fraza` vers le registre Fraza dans son `.npmrc`, ou dans `~/.npmrc` pour tous les projets de la machine :
+
+```bash
+npm config set "@fraza:registry" https://registry.fraza.ca/
+```
+
+Sans cette ligne, `npm install` et `npx fraza-update` vont chercher `@fraza/*` sur npmjs et ne voient que les versions publiées avec `-g`. La publication, elle, ne dépend d'aucune de ces lignes : elle passe le registre visé à chaque appel.
+
+Quand plusieurs changements sont prêts pour les sites, ajouter `-g` :
+
+```bash
+npm run release -g
+```
+
+La version part alors sur npmjs, puis sur `registry.fraza.ca`. npmjs met plusieurs minutes à rendre une nouvelle version visible : c'est pourquoi les versions de test n'y vont pas. Les versions intermédiaires restent sur `registry.fraza.ca` seulement, et npmjs passe directement de la dernière version portée à la nouvelle.
+
+Pour un autre niveau que `patch`, le donner en argument :
 
 ```bash
 npm run release -- minor
+npm run release -g -- minor
 ```
 
 Le script `release` lance [`fraza-module release`](../03-reference/05-cli/fraza-module.md#release), qui monte la version, `patch` par défaut, et enchaîne quatre étapes dans cet ordre. Il s'arrête à la première qui échoue :
 
 1. **Vérifications, avant toute écriture** : arbre de travail propre, branche courante affichée et suivie d'une branche distante, `git fetch` puis branche à jour avec elle, étiquette encore libre en local comme sur le dépôt distant, build, contrat pour un module, tests. Un échec laisse le dépôt intact.
 2. **Montée de version** : la commande affiche `ancienne → nouvelle`, écrit la version dans `package.json` et `package-lock.json`, régénère le module de version, `CHANGELOG.md`, `changelog.json` et le résumé `package.json#fraza`, rebuild, puis committe ces fichiers seuls avec le message `chore: bump version to X.Y.Z`. Ce message est la borne de version que lit le générateur de notes : voir [Notes de version](./07-changelog.md).
-3. **Publication** par [`fraza-module publish`](../03-reference/05-cli/fraza-module.md#publish) : `prepublishOnly` relance le build, puis `fraza-module check` pour un module. Le paquet est empaqueté une fois, et ce même tarball part vers npmjs puis `registry.fraza.ca` pour `@fraza/*`, vers `registry.fraza.ca` seulement pour `@fraza-pro/*`. Les deux registres servent ainsi les mêmes octets, ce qui permet à un site de [basculer sur le registre de secours](../02-guides/basculer-sur-le-registre-de-secours.md).
+3. **Publication** par [`fraza-module publish`](../03-reference/05-cli/fraza-module.md#publish) : `prepublishOnly` relance le build, puis `fraza-module check` pour un module. Le paquet est empaqueté une fois, et ce même tarball part vers `registry.fraza.ca`. Avec `-g`, un paquet `@fraza/*` part d'abord vers npmjs, puis vers `registry.fraza.ca`. Les deux registres servent ainsi les mêmes octets, ce qui permet à un site de [basculer sur le registre de secours](../02-guides/basculer-sur-le-registre-de-secours.md).
 4. **`git tag -a v<version>` puis `git push --atomic --follow-tags`**, seulement si chaque registre a accepté la version. `--atomic` envoie la branche et l'étiquette ensemble, ou aucune des deux : sans lui, git pousse l'étiquette même quand il refuse la branche, et le dépôt distant garde une étiquette sur un commit qu'aucune branche ne contient.
 
 Pour voir la version calculée et vérifier le paquet sans rien écrire ni publier :
@@ -92,7 +119,7 @@ Pour voir la version calculée et vérifier le paquet sans rien écrire ni publi
 npm run release -- --dry-run
 ```
 
-L'étiquette vient après la publication : une publication refusée par un registre ne laisse pas d'étiquette sur une version incomplète, ni de commit poussé qui l'annonce. Dans ce cas, la commande s'arrête sur le commit de version, fait en local, dit sur quels registres la version est arrivée, et affiche les commandes pour reprendre : `npm run release:publish`, qui publie seulement là où elle manque, avec le même tarball, puis l'étiquette et l'envoi. Relancer `npm run release` monterait la version une deuxième fois, sur une version jamais publiée : la commande le refuse. Quand `HEAD` est le commit de version de la version courante et n'est pas encore sur le dépôt distant, elle s'arrête avant toute écriture et redonne les commandes pour reprendre, ou seulement l'envoi si l'étiquette est déjà posée. Pour annuler la montée de version, `git reset --hard HEAD~1`, seulement si aucun registre n'a reçu la version : un numéro publié sur npmjs n'est plus jamais réutilisable.
+L'étiquette vient après la publication : une publication refusée par un registre ne laisse pas d'étiquette sur une version incomplète, ni de commit poussé qui l'annonce. Dans ce cas, la commande s'arrête sur le commit de version, fait en local, dit sur quels registres la version est arrivée, et affiche les commandes pour reprendre : `npm run release:publish`, avec `-g` si la publication visait npmjs, qui publie seulement là où elle manque, avec le même tarball, puis l'étiquette et l'envoi. Relancer `npm run release` monterait la version une deuxième fois, sur une version jamais publiée : la commande le refuse. Quand `HEAD` est le commit de version de la version courante et n'est pas encore sur le dépôt distant, elle s'arrête avant toute écriture et redonne les commandes pour reprendre, ou seulement l'envoi si l'étiquette est déjà posée. Pour annuler la montée de version, `git reset --hard HEAD~1`, seulement si aucun registre n'a reçu la version : un numéro publié sur npmjs n'est plus jamais réutilisable.
 
 Si l'envoi échoue après la publication, la commande dit si l'étiquette a atteint le dépôt distant. Quand la branche distante a avancé entre-temps, lancer `git pull --no-rebase`, puis `git push --atomic --follow-tags`. Ne pas rebaser le commit de version : l'étiquette, déjà publiée, pointerait vers un commit qu'aucune branche ne contient.
 
@@ -117,15 +144,19 @@ Le build produit aussi `dist/docs/`, donc la documentation publiée correspond e
 
 L'organisation `fraza-pro` est aussi réservée sur npmjs, vide : personne d'autre ne peut y publier un paquet du même nom qu'un module Pro. Un projet dont le `.npmrc` perdrait sa ligne `@fraza-pro` ne pourrait donc pas installer un faux module depuis npmjs.
 
-### Amorcer npmjs
+### Porter une version existante sur npmjs
 
-Les versions publiées avant la mise en place de npmjs ne sont que sur `registry.fraza.ca`. Pour copier la version actuelle d'un paquet gratuit sur npmjs, sans monter de version, lancer dans son dépôt, à jour sur l'étiquette de cette version :
+Pour envoyer sur npmjs la version actuelle d'un paquet gratuit, déjà publiée sur `registry.fraza.ca`, sans monter de version, lancer dans son dépôt, à jour sur l'étiquette de cette version :
 
 ```bash
-npm run release:publish
+npm run release:publish -g
 ```
 
-La commande voit que la version manque sur npmjs, télécharge le tarball de `registry.fraza.ca` et l'envoie tel quel à npmjs. `--dry-run` après `--` dit ce qui partirait, sans rien publier.
+La commande voit que la version manque sur npmjs, télécharge le tarball de `registry.fraza.ca` et l'envoie tel quel à npmjs. `--dry-run` dit ce qui partirait, sans rien publier. C'est aussi ainsi qu'on porte sur npmjs une version publiée avant la mise en place de npmjs.
+
+### Ordre entre paquets
+
+Avec `-g`, un paquet qui dépend d'autres paquets Fraza est construit et testé contre leur dernière version **sur npmjs**, celle qu'un site recevra avec lui. Si un module utilise un changement du core publié seulement sur `registry.fraza.ca`, son build ou ses tests échouent avant toute écriture, et la commande rappelle de porter d'abord le core sur npmjs. Porter donc les paquets dans l'ordre de leurs dépendances : `@fraza/icons`, puis le core, puis les modules et `@fraza/start`.
 
 ## Modules externes
 

package/dist/docs/05-contribution/06-registre-verdaccio.md

@@ -8,7 +8,7 @@ related:
     - 03-reference/05-cli/fraza-key
 ---
 
-Commandes de gestion du registre Verdaccio de Fraza, à `https://registry.fraza.ca/`. Il sert deux scopes. Les paquets de Fraza Libre sont publiés sous `@fraza/*` et se lisent sans compte : les sites les installent depuis npmjs, et ce registre en garde une copie complète, en secours. Les modules de Fraza Pro sont publiés sous `@fraza-pro/*`, ici seulement, et leur lecture demande un compte. La publication demande un compte sur les deux scopes.
+Commandes de gestion du registre Verdaccio de Fraza, à `https://registry.fraza.ca/`. Il sert deux scopes. Les paquets de Fraza Libre sont publiés sous `@fraza/*` et se lisent sans compte : les sites les installent depuis npmjs, et ce registre en garde une copie complète, en secours. Il reçoit aussi les versions de test, que `npm run release` sans `-g` n'envoie pas sur npmjs. Les modules de Fraza Pro sont publiés sous `@fraza-pro/*`, ici seulement, et leur lecture demande un compte. La publication demande un compte sur les deux scopes.
 
 Pour publier un package, voir [Publication](./05-publication.md). Pour synchroniser le token dans un projet, voir [fraza-key](../03-reference/05-cli/fraza-key.md).
 

package/dist/docs/05-contribution/index.md

@@ -16,7 +16,7 @@ Ces pages s'adressent à qui modifie `@fraza/core` lui-même, un package `@fraza
 | [Langue](./02-langue.md) | Ce qui s'écrit en anglais, ce qui s'écrit en français. |
 | [Rédaction](./03-redaction.md) | Voix de l'interface, voix de la documentation, formules à éviter. |
 | [Commits](./04-commits.md) | Format Conventional Commits, types, breaking changes. |
-| [Publication](./05-publication.md) | Checklist, versionnage semver, publication sur npmjs et le registre Fraza. |
+| [Publication](./05-publication.md) | Checklist, versionnage semver, publication sur le registre Fraza, et sur npmjs avec `-g`. |
 | [Notes de version](./07-changelog.md) | Génération de `CHANGELOG.md` et `changelog.json`, pieds de commit, ce que `fraza-update` en tire. |
 | [Tests](./08-tests.md) | `node:test`, tests unitaires, tests d'intégration PostgreSQL sur un schéma jetable. |
 | [Registre Verdaccio](./06-registre-verdaccio.md) | Administration du registre : utilisateurs, packages, tags, droits. |

package/dist/shared/lib/version.js

@@ -1,4 +1,4 @@
-const CORE_VERSION = "0.3.4";
+const CORE_VERSION = "0.3.6";
 export {
   CORE_VERSION
 };

package/dist/tools/cli.js

@@ -8,7 +8,7 @@ import { generateNotices } from "./notices.server.js";
 import { findPackageRoot, ToolError } from "./package.server.js";
 import { publishPackage } from "./publish.server.js";
 import { releaseCheck } from "./release-check.server.js";
-import { parseReleaseArgs, releasePackage } from "./release.server.js";
+import { NPMJS_FLAGS, parseReleaseArgs, releasePackage } from "./release.server.js";
 import { syncVersion } from "./sync-version.server.js";
 import { describeSchemaAge, parseTestCleanArgs, testClean } from "./test-clean.server.js";
 function printHelp() {
@@ -30,10 +30,12 @@ Commandes:
   release [niveau]        V\xE9rifie, monte la version, commite, publie, puis \xE9tiquette et pousse
                             patch (d\xE9faut), minor, major ou un num\xE9ro X.Y.Z
                             --dry-run  v\xE9rifie et calcule la version sans rien \xE9crire ni publier
+                            -g         publie aussi sur npmjs, pour un paquet @fraza
   release-check           V\xE9rifie que le paquet peut \xEAtre publi\xE9 tel quel, sans rien modifier
   publish                 Publie la version actuelle sur chaque registre o\xF9 elle manque,
-                            npmjs puis registry.fraza.ca pour @fraza, registry.fraza.ca pour @fraza-pro
+                            registry.fraza.ca pour @fraza et @fraza-pro
                             --dry-run  dit o\xF9 la version partirait, sans rien publier
+                            -g         ajoute npmjs, en premier, pour un paquet @fraza
   test-clean [options]    Supprime les sch\xE9mas de test rest\xE9s sur FRAZA_TEST_DATABASE_URL
                             --older-than <heures>  seulement ceux plus vieux que ce nombre d'heures
                             --prefix <pr\xE9fixe>     fraza_test par d\xE9faut, pr\xE9fixes plus longs compris
@@ -45,6 +47,11 @@ Codes de sortie:
   1   \xE9chec, d\xE9taill\xE9 sur la sortie d'erreur
 `);
 }
+function takeNpmGlobal() {
+  const global = process.env.npm_config_global === "true";
+  delete process.env.npm_config_global;
+  return global;
+}
 const COMMANDS = {
   build({ root }) {
     buildPackage({ root });
@@ -84,15 +91,17 @@ const COMMANDS = {
   async release({ root, args }) {
     const options = parseReleaseArgs(args);
     if (process.env.npm_config_dry_run === "true") options.dryRun = true;
+    if (takeNpmGlobal()) options.npmjs = true;
     const result = await releasePackage({ root, ...options });
     console.log(result.dryRun ? `\u2713 Simulation termin\xE9e : ${result.previous} \u2192 ${result.version}, rien n'a \xE9t\xE9 \xE9crit ni publi\xE9.` : `\u2713 ${result.version} publi\xE9e, \xE9tiquet\xE9e v${result.version} et pouss\xE9e.`);
     return 0;
   },
   async publish({ root, args }) {
     const dryRun = args.includes("--dry-run") || process.env.npm_config_dry_run === "true";
-    const unknown = args.filter((arg) => arg !== "--dry-run");
-    if (unknown.length > 0) throw new ToolError(`publish : argument inconnu \xAB ${unknown[0]} \xBB. Usage : fraza-module publish [--dry-run]`);
-    const result = await publishPackage({ root, dryRun });
+    const npmjs = takeNpmGlobal() || args.some((arg) => NPMJS_FLAGS.includes(arg));
+    const unknown = args.filter((arg) => arg !== "--dry-run" && !NPMJS_FLAGS.includes(arg));
+    if (unknown.length > 0) throw new ToolError(`publish : argument inconnu \xAB ${unknown[0]} \xBB. Usage : fraza-module publish [--dry-run] [-g]`);
+    const result = await publishPackage({ root, dryRun, npmjs });
     if (!dryRun && result.published.length > 0) console.log(`\u2713 ${result.version} publi\xE9e sur ${result.published.join(", ")}.`);
     return 0;
   },

package/dist/tools/publish.server.js

@@ -13,12 +13,15 @@ function packageScope(name) {
   var _a;
   return ((_a = /^(@[^/]+)\//.exec(name ?? "")) == null ? void 0 : _a[1]) ?? null;
 }
-function publishTargets(name) {
+function publishTargets(name, { npmjs = false } = {}) {
   const scope = packageScope(name);
-  if (scope === "@fraza") return [NPMJS, FRAZA];
+  if (scope === "@fraza") return npmjs ? [NPMJS, FRAZA] : [FRAZA];
   if (scope === "@fraza-pro") return [FRAZA];
   return [{ label: "registre du paquet", url: null, access: null }];
 }
+function reachesNpmjs(name) {
+  return packageScope(name) === "@fraza";
+}
 function publishConfigProblems(pkg) {
   const scope = packageScope(pkg.name);
   const config = pkg.publishConfig ?? {};
@@ -28,7 +31,7 @@ function publishConfigProblems(pkg) {
       problems.push(`package.json#publishConfig.access doit valoir \xAB public \xBB : npmjs refuse un paquet ${scope} en \xAB ${config.access ?? "restricted"} \xBB sans abonnement payant.`);
     }
     if (config.registry) {
-      problems.push(`package.json#publishConfig.registry (${config.registry}) doit \xEAtre retir\xE9 : la publication choisit elle-m\xEAme les registres de ${scope}, npmjs puis ${REGISTRY_HOST}.`);
+      problems.push(`package.json#publishConfig.registry (${config.registry}) doit \xEAtre retir\xE9 : la publication choisit elle-m\xEAme les registres de ${scope}, ${REGISTRY_HOST}, et npmjs avec -g.`);
     }
   } else if (scope === "@fraza-pro") {
     if (config.registry !== FRAZA_REGISTRY) {
@@ -37,9 +40,10 @@ function publishConfigProblems(pkg) {
   }
   return problems;
 }
-function publishCommand(pkg) {
+function publishCommand(pkg, { npmjs = false } = {}) {
   var _a;
-  return ((_a = pkg.scripts) == null ? void 0 : _a["release:publish"]) ? "npm run release:publish" : "npx fraza-module publish";
+  const command = ((_a = pkg.scripts) == null ? void 0 : _a["release:publish"]) ? "npm run release:publish" : "npx fraza-module publish";
+  return npmjs && reachesNpmjs(pkg.name) ? `${command} -g` : command;
 }
 function registryFlags(scope, target) {
   const flags = [];
@@ -71,6 +75,7 @@ function packedTarball(dir) {
 async function publishPackage({
   root,
   dryRun = false,
+  npmjs = false,
   log = console.log,
   npm = (args) => run("npm", args, { cwd: root }),
   query = npmCapture
@@ -79,7 +84,7 @@ async function publishPackage({
   const pkg = readPackage(root);
   const { name, version } = pkg;
   const scope = packageScope(name);
-  const targets = publishTargets(name);
+  const targets = publishTargets(name, { npmjs });
   const configProblems = publishConfigProblems(pkg);
   if (configProblems.length > 0) {
     throw new ToolError(`publication refus\xE9e :
@@ -135,7 +140,7 @@ async function publishPackage({
           `npm publish vers ${target.label} a \xE9chou\xE9.
   - ${name} ${version} est sur : ${has.length ? has.join(", ") : "aucun registre"} ;
   - il manque sur : ${lacks.join(", ")}.
-Une fois la cause corrig\xE9e (connexion, code 2FA, droits), \xAB ${publishCommand(pkg)} \xBB publie seulement l\xE0 o\xF9 il manque, avec le m\xEAme tarball.`
+Une fois la cause corrig\xE9e (connexion, code 2FA, droits), \xAB ${publishCommand(pkg, { npmjs })} \xBB publie seulement l\xE0 o\xF9 il manque, avec le m\xEAme tarball.`
         );
       }
       published.push(target.label);
@@ -152,5 +157,6 @@ export {
   publishCommand,
   publishConfigProblems,
   publishPackage,
-  publishTargets
+  publishTargets,
+  reachesNpmjs
 };

package/dist/tools/release.server.js

@@ -5,7 +5,7 @@ import { compare, parse } from "../shared/lib/semver.js";
 import { generateChangelog } from "./changelog.server.js";
 import { checkContract } from "./contract.server.js";
 import { packageProfile, ToolError } from "./package.server.js";
-import { publishCommand, publishConfigProblems, publishPackage, publishTargets } from "./publish.server.js";
+import { FRAZA_REGISTRY, NPMJS_REGISTRY, publishCommand, publishConfigProblems, publishPackage, publishTargets, reachesNpmjs } from "./publish.server.js";
 import { run } from "./run.server.js";
 import { syncVersion } from "./sync-version.server.js";
 const RELEASE_LEVELS = ["patch", "minor", "major"];
@@ -56,22 +56,25 @@ function checkExactVersion(previous, next) {
   }
   return next;
 }
+const NPMJS_FLAGS = ["-g", "--global"];
 function parseReleaseArgs(args) {
   let level = null;
   let version = null;
   let dryRun = false;
+  let npmjs = false;
   for (const arg of args) {
     if (arg === "--dry-run") dryRun = true;
+    else if (NPMJS_FLAGS.includes(arg)) npmjs = true;
     else if (RELEASE_LEVELS.includes(arg) || /^\d+\.\d+\.\d+/.test(arg)) {
       const chosen = level ?? version;
       if (chosen && chosen !== arg) throw new ToolError(`release : un seul niveau ou num\xE9ro \xE0 la fois (${chosen} ou ${arg}).`);
       if (RELEASE_LEVELS.includes(arg)) level = arg;
       else version = arg;
     } else {
-      throw new ToolError(`release : argument inconnu \xAB ${arg} \xBB. Usage : fraza-module release [patch|minor|major|X.Y.Z] [--dry-run]`);
+      throw new ToolError(`release : argument inconnu \xAB ${arg} \xBB. Usage : fraza-module release [patch|minor|major|X.Y.Z] [--dry-run] [-g]`);
     }
   }
-  return { level: level ?? (version ? null : "patch"), version, dryRun };
+  return { level: level ?? (version ? null : "patch"), version, dryRun, npmjs };
 }
 function gitQuery(root, args) {
   try {
@@ -110,7 +113,7 @@ function remoteProblems({ root, branch, next }) {
   }
   return problems;
 }
-function unfinishedRelease({ root, version, pkg }) {
+function unfinishedRelease({ root, version, pkg, npmjs }) {
   var _a, _b, _c;
   const subject = (_a = gitQuery(root, ["log", "-1", "--format=%s"])) == null ? void 0 : _a.trim();
   if (subject !== `chore: bump version to ${version}`) return null;
@@ -122,7 +125,7 @@ function unfinishedRelease({ root, version, pkg }) {
     Si la branche distante a avanc\xE9, lancer d'abord \xAB git pull --no-rebase \xBB, jamais un rebase : l'\xE9tiquette publi\xE9e d\xE9signe le commit de version.`;
   }
   return `Le commit \xAB ${subject} \xBB est fait en local, sans \xE9tiquette ${tag} ni envoi : une publication pr\xE9c\xE9dente s'est arr\xEAt\xE9e apr\xE8s lui. Relancer \xAB npm run release \xBB monterait la version une deuxi\xE8me fois, sur une version jamais publi\xE9e. Pour reprendre :
-      ${publishCommand(pkg)}
+      ${publishCommand(pkg, { npmjs })}
       git tag -a ${tag} -m ${tag}
       ${PUSH_COMMAND}
     La premi\xE8re commande publie seulement sur les registres o\xF9 ${version} manque. Pour annuler la mont\xE9e de version, si ${version} n'est publi\xE9e nulle part :
@@ -154,7 +157,11 @@ function frazaDependencies(pkg) {
   }
   return [...names].sort();
 }
-async function preflight({ root, profile, previous, next, npm, log, contract = checkContract }) {
+function npmjsHint(pkg, npmjs) {
+  if (!npmjs || !reachesNpmjs(pkg.name) || frazaDependencies(pkg).length === 0) return "";
+  return "\n    Avec -g, le paquet est v\xE9rifi\xE9 contre les paquets Fraza publi\xE9s sur npmjs. Si l'un d'eux n'a sa derni\xE8re version que sur registry.fraza.ca, la porter d'abord sur npmjs : \xAB npm run release:publish -g \xBB dans son d\xE9p\xF4t.";
+}
+async function preflight({ root, profile, previous, next, npmjs, npm, log, contract = checkContract }) {
   var _a, _b, _c, _d, _e;
   const { pkg, kind } = profile;
   const problems = [];
@@ -170,7 +177,7 @@ async function preflight({ root, profile, previous, next, npm, log, contract = c
       problems.push(`La branche ${branch} ne suit aucune branche distante : \xAB ${PUSH_COMMAND} \xBB \xE9chouerait apr\xE8s la publication. Lancer d'abord \xAB git push -u origin ${branch} \xBB.`);
     } else {
       problems.push(...remoteProblems({ root, branch, next }));
-      const unfinished = unfinishedRelease({ root, version: previous, pkg });
+      const unfinished = unfinishedRelease({ root, version: previous, pkg, npmjs });
       if (unfinished) problems.push(unfinished);
     }
   }
@@ -188,21 +195,24 @@ async function preflight({ root, profile, previous, next, npm, log, contract = c
   const deps = frazaDependencies(pkg);
   if (deps.length > 0) {
     const specs = deps.map((name) => `${name}@latest`);
-    log(`\u25C6 npm install --no-save ${specs.join(" ")}`);
-    if (npm(["install", "--no-save", ...specs]) !== 0) {
+    const fromNpmjs = npmjs && reachesNpmjs(pkg.name);
+    const flags = [`--@fraza:registry=${fromNpmjs ? NPMJS_REGISTRY : FRAZA_REGISTRY}`];
+    log(`\u25C6 npm install --no-save ${specs.join(" ")}, depuis ${fromNpmjs ? "npmjs" : "registry.fraza.ca"}`);
+    if (npm(["install", "--no-save", ...specs, ...flags]) !== 0) {
       throw new ToolError(formatProblems([`npm install des derni\xE8res versions Fraza a \xE9chou\xE9 (${specs.join(", ")}).`]));
     }
   }
   log("\u25C6 npm run build");
-  if (npm(["run", "build"]) !== 0) throw new ToolError(formatProblems(["npm run build a \xE9chou\xE9."]));
+  if (npm(["run", "build"]) !== 0) throw new ToolError(formatProblems([`npm run build a \xE9chou\xE9.${npmjsHint(pkg, npmjs)}`]));
   if (kind === "module") {
     log("\u25C6 fraza-module check");
     const { errors } = await contract({ root });
-    if (errors.length > 0) throw new ToolError(formatProblems(errors));
+    const hint = npmjsHint(pkg, npmjs).trim();
+    if (errors.length > 0) throw new ToolError(formatProblems(hint ? [...errors, hint] : errors));
   }
   if ((_e = pkg.scripts) == null ? void 0 : _e.test) {
     log("\u25C6 npm test");
-    if (npm(["test"]) !== 0) throw new ToolError(formatProblems(["npm test a \xE9chou\xE9."]));
+    if (npm(["test"]) !== 0) throw new ToolError(formatProblems([`npm test a \xE9chou\xE9.${npmjsHint(pkg, npmjs)}`]));
   }
   const changed = dirtyPaths(root).filter((path) => !FROM_INSTALLED_TREE.includes(path));
   if (changed.length > 0) {
@@ -278,6 +288,7 @@ async function releasePackage({
   level = "patch",
   version = null,
   dryRun = false,
+  npmjs = false,
   log = console.log,
   npm = (args) => run("npm", args, { cwd: root }),
   contract = checkContract,
@@ -296,8 +307,10 @@ async function releasePackage({
     level = level ?? "patch";
   }
   const tag = `v${next}`;
+  const targets = publishTargets(profile.name, { npmjs }).map((t) => t.label).join(", puis ");
   log(`${profile.name} : ${previous} \u2192 ${next} (${level})${dryRun ? ", simulation" : ""}`);
-  await preflight({ root, profile, previous, next, npm, log, contract });
+  log(`Registres : ${targets}${npmjs && !reachesNpmjs(profile.name) ? " (-g ignor\xE9 : seul un paquet @fraza/* va sur npmjs)" : ""}`);
+  await preflight({ root, profile, previous, next, npmjs, npm, log, contract });
   if (dryRun) {
     const lock = existsSync(join(root, "package-lock.json")) ? ", package-lock.json" : "";
     log("");
@@ -307,15 +320,15 @@ async function releasePackage({
     log("  3. changelog : CHANGELOG.md, changelog.json, package.json#fraza");
     log("  4. npm run build");
     log(`  5. git commit \xAB chore: bump version to ${next} \xBB`);
-    log(`  6. publication : ${publishTargets(profile.name).map((t) => t.label).join(", puis ")}`);
+    log(`  6. publication : ${targets}`);
     log(`  7. git tag -a ${tag} -m ${tag}`);
     log(`  8. ${PUSH_COMMAND}`);
     return { previous, version: next, dryRun: true };
   }
   const files = bumpAndCommit({ root, profile, next, npm, log });
-  log(`\u25C6 publication : ${publishTargets(profile.name).map((t) => t.label).join(", puis ")}`);
+  log(`\u25C6 publication : ${targets}`);
   try {
-    await publish({ root, log });
+    await publish({ root, log, npmjs });
   } catch (error) {
     const reason = error instanceof ToolError ? error.message : String((error == null ? void 0 : error.stack) ?? error);
     throw new ToolError(
@@ -326,7 +339,7 @@ O\xF9 en est la publication :
   - aucune \xE9tiquette n'est pos\xE9e, rien n'est pouss\xE9.
 
 Ne pas relancer \xAB npm run release \xBB : il monterait la version une deuxi\xE8me fois. Pour reprendre, une fois la cause corrig\xE9e, publier l\xE0 o\xF9 la version manque, puis poser l'\xE9tiquette :
-  ${publishCommand(profile.pkg)}
+  ${publishCommand(profile.pkg, { npmjs })}
   git tag -a ${tag} -m ${tag}
   ${PUSH_COMMAND}
 
@@ -363,6 +376,7 @@ O\xF9 en est la publication :
   return { previous, version: next, dryRun: false };
 }
 export {
+  NPMJS_FLAGS,
   RELEASE_LEVELS,
   bumpVersion,
   checkExactVersion,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fraza/core",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Starter kit Next.js avec un back-office modulaire, conçu au Québec.",
   "publishConfig": {
     "access": "public"