モノレポ全体構造

概要

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

技術スタック

ディレクトリ構成

kaedevn-monorepo/
├── apps/
│   ├── editor/          # メインエディタ SPA (Vite + React, :5176)
│   ├── hono/            # バックエンド API (Hono, :8080)
│   ├── next/            # 認証・管理画面 (Next.js, :3000)
│   └── ksc-editor/      # KSC スクリプトエディタ (Vite + React + Monaco, :5177)
├── packages/
│   ├── core/            # 共有型定義・Op 型・Timeline 型
│   ├── compiler/        # .ks → Op[] コンパイラ
│   ├── ksc-compiler/    # .ksc コンパイラ + VM
│   ├── web/             # PixiJS WebGL エンジン・プレビュー (:5175)
│   ├── interpreter/     # スクリプトインタプリタ
│   ├── ai-gateway/      # LLM クライアント抽象化
│   ├── battle/          # コマンドバトルシステム
│   ├── ui/              # 共有 React UI コンポーネント
│   ├── tools/           # アセット処理 CLI ツール
│   ├── native-engine/   # C++ ネイティブエンジン (Switch/Android)
│   ├── sdl/             # SDL2 ライブラリ
│   └── vscode-ks-ksc/   # VSCode 拡張（.ks/.ksc 構文ハイライト）
├── tests/               # Playwright E2E テスト (48 ファイル)
├── e2e/                 # KSC デモ E2E テスト
├── scripts/             # 開発・テスト・デプロイスクリプト (39 ファイル)
├── projects/            # コンテンツデータ（対象外）
├── docs/                # ドキュメント
├── .github/workflows/   # CI/CD (7 ワークフロー)
├── .husky/              # Git hooks (pre-push, pre-commit)
└── package.json         # ワークスペース定義

パッケージ依存関係

core ← compiler ← web
core ← ksc-compiler ← web
core ← interpreter
core ← battle ← web
ai-gateway ← hono (API)

apps/editor → core (型のみ)
apps/hono → core, ai-gateway
apps/next → (独立)
apps/ksc-editor → (独立)

packages/web → core, compiler, ksc-compiler, battle

依存方向の原則

• core は他パッケージに依存しない（基盤層）
• compiler, ksc-compiler, interpreter, battle は core のみに依存
• web はすべてのランタイムパッケージに依存（統合層）
• ai-gateway は独立（外部 LLM API のみ）
• アプリ層（apps/）はパッケージ層に依存するが、パッケージ層はアプリ層に依存しない

サーバー構成

データフロー

[Editor SPA]  →  PUT /api/projects/:id  →  [Hono API]  →  [PostgreSQL]
     ↓                                          ↓
[buildPreviewScript()]              GET /api/preview/:id
     ↓                                          ↓
[Preview Engine]  ←  KSC Script  ←  [generateKSCScript()]
     ↓
[PixiJS / WebGL Rendering]

スクリプト処理パイプライン

エディタブロック → .ks スクリプト → Compiler → Op[] → OpRunner → WebOpHandler → PixiJS
                    or
エディタブロック → .ksc スクリプト → KSC Compiler → IR → VM → HostAPI → WebOpHandler → PixiJS

コア抽象化インターフェース

Switch 移植を見据え、以下のインターフェースを通じてプラットフォーム差異を吸収する。

デプロイ構成

ファイル規模