Files
hakorune/docs/reference/language
tomoaki f740e6542f feat(phase285): Complete weak reference implementation (VM + LLVM harness)
Phase 285LLVM-1.1 to 1.4 + weak reference infrastructure:

**LLVM Harness** (Phase 285LLVM-1.x):
- 285LLVM-1.1: User Box registration & debug output
- 285LLVM-1.2: WeakRef basic operations (identity deferred)
- 285LLVM-1.3: InstanceBox field access (getField/setField)
- 285LLVM-1.4: print Handle resolution (type tag propagation)

**VM Runtime** (nyash_kernel):
- FFI functions: nyrt_weak_new, nyrt_weak_to_strong, nyrt_weak_drop
  (crates/nyash_kernel/src/lib.rs: +209 lines)
- WeakRef plugin invoke support
  (crates/nyash_kernel/src/plugin/invoke.rs: +250 lines)
- weak_handles.rs: WeakRef handle registry (NEW)

**LLVM Python Backend**:
- WeakRef instruction lowering (weak.py: NEW)
- Entry point integration (entry.py: +93 lines)
- Instruction lowering (instruction_lower.py: +13 lines)
- LLVM harness runner script (tools/run_llvm_harness.sh: NEW)

**MIR & Runtime**:
- WeakRef emission & validation
- MIR JSON export for weak instructions
- Environment variable support (NYASH_WEAK_*, HAKO_WEAK_*)

**Documentation**:
- CLAUDE.md: Phase 285 completion notes
- LANGUAGE_REFERENCE_2025.md: Weak reference syntax
- 10-Now.md & 30-Backlog.md: Phase 285 status updates

Total: +864 lines, 24 files changed

SSOT: docs/reference/language/lifecycle.md
Related: Phase 285W-Syntax-0, Phase 285W-Syntax-0.1
2025-12-25 00:11:34 +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).