Files

Moe Charm cc2a820af7 feat(plugin): Fix plugin BoxRef return and Box argument support

- Fixed deadlock in FileBox plugin copyFrom implementation (single lock)
- Added TLV Handle (tag=8) parsing in calls.rs for returned BoxRefs
- Improved plugin loader with config path consistency and detailed logging
- Fixed loader routing for proper Handle type_id/fini_method_id resolution
- Added detailed logging for TLV encoding/decoding in plugin_loader_v2

Test docs/examples/plugin_boxref_return.nyash now works correctly:
- cloneSelf() returns FileBox Handle properly
- copyFrom(Box) accepts plugin Box arguments
- Both FileBox instances close and fini correctly

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-08-21 00:41:26 +09:00

5.4 KiB

Raw Blame History

🔍 Nyash WASM実行におけるRust依存性分析

📅 最終更新: 2025-08-15

🎯 概要

Nyash WASMの実行時Rust依存性について、Phase 9.77（手動実装）とPhase 9.8+（FFI基盤）を比較分析し、真のRust依存脱却の実現方法を解説。

🔍 重要な発見: 実行時Rust依存性はゼロ

結論

どちらの方式でも実行時Rust依存はなし！

方式	コンパイル時	実行時	配布ファイル
Phase 9.77 (手動)	❌ Rust必要	✅ Rust不要	.wasm + .js のみ
Phase 9.8+ (FFI)	❌ Rust必要	✅ Rust不要	.wasm + .js のみ

🛠️ Phase 9.77: 手動実装アプローチ

特徴

基本的なCanvas/Console操作を手動でWASM import実装
緊急復旧に最適（1-2週間で完了）
実行時はWASM + JavaScriptのみ

実行時依存関係

graph LR
    A[ブラウザー] --> B[app.wasm]
    A --> C[importObject.js]
    B --> C
    style A fill:#4ecdc4
    style B fill:#f9ca24
    style C fill:#f0932b

生成例

# コンパイル時 - Rust必要
cargo build --target wasm32-unknown-unknown
# → app.wasm 生成

# 実行時 - Rust完全不要！
# ブラウザーでWASM + JavaScriptのみ

🚀 Phase 9.8+: FFI基盤アプローチ

特徴

BID（Box Interface Definition）からの自動生成
新API追加が数分で完了
長期開発効率の飛躍的向上

自動生成フロー

graph TD
    A[BID YAML定義] --> B[nyash bid gen]
    B --> C[WASM import宣言]
    B --> D[JavaScript実装]
    B --> E[Rust生成コード]
    C --> F[配布: WASM + JS]
    D --> F
    style F fill:#2ed573

生成コマンド

# BID定義から自動生成
nyash bid gen --target wasm bid/canvas.yaml

# コンパイル
cargo build --target wasm32-unknown-unknown

# 実行時 - Rust完全不要！
# 同じくWASM + JavaScriptのみ

📦 配布ファイル構成（共通）

どちらの方式でも、配布時は以下のファイルのみ:

my_nyash_app/
├── app.wasm           # コンパイル済みWASM（Rust不要）
├── runtime.js         # importObject実装（JavaScript）
├── index.html         # HTMLページ
└── README.md          # 使用説明

🌐 実際の実行例

HTMLファイル（Rust一切不要）

<!DOCTYPE html>
<html>
<head><title>Nyash App</title></head>
<body>
    <canvas id="gameCanvas" width="400" height="300"></canvas>
    <script src="runtime.js"></script>
    <script>
        // WASMロード・実行（Rust依存なし）
        WebAssembly.instantiateStreaming(
            fetch('app.wasm'), 
            importObject
        ).then(instance => {
            instance.exports.main();
        });
    </script>
</body>
</html>

実行環境要件

✅ モダンブラウザー（Chrome, Firefox, Safari, Edge）
✅ WebAssembly対応
❌ Rust不要
❌ Node.js不要
❌ 特別なランタイム不要

📊 方式比較詳細

評価軸	Phase 9.77 手動	Phase 9.8+ FFI
実行時Rust依存	❌ なし	❌ なし
配布ファイル	WASM + JS	WASM + JS
開発時間	1-2週間	3-4週間
API追加工数	数時間（手動）	数分（自動）
保守性	低	高
拡張性	限定的	無制限
学習コスト	中	高

🎯 実用的選択指針

Phase 9.77を選ぶべき場合

✅ 即座にRust依存脱却したい
✅ 基本的なCanvas/Console操作で十分
✅ 短期プロジェクト
✅ 学習コスト最小化

Phase 9.8+を選ぶべき場合

✅ 長期開発プロジェクト
✅ 多様な外部API統合が必要
✅ チーム開発
✅ API拡張の自動化が重要

💡 戦略的アプローチ

段階的進化パス

graph LR
    A[現在: Rust依存] --> B[Phase 9.77: 手動WASM]
    B --> C[Phase 9.8+: FFI基盤]
    C --> D[完全自動化]
    
    style A fill:#ff6b6b
    style B fill:#f9ca24
    style C fill:#4ecdc4
    style D fill:#2ed573

推奨戦略

Phase 9.77: 手動実装で即座にRust依存脱却
検証: 実用性・性能確認
Phase 9.8+: 必要に応じてFFI基盤へ移行

🎉 期待される効果

即時効果（Phase 9.77）

Rust依存完全排除（実行時）
配布の簡素化
ブラウザー単体実行
学習コスト削減

長期効果（Phase 9.8+）

開発効率の飛躍的向上
API拡張の自動化
チーム開発の標準化
エコシステム拡充

🔗 関連ドキュメント

技術仕様

実装計画

問題分析

WASM現在の問題

この分析により、NyashはWASMを通じて真のRust依存脱却を実現し、ブラウザー環境での自由な実行が可能になります。 🚀

5.4 KiB Raw Blame History Unescape Escape