134 lines
4.3 KiB
Markdown
134 lines
4.3 KiB
Markdown
|
# Nyash ABI/TypeBox 統合インデックス
|
|||
|
|
|
|||
|
|
このドキュメントは、分散しているNyash ABI関連ドキュメントへの統合入口です。
|
|||
|
|
|
|||
|
|
## 🎯 現在の実装状態（Phase 15）
|
|||
|
|
|
|||
|
|
### 実装済み
|
|||
|
|
- **TypeBox FFI基本構造** - TLVベースの統一`invoke_id`
|
|||
|
|
- **struct_sizeフィールド** - 前方互換性確保
|
|||
|
|
- **プラグインローダーv2** - 7個の基本Boxプラグイン動作中
|
|||
|
|
|
|||
|
|
### 計画中
|
|||
|
|
- **専用関数追加** - `create`/`destroy`/`get_type_info`
|
|||
|
|
- **パフォーマンス最適化** - 直接関数ポインタ呼び出し
|
|||
|
|
- **C ABI完全互換** - 他言語との相互運用性向上
|
|||
|
|
|
|||
|
|
## 📚 主要ドキュメント
|
|||
|
|
|
|||
|
|
### 1. コア設計ドキュメント
|
|||
|
|
|
|||
|
|
#### [NYASH_ABI_MIN_CORE.md](../../private/reference/abi/NYASH_ABI_MIN_CORE.md)
|
|||
|
|
**最小コアABIとエボリューション戦略**
|
|||
|
|
- NyrtValue 16B固定表現
|
|||
|
|
- struct_sizeによる前方互換性
|
|||
|
|
- feature_bits交渉メカニズム
|
|||
|
|
- エボリューション・ハッチ（将来拡張への逃げ道）
|
|||
|
|
|
|||
|
|
#### [typebox-api-reference.md](../../development/roadmap/phases/phase-12/specs/typebox-api-reference.md)
|
|||
|
|
**統一TypeBox APIリファレンス**
|
|||
|
|
- NyashTypeBox C構造体仕様
|
|||
|
|
- NyValue型システム
|
|||
|
|
- 関数ポインタ仕様（create/destroy/invoke_id）
|
|||
|
|
- エラーハンドリング・所有権ルール
|
|||
|
|
|
|||
|
|
#### [NYASH-ABI-C-IMPLEMENTATION.md](../../development/roadmap/phases/phase-12/design/NYASH-ABI-C-IMPLEMENTATION.md)
|
|||
|
|
**Nyash ABIをTypeBoxとして実装する革新的設計**
|
|||
|
|
- "Everything is Box" → ABIもBox
|
|||
|
|
- 3段階実装戦略（C Shim → フルC → Nyash再実装）
|
|||
|
|
- Tagged Pointers・セレクターキャッシング
|
|||
|
|
- 3大AI（Gemini/Codex/ChatGPT5）による評価
|
|||
|
|
|
|||
|
|
### 2. 実装詳細
|
|||
|
|
|
|||
|
|
#### [unified-typebox-abi.md](../../development/roadmap/phases/phase-12/unified-typebox-abi.md)
|
|||
|
|
**Phase 12統一TypeBox ABI実装計画**
|
|||
|
|
- 移行ロードマップ
|
|||
|
|
- パフォーマンス目標（33倍高速化）
|
|||
|
|
- 互換性維持戦略
|
|||
|
|
|
|||
|
|
#### [PLUGIN_ABI.md](../../../PLUGIN_ABI.md)
|
|||
|
|
**プラグインABI概要**
|
|||
|
|
- 現在のTLVベース実装
|
|||
|
|
- プラグイン開発ガイド
|
|||
|
|
|
|||
|
|
### 3. 現在のソースコード実装
|
|||
|
|
|
|||
|
|
#### Rust側（ランタイム）
|
|||
|
|
```rust
|
|||
|
|
// src/runtime/plugin_loader_v2/enabled/types.rs
|
|||
|
|
#[repr(C)]
|
|||
|
|
pub struct NyashTypeBoxFfi {
|
|||
|
|
pub abi_tag: u32,
|
|||
|
|
pub version: u16,
|
|||
|
|
pub struct_size: u16, // 前方互換性キー！
|
|||
|
|
pub name: *const c_char,
|
|||
|
|
pub resolve: Option<extern "C" fn(*const c_char) -> u32>,
|
|||
|
|
pub invoke_id: Option<extern "C" fn(u32, u32, *const u8, usize, *mut u8, *mut usize) -> i32>,
|
|||
|
|
pub capabilities: u64,
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### プラグイン側（C/Rust）
|
|||
|
|
- `plugins/nyash-string-plugin/`
|
|||
|
|
- `plugins/nyash-array-plugin/`
|
|||
|
|
- その他基本Boxプラグイン
|
|||
|
|
|
|||
|
|
## 🔄 ABI拡張方法
|
|||
|
|
|
|||
|
|
### 1. 構造体末尾に新フィールド追加
|
|||
|
|
```rust
|
|||
|
|
pub struct NyashTypeBoxFfi {
|
|||
|
|
// 既存フィールド...
|
|||
|
|
|
|||
|
|
// 新規追加（末尾に！）
|
|||
|
|
pub create: Option<extern "C" fn(*const u8) -> u32>,
|
|||
|
|
pub destroy: Option<extern "C" fn(u32) -> i32>,
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 2. struct_sizeで互換性チェック
|
|||
|
|
```rust
|
|||
|
|
let actual_size = (*tb).struct_size;
|
|||
|
|
if actual_size >= expected_size {
|
|||
|
|
// 新機能使用可能
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🚀 移行タイミング検討
|
|||
|
|
|
|||
|
|
### Option 1: **LLVM完成後に移行**（推奨）
|
|||
|
|
**メリット**：
|
|||
|
|
- LLVMの最適化機会を考慮した設計可能
|
|||
|
|
- JIT/AOTでの関数ポインタ直接呼び出し最適化
|
|||
|
|
- 実行パスが確定してからの最適設計
|
|||
|
|
|
|||
|
|
**デメリット**：
|
|||
|
|
- 移行が遅れる
|
|||
|
|
- 現在のTLVオーバーヘッドが継続
|
|||
|
|
|
|||
|
|
### Option 2: **今すぐ段階的移行**
|
|||
|
|
**メリット**：
|
|||
|
|
- プラグイン数が少ない今がチャンス
|
|||
|
|
- 早期にパフォーマンス改善
|
|||
|
|
- 将来の技術的負債を回避
|
|||
|
|
|
|||
|
|
**デメリット**：
|
|||
|
|
- LLVM実装と並行作業
|
|||
|
|
- 優先度の分散
|
|||
|
|
|
|||
|
|
### 結論：**LLVM Phase完了後が最適**
|
|||
|
|
理由：
|
|||
|
|
1. 現在のTLVベースでも実用上問題なし
|
|||
|
|
2. LLVM最適化と同時に設計見直し
|
|||
|
|
3. 一度の大きな変更で済む
|
|||
|
|
4. Phase 16でのABI安定化に向けた準備
|
|||
|
|
|
|||
|
|
## 関連リンク
|
|||
|
|
|
|||
|
|
- [Phase 15 README](../../development/roadmap/phases/phase-15/README.md) - 現在のフェーズ
|
|||
|
|
- [Phase 22 構想](../../development/roadmap/phases/phase-22/) - Nyash LLVMコンパイラ
|
|||
|
|
- [Box設計哲学](../../development/architecture/box-externcall-design.md) - Box/ExternCall境界
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
最終更新: 2025-09-12
|