Aurelia 2 モノレポ: ベータの状態、コンポーネントモデル、makes ジェネレータ

モノレポとベータ警告

このリポジトリは Aurelia 2 のモノレポで、コアパッケージとプラグインパッケージ、サンプル、ベンチマーク、ドキュメントが含まれています。README は Aurelia 2 がまだベータであり、公開 API の一部の機能や利用法は未検証で、今後も破壊的な変更がいくつかあると明記しています。リポジトリのメタデータは、このプロジェクトを TypeScript で書かれた標準ベースのフロントエンドフレームワークと説明しています。README はベンチマークのディレクトリに言及するだけで、結果や比較データは示していません。メタデータの「高性能」という表現も、数値で定義されていません。

フレームワークの目標とコンポーネントの慣習

Aurelia は、ブラウザ、モバイル、デスクトップアプリケーション向けのモダンなフロントエンド JavaScript フレームワークと説明されています。その焦点は、Web プラットフォームの仕様に沿い、設定より規約を使い、フレームワークによる干渉を最小限にすることです。慣習として、Aurelia のコンポーネントは通常の JavaScript または TypeScript のクラスと HTML テンプレートの組み合わせです。README の例では App クラスに welcome と quests プロパティを定義し、テンプレートがそれらをバインドしています。ファイル構成や命名規則、コンポーネント間の通信方法は README には書かれていません。

README のサンプルにあるバインディング構文

サンプルテンプレートはフォームを示しており、入力欄は value.bind と debounce:500 修飾子を使い、セレクトは repeat.for で quests 配列を繰り返し、段落は if.bind で表示を制御します。テキストには ${} による補間でバインド値が挿入されます。README はこれらをバインディング構文の例として示すだけで、双方向バインディングの動作、debounce のタイミング、repeat.for がコレクションの更新を扱う方法、if.bind と hidden 属性の違いは説明していません。詳細はドキュメントサイトに任せています。

makes ジェネレータでプロジェクトを作成

新しいプロジェクトを作るには、README は Node.js v8.9.0 以上をインストールした後、コマンドプロンプトで npx makes aurelia を実行するよう指示しています。npx は makes スキャフォールディングツールと aurelia ジェネレータをダウンロードし、セットアップを案内します。README には他のコマンド名、フラグ、非対話モードの説明はなく、オフラインインストールやジェネレータのバージョン固定についても触れていません。別の方法として examples フォルダを挙げており、そこには規約を使わない純粋な JIT セットアップがさまざまなローダーやバンドラー向けに含まれるとしています。Node.js のバージョン要件が現在も有効かどうかは記述されていません。

ドキュメント、コミュニティ、コントリビューション

README は docs.aurelia.io にある Aurelia 2 ドキュメントへのリンクを張り、ドキュメントは作業中であり、入門セクションが最も整っていると述べています。また、コントリビューター向けドキュメント、公式ブログ、メールリスト、Twitter アカウント、Discourse フォーラム、Aurelia 2 の Discord サーバー、スポンサー向け Open Collective ページを紹介しています。コントリビューター向けドキュメントは、コードのビルドとテストの実行、ソーシャルチャネルへの参加、PR の提出、ドキュメントへの貢献を扱うとされています。Discourse と Discord の役割分担は説明されておらず、リリース日やバージョンのマイルストーンも書かれていません。

MIT ライセンスとその範囲

このリポジトリは MIT ライセンスです。ライセンスの抜粋では、Blue Spire Inc. が著作権者であり、著作権表示と許可表示をすべてのコピーまたは実質的な部分に含めることを条件に、ソフトウェアのコピーの使用、複製、変更、結合、公開、配布、サブライセンス、販売を許可しています。ソフトウェアは「現状のまま」提供され、いかなる保証もありません。MIT ライセンスは二次的著作物のオープンソース化を要求しませんが、README はその違いに触れていません。また、セキュリティサポート、保守の約束、本番環境での利用可否についても何も述べていません。

README が明らかにしていないこと

README には変更履歴、API リファレンス、ベンチマーク結果、ブラウザサポートのマトリックスは含まれていません。ドキュメントは作業中であると述べ、入門ガイドとドキュメントサイトを参照するよう促しています。また、ベータを終了するためのリリーススケジュールも書かれていません。Aurelia 2 を既存プロジェクトで使うかどうかを検討する場合、リポジトリ内の examples と benchmarks を確認するか、メンテナーからの更新を待つ必要があります。README 自体はこれらの詳細を確立していないため、これらは検証すべき質問として扱うべきです。実施記録には対象版と入力条件を残し、成功した結果だけでなく失敗した場合の出力も保存します。設定を変更した前後で同じ確認を繰り返せるようにし、READMEに書かれた機能と自分の環境で確認できた事実を分けます。採用判断では、導入できたかだけでなく、更新、障害、切り戻し、権限、ライセンスを同じ担当者が追跡できるかを確かめます。

編集部の結論

Aurelia 2 はまだベータ版であり、README の主な役割はドキュメントやサンプル、コミュニティへの入口を示すことであって、安定性を約束することではありません。

公式情報源

1. Official README
2. Project repository
3. Release notes