安定性

Vize は v1 アルファ版を目指して開発中です。早期に導入できる機能と、変更が続く内部実装・実験的な統合を区別します。 ツールチェーン全体が本番利用に十分な状態になった、という意味ではありません。 導入判断には本番利用の準備状況を、 非推奨期間やバージョンごとのサポートにはサポート方針を参照してください。

バージョンと互換性

安定版 v1 より前のリリースには破壊的変更が含まれる可能性があります。公開 API、CLI のフラグ、設定項目、診断コード、 生成結果に影響する変更は、リリースノートで説明します。アルファ版の互換性の方針は次のとおりです。

ランタイムサポート

公開 npm パッケージが必要とする Node.js の最低バージョンは、原則として Node 22 です。 oxlint-plugin-vize は ^22 || >= 24 を指定しており、Node 22 と Node 24 以降に対応します。Node 23 は検証対象に含みません。

ネイティブパッケージは macOS・Linux・Windows の x64 / arm64 向けに提供しています。

npm に公開する前に、リリース用 tarball をインストールし、vize --version、vize check、@vizejs/native の require / import、@vizejs/vite-plugin による vite build がすべて通ることを確認します。新規インストールの全体検証は毎週も実行します。

Rust の最低対応バージョン（MSRV）は、Cargo.toml の [workspace.package].rust-version に記載しています。 開発用の rust-toolchain.toml は、同じバージョンか、それより新しいバージョンを指定します。 安定版 v1 より前は MSRV を引き上げる場合があり、その際はリリースノートで案内します。 パッケージを配布する場合は、ツールチェーンの指定から推測せず、クレートの Cargo.toml にある rust-version を確認してください。

パッケージのサポート区分

Rust クレートのサポート区分

この節は crates.io から Vize のクレートを使う Rust 開発者向けです。Vue アプリの開発者は読み飛ばしてかまいません。 以下の表は、crates.io の利用者向けの互換性の方針です。Cargo メタデータで公開が許可されたクレートをすべて含みます。 初回公開の準備などでリリースが延期されているクレートも対象です。非公開のモジュールや実装の詳細には、同じ互換性を保証しません。

各クレートの区分は package.metadata.vize.stability にも記載します。CI は Cargo メタデータ、この表、 リリース対象のクレート一覧を照合し、追加・削除・区分変更によって互換性の方針が暗黙に変わることを防ぎます。

SemVer 検証の意味

cargo-semver-checks は、レジストリに比較対象のリリースがあるクレートに対して実行します。 初回公開を待つクレートは、比較対象を取得できるようになった段階で検証に加わります。 それまでも、メタデータ・サポート表・リリース一覧の照合は行います。

CI が認識する破壊的変更の印は、Conventional Commits のタイトルにある !、または BREAKING CHANGE: のフッターです。 印を付けても、アルファ版対応・互換性プレビューの非推奨期間は省略できません。

アルファ版対応に必要な条件

• インストールと使い方が文書化されている
• パッケージのビルド、インストール、対応 Node.js を CI で検証している
• 公開 API をリリース時に検証している
• 不具合や互換性の報告を担当する人がいる
• 未対応の動作が関連ガイドに明記されている

まだ保証していないこと

すべての Vue 構文、パッケージマネージャーの配置、エディター機能、フレームワークとの互換性を保証するわけではありません。 Vize のガイドが意図した違いを明記していない限り、公式の Vue ツールの結果を互換性の基準として扱ってください。 リリースを止めるコンパイラ・型チェック・ランタイム・Vite ビルドの検証項目は、 Vue 互換性マトリックスにまとめています。

セキュリティ上の問題は SECURITY.md、開発への参加と修正の流れは CONTRIBUTING.md を参照してください。