Skip to content

RmlUi ソース構成 ​

packages/sfml.js-rmlui はネイティブバインディング、TypeScript インターフェース、テストを責務別に配置しています。新しい実装は担当モジュールに置き、関連するヘッダーと実装ファイルをまとめます。

ディレクトリ責務
runtime/初期化、Context、実行時状態、機能照会、コールバック寿命、Plugin、Debugger
dom/documents/ドキュメント、Factory、属性集合、XML 解析
dom/elements/Element、レイアウト、スクロール、要素のインスタンス化、SVG、Lottie
dom/controls/フォーム、テキストコントロール、選択肢、パネル
data/データモデル、型登録、アドレス、メンバー、バッチ処理、診断
events/イベント、リスナー、ディスパッチ、インスタンス化
style/properties/Property、パーサー、仕様、スタイルシート
style/effects/デコレーター、フィルター、エフェクト値とコールバック
style/values/計算済みスタイル、スタイル構造体、変換、マップされたビュー
animation/アニメーション、トランジション、Tween、値コールバック
rendering/描画管理、ジオメトリ、テクスチャ、レイヤー、リソース、SFML 描画アダプター
fonts/フォント読み込み、FreeType/HarfBuzz/ビットマップエンジン、計測、グリフ、フォントエフェクト
scripting/スクリプトインターフェース、ホスト、スクリプトオブジェクト
scripting/lua/Lua ホスト、モデル、値、関数、インスタンス化
platform/SFML システム連携、入力、テキスト入力、ウィンドウ密度
io/ファイルインターフェース、ストリーム
values/Variant、数値、文字列、URL、共有型

これらは native/ と src/ の下にあります。片方の層だけで必要な実装はその層に置きます。src/internal/ はネイティブローダー、ラッパー割り当て、共有メモリ変換など、モジュール間の内部プロトコルを保持します。

src/index.ts が npm の公開入口、native/addon.cc がネイティブモジュールの登録入口です。パッケージのビルド設定はルートの binding.gyp、package.json、tsconfig.json に残します。

生成ファイルは src/generated/ と native/generated/ にあります。生成処理の変更は tools/codegen/ の生成器を編集してから再生成します。

ツールディレクトリ責務
tools/build/パッケージのネイティブビルド、Lua の C++ コンパイル、コンパイルデータベース修正。リポジトリ LSP データベースの統合は所属する Rush ワークスペース内だけで実行
tools/codegen/上流ヘッダーから入力、イベント、プロパティ ID、スタイルバインディングを生成
tools/dependencies/依存バージョン、検証、ダウンロード、ビルドソース一覧
tools/dependencies/patches/RmlUi、Lua、Debugger、数値、文字列、rlottie のパッチ
tools/performance/性能測定、ネイティブ呼び出し回数
tools/testing/実行時テストの再帰収集・実行、クリップボード保護、npm ソースパッケージのファイル一覧とビルド依存の検証

test/ は実行時・型テストをモジュール別に配置します。test/native/ は C++ 対照プログラムとビルドスクリプトをモジュール別に配置します。スクリプトは現在のパッケージのオブジェクトファイルを再利用し、呼び出し元が既存の一時出力ディレクトリを指定します。

packages/sfmljs-rmlui-vscode/tools/testing/ は既存の VS Code で拡張機能の統合検証を実行します。同パッケージの tools/packaging/ は VSIX 内蔵クライアント、言語サーバー、言語リソース、四言語の README を検証します。リポジトリ共通の Windows ツールチェーン初期化は tools/ci/ にあり、既存の Node.js CI と専用 RmlUi CI で共有します。

third_party/ は上流のディレクトリ構成を保持します。build/ と dist/ は既存のビルドディレクトリを再利用します。ソース移動後は、新しいパスの成果物が存在する旧成果物だけを削除します。

ディレクトリ移動は RmlUi 6.3 全体の受け入れ完了を意味しません。audit/6.3/ の既存証拠は採取時のパスとハッシュを保持します。過去のパスは移動対応表で確認してください。

Icons made by Lorc, Delapouite & Skoll game-icons.net · CC BY 3.0