Canaux de publication
Dist-tags stable, canary et LTS, versions synchronisées, provenance et publication d’une version.
Text.js est distribué via trois dist-tags npm. Tous les paquets (@textjs/app, @textjs/react, @textjs/core, @textjs/font, @textjs/opencode, create-text-app et eslint-plugin-textjs) partagent la même version, de sorte qu’un seul numéro de version décrit l’ensemble du framework.
Canaux
| Canal | dist-tag | Version | Installation |
|---|---|---|---|
| Stable | latest | 1.0.x | bun add @textjs/app |
| Canary | canary | 1.0.x-canary.N | bun add @textjs/app@canary |
| LTS | lts, v1-lts | Publiée à la sortie de 2.0.0 | bun add @textjs/app@lts |
Utilisez le canal stable en production. Utilisez le canal canary pour essayer les correctifs et les fonctionnalités dès leur arrivée sur dev. Dès qu’une branche LTS existe, utilisez-la si vous effectuez une mise à niveau par an.
bun create text-app@canary my-consoleStable
Les versions stables suivent le versionnage sémantique : les versions correctives corrigent des bugs, les versions mineures ajoutent des fonctionnalités rétrocompatibles et les versions majeures peuvent introduire des ruptures d’API après une période de dépréciation. Une version stable provient d’une version canary ayant passé l’intégralité de la suite de tests et est publiée avec une attestation de provenance npm.
Canary
Chaque push vers dev dans le dépôt officiel fait l’objet d’une vérification des types et de tests, puis est publié sous le numéro de la prochaine version corrective avec le suffixe -canary.N :
latest | Push vers dev | Version publiée |
|---|---|---|
1.0.0 | premier | 1.0.1-canary.0 |
1.0.0 | deuxième | 1.0.1-canary.1 |
1.0.1 | suivant | 1.0.2-canary.0 |
N reprend à partir du numéro canary le plus élevé déjà présent sur npm, de sorte que les numéros ne se répètent jamais. Les versions canary ne sont pas enregistrées dans les commits du dépôt. Ajoutez [skip canary] à un message de commit pour éviter une publication.
Les versions canary sont des builds de dev, la branche dans laquelle toutes les pull requests sont fusionnées. Elles peuvent modifier ou supprimer sans préavis des API non encore publiées en version stable. Fixez une version canary exacte si vous en dépendez.
Provenance
Les versions sont publiées depuis GitHub Actions avec npm publish --provenance, ce qui relie chaque archive au commit et au workflow exacts qui l’ont produite. Vérifiez un paquet avec :
npm audit signaturesPublier une version
Les responsables de maintenance incrémentent la version de tous les paquets du workspace de manière synchronisée avec les scripts de publication :
bun run release:version minor # 1.0.0 → 1.1.0 (also: patch, major, canary, stable, x.y.z)bun run release:publish --tag latest --provenancerelease:version réécrit chaque package.json et les constantes de version qui le reflètent (VERSION, rendererVersion du réconciliateur), refuse de s’exécuter lorsque les versions des paquets divergent, et --dry-run affiche le plan. release:publish compile, crée les archives (en résolvant workspace:*), applique publishConfig, refuse de publier une préversion sur latest ou une version stable sur canary, et ignore les versions qui existent déjà sur npm.
Consultez la politique de support pour connaître la durée de maintenance de chaque branche de versions.