Files
hakorune/lang/src/llvm_ir/README.md

25 lines
1.1 KiB
Markdown
Raw Normal View History

# LLVM Script Builder (opt-in, Phase 20.11)
目的
- Python llvmlite ハーネスで行っている IR 構築を、Hakorune スクリプトの薄い箱で段階的に置き換える。
- 責務は「IR 構築」に限定し、リンクおよび実行は小ライブラリlibhako_aot/AotBox に委譲する。
ゲート
- HAKO_LLVM_SCRIPT_BUILDER=1 で有効化既定OFF
- 厳格化未実装はFAIL: HAKO_LLVM_SCRIPT_BUILDER_STRICT=1既定はFAIL推奨
責務境界Box
- LLVMModuleBox: モジュール作成・型/レイアウト設定・関数登録
- LLVMFunctionBox: 関数定義・基本ブロック追加
- LLVMBuilderBox: 命令構築v0: const/binop/ret から開始)
- LLVMTypesBox: 代表的なプリミティブ型クエリ
- LLVMEmitBox: オブジェクト出力(当面は AotBox へ委譲予定)
FailFast
- 未実装/未対応は `UNSUPPORTED: <op>` を短文で出力して負値を返す(将来は統一エラーへ)。
将来拡張
- v1: compare/branch/phi、v2: call/externhako_* の C-ABI のみ)
- MIR→IR の対応は SSOT に集約し、Builder は小さな純関数にまとめる。