hakorune/docs/reference/architecture/TECHNICAL_ARCHITECTURE_2025.md

# Technical Architecture (2025) – Map

This index points to the currently maintained architectural documents:

- Core Concepts: reference/architecture/nyash_core_concepts.md
- Execution Backends: reference/architecture/execution-backends.md
- Lowering Contexts: LOWERING_CONTEXTS.md
- LLVM Layer Overview: LLVM_LAYER_OVERVIEW.md
- VM Overview: VM_README.md
- Cranelift AOT design: backend-cranelift-aot-design.md

Note: Some long-form papers reside under `private/papers/reference/architecture/`.
-												🚀 feat: Multiple improvements for Nyash parser and LLVM backend

Parser improvements:
- Added expression statement fallback in parse_statement() for flexible syntax
- Fixed ternary operator to use PeekExpr instead of If AST (better lowering)
- Added peek_token() check to avoid ?/?: operator conflicts

LLVM Python improvements:
- Added optional ESC_JSON_FIX environment flag for string concatenation
- Improved PHI generation with better default handling
- Enhanced substring tracking for esc_json pattern

Documentation updates:
- Updated language guide with peek expression examples
- Added box theory diagrams to Phase 15 planning
- Clarified peek vs when syntax differences

These changes enable cleaner parser implementation for self-hosting,
especially for handling digit conversion with peek expressions instead
of 19-line if-else chains.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

											
										
										
											2025-09-14 19:16:32 +09:00
+								# Technical Architecture (2025) – Map
 								This index points to the currently maintained architectural documents:
 								- Core Concepts: reference/architecture/nyash_core_concepts.md
 								- Execution Backends: reference/architecture/execution-backends.md
 								- Lowering Contexts: LOWERING_CONTEXTS.md
 								- LLVM Layer Overview: LLVM_LAYER_OVERVIEW.md
 								- VM Overview: VM_README.md
 								- Cranelift AOT design: backend-cranelift-aot-design.md
 								Note: Some long-form papers reside under `private/papers/reference/architecture/`.