Files
hakorune/docs/guides/style-guide.md
Selfhosting Dev d90216e9c4 📚 Phase 15 - セルフホスティング戦略の明確化とEXE-first実装
## 主な変更点

### 🎯 戦略の転換と明確化
- PyVMを開発ツールとして位置づけ(本番経路ではない)
- EXE-first戦略を明確に優先(build_compiler_exe.sh実装済み)
- Phase順序の整理: 15.2(LLVM)→15.3(コンパイラ)→15.4(VM)

### 🚀 セルフホスティング基盤の実装
- apps/selfhost-compiler/にNyashコンパイラMVP実装
  - compiler.nyash: メインエントリー(位置引数対応)
  - boxes/: parser_box, emitter_box, debug_box分離
- tools/build_compiler_exe.sh: ネイティブEXEビルド+dist配布
- Python MVPパーサーStage-2完成(local/if/loop/call/method/new)

### 📝 ドキュメント整備
- Phase 15 README/ROADMAP更新(Self-Hosting優先明記)
- docs/guides/exe-first-wsl.md: WSLクイックスタート追加
- docs/private/papers/: 論文G~L、爆速事件簿41事例収録

### 🔧 技術的改善
- JSON v0 Bridge: If/Loop PHI生成実装(ChatGPT協力)
- PyVM/llvmliteパリティ検証スイート追加
- using/namespace機能(gated実装、Phase 15では非解決)

## 次のステップ
1. パーサー無限ループ修正(未実装関数の実装)
2. EXEビルドとセルフホスティング実証
3. c0→c1→c1'ブートストラップループ確立

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-15 18:44:49 +09:00

2.3 KiB
Raw Blame History

Nyash Style Guide (Phase 15)

Goals

  • Keep Nyash sources readable and structured. Favor simple, predictable formatting compatible with reversible formatting (nyfmt PoC).

Formatting

  • Indent with 2 spaces (no tabs).
  • Braces: K&R style (opening brace on the same line).
  • Max line length: 100 characters (soft limit).
  • One statement per line. Use semicolons only when placing multiple statements on one physical line.
  • Blank lines: separate toplevel box declarations with one blank line; no trailing blank lines at file end.

Statements and ASI

  • Newline is the primary separator. See reference/language/statements.md.
  • Do not insert semicolons before else.
  • When breaking expressions across lines, break after an operator or keep the expression grouped.

using / include

  • Place all using lines at the top of the file, before code.
  • One using per line; no trailing semicolons.
  • Sort using targets alphabetically; group namespaces before file paths.
  • Prefer as aliases for readability. Aliases should be PascalCase.
  • Keep include adjacent to using group, sorted and one per line.

Naming (conventions for Nyash code)

  • Boxes (types): PascalCase (e.g., ConsoleBox, PathBox).
  • Methods/functions: lowerCamelCase (e.g., length, substring, lastIndexOf).
  • Local variables: concise lowerCamelCase (e.g., i, sum, filePath).
  • Constants (if any): UPPER_SNAKE_CASE.

Structure

  • Toptobottom: using/include → static/box declarations → helpers → main.
  • Keep methods short and focused; prefer extracting helpers to maintain clarity.
  • Prefer pure helpers where possible; isolate I/O in specific methods.

Examples

using core.std as Std
using "apps/examples/string_p0.nyash" as Strings

static box Main {
  escJson(s) {  // lowerCamelCase for methods
    local out = ""
    local i = 0
    local n = s.length()
    loop(i < n) {
      local ch = s.substring(i, i+1)
      if ch == "\\" { out = out + "\\\\" }
      else if ch == "\"" { out = out + "\\\"" }
      else { out = out + ch }
      i = i + 1
    }
    return out
  }

  main(args) {
    local console = new ConsoleBox()
    console.println("ok")
    return 0
  }
}

CI/Tooling

  • Optional formatter PoC: see docs/tools/nyfmt/NYFMT_POC_ROADMAP.md.
  • Keep smoke scripts small and fast; place them under tools/.