リリースチャンネル

Text.jsは3つのnpm dist-tagで配布されます。すべてのパッケージ（@textjs/app、@textjs/react、@textjs/core、@textjs/font、@textjs/opencode、create-text-app、eslint-plugin-textjs）のバージョンは同期して更新されるため、1つのバージョン番号がフレームワーク全体を表します。

#チャネル

本番環境では安定版を使用してください。修正や機能が dev に入った当日に試すには、Canary版を使用してください。LTS系列が提供されたら、年に1回アップグレードする場合はLTS版を使用してください。

bun create text-app@canary my-console

#安定版

安定版リリースはセマンティックバージョニングに従います。パッチではバグを修正し、マイナーでは後方互換性のある機能を追加し、メジャーでは非推奨期間を経てAPIに破壊的変更を加える場合があります。安定版リリースは、テストスイート全体に合格したCanary版から昇格され、npmの来歴情報付きで公開されます。

#Canary版

公式リポジトリの dev へのプッシュごとに、型チェックとテストを実施し、接尾辞 -canary.N を付けた次のパッチバージョンとして公開します。

N はnpm上にあるCanary版の最大値から続くため、番号が重複することはありません。Canary版のバージョンはリポジトリにコミットされません。リリースをスキップするには、コミットメッセージに [skip canary] を追加してください。

Canary版は、すべてのプルリクエストのマージ先である dev ブランチのビルドです。未リリースのAPIは予告なく変更または削除される場合があります。Canary版に依存する場合は、正確なバージョンを固定してください。

#来歴情報

リリースはGitHub Actionsから npm publish --provenance で公開され、各tarballが、そのビルドに使用された正確なコミットとワークフローに紐付けられます。パッケージを検証するには、次のコマンドを使用します。

npm audit signatures

#リリースの作成

メンテナーはリリーススクリプトを使い、すべてのワークスペースパッケージのバージョンを同期して更新します。

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 --provenance

release:version は各 package.json とそのバージョンを反映する定数（VERSION、リコンサイラーの rendererVersion）を書き換え、パッケージ間でバージョンが一致しない場合は実行を拒否し、--dry-run を指定すると実行計画を表示します。release:publish はビルド、パック（workspace:* の解決を含む）、publishConfig の適用を実施し、プレリリースの latest への公開や安定版の canary への公開を拒否し、npmにすでに存在するバージョンをスキップします。

各リリース系列のメンテナンス期間については、サポートポリシーを参照してください。