Files
hakorune/docs/reference/language
tomoaki af99ccab91 feat(llvm): Phase 285LLVM-0 - LLVM Conformance One-Pass
Step 0: SSOT/Reality Alignment
- Update Feature Matrix (lifecycle.md):
  - WeakRef: "285A1" → "285LLVM-1"
  - Leak Report: "partial" → "Parent process roots only (285LLVM-0)"
  - Add detailed LLVM limitation explanation
- Update SKIP reason (phase285_weak_basic_llvm.sh): "285A1" → "285LLVM-1"

Step 1: LLVM Leak Report Implementation
- Add emit_leak_report() calls to llvm.rs (success + error paths)
- Create phase285_leak_report_llvm.sh smoke test (3 test cases PASS)
- Add NYASH_LEAK_LOG documentation to environment-variables.md
- Manual test: All 3 cases PASS (no-log, LEVEL=1, LEVEL=2)
- Smoke test: 3/3 PASS

Step 2: WeakRef Design Preparation
- Create phase-285llvm-1-design.md
  - Runtime representation candidate (Option B with caveat)
  - FFI signatures definition
  - Implementation checklist
  - Test strategy
  - NO CODE IMPLEMENTATION (design-only phase)

Implementation:
- Minimal 10-20 line code change (as planned)
- Reuses existing leak_tracker.rs infrastructure
- LLVM limitation transparently documented
- Exit codes unchanged (0/1 preserved)
- Fixture SSOT: apps/tests/*.hako shared between VM/LLVM

Test Results:
-  Manual test: 3/3 cases PASS
-  Smoke test: 3/3 cases PASS
-  No regressions

Files Changed:
- src/runner/modes/llvm.rs (2 emit_leak_report() calls)
- docs/reference/language/lifecycle.md (Feature Matrix + LLVM limitation)
- docs/reference/environment-variables.md (NYASH_LEAK_LOG entry)
- tools/smokes/v2/profiles/quick/lifecycle/phase285_weak_basic_llvm.sh (SKIP reason)

Files Added:
- tools/smokes/v2/profiles/quick/lifecycle/phase285_leak_report_llvm.sh
- docs/development/current/main/phases/phase-285/phase-285llvm-1-design.md

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2025-12-24 09:58:00 +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.
  • See: reference/language/lifecycle.md — Box lifetime, ownership (strong/weak), and finalization (fini) SSOT.

Type system (SSOT)

  • See: reference/language/types.md — runtime truthiness, +/compare/equality semantics, and the role/limits of MIR type facts.

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).