moonbit-luna-ui

# MoonBit + Luna UI 開発ガイド

MoonBitとLuna UI (Sol Framework) を使用したCloudflare Workers向けWebアプリケーション開発のノウハウ。

## 開発を始める前に必読

### アプローチ選択

**→ [ECOSYSTEM.md](./ECOSYSTEM.md)を参照**

Luna UI (Sol Framework) 以外にも選択肢があります:
- **vite-plugin-moonbit**: HMR対応、既存Viteプロジェクトへの統合向け
- **mizchi/js**: JS FFIバインディング（**必須ライブラリ**）
- **mizchi/npm_typed**: Hono, Playwright等50+パッケージのバインディング

**FFIを自前で書く前に、必ず既存ライブラリを確認してください。**

### 本ドキュメントの対象

このスキルは **Luna UI + Sol Framework** を使う場合のガイドです。
シンプルなアプリや既存Viteプロジェクトには **vite-plugin-moonbit** を推奨します。

## 技術スタック概要

| 技術 | 役割 |
|-----|------|
| MoonBit | メイン言語（WASMターゲット、JSターゲット両対応） |
| Luna UI | UIフレームワーク（Island Architecture） |
| Sol Framework | ルーティング・SSR・Server Actions |
| Cloudflare Workers | ランタイム |
| D1 | SQLiteベースのデータベース |
| Hono | HTTPミドルウェア（認証等） |

## プロジェクト構成

```
project/
├── app/
│   ├── server/
│   │   ├── routes.mbt      # ルーティング・ページ・API定義
│   │   ├── db.mbt          # D1 FFIバインディング
│   │   └── _using.mbt      # 共通インポート
│   ├── client/
│   │   ├── *.mbt           # Island Components
│   │   └── _using.mbt
│   └── __gen__/            # 自動生成（.gitignore推奨）
├── src/
│   └── worker.ts           # Cloudflare Workerエントリーポイント
├── static/
│   └── loader.js           # Luna UIハイドレーションローダー
├── scripts/
│   ├── patch-for-cloudflare.js  # CF Workers用パッチ
│   └── bundle-client.js         # クライアントバンドル
├── moon.mod.json           # MoonBit設定
├── wrangler.json           # Cloudflare設定
└── .sol/                   # Sol生成物（.gitignore推奨）
```

## 開発コマンド（just）

プロジェクトでは `just` コマンドを使用して開発タスクを実行します。

```bash
# 主要コマンド
just dev          # 開発サーバー起動（wrangler dev）
just build        # 完全ビルド
just deploy       # Cloudflare Workersにデプロイ

# ビルド関連
just generate     # sol generate 実行
just moon-build   # MoonBitビルド
just bundle       # クライアントバンドル
just clean        # ビルド成果物削除

# テスト関連
just test         # MoonBit単体テスト実行
just test-e2e     # E2Eテスト実行
just test-all     # 全テスト実行

# SSG関連
just ssg          # SSGビルド
just ssg-preview  # SSGビルド + プレビュー

# 型チェック・リント
just check        #