hakorune/docs/guides/wasm-guide/README.md

# 🌐 Nyash WASM ガイド

Nyash WebAssembly（WASM）実行に関する包括的ガイド

## 📖 ドキュメント一覧

### 基本ガイド
- **[Rust依存性分析](rust-dependency-analysis.md)** - 実行時Rust依存性の詳細分析
- **[Phase比較](phase-comparison.md)** - 9.77手動実装 vs 9.8+FFI基盤の比較
- **[配布ガイド](deployment-guide.md)** - WASM配布・実行方法

### 技術仕様
- **[FFI/BIDチュートリアル](ffi-bid-tutorial.md)** - 外部API統合方法
- **[メモリ管理](memory-management.md)** - WASM メモリレイアウト・最適化

## 🚀 クイックスタート

### WASM コンパイル
```bash
# 基本コンパイル
./target/release/hakorune --compile-wasm program.hako

# AOT コンパイル（配布用）
./target/release/hakorune --aot program.hako
```

### ブラウザー実行
```html
<!DOCTYPE html>
<html>
<body>
    <script>
        WebAssembly.instantiateStreaming(fetch('program.wasm'), importObject)
            .then(instance => instance.exports.main());
    </script>
</body>
</html>
```

## 🎯 実行方式選択

| 用途 | 方式 | コマンド |
|------|------|----------|
| **開発・テスト** | インタープリター | `nyash program.hako` |
| **高速実行** | VM | `nyash --backend vm program.hako` |
| **Web配布** | WASM | `nyash --compile-wasm program.hako` |
| **ネイティブ配布** | AOT | `nyash --aot program.hako` |

## 📊 性能比較

| バックエンド | 実行速度 | 配布サイズ | 依存関係 |
|-------------|----------|------------|----------|
| インタープリター | 1x | - | Rust |
| VM | 20.4x | - | Rust |
| **WASM** | **13.5x** | **小** | **なし** |
| AOT | 目標1000x+ | 小 | なし |

## 🔗 関連ドキュメント
- [言語ガイド](../LANGUAGE_GUIDE.md)
- [実行バックエンド](../execution-backends.md)
- [ビルドガイド](../build/README.md)

---
**最終更新**: 2025-08-15
-												📚 Add WASM documentation - Phase 9.77 planning and Rust dependency analysis

- Add docs/説明書/wasm/README.md: WASM comprehensive guide
- Add docs/説明書/wasm/rust-dependency-analysis.md: Detailed Rust dependency analysis
- Add docs/予定/native-plan/issues/phase_9_77_wasm_emergency.md: Emergency recovery plan
- Update copilot_issues.txt: Add Phase 9.77 between 9.75 and 9.8

Phase 9.77 strategy: Manual implementation → FFI foundation (Phase 9.8+)
Both approaches achieve zero Rust runtime dependency via WASM + JavaScript

											
										
										
											2025-08-15 15:24:03 +09:00
+								# 🌐 Nyash WASM ガイド
 								Nyash WebAssembly（WASM）実行に関する包括的ガイド
 								## 📖 ドキュメント一覧
 								### 基本ガイド
 								- **[Rust依存性分析](rust-dependency-analysis.md)** - 実行時Rust依存性の詳細分析
 								- **[Phase比較](phase-comparison.md)** - 9.77手動実装 vs 9.8+FFI基盤の比較
 								- **[配布ガイド](deployment-guide.md)** - WASM配布・実行方法
 								### 技術仕様
 								- **[FFI/BIDチュートリアル](ffi-bid-tutorial.md)** - 外部API統合方法
 								- **[メモリ管理](memory-management.md)** - WASM メモリレイアウト・最適化
 								## 🚀 クイックスタート
 								### WASM コンパイル
 								```bash
 								# 基本コンパイル
-												feat(joinir): Phase 213-2 Step 2-2 & 2-3 Data structure extensions

Extended PatternPipelineContext and CarrierUpdateInfo for Pattern 3 AST-based generalization.

Changes:
1. PatternPipelineContext:
   - Added loop_condition: Option<ASTNode>
   - Added loop_body: Option<Vec<ASTNode>>
   - Added loop_update_summary: Option<LoopUpdateSummary>
   - Updated build_pattern_context() for Pattern 3

2. CarrierUpdateInfo:
   - Added then_expr: Option<ASTNode>
   - Added else_expr: Option<ASTNode>
   - Updated analyze_loop_updates() with None defaults

Status: Phase 213-2 Steps 2-2 & 2-3 complete
Next: Create Pattern3IfAnalyzer to extract if statement and populate update summary

											
										
										
											2025-12-10 00:01:53 +09:00
+								./target/release/hakorune --compile-wasm program.hako
-												📚 Add WASM documentation - Phase 9.77 planning and Rust dependency analysis

- Add docs/説明書/wasm/README.md: WASM comprehensive guide
- Add docs/説明書/wasm/rust-dependency-analysis.md: Detailed Rust dependency analysis
- Add docs/予定/native-plan/issues/phase_9_77_wasm_emergency.md: Emergency recovery plan
- Update copilot_issues.txt: Add Phase 9.77 between 9.75 and 9.8

Phase 9.77 strategy: Manual implementation → FFI foundation (Phase 9.8+)
Both approaches achieve zero Rust runtime dependency via WASM + JavaScript

											
										
										
											2025-08-15 15:24:03 +09:00
 								# AOT コンパイル（配布用）
-												feat(joinir): Phase 213-2 Step 2-2 & 2-3 Data structure extensions

Extended PatternPipelineContext and CarrierUpdateInfo for Pattern 3 AST-based generalization.

Changes:
1. PatternPipelineContext:
   - Added loop_condition: Option<ASTNode>
   - Added loop_body: Option<Vec<ASTNode>>
   - Added loop_update_summary: Option<LoopUpdateSummary>
   - Updated build_pattern_context() for Pattern 3

2. CarrierUpdateInfo:
   - Added then_expr: Option<ASTNode>
   - Added else_expr: Option<ASTNode>
   - Updated analyze_loop_updates() with None defaults

Status: Phase 213-2 Steps 2-2 & 2-3 complete
Next: Create Pattern3IfAnalyzer to extract if statement and populate update summary

											
										
										
											2025-12-10 00:01:53 +09:00
+								./target/release/hakorune --aot program.hako
-												📚 Add WASM documentation - Phase 9.77 planning and Rust dependency analysis

- Add docs/説明書/wasm/README.md: WASM comprehensive guide
- Add docs/説明書/wasm/rust-dependency-analysis.md: Detailed Rust dependency analysis
- Add docs/予定/native-plan/issues/phase_9_77_wasm_emergency.md: Emergency recovery plan
- Update copilot_issues.txt: Add Phase 9.77 between 9.75 and 9.8

Phase 9.77 strategy: Manual implementation → FFI foundation (Phase 9.8+)
Both approaches achieve zero Rust runtime dependency via WASM + JavaScript

											
										
										
											2025-08-15 15:24:03 +09:00
+								```
 								### ブラウザー実行
 								```html
 								<!DOCTYPE html>
 								<html>
 								<body>
 								    <script>
 								        WebAssembly.instantiateStreaming(fetch('program.wasm'), importObject)
 								            .then(instance => instance.exports.main());
 								    </script>
 								</body>
 								</html>
 								```
 								## 🎯 実行方式選択
 								| 用途 | 方式 | コマンド |
 								|------|------|----------|
-												phase: 20.49 COMPLETE; 20.50 Flow+String minimal reps; 20.51 selfhost v0/v1 minimal (Option A/B); hv1-inline binop/unop/copy; docs + run_all + CURRENT_TASK -> 21.0

											
										
										
											2025-11-06 15:41:52 +09:00
+								| **開発・テスト** | インタープリター | `nyash program.hako` |
 								| **高速実行** | VM | `nyash --backend vm program.hako` |
 								| **Web配布** | WASM | `nyash --compile-wasm program.hako` |
 								| **ネイティブ配布** | AOT | `nyash --aot program.hako` |
-												📚 Add WASM documentation - Phase 9.77 planning and Rust dependency analysis

- Add docs/説明書/wasm/README.md: WASM comprehensive guide
- Add docs/説明書/wasm/rust-dependency-analysis.md: Detailed Rust dependency analysis
- Add docs/予定/native-plan/issues/phase_9_77_wasm_emergency.md: Emergency recovery plan
- Update copilot_issues.txt: Add Phase 9.77 between 9.75 and 9.8

Phase 9.77 strategy: Manual implementation → FFI foundation (Phase 9.8+)
Both approaches achieve zero Rust runtime dependency via WASM + JavaScript

											
										
										
											2025-08-15 15:24:03 +09:00
 								## 📊 性能比較
 								| バックエンド | 実行速度 | 配布サイズ | 依存関係 |
 								|-------------|----------|------------|----------|
 								| インタープリター | 1x | - | Rust |
 								| VM | 20.4x | - | Rust |
 								| **WASM** | **13.5x** | **小** | **なし** |
 								| AOT | 目標1000x+ | 小 | なし |
 								## 🔗 関連ドキュメント
 								- [言語ガイド](../LANGUAGE_GUIDE.md)
 								- [実行バックエンド](../execution-backends.md)
 								- [ビルドガイド](../build/README.md)
 								---
 								**最終更新**: 2025-08-15