Files
hakorune/docs/reference/language
nyash-codex 525e59bc8d feat(loop-phi): Add body-local variable PHI generation for Rust AST loops
Phase 25.1c/k: Fix ValueId undefined errors in loops with body-local variables

**Problem:**
- FuncScannerBox.scan_all_boxes/1 and BreakFinderBox._find_loops/2 had ValueId
  undefined errors for variables declared inside loop bodies
- LoopFormBuilder only generated PHIs for preheader variables, missing body-locals
- Example: `local ch = s.substring(i, i+1)` inside loop → undefined on next iteration

**Solution:**
1. **Rust AST path** (src/mir/loop_builder.rs):
   - Detect body-local variables by comparing body_end_vars vs current_vars
   - Generate empty PHI nodes at loop header for body-local variables
   - Seal PHIs with latch + continue snapshot inputs after seal_phis()
   - Added HAKO_LOOP_PHI_TRACE=1 logging for debugging

2. **JSON v0 path** (already fixed in previous session):
   - src/runner/json_v0_bridge/lowering/loop_.rs handles body-locals
   - Uses same strategy but for JSON v0 bridge lowering

**Results:**
-  FuncScannerBox.scan_all_boxes: 41 body-local PHIs generated
-  Main.main (demo harness): 23 body-local PHIs generated
- ⚠️ Still some ValueId undefined errors remaining (exit PHI issue)

**Files changed:**
- src/mir/loop_builder.rs: body-local PHI generation logic
- lang/src/compiler/entry/func_scanner.hako: debug logging
- /tmp/stageb_funcscan_demo.hako: test harness

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-19 23:12:01 +09:00
..

Nyash Language Reference Index

This is the entry point for Nyash language documentation.

  • Full Language Reference (2025): reference/language/LANGUAGE_REFERENCE_2025.md
  • Syntax Cheat Sheet: quick-reference/syntax-cheatsheet.md
  • Phase 12.7 Grammar Specs (ternary, sugar; peek → match に統合):
    • Overview: development/roadmap/phases/phase-12.7/grammar-specs/README.md
    • Token/Grammar: development/roadmap/phases/phase-12.7/ancp-specs/ANCP-Token-Specification-v1.md
  • Sugar Transformations (?., ??, |> and friends): parser/sugar.rs (source) and tools/nyfmt/NYFMT_POC_ROADMAP.md
  • Match Expression (pattern matching): see the Language Reference and EBNF (peek was replaced by match)

Statement separation and semicolons

  • See: reference/language/statements.md — newline as primary separator; semicolons optional for multiple statements on one line; minimal ASI rules.

Imports and namespaces

  • See: reference/language/using.md — using syntax, runner resolution, and style guidance.

Variables and scope

  • See: reference/language/variables-and-scope.md — Block-scoped locals, assignment resolution, and strong/weak reference guidance.

Grammar (EBNF)

  • See: reference/language/EBNF.md — Stage2 grammar specification used by parser implementations.
  • Unified Members (stored/computed/once/birth_once): see reference/language/EBNF.md “Box Members (Phase 15)” and the Language Reference section. Default ON (disable with NYASH_ENABLE_UNIFIED_MEMBERS=0).

Member exceptions and handlers (Stage3)

  • Postfix catch/cleanup may be attached to computed/once/birth_once/method blocks when Stage3 is enabled. Stored members (plain name: Type [= expr]) do not support handlers.

Related implementation notes

  • Tokenizer: src/tokenizer.rs
  • Parser (expressions/statements): src/parser/expressions.rs, src/parser/statements.rs
  • MIR Lowering (expressions): src/mir/builder/exprs.rs and friends

Navigation tips

  • The “reference/language/LANGUAGE_REFERENCE_2025.md” is the canonical longform reference; use the Cheat Sheet for quick syntax lookup.
  • Phase 12.7 files capture the finalized sugar and new constructs (match (replaces peek), ternary, nullsafe).