Toolkit for YNABの保守モードと拡張機能のビルド

メンテナンスモードとメンテナー募集の現状

README はメンテナンスモードの告知から始まる。告知によると、更新頻度は大幅に減り、新機能ではなくバグ修正のみになる可能性が高い。プロジェクトは更新の承認とリリースの責務を担う新しいメンテナーを積極的に探しており、関心のある人はプロジェクトの Discord にいる Josh Madewell に連絡するよう案内されている。リポジトリのメタデータによると、このプロジェクトには 1511 のスター、362 のフォーク、307 のオープンイシューがあり、デフォルトブランチは develop、言語は TypeScript である。ただし README は、メンテナンスモードがイシュートラッカーやロードマップにどう影響するかを説明しておらず、メンテナンスモードの開始日も明記していない。

YNAB ウェブアプリのためのブラウザ拡張機能

Toolkit for YNAB は、YNAB ウェブアプリケーションの体験を向上させるブラウザ拡張機能である。動機のセクションでは、YNAB が新しいウェブバージョンをリリースした際、旧バージョンのパワーユーザーがブラウザ拡張機能で簡単に実装できるオプションを求めたと説明されている。YNAB チームにこれらの機能の実装を依頼するのではなく、自分たちでやってしまおうというのがプロジェクトの選択だった。完全な機能リストは docs/feature-list.md にあり、拡張機能をインストールした後のオプションページにも機能が一覧表示され、各機能をオンまたはオフに設定できる。README 自体には機能の列挙はなく、具体的な機能を確認するには機能リストのドキュメントを参照する必要がある。

Chrome、Firefox、Edge 対応、Safari は非対応

この拡張機能はブラウザ（Web）拡張機能 API を使用して構築されており、Chrome、Firefox、Edge で利用できる。ビルド済みバージョンは Chrome ウェブストア、Firefox アドオンリポジトリ、Microsoft Edge アドオンページから入手でき、README は各ストアへの直接リンクを提供している。ソースから自分でビルドしたくない場合は、これらのストアから直接インストールできる。Web Extensions が Safari でサポートされていないため、この拡張機能も Safari ではサポートされない。README によると、Safari が Web Extensions をサポートすることになれば、プロジェクトはそのブラウザのサポートを提供するためにできることを行うとしている。各ストア版の更新頻度やバージョン番号については README に記載がない。

ソースコードからの拡張機能のビルド

ビルドには Node.js（>=18.12.1）と Yarn（>= v1.10.0）が必要である。macOS では両方を brew でセットアップでき、コマンドライン開発者ツール（xcode-select --install）も必要とされる。Windows では Chocolatey パッケージマネージャーでインストールできる。ビルドプロセスでは、ESLint がコードスタイルをチェックし、Babel が ES2015 を ES5 にトランスパイルし、Webpack がすべての Web 拡張機能ページ（背景、ポップアップ、オプション、コンテンツスクリプト）のエントリポイントを単一ファイルにバンドルする。リポジトリをクローンしたら、yarn install を実行し、次に yarn build:development を実行する。開発中は yarn watch がプロジェクトディレクトリを監視して自動的に再ビルドする。yarn watch:webpack はインデックスを再生成せずにコードの変更のみをコンパイルするため、開発が著しく速くなる可能性がある。ビルドした拡張機能を Chrome に読み込むには、README によると chrome://extensions に移動し、デベロッパーモードをオンにして、パッケージ化されていない拡張機能を読み込むをクリックし、dist/extension フォルダを選択する。拡張機能がすでにインストールされている場合は再読み込みが必要かもしれない。Firefox では、yarn で web-ext をグローバルインストールし、yarn run manifest:firefox を実行してから web-ext run --source-dir dist/extension/ を実行すると記載されている。VS Code を使用している場合は、Setup タスクを実行すると手順の一部を省略できる。

コントリビューションと機能フレームワーク

README はコントリビューションを歓迎しており、作業が重複しないように事前に連絡するよう求めている。ロードマップで誰が何に取り組んでいるかを確認でき、作りたい機能が見つからない場合は GitHub イシューボードにメモを投稿してチームに知らせることができる。コードの準備ができたらプルリクエストを提出する。機能コードは src/extension/features ディレクトリにあり、サブディレクトリが YNAB アプリケーションの各セクションに対応している。機能開発者は、機能が実行されるべきアプリケーションのセクションを表すフォルダを選択して開発を始める。新しいフレームワークは、古いフレームワークがすべての機能に大量のボイラープレートコードを必要としたために構築されたもので、新しいものは ES6 機能をより多用し、新規コントリビューションからボイラープレートの負担を取り除く。関連ドキュメントは docs/building-features.md にある。コントリビューターはエディタが Unix スタイルの行送り（LF）を使用するように設定しなければならず、そうしないとビルドが失敗する。README はこれが主に Windows ユーザーに影響すると述べている。

ライセンスと法的注意事項

この拡張機能は MIT ライセンスで配布されており、著作権は 2016 年に Kevin Brown に帰属する。ライセンスは、ソフトウェアのコピーを使用、複製、変更、統合、公開、配布、サブライセンス、および販売する権利を許可し、すべてのコピーまたは重要な部分に上記の著作権表示と許可表示を含めることを要求する。README には、この拡張機能はいかなる形でも YNAB と提携しておらず、YNAB はこれを承認していないという重要な注意事項が含まれている。You Need a Budget と YNAB は Steine LLC またはその子会社の登録商標である。ライセンステキストには、ソフトウェアが「現状のまま」提供され、いかなる種類の保証もないという標準的な免責事項が含まれており、商品性、特定目的への適合性、非侵害性の保証を含まない。README はそれを超えるサポート保証やセキュリティ態勢について説明していない。

編集部の結論

Toolkit for YNAB は MIT ライセンスで配布されており、YNAB とは提携していない。README はメンテナンス告知の Discord リンク以外のサポートチャネルを説明しておらず、メンテナンスモードがイシュートラッカーにどう影響するかも述べていない。

公式情報源

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