118 lines
3.6 KiB
Markdown
118 lines
3.6 KiB
Markdown
# モジュラービルトインBoxシステム
|
||
Status: Pending
|
||
Created: 2025-08-26
|
||
Priority: Medium
|
||
Related: ビルトインBox管理の柔軟性向上
|
||
|
||
## 現状の問題
|
||
- ビルトインBoxは本体にハードコードされており、不要な機能も常に含まれる
|
||
- プラグインBoxはWASMでは動作しない（.so/.dll依存）
|
||
- 特殊用途のBox（MidnightBox等）が常にビルドに含まれる
|
||
|
||
## 提案：3層アーキテクチャ
|
||
|
||
```
|
||
┌─────────────────────────────────────┐
|
||
│ Core Builtin Boxes │ ← 絶対必要（String, Integer等）
|
||
├─────────────────────────────────────┤
|
||
│ Optional Builtin Modules │ ← 条件付きコンパイル（MidnightBox等）
|
||
├─────────────────────────────────────┤
|
||
│ Plugin Boxes (BID) │ ← 外部プラグイン（FileBox等）
|
||
└─────────────────────────────────────┘
|
||
```
|
||
|
||
## 実装案
|
||
|
||
### 1. BuiltinModuleトレイト
|
||
```rust
|
||
pub trait BuiltinModule: Send + Sync {
|
||
fn name(&self) -> &'static str;
|
||
fn create_box(&self, args: Vec<Box<dyn NyashBox>>) -> Option<Box<dyn NyashBox>>;
|
||
fn required_features(&self) -> Vec<&'static str> { vec![] }
|
||
}
|
||
|
||
pub struct BuiltinModuleRegistry {
|
||
modules: HashMap<String, Box<dyn BuiltinModule>>,
|
||
enabled: HashSet<String>,
|
||
}
|
||
```
|
||
|
||
### 2. 設定ファイルベース管理
|
||
```toml
|
||
# nyash.toml
|
||
[builtin_modules]
|
||
core = ["StringBox", "IntegerBox", "BoolBox", "ArrayBox", "MapBox"]
|
||
|
||
[builtin_modules.optional]
|
||
midnight = { enabled = true, features = ["testnet"] }
|
||
egui = { enabled = false }
|
||
webcanvas = { enabled = true, target = "wasm32" }
|
||
```
|
||
|
||
### 3. Cargo features統合
|
||
```toml
|
||
[features]
|
||
default = ["core-boxes"]
|
||
|
||
# オプショナルモジュール
|
||
builtin-midnight = ["web-sys", "js-sys", "wasm-bindgen"]
|
||
builtin-egui = ["egui", "eframe"]
|
||
builtin-webcanvas = ["web-sys/CanvasRenderingContext2d"]
|
||
|
||
# プリセット
|
||
full = ["builtin-midnight", "builtin-egui", "builtin-webcanvas", "plugins"]
|
||
minimal = ["core-boxes"]
|
||
wasm-web = ["core-boxes", "builtin-webcanvas", "builtin-midnight"]
|
||
```
|
||
|
||
### 4. 動的登録マクロ
|
||
```rust
|
||
builtin_module! {
|
||
MidnightModule,
|
||
condition = cfg!(feature = "builtin-midnight")
|
||
}
|
||
```
|
||
|
||
## 利点
|
||
1. **バイナリサイズ削減**: 必要な機能のみ含める
|
||
2. **ビルド時間短縮**: 不要な依存関係を除外
|
||
3. **WASM対応**: Rust WASM機能をフル活用可能
|
||
4. **設定の柔軟性**: ビルド時/実行時の両方で制御
|
||
5. **後方互換性**: 既存のコードは変更不要
|
||
|
||
## 使用例
|
||
|
||
```nyash
|
||
// 条件付き実行
|
||
if hasBox("MidnightBox") {
|
||
local voting = new VotingApp()
|
||
voting.run()
|
||
} else {
|
||
print("MidnightBox is not available in this build")
|
||
}
|
||
```
|
||
|
||
## ビルドコマンド例
|
||
```bash
|
||
# 最小構成
|
||
cargo build --release
|
||
|
||
# Midnight対応版
|
||
cargo build --release --features builtin-midnight
|
||
|
||
# フル機能版
|
||
cargo build --release --features full
|
||
|
||
# WASM Web版
|
||
cargo build --target wasm32-unknown-unknown --features wasm-web
|
||
```
|
||
|
||
## 実装タイミング
|
||
- Phase 10以降の最適化フェーズで検討
|
||
- プラグインシステムの成熟後に実装
|
||
- パフォーマンス問題が顕在化した場合に優先度上げ
|
||
|
||
## 関連課題
|
||
- プラグインシステムとの統合
|
||
- 設定ファイル管理の標準化
|
||
- ドキュメント自動生成（有効なBoxの一覧） |