pasta

Memories of pasta twine together—now and then a knot, yet always a delight.

Pasta DSL サンプル

＊OnBoot
　＠挨拶：ごきげんよう、お待ちしておりましたわ、まあまあ
　％ぱすた、ラザニア
　ラザニア：＠挨拶　！
　　　　　：べ、別にあなたを待っていたわけではありませんのよ？
　　ぱすた：素直じゃないなあ……
　　　　　：ようこそ！一緒に楽しもうね。

Pasta は里々/Ren'Pyにインスパイアされた対話スクリプト言語/SHIORI.DLLです。 日本語フレンドリーな全角マーカー、前方一致によるランダム選択、Luaランタイムによる拡張性を特徴とします。 上のサンプルのように、シンプルな記述で自然な対話を実現できます。

---

関連ドキュメント

ドキュメント	説明
GRAMMAR.md	Pasta DSL 文法リファレンス（学習用クイックガイド）
doc/spec/	Pasta DSL 正式言語仕様書（章別分割、実装判断の権威的ソース）
AGENTS.md	AI開発支援ドキュメント（Kiro仕様駆動開発）

アーキテクチャ

Pastaは、「伺か」などのデスクトップマスコットアプリケーション、あるいはノベルゲーム用途に向いたスクリプトエンジンです。

レイヤー構成

Engine (上位API) → Cache/Loader
    ↓
Transpiler (2pass) ← Parser (pasta_dsl, Pest)
    ↓
Runtime (Lua VM) → IR Output (ScriptEvent)

パーサー/トランスパイラーアーキテクチャ

Pastaは現行の parser + transpiler スタックを使用しています：

モジュール	文法ファイル	状態	用途
pasta_dsl::parser	grammar.pest	現行	DSL→AST変換
pasta_lua::transpiler	-	現行	2-pass トランスパイル

使用方法

// 現行スタック
use pasta_dsl::parser::{parse_str, parse_file};
use pasta_lua::transpiler::Transpiler;

parserについて

parserモジュールは、独立クレート pasta_dsl として提供され、grammar.pest文法に基づいています。

主な特徴：

• 3層スコープ構造：FileScope ⊃ GlobalSceneScope ⊃ LocalSceneScope
• 未名グローバルシーンの自動名前継承
• 全角/半角数字の自動正規化
• 継続行アクション（：で始まる行）のサポート

---

ドキュメントマップ

Level 0: Entry Point

• README.md - プロジェクト概要（このドキュメント）

Level 1: Core Docs

• GRAMMAR.md - Pasta DSL 文法リファレンス
• doc/spec/ - 言語仕様書（章別分割、権威的ソース）
• AGENTS.md - AI開発支援ドキュメント

Level 2: Crate Docs

• pasta_dsl/README.md - DSLパーサー
• pasta_core/README.md - レジストリ・ユーティリティ
• pasta_lua/README.md - Luaトランスパイラ
• pasta_shiori/README.md - SHIORI DLL統合

Level 3: Steering

• .kiro/steering/ - AI/仕様駆動開発コンテキスト

開発者向けリソース

• crates/pasta_lua/tests/fixtures/ - テストフィクスチャ

---

オンボーディングパス

DSLユーザー向け（推定所要時間: 30分）

1. GRAMMAR.md - 基本文法を学ぶ
2. crates/pasta_lua/tests/fixtures/sample.pasta - サンプルスクリプト
3. クイックスタート - ビルド・実行方法
4. pasta DSL vscode拡張 - pasta構文 vscode拡張

開発者向け（推定所要時間: 2-3時間）

1. doc/spec/ - 言語仕様の理解（必要な章のみ）
2. pasta_dsl/README.md - DSLパーサー
3. pasta_core/README.md - レジストリ
4. .kiro/steering/structure.md - プロジェクト構造
5. .kiro/steering/workflow.md - 開発ワークフロー

AI開発支援向け（推定所要時間: 1時間）

1. AGENTS.md - AI開発支援概要
2. .kiro/steering/ - ステアリングファイル群
3. doc/spec/README.md - 正式仕様（章別インデックス）

---

クイックスタート

前提条件

• Rust 2024 edition
• cargo

ビルド

cargo build --workspace

テスト

cargo test --workspace

プロジェクト構造

pasta/
├── crates/
│   ├── pasta_dsl/     # DSLパーサー（Pest PEG → AST）
│   ├── pasta_core/    # レジストリ・ユーティリティ（言語非依存層）
│   ├── pasta_lua/     # Luaトランスパイラ・ランタイム
│   └── pasta_shiori/  # SHIORI DLL統合
└── tests/             # 統合テスト・フィクスチャ

---

ライセンス

LICENSE ファイルを参照してください。