MoonBit + WebAssembly 入門（2026年3月版）
〜変化に強い「LLMプロンプト駆動」学習ガイド〜

## Part 1: 環境構築（1-3章）
- インストール → パッケージ管理 → Hello World

## Part 2: 言語基礎（4-5章）
- 基本構文 → 非同期処理

## Part 3: 実践ファイルI/O（6-9章）
- cat → ls → grep → dotenv（難易度順）

## Part 4: 相互運用（10章）
- JavaScript FFI

### 6. ファイルI/O入門（catコマンド相当）

**ゴール**
Unixのcatコマンド相当を作り、ファイル読み込みとエラーハンドリングを学ぶ

**プロンプト（LLMにコピペ）**

**期待される出力イメージ**

**私が残す罠メモ**
- [既存の罠メモ]

**🚨 Windows: cmd vs PowerShell**

**症状：** `moon`コマンドが見つからない、またはインストール後にコマンドが効かない

**原因：** cmdの環境変数反映が遅い/不完全な場合がある

**対処法：** 
1. PowerShellを管理者権限で開き直す
2. またはインストール後にPCを再起動
3. `moon version`が通ることを確認してから次に進む

## Appendix A: トラブルシューティング（2026年3月時点）

| 現象 | 原因 | 解決策 |
|------|------|--------|
| `moon test`がブラウザバックエンドで失敗 | ブラウザ環境の制限 | `moon test --target node`を使用 |
| LSPの補完が効かない | 依存追加後の未リロード | VSCode: 「Reload Window」実行 |
| xパッケージのimportエラー | パス変更 | プロンプトで最新パスを確認 |

現在のMoonBitのインストール方法を、Linux / macOS / Windowsそれぞれでステップバイステップで教えてください。
公式のcurlコマンドもそのまま書いて、インストール後に必ず実行すべき検証コマンド（moon versionなど）も含めて。
VSCode拡張のインストール方法と、初回起動時に推奨される設定も教えて。

$ moon version
moon 0.x.x (some-commit-hash)

$ moon new hello
Created hello/...

現在のMoonBitで、外部パッケージの追加・更新・削除・バージョンピン留めの方法をすべて教えてください。
以下のすべてをコマンド例＋moon.mod.json / moon.pkg.jsonの実際の差分付きで説明：
・moon add / moon remove / moon update の使い方
・moonbitlang/x を依存として追加する例
・ローカルパス参照の方法
・バージョンピン留め（例: ~0.1.0）とワイルドカードの違い

# パッケージ追加
$ moon add moonbitlang/x
Added moonbitlang/[email protected]

# 確認
$ cat moon.mod.json
{
  "name": "my-project",
  "version": "0.1.0",
  "deps": {
    "moonbitlang/x": "~0.x.x"
  }
}

現在のMoonBitで、ゼロからプロジェクトを作成してHello Worldを動かすまでの全コマンドを教えて。
moon new → 必要なファイルの説明 → moon run までの流れを、実際のターミナル出力例付きで。
ブラウザバックエンドとNodeバックエンドの両方を試す方法も教えて。

# プロジェクト作成
$ moon new hello
$ cd hello

# デフォルト（ブラウザバックエンド）
$ moon run main.mbt
Hello, world!

# Nodeバックエンドで実行
$ moon run --target node main.mbt
Hello, world!

現在のMoonBitで、以下の基本構文をRustとの違いをコメント付きで5〜8個の例を示してください：
・変数宣言（let / mut）
・if / else / match
・for / while
・関数定義とクロージャ
・struct / enum / impl
可能な限り短く、実用的なコード例に。

// main.mbt
// Rustとの主な違い：
// - letだけで可変/不変を区別（mutキーワードなし）
// - 型推論が強力
// - matchは必須ではない（if式で十分なことも多い）

fn main {
  // 変数（デフォルトで不変）
  let x = 5
  // 可変にするには明示的に型注釈＆mut相当の記法（現在の仕様を確認）
  
  // 関数定義
  fn add(a: Int, b: Int) -> Int {
    a + b  // 最後の式が返り値（return不要）
  }
  
  // structとimpl
  struct Point {
    x: Int,
    y: Int
  }
  
  // ... などなど
}

現在のMoonBitにおけるasync/awaitのサポート状況を正確に教えてください。
・使える範囲と使えない範囲
・ブラウザバックエンドとNodeバックエンドの違い
・今後予定されている機能（あれば）
・実用例としてシンプルなasync関数を1つ書いて。

// 現在の制限付きasync/awaitの例
// （実際のコードはLLMに最新版を確認）

async fn fetch_data(url: String) -> Result[String, String] {
  // ブラウザでは制限あり、Nodeではより自由に使える
  // ...
}

現在のMoonBitで、Unixライクなcatコマンド相当のプログラムを書いてください。
・ファイル読み込み＋標準出力
・コマンドライン引数でファイル名を受け取る（引数なしならstdin）
・エラーハンドリングは?演算子かResult型で丁寧に
・coreだけでは無理なら、最新の正しい外部パッケージ（moonbitlang/x配下など）を自動で提案してimportしてください
・Nodeバックエンドとブラウザバックエンドの違いも注記して
完全な動くコード＋実行方法を教えて。

# ファイル読み込み
$ moon run main.mbt -- file.txt
Hello, MoonBit!

# stdinから
$ echo "Hello" | moon run main.mbt
Hello

現在のMoonBitで、lsコマンド相当のプログラムを書いてください。
・現在のディレクトリの一覧表示
・ファイルサイズも表示
・再帰オプション（-R）も実装
・最新の正しい外部パッケージを自動提案してimport
・エラーハンドリングは丁寧に
完全なコードと実行例を。

$ moon run main.mbt
drwxr-xr-x  src/
-rw-r--r--  1.2KB  moon.mod.json
-rw-r--r--  856B   main.mbt

$ moon run main.mbt -- -R
./
  src/
    main.mbt  856B
  moon.mod.json  1.2KB

現在のMoonBitで、grepコマンド相当のプログラムを書いてください。
・指定パターンをファイル内で検索
・行番号付きでヒット表示
・複数ファイル対応
・最新の正しい外部パッケージを自動提案
完全なコード＋実行例を。

$ moon run main.mbt -- "func" src/*.mbt
src/main.mbt:3:fn main() {
src/main.mbt:7:fn helper() {
src/lib.mbt:12:fn public_func() {

現在のMoonBitで、.envファイルを読み込むdotenvライブラリ相当を実装してください。
・.env / .env.local / .env.production の優先順位対応
・型安全な環境変数オブジェクトとして返す（struct推奨）
・最新の正しい外部パッケージを自動提案
・エラーハンドリングも含めて完全なコードを。

// 使用例
let config = load_dotenv!()
println(config.database_url)  // 型安全にアクセス

現在のMoonBitからJavaScriptの関数（console.log、fetchなど）を呼び出すFFIの最新の書き方をステップごとに教えて。
逆（JS→MoonBit）の例も1つ。
ブラウザとNode両対応で。

// MoonBitからJSのconsole.logを呼ぶ
fn js_log(s: String) = "console.log"

// JSからMoonBitの関数を呼ぶ設定
// ...

現在のMoonBitで単体テストを書く方法を教えて。
・moon testの使い方
・アサーションの書き方
・テスト用のfixtureや一時ファイルの扱い

現在のMoonBitでWASMを出力し、HTMLから読み込む方法をステップごとに教えて。
・moon build --target wasm の使い方
・出力された.wasmの構造
・HTML/JSからの読み込み方（instantiateStreamingなど）

現在のMoonBitでWASMの出力サイズを小さくする方法と、実行速度を上げる方法を教えて。
・コンパイルオプション
・不要なコードの削除
・プロファイリング方法