ソースコード説明書

モノレポ全体構造

kaedevn-monorepo は、Nintendo Switch（主）と Web（副）を対象としたクロスプラットフォームの**ノベルゲームと RPG ゲームが両方作れるプラットフォーム**のモノレポ。ノベル側は VRM / Live2D キャラ対応で稼働中、RPG 側（Database・マップ・イベント・コマンドバトル）は開発中。エディタ、API、プレビュー、コンパイラ、インタプリタ、ネイティブエンジンなど 16 以上のパッケージで構成される。

apps/editor - エディタ SPA

kaedevn のメインエディタ。React 19 + Vite 7 + Zustand 5 で構成される SPA。ブロックベースの GUI でページ・ブロック・キャラクター（2D 立ち絵 / VRM 3D / Live2D / Shape Ch）・アセットを管理し、Kaede Script のタグ記法（KS）を生成してプレビューエンジンに送る。KSC（コード記法）ブロックの埋め込みにも対応。

apps/hono - Hono API サーバー

Hono 4 ベースの REST API サーバー。認証、プロジェクト管理、アセット管理、プレビュー生成、AI 執筆支援、管理画面機能を提供する。Prisma ORM で PostgreSQL に接続し、Azure Blob Storage にアセットを格納する。

apps/next - Next.js 認証・管理画面

Next.js App Router ベースの Web アプリケーション。ユーザー認証（登録・ログイン・パスワードリセット）、マイページ、プロジェクト管理、管理画面を提供する。エディタ（apps/editor）へのエントリポイントとして機能する。

apps/ksc-editor - KSC スクリプトエディタ

KSC (TypeScript 風スクリプト言語) 専用のコードエディタ。Monaco Editor を統合し、構文ハイライト、リアルタイム診断、オートコンプリート、ファイルツリー、プレビューペインを備える。ポート 5177 で動作。

packages/core - 共有型定義・コア抽象化

モノレポ全体の基盤パッケージ。Op 命令型、タイムライン型、プラットフォーム抽象化インターフェース（IInput, IAudio, IStorage）、セーブデータスキーマを定義する。他のすべてのパッケージが依存する最下層レイヤー。

packages/compiler - .ks コンパイラ

TyranoScript 風の .ks スクリプトを Op[] (ランタイム命令配列) にコンパイルする。Tokenizer → Parser → Transformer → Finalizer のパイプラインで処理する。コマンドレジストリにより、新コマンドの追加が容易。

packages/ksc-compiler - KSC コンパイラ + VM

KSC (TypeScript 風スクリプト言語) のフルコンパイラと仮想マシン。Lexer → Parser → Checker (型チェック) → Emitter (IR 生成) → VM (実行) のパイプラインで処理する。プリミティブ型、オブジェクト、配列、関数、条件式をサポートする型システムを持つ。

packages/web - PixiJS WebGL エンジン

PixiJS + Filament.js ベースの Web エンジン。Op 命令の実行、スプライト・テキスト・UI のレンダリング、VRM 3D キャラクター（BlendShape / SpringBone / MToon）、Live2D キャラクター、46 種のスクリーンフィルター、ゲームシステム（セーブ/ロード、バックログ、設定）を提供する。プレビューエンジン (:5175) として動作。

packages/interpreter - スクリプトインタプリタ

KSC (Kaede Script Code / `.ksc`) スクリプトの純 JavaScript インタプリタ。VM、デバッグモード（ブレークポイント、変数ウォッチ、トレースログ）、エラーハンドリング（Levenshtein 距離によるコマンド候補提示）を備える。

packages/ai-gateway - LLM クライアント抽象化

複数の LLM プロバイダ（OpenAI, Anthropic, Google Vertex AI, Google Gemini）を統一インターフェースで利用するための抽象化レイヤー。テキスト生成とベクトル埋め込みの両方をサポート。

packages/battle, ui, tools, vscode-ks-ksc

packages/native-engine, packages/sdl - ネイティブエンジン

Nintendo Switch / Android 向けの C++ ネイティブエンジン。SDL2 + OpenGL でレンダリングし、KS スクリプトの実行、テクスチャ/オーディオ/フォント管理、セーブ/ロード機能を備える。Web エンジン (packages/web) と同等の機能をネイティブで実装し、同じ Kaede Script（KS / KSC）が両方で動作する。

tests/ - E2E テスト

Playwright による E2E テスト群。48 テストファイル (約 9,500 行) で、エディタ、認証、プレビュー、バトル、タイムライン、アセット管理、ゲストモード、管理画面をカバーする。ローカル環境と Azure 環境の両方に対応。

scripts/ - スクリプト一覧

開発、テスト、デプロイ、バックアップ、ユーティリティのシェルスクリプトと TypeScript スクリプト。合計 39 ファイル。

設定ファイル・CI/CD

モノレポのルート設定ファイル、Git hooks、GitHub Actions ワークフロー、Docker 構成、環境変数の一覧と説明。

macOS ビルドガイド

macOS (Apple Silicon / Intel) でネイティブエンジンをビルドし、背景・立ち絵・テキストが表示される状態まで持っていく手順。SDL2 + OpenGL で動作する。

Android ビルドガイド

macOS 上でネイティブエンジンを Android 向けにクロスビルドし、エミュレーターまたは実機で動作確認する手順。SDL2 をソースからビルドし、NDK 経由でコンパイルする。macOS 側のコードは `#ifdef __ANDROID__` ガードで分岐しており、既存のビルドには影響しない。