docs: add MIR13 mode doc and set PHI-off as default; bridge lowering split (if/loop/try); llvmlite resolver stabilization; curated runner default PHI-off; refresh CURRENT_TASK.md
This commit is contained in:
Selfhosting Dev
12
.github/mlc_config.json
vendored
Normal file
12
.github/mlc_config.json
vendored
Normal file
@ -0,0 +1,12 @@
|
|||||||
|
{
|
||||||
|
"ignorePatterns": [
|
||||||
|
{ "pattern": "^mailto:" },
|
||||||
|
{ "pattern": "^vscode:" },
|
||||||
|
{ "pattern": "^file://" }
|
||||||
|
],
|
||||||
|
"timeout": "10s",
|
||||||
|
"retryOn429": true,
|
||||||
|
"retryCount": 2,
|
||||||
|
"aliveStatusCodes": [200, 206, 429]
|
||||||
|
}
|
||||||
|
|
||||||
34
.github/workflows/docs-link-check.yml
vendored
Normal file
34
.github/workflows/docs-link-check.yml
vendored
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
name: docs-link-check
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
paths:
|
||||||
|
- '**.md'
|
||||||
|
- '.github/workflows/docs-link-check.yml'
|
||||||
|
- '.github/mlc_config.json'
|
||||||
|
pull_request:
|
||||||
|
paths:
|
||||||
|
- '**.md'
|
||||||
|
- '.github/workflows/docs-link-check.yml'
|
||||||
|
- '.github/mlc_config.json'
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
markdown-link-check:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- name: Checkout
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Run markdown-link-check on docs and READMEs
|
||||||
|
uses: gaurav-nelson/github-action-markdown-link-check@v1
|
||||||
|
with:
|
||||||
|
use-quiet-mode: 'yes'
|
||||||
|
use-verbose-mode: 'no'
|
||||||
|
config-file: '.github/mlc_config.json'
|
||||||
|
folder-path: |
|
||||||
|
docs
|
||||||
|
file-path: |
|
||||||
|
README.md
|
||||||
|
README.ja.md
|
||||||
|
CLAUDE.md
|
||||||
|
|
||||||
@ -170,7 +170,7 @@ Flags
|
|||||||
## Commit & Pull Request Guidelines
|
## Commit & Pull Request Guidelines
|
||||||
- Commits: concise imperative subject; scope the change (e.g., "llvm: fix argc handling in nyrt").
|
- Commits: concise imperative subject; scope the change (e.g., "llvm: fix argc handling in nyrt").
|
||||||
- PRs must include: description, rationale, reproduction (if bug), and run instructions.
|
- PRs must include: description, rationale, reproduction (if bug), and run instructions.
|
||||||
- Link issues (`docs/issues/*.md`) and reference affected scripts (e.g., `tools/llvm_smoke.sh`).
|
- Link issues (`docs/development/issues/*.md`) and reference affected scripts (e.g., `tools/llvm_smoke.sh`).
|
||||||
- CI: ensure smokes pass; use env toggles in the workflow as needed.
|
- CI: ensure smokes pass; use env toggles in the workflow as needed.
|
||||||
|
|
||||||
## Security & Configuration Tips
|
## Security & Configuration Tips
|
||||||
|
|||||||
@ -4,9 +4,9 @@
|
|||||||
|
|
||||||
## Start Here (必ずここから)
|
## Start Here (必ずここから)
|
||||||
- 現在のタスク: [CURRENT_TASK.md](CURRENT_TASK.md)
|
- 現在のタスク: [CURRENT_TASK.md](CURRENT_TASK.md)
|
||||||
- 📁 **Main**: [docs/current_task/main/](docs/current_task/main/)
|
- 📁 **Main**: [docs/development/current/main/](docs/development/current/main/)
|
||||||
- 📁 **LLVM**: [docs/current_task/llvm/](docs/current_task/llvm/)
|
- 📁 **LLVM**: [docs/development/current/llvm/](docs/development/current/llvm/)
|
||||||
- 📁 **Self**: [docs/current_task/self_current_task/](docs/current_task/self_current_task/)
|
- 📁 **Self**: [docs/development/current/self_current_task/](docs/development/current/self_current_task/)
|
||||||
- ドキュメントハブ: [README.md](README.md)
|
- ドキュメントハブ: [README.md](README.md)
|
||||||
- 🚀 **開発マスタープラン**: [00_MASTER_ROADMAP.md](docs/development/roadmap/phases/00_MASTER_ROADMAP.md)
|
- 🚀 **開発マスタープラン**: [00_MASTER_ROADMAP.md](docs/development/roadmap/phases/00_MASTER_ROADMAP.md)
|
||||||
- 📊 **JIT統計JSONスキーマ(v1)**: [jit_stats_json_v1.md](docs/reference/jit/jit_stats_json_v1.md)
|
- 📊 **JIT統計JSONスキーマ(v1)**: [jit_stats_json_v1.md](docs/reference/jit/jit_stats_json_v1.md)
|
||||||
|
|||||||
428
CURRENT_TASK.md
428
CURRENT_TASK.md
@ -1,399 +1,49 @@
|
|||||||
# Current Task — Phase 15 Self‑Hosting (2025‑09‑16)
|
# Current Task — Phase 15 Self‑Hosting (2025‑09‑17)
|
||||||
|
|
||||||
TL;DR
|
Summary
|
||||||
- 目標は「自己ホスティング達成」＝ Nyash製パーサで Ny → JSON v0 → Bridge → MIR 実行を安定化すること。
|
- Default execution is MIR13 (PHI‑off). Bridge/Builder do not emit PHIs; llvmlite synthesizes PHIs when needed. MIR14 (PHI‑on) remains experimental for targeted tests.
|
||||||
- PyVM は意味論の参照実行器（開発補助）。llvmlite は AOT/検証。配布やバンドル化は後回し（基礎固めが先）。
|
- PyVM is the semantic reference engine; llvmlite is used for AOT and parity checks.
|
||||||
|
|
||||||
What Changed (today)
|
What Changed (recent)
|
||||||
- Selfhost 経路の安定化（Python MVP 優先→PyVM 実行）。Selfhost Stage‑2（直/Bridge）スモークは緑化。
|
- MIR13 default enabled
|
||||||
- Using/Resolver を Runner 前処理に集約し、BoxIndex（グローバル）＋解決キャッシュを導入。
|
- `mir_no_phi()` default set to true (can disable via `NYASH_MIR_NO_PHI=0`).
|
||||||
- nyash.toml の `[aliases]`/env `NYASH_ALIASES` 対応、候補提示、`NYASH_RESOLVE_TRACE=1` でトレース。
|
- Curated LLVM runner defaults to PHI‑off; `--phi-on` enables MIR14 lane.
|
||||||
- strict プレフィクス: `NYASH_PLUGIN_REQUIRE_PREFIX=1` または `[plugins] require_prefix=true`。
|
- Added doc: `docs/development/mir/MIR13_MODE.md`; README references it.
|
||||||
- per‑plugin meta（`prefix/require_prefix/expose_short_names`）の読取導線を実装（挙動は現状据え置き）。
|
- JSON v0 Bridge lowering split (non‑functional)
|
||||||
- CLI `--using` を追加（`--using "ns as Alias"` / `--using '"apps/foo.nyash" as Foo'`）。
|
- Added `src/runner/json_v0_bridge/lowering/{if_else.rs, loop_.rs, try_catch.rs, merge.rs}` and routed calls from `lowering.rs`.
|
||||||
- フィールドは box 先頭のみルールのリンタを Runner に追加（`NYASH_FIELDS_TOP_STRICT=1` でエラー）。
|
- llvmlite stability for MIR13
|
||||||
- Syntax Torture スイートの実行正規化（末行比較）。一部テスト本文を Nyash 仕様に合わせて修正。
|
- Resolver: forbids cross‑block non‑dominating vmap reuse; for multi‑pred and no declared PHI, synthesizes a localization PHI at block head.
|
||||||
- JSON v0 仕様に Stage‑3 ノード（Break/Continue/Throw/Try）を追記。Parser Stage‑3 設計メモの現状/残課題を更新。
|
- Finalize remains function‑local; `block_end_values` snapshots and placeholder wiring still in place.
|
||||||
- LLVM curated smokes を新設（`tools/smokes/curated_llvm.sh`）。core/async/loop/peek を10s/ケースで実行、PHI‑off も検証可（`--phi-off`）。
|
- Parity runner pragmatics
|
||||||
- LLVM Stage‑3 受理スモークを追加（`tools/smokes/curated_llvm_stage3.sh`）。try/finally・dead throw を10s/ケースで実行。PHI‑off（`--phi-off`）/trap抑止（`NYASH_LLVM_TRAP_ON_THROW=0`）も確認。
|
- `tools/pyvm_vs_llvmlite.sh` compares exit code by default; use `CMP_STRICT=1` for stdout+exit.
|
||||||
- 旧スモークは `tools/smokes/archive/` へ整理（JIT/Cranelift 系は当面対象外）。
|
|
||||||
- Bridge/Builder に PHI 非生成モードを導入（`NYASH_MIR_NO_PHI=1`）。LLVM Resolver 合成と統一し、Verifier は緩和ゲート（`verify_allow_no_phi()`）を追加。
|
|
||||||
- LLVM 側に PHI 合成トレースを追加（`NYASH_LLVM_TRACE_PHI=1`）。jump/finalize/resolve の観測を統一タグで出力。
|
|
||||||
- LLVM Throw を最小降ろし（`llvm.trap`→`unreachable`、`NYASH_LLVM_TRAP_ON_THROW=0` で trap 抑止）。
|
|
||||||
- 環境変数アクセスを `config::env` に集約（`mir_no_phi()`/`verify_allow_no_phi()`/`llvm_use_harness()`）。
|
|
||||||
- dev プロファイル `tools/dev_env.sh phi_off` を追加。ルート清掃ユーティリティ `tools/clean_root_artifacts.sh` を追加。
|
|
||||||
- CI（GH Actions）を curated LLVM（PHI‑on/off）実行に刷新。旧JITジョブは停止。
|
|
||||||
- Verifier: verification.rs 内の compute_* ラッパーを撤去し、全て `verification::utils::*` を直参照に置換。
|
|
||||||
- Parser: `bit_or/xor/and` と `equality/comparison/range/term/shift/factor` に加え、`call/primary` も `parser/expr/` へ分割。`expressions.rs` は委譲ラッパーのみに縮退（互換維持）。
|
|
||||||
- Optimizer(BoxField): 同一ブロック内の set 直後の get（同一 box+index）を Copy に置換する軽量 peephole を追加（load-after-store 短絡）。
|
|
||||||
- LLVM(select/terminators): `function.rs` から `instructions::term_emit_*` を利用しつつ、`normalize_branch_condition()` をブランチ直前で適用する流れを固定化（truthy 正規化の前段フック）。
|
|
||||||
- Runner/env 集約: `src/config/env.rs` に CLI/自ホスト/VM まわりの getter を追加（`cli_verbose()/enable_using()/vm_use_py()/ny_compiler_*()` など）。`runner/selfhost.rs`/`runner/pipe_io.rs`/`runner/modes/common.rs` のホットパスを getter 参照に更新（段階導入）。
|
|
||||||
- VM dispatch: 実装は既に dispatch 中央化済み（`backend::dispatch` 経由）。`NYASH_VM_USE_DISPATCH` フラグの getter を追加（将来の選択切替用）。
|
|
||||||
- Runner/log: `runner/trace.rs` を追加。`cli_verbose()` と `cli_v!` マクロを導入し、`modes/common.rs` の一部情報ログを置換（verbose ガードの明確化）。
|
|
||||||
- Selfhost helpers: PyVM ハーネス実行を `NyashRunner::run_pyvm_harness(..)` として共通化。EXE パーサ経路の JSON 抽出をまとめる `exe_try_parse_json_v0(..)` を追加（段階適用の足場）。
|
|
||||||
|
|
||||||
Refactor Progress (2025‑09‑16, end of day)
|
|
||||||
- Runner: ヘッダ指令スキャンとトレース出力を分離（`runner/cli_directives.rs`, `runner/trace.rs`）。using 解決ログを集約。
|
|
||||||
- LLVM: terminators(select) の足場を追加し、呼び出しを alias 経由に切替（挙動不変）。
|
|
||||||
- Optimizer: パス別に分割し、オーケストレータから委譲（挙動不変の足場）。
|
|
||||||
- `optimizer_passes/{normalize,diagnostics,reorder,boxfield,intrinsics}.rs`
|
|
||||||
- 統計を `optimizer_stats.rs` へ分離。
|
|
||||||
- Verifier: 主要チェックをモジュール化し、`verification.rs` を薄いオーケストレータ化。
|
|
||||||
- `verification/{ssa,dom,cfg,barrier,legacy,awaits,utils}.rs`
|
|
||||||
- AST: `Span` を `ast/span.rs` へ分離し、`ast.rs` は re‑export。
|
|
||||||
- Parser: expressions を段階分割（ternary/coalesce/logic を `parser/expr/*` へ）。
|
|
||||||
|
|
||||||
Remaining Refactors (Phase‑15 mainline)
|
|
||||||
- Verifier（仕上げ）
|
|
||||||
- `verification.rs` 内の `compute_*` ラッパーを完全撤去し、全呼び出しを `verification::utils` に集約。
|
|
||||||
- テスト追加: reachability/phi/await チェックの簡易ケース（任意）。
|
|
||||||
- Parser（段階分割の続き）
|
|
||||||
- `bit_or/bit_xor/bit_and`、`comparison/range/term/shift/factor` を `parser/expr/` へ移動し、`parse_expression` チェインを維持。
|
|
||||||
- `call/primary` は最後に移動（依存が多いため）。
|
|
||||||
- AST（構造の分離）
|
|
||||||
- `ast/nodes/{structure,expression,statement}.rs` へノード定義を分離し、`ast.rs` は `pub use` 集約のみへ縮退。
|
|
||||||
- Optimizer（足場→実装へ）
|
|
||||||
- `reorder/boxfield/intrinsics` の実装を段階導入（まず small win: CSE のキーフィルタ改善、boxfield の load-after-store）。
|
|
||||||
- `normalize` の terminator 側の補完（未移行箇所があれば寄せる）。
|
|
||||||
- Runner/env 集約
|
|
||||||
- ホットパスの環境参照を `config::env` getter へ置換（残件: VM trace/diagnostics の一部）。
|
|
||||||
- Runner/log 整理（第2〜第3弾）
|
|
||||||
- 情報ログ（verbose 連動）を `cli_v!` に一本化。エラー系は従来通り eprintln のまま。
|
|
||||||
- Selfhost EXE 経路の関数抽出（仕上げ）
|
|
||||||
- 既存の EXE‑first ブロックを `exe_try_parse_json_v0(..)` を用いた薄い分岐に縮退（挙動不変）。
|
|
||||||
- LLVM select/terminators（実装化）
|
|
||||||
- `select` に truthy 規約の軽い正規化を追加（等価変換のみ）。
|
|
||||||
- `terminators` へ実体移動（`flow` からの段階的差し替え）。
|
|
||||||
- VM dispatch（段階導入）
|
|
||||||
- `NYASH_VM_USE_DISPATCH=1` フラグを導入し、無副作用命令から `backend/dispatch.rs` 経由に切替。
|
|
||||||
|
|
||||||
Notes
|
|
||||||
- すべて挙動等価の範囲で段階的に進める。足場化したモジュールは後続で実装を徐々に移す。
|
|
||||||
|
|
||||||
Self‑Hosting plumbing (2025‑09‑16, later in day)
|
|
||||||
- Runner: 自己ホスト経路で子プログラム（`apps/selfhost-compiler/compiler.nyash`）を優先実行し、`--read-tmp` 常時付与で安定運用に変更。
|
|
||||||
- PyVM 優先の統一（`NYASH_VM_USE_PY=1`）は EXE/inline/child の全分岐で尊重。
|
|
||||||
- CLI: `--stage3` を追加（`NYASH_NY_COMPILER_STAGE3=1` を設定）。
|
|
||||||
- Script args パススルー（B案）実装: `nyash ... FILE -- arg1 arg2` → `NYASH_SCRIPT_ARGS_JSON=["arg1","arg2"]` として `Main.main(args)` に ArrayBox で注入。
|
|
||||||
- Interpreter: `ArrayBox.of(...)` を追加して初期配列を簡潔に構築。
|
|
||||||
- Runner: Python MVP は `NYASH_NY_COMPILER_SKIP_PY=1` でスキップ可能（自己ホスト子を優先）。
|
|
||||||
|
|
||||||
|
|
||||||
Decision (Phase‑15 wrap‑up)
|
|
||||||
- MIR13 移行（PHI 非生成）: Phase‑15 の締めとして、MIR 生成層（Bridge/Builder）は PHI を生成しない方針に切替。PHI 合成は LLVM 層（llvmlite/Resolver）に集約。
|
|
||||||
- LoopForm は次フェーズ（MIR18）で導入: まずは MIR14 を維持し、次フェーズで `LoopHeader/Enter/Latch` 等の占位命令を追加。現行 Phase‑15 は CFG パターン検知でループ搬送値を合成。
|
|
||||||
- 例外は段階導入: Throw/Catch は現行維持（Bridge ゲートで出力可）。Try/Finally の構造化は将来の TryRegion で検討。
|
|
||||||
|
|
||||||
Next Focus (Throw/Try — LLVM first)
|
|
||||||
- ブリッジ設計: `emit_degraded_throw` の差し替え方針を策定し、JSON v0 `Try` ノード → MIR 変換の仕様を決める（Stage-3 例外モデル）。
|
|
||||||
- MIR Builder/Runtime 調査: Rust VM/PyVM の `ControlFlow::Throw` 経路と既存 TryCatch 降格の挙動を整理。必要に応じて docs と CURRENT_TASK に反映。
|
|
||||||
- PyVM 設計: 例外モデルをどこまで Python 側に実装するか決め、最小テスト計画を用意。
|
|
||||||
- LLVM 実装方針: Throw/Try の MIR 命令を LLVM 側がどう扱うか（panic扱い or fallback）を設計し、smoke 更新案を作る（現状 Throw は trap/unreachable 最小降ろし完了）。
|
|
||||||
- テスト計画: JSON フィクスチャと `tools/llvm_smoke.sh` を中心に Stage-3 例外用のスモーク/単体テストを整備。
|
|
||||||
|
|
||||||
Open Items (handoff)
|
|
||||||
- Selfhost Stage‑3 E2E smoke（Runner→子→JSON→Bridge）の最終緑化
|
|
||||||
- 現状: 子へ `--read-tmp` は付与済み。`--stage3` は env→子へ透過済み。
|
|
||||||
- 直近 TODO: tools/selfhost_stage3_accept_smoke.sh を Runner 優先経路に再調整し、`NYASH_NY_COMPILER_SKIP_PY=1` 併用で安定化。
|
|
||||||
- 期待値: try/finally/break/continue/throw(accept) で exit=0（degrade 経路）
|
|
||||||
- CLI argv 前処理の挙動監視
|
|
||||||
- `--` なしの通常実行での Positional FILE 受理を再検証（Clapの警告再現時は build_command の宣言順/Arg要件を再点検）。
|
|
||||||
- LLVM: Throw 実投げの終了コード方針を決定し、trap on/off の期待値を固定化。
|
|
||||||
|
|
||||||
Next Steps (suggested order)
|
|
||||||
1) Selfhost Stage‑3 E2E 緑化（smoke 修正 → 確認）
|
|
||||||
2) CLI FILE positional の回帰があれば即修正（Clap設定の微調整）
|
|
||||||
3) LLVM Throw 実投げの設計（終了コード/シグナル）＋スモーク
|
|
||||||
4) Runner 実装の集約（modes/common → selfhost.rs）と微ノイズ削減
|
|
||||||
5) CI に Selfhost Stage‑2/E2E（軽量）をオプションで追加
|
|
||||||
|
|
||||||
※ Cranelift/JIT 系は当面対象外。ビルド時も LLVM のみを有効化（JIT 関連 feature/CI は無視）。
|
|
||||||
|
|
||||||
Runner updates (2025‑09‑16)
|
|
||||||
- Selfhost pipeline: PyVM 優先（`NYASH_VM_USE_PY=1`）を全分岐で適用（EXE/inline/child 経路の一貫性）。
|
|
||||||
- 重複関数の整理: `modes/common.rs::try_run_ny_compiler_pipeline` は `selfhost.rs::try_run_selfhost_pipeline` に委譲（ドリフト防止）。
|
|
||||||
- Stage‑3 受理導線: `NYASH_NY_COMPILER_STAGE3=1` で子プロセスに `--stage3` を付与。inline フォールバックは `stage3_enable(1)` を既定有効化。
|
|
||||||
|
|
||||||
- llvmlite/AOT（本戦）強化 — コアコレクション配線とエントリ統一
|
|
||||||
- Array/Map の BoxCall を NyRT ハンドルAPIに直結：
|
|
||||||
- Array: `push`→`nyash.array.push_h`、`length/len`→`nyash.any.length_h`
|
|
||||||
- Map: `set`→`nyash.map.set_hh`、`get`→`nyash.map.get_hh`、`has`→`nyash.map.has_hh`、`size`→`nyash.any.length_h`
|
|
||||||
- `ny_main` を i64 戻りに統一し、`Main.main/1` を優先（既定 args は `new ArrayBox()`）。
|
|
||||||
- Core Box 生成の安定化：`nyash.array.birth_h` / `nyash.map.birth_h` を追加し、llvmlite `new` は birth_h を優先。
|
|
||||||
- AOT 実行確認：
|
|
||||||
- `[1,2,3].length()` → `Result: 3`
|
|
||||||
- `{"name":"Alice","age":25}.size()` → `Result: 2`
|
|
||||||
- `m.has("name") ? m.get("name").length() : 0` → `Result: 5`
|
|
||||||
|
|
||||||
|
|
||||||
Quick Next (today)
|
|
||||||
- いよいよ「Nyash で書く」段階へ（Self‑Hosting 実装の着手）：
|
|
||||||
1) ParserBox 拡張（Stage‑2 の堅牢化・回帰修正）✅ Done 2025‑09‑16
|
|
||||||
- bool/null リテラルと空 RHS（代入/return/local）を Int(0) フォールバックで正規化。
|
|
||||||
- simple assignment → Local 正常化を `==` 判定と共に調整。
|
|
||||||
- 三項演算子 `cond ? a : b` を `Ternary` ノードに正規化し、自走スモーク追加。
|
|
||||||
2) EmitterBox 拡張（JSON v0 の安定化）✅ Done 2025‑09‑16
|
|
||||||
- `meta.usings` を常時出力（空は `[]`）。
|
|
||||||
3) Resolver/BoxIndex の prefix メタ反映 ✅ Done 2025‑09‑16
|
|
||||||
- `plugin_meta_by_box` を構築し、`require_prefix` / `expose_short_names` を `resolve_using_target` へ適用。
|
|
||||||
- `NYASH_PLUGIN_REQUIRE_PREFIX` が無効でも per-plugin meta で短名禁止を検知。
|
|
||||||
4) Parser Stage‑3 下地 ✅ Done 2025‑09‑16
|
|
||||||
- `ParserBox.stage3_enable()` を追加し、Break/Continue/Throw/Try を JSON v0 に出力できるゲートを実装。
|
|
||||||
- `--stage3` CLI フラグから ParserBox へ渡す導線を追加。
|
|
||||||
- `docs/reference/architecture/parser_mvp_stage3.md` に Stage‑3 設計を記録。
|
|
||||||
5) 自己ホスト経路で Ny 実装切替のゲート準備（現状は Python MVP 優先を維持）。
|
|
||||||
6) テスト:
|
|
||||||
- `source tools/dev_env.sh pyvm`
|
|
||||||
- `NYASH_VM_USE_PY=1 ./tools/selfhost_stage2_smoke.sh`
|
|
||||||
- `NYASH_VM_USE_PY=1 ./tools/selfhost_stage2_bridge_smoke.sh`
|
|
||||||
- Torture（VM中心）: `(cd tests/nyash_syntax_torture_20250916 && BACKENDS="vm" NYASH_BIN=../../target/release/nyash bash run_spec_smoke.sh)`
|
|
||||||
- LLVM Stage‑3 smoke (手動): `NYASH_LLVM_STAGE3_SMOKE=1 ./tools/llvm_smoke.sh release`
|
|
||||||
- Runner/Bridge 実行系
|
|
||||||
- `--ny-parser-pipe` は `NYASH_PIPE_USE_PYVM=1` で PyVM に委譲（exit code 判定に統一）。
|
|
||||||
- 自己ホスト JSON 生成は Python MVP を優先、LLVM EXE/インラインVMを段階フォールバック。
|
|
||||||
- Runner 分割（第1弾〜第2弾）: `dispatch.rs` へ backend 分岐を集約、`tasks.rs`/`build.rs`/`demos.rs` へ職責分離。`mod.rs` を薄型化。
|
|
||||||
- LLVM Codegen リファクタ（第1弾〜第2弾）
|
|
||||||
- `codegen/utils.rs` を新設し `sanitize_symbol`/`build_const_str_map` を抽出。
|
|
||||||
- `codegen/function.rs` を追加し `lower_one_function` を完全移管（呼び出しは `function::lower_one_function`）。
|
|
||||||
- 旧レガシー断片コメントを除去して軽量化。機能・出力は不変。
|
|
||||||
- MIR Builder 整理（小分割）
|
|
||||||
- `builder/vars.rs` を追加し、Lambda の自由変数収集ロジックを外出し。
|
|
||||||
- 既存の `LoopBuilder`/`phi` 分割方針は維持（今後 small utils を `loops.rs` に抽出予定）。
|
|
||||||
|
|
||||||
Current Status
|
Current Status
|
||||||
- Stage‑2: 自己ホスト → JSON v0 → PyVM の代表スモークは緑（配列/文字列/論理/if/loop）。
|
- Self‑hosting Bridge → PyVM smokes: PASS (Stage‑2 reps: array/string/logic/if/loop).
|
||||||
- Stage‑3: 構文受理のみ完了（break/continue/throw/try/catch/finally）。現時点では JSON 降格（no‑op/Expr）で安全受理。
|
- Curated LLVM (PHI‑off default): PASS.
|
||||||
- Runner: Using/Resolver を前処理に統合（BoxIndex/キャッシュ/strict）。`--ny-parser-pipe` は PyVM 委譲（exit code 判定）。
|
- Curated LLVM (PHI‑on experimental): `apps/tests/loop_if_phi.nyash` shows a dominance issue (observed; not blocking, MIR13 recommended).
|
||||||
- llvmlite/AOT: Array/Map の基本操作（push/get/set/has/size, length）が NyRT ハンドルAPIで動作。`ny_main` は i64 戻り・`Main.main/1` 優先で起動。
|
|
||||||
- ログ: verbose 出力の一部を `cli_v!` で共通化（引き続き適用範囲を拡大中）。
|
|
||||||
|
|
||||||
Open
|
Next (short plan)
|
||||||
- Bridge/PHI の正規化: 短絡（入れ子）における merge/PHI incoming を固定化（rhs_end/fall_bb の順序）。
|
1) JSON v0 lowering: split remaining helpers (peek/ternary/expr) without behavior change.
|
||||||
- JSON v0 の拡張方針: break/continue/try/catch/finally の表現（受け皿設計 or 受理時の事前降下）。➡ `docs/reference/architecture/parser_mvp_stage3.md`
|
2) PHI‑on lane (optional): investigate `loop_if_phi` dominance by tightening finalize ordering and resolver materialization (low priority).
|
||||||
- per‑plugin meta の反映: `require_prefix/expose_short_names/prefix` を Resolver 挙動へ段階適用（導線は実装済み）。✅ 2025‑09‑16 prefix enforcement とテスト追加済み。
|
3) Runner refactor (small PRs):
|
||||||
- `me` の扱い: MVP は `NYASH_BRIDGE_ME_DUMMY=1` の仮注入を継続（将来撤去）。
|
- `selfhost/{child.rs,json.rs}` split; `modes/common/{io,resolve,exec}.rs` split; reduce `runner/mod.rs` surface.
|
||||||
- LLVM 直結（任意）: JSON v0 → LLVM の導線追加は後回し。
|
4) Optimizer/Verifier thin‑hub cleanup (non‑functional): orchestrator minimalization and pass boundaries clarified.
|
||||||
|
|
||||||
- NyRT 整頓:
|
How to Run
|
||||||
- FFI ヘルパー化（handles/boxing 正規化）／birth_h→new_i64x 統合／Core Box のプラグイン事前登録／FFI エクスポートのマクロ化。
|
- PyVM reference smokes: `tools/pyvm_stage2_smoke.sh`
|
||||||
- llvmlite 整頓:
|
- Bridge → PyVM smokes: `tools/selfhost_stage2_bridge_smoke.sh`
|
||||||
- boxcall のテーブル駆動化、追加 API（delete/keys/values など）の段階配線。
|
- LLVM curated (PHI‑off default): `tools/smokes/curated_llvm.sh`
|
||||||
|
- LLVM PHI‑on (experimental): `tools/smokes/curated_llvm.sh --phi-on`
|
||||||
|
- Parity (AOT vs PyVM): `tools/pyvm_vs_llvmlite.sh <file.nyash>` (`CMP_STRICT=1` to enable stdout check)
|
||||||
|
|
||||||
Plan (to Self‑Hosting)
|
Key Flags
|
||||||
1) Phase‑1: Stage‑2 完了＋堅牢化（今ここ）
|
- `NYASH_MIR_NO_PHI` (default 1): PHI‑off when 1 (MIR13). Set `0` for PHI‑on.
|
||||||
- 正常系スモークを自己ホスト直/Bridge（PyVM）で常緑化（追加分を反映済み）。
|
- `NYASH_VERIFY_ALLOW_NO_PHI` (default 1): relax verifier for PHI‑less MIR.
|
||||||
- 進捗ガードの継続検証（不完全入力セット）。
|
- `NYASH_LLVM_USE_HARNESS=1`: route AOT through llvmlite harness.
|
||||||
2) Phase‑2: Bridge 短絡/PHI 固定＋パリティ収束
|
- `NYASH_LLVM_TRACE_PHI=1`: trace PHI resolution/wiring.
|
||||||
- 入れ子短絡の merge/PHI incoming を固定し、stdout 判定でスモークを緑化。
|
|
||||||
- PyVM/llvmlite パリティを常時緑（代表ケースを exit code 判定へ統一）。
|
|
||||||
3) Phase‑3: 構文受理の拡張（完了）→ Bootstrap c0→c1→c1’
|
|
||||||
- 受理のみ: break/continue/throw/try-catch-finally（実行意味論は降格）。
|
|
||||||
- emit‑only で c1 を生成→既存経路にフォールバック実行、正規化 JSON 差分で等価を確認。
|
|
||||||
|
|
||||||
How to Run (dev)
|
|
||||||
- 推奨環境: `source tools/dev_env.sh pyvm`（PyVM を既定。Bridge→PyVM 直送）
|
|
||||||
- 自己ホスト（子経路 ON）: `NYASH_USE_NY_COMPILER=1`
|
|
||||||
- 安全弁: `NYASH_NY_COMPILER_TIMEOUT_MS=2000`、emit‑only 既定: `NYASH_NY_COMPILER_EMIT_ONLY=1`
|
|
||||||
|
|
||||||
Smokes
|
|
||||||
- 無限ループ防止: `./tools/selfhost_progress_guard_smoke.sh`
|
|
||||||
- 自己ホスト → Interpreter（BoxCallなし集合）: `./tools/selfhost_stage2_smoke.sh`
|
|
||||||
- 自己ホスト → JSON → PyVM（Array/String/Console 含む）: `./tools/selfhost_stage2_bridge_smoke.sh`
|
|
||||||
- 動作確認（ローカル）
|
|
||||||
- VM: `./target/debug/nyash --backend vm apps/tmp_hello.nyash`（Result: 0）
|
|
||||||
- LLVM モック: `./target/debug/nyash --backend llvm apps/tmp_hello.nyash`
|
|
||||||
- PyVM/Stage‑2: `tools/pyvm_stage2_smoke.sh`（All PASS）
|
|
||||||
- Bridge/Stage‑2: `tools/ny_stage2_bridge_smoke.sh`（All PASS）
|
|
||||||
|
|
||||||
Notes / Policies
|
Notes / Policies
|
||||||
- PyVM は意味論の参照実行器として運用（exit code 判定を基本）。
|
- Focus is self‑hosting stability. JIT/Cranelift is out of scope (safety fixes only).
|
||||||
- Bridge は JSON v0 → MIR 降下で PHI を生成（Phase‑15 中は現行方式を維持）。
|
- PHI generation remains centralized in llvmlite; Bridge/Builder keep PHI‑off by default.
|
||||||
- 配布/バンドル/EXE 化は任意の実験導線として維持（Phase‑15 の主目的外）。
|
- No full tracing GC yet; handles/Arc lifetimes govern object retention. Safepoint/barrier/roots are staging utilities.
|
||||||
|
|
||||||
Smoke Snapshot (2025‑09‑15)
|
|
||||||
- 修正: `runner/dispatch.rs` に `vm` 分岐が欠落しており `--backend vm` が interpreter にフォールバックしていたため、PyVM スモークが作動せず。分岐を追加して復旧済み。
|
|
||||||
- PyVM Stage‑2 部分結果:
|
|
||||||
- PASS: string ops basic, me method call
|
|
||||||
- FAIL: loop/if/phi → 出力 `sum=4`（期待 `sum=9`）
|
|
||||||
- 原因分析: ループ内 if の merge で `sum` の Phi 正規化が入らず、latch 側スナップショットが else 系の一時値を優先（`16`）しうる構造。`LoopBuilder::build_statement(If)` が `normalize_if_else_phi` 相当を呼ばず、変数マップが φ 統合されていない。
|
|
||||||
- 対応方針（最小修正）:
|
|
||||||
- LoopBuilder の If 降下で merge 到達時に「両枝が同一変数に代入」の場合は `phi(dst=[then,else])` を emit→その φ を対象変数に bind。
|
|
||||||
- latch スナップショットはこの φ 後の変数マップで採取する。
|
|
||||||
- 代替（短期）: Builder 側の `normalize_if_else_phi` を呼ぶ薄いフックを設けて流用。
|
|
||||||
|
|
||||||
Fixes Applied (2025‑09‑15)
|
|
||||||
- LoopBuilder If 降下に φ 正規化を追加（両枝代入の変数を merge 時に φ で束ねて再束縛）。
|
|
||||||
- PyVM φ 解決ロジックを安定化（incoming を [value, pred] 形に限定し、[pred, value] の曖昧推測を削除）。偶然一致による誤選択を排除。
|
|
||||||
- これにより `tools/pyvm_stage2_smoke.sh` は全 PASS を確認済み。
|
|
||||||
|
|
||||||
Refactor Candidates (early plan)
|
|
||||||
- runner/mod.rs（~70K chars）: “runner pipeline” を用途別に分割（TODO #15）
|
|
||||||
- runner/pipeline.rs（入力正規化/using解決/環境注入）
|
|
||||||
- runner/pipe_io.rs（stdin/file の JSON v0 受理・整形）
|
|
||||||
- runner/selfhost.rs（自己ホスト EXE/VM/Python フォールバック、timeout/ログ含む）
|
|
||||||
- runner/dispatch.rs（backend 選択と実行、PyVM 委譲）
|
|
||||||
- 既存 json_v0_bridge/mir_json_emit は流用、mod.rs から薄いファサードに縮退。
|
|
||||||
- backend/llvm/compiler/codegen（責務分割の継続）
|
|
||||||
- 済: utils 抽出、`lower_one_function` を `function.rs` へ移管。
|
|
||||||
- 次: 終端系・選択系の薄層切り出し。
|
|
||||||
- `instructions/terminators.rs`: return/jump/branch の分岐ドライバ（emit_* 呼び出し集約）。
|
|
||||||
- `instructions/select.rs`: 条件・短絡・PHI 前処理（sealed-SSA 前提の前段正規化）。
|
|
||||||
- 目標: `function.rs` の見通し改善（1関数=制御フロー骨格）、テスト容易化。
|
|
||||||
- mir/builder.rs（ヘッダ~80行、全体~1K行）
|
|
||||||
- 既に多くを modules に分割済み。残る “variable/phi 合流”“loop ヘッダ/出口管理” を builder/loops.rs / builder/phi.rs に抽出。
|
|
||||||
- 目標: 依存関係（utils/exprs/stmts）を維持したまま、1ファイル1責務を徹底。
|
|
||||||
|
|
||||||
Recommended Next (short list)
|
|
||||||
- LLVM Codegen（B 継続）
|
|
||||||
- `instructions/terminators.rs` を新設し、`function.rs` から終端分岐（return/jump/branch）を移譲。
|
|
||||||
- `instructions/select.rs` を新設し、条件/短絡/PHI 前処理（sealed-SSA 前提の軽い正規化）を集約。
|
|
||||||
- `function.rs` は「BB 周回＋各 lowering 呼び出し」の骨格のみへ縮退。
|
|
||||||
- MIR Builder（C 継続）
|
|
||||||
- `builder/loops.rs` を新設し、ループのヘッダ/出口の小物ユーティリティを抽出（`LoopBuilder` の補助レイヤ）。
|
|
||||||
|
|
||||||
Refactor Plan (MIR Core / Parser / Runner)
|
|
||||||
|
|
||||||
- MIR Core（中〜高）
|
|
||||||
- 問題点
|
|
||||||
- `optimizer.rs` と `verification.rs` に処理が集中し、追加パスや検証増に弱い構造（巨大化: 994/980 行規模）。
|
|
||||||
- 提案
|
|
||||||
- パス駆動に分割: `mir/passes/{dce.rs, ssa.rs, const_fold.rs, simplify.rs}` と `MirPass` トレイト（`run(&mut MirModule)`）。
|
|
||||||
- 進捗: dce/cse 抽出済み、`MirPass` 骨格導入済み。次は normalize 系の抽出を段階実施。
|
|
||||||
- `optimizer.rs` はパイプライン組立（順序・ゲート・Stats 集約）に縮小。
|
|
||||||
- `verification.rs` もカテゴリ分割（ブロック整合性、SSA/PHI、型整合）。失敗メッセージ表現の一貫化（hintを統一）。
|
|
||||||
|
|
||||||
- Parser/Tokenizer（中）
|
|
||||||
- 問題点
|
|
||||||
- `parser/expressions.rs`（~986行）、`parser/statements.rs`（~562行）、`tokenizer.rs`（~863行）が肥大。
|
|
||||||
- 提案
|
|
||||||
- Pratt/precedence テーブル化で演算子別分岐の重複削減。
|
|
||||||
- 共通エラー生成ユーティリティで `expected(...)` メッセージを統一。
|
|
||||||
- `tokenizer.rs` を `tokens.rs`（定義）と `lexer.rs`（実装）に分離。テストは `tests/lexer_*.rs` へ退避。
|
|
||||||
|
|
||||||
- Runner（中）
|
|
||||||
- 問題点
|
|
||||||
- `runner/modes/common.rs`（~734行）、`runner/mod.rs`（~597行）に CLI/環境フラグ/実行分岐が混載。
|
|
||||||
- 提案
|
|
||||||
- `runner/modes/common/` ディレクトリ化し、CLI引数処理・環境フラグ解決・モードディスパッチを分離。
|
|
||||||
- 重複ログ/検証を共通ヘルパへ集約。
|
|
||||||
|
|
||||||
- `builder/vars.rs` に SSA 変数正規化の小物を段階追加（変数名再束縛/スコープ終端の型ヒント伝搬など）。
|
|
||||||
- Runner（仕上げ）
|
|
||||||
- `mod.rs` の残置ヘルパ（usingの候補提示・環境注入ログ）を `pipeline/dispatch` へ集約し、`mod.rs` を最小のオーケストレーションに。
|
|
||||||
- Namespaces Phase‑1（実装着手）: BoxIndex 構築・3段階解決・toml aliases・曖昧エラー改善・トレース
|
|
||||||
|
|
||||||
Smoke Policy (Phase‑15)
|
|
||||||
- PyVM: 一部チェックのみ（async/nowait/await/GC/sync は対象外）
|
|
||||||
- LLVM: フル対応（llvmlite harness）。`tools/smokes/curated_llvm.sh [--phi-off]` を利用
|
|
||||||
- JIT: 未整備（JIT向けスモークは `tools/smokes/archive/` に移管）
|
|
||||||
- Stage‑3 acceptance（Bridge 経路）: `tools/ny_stage3_bridge_accept_smoke.sh`（Try/Break/Continue/Throw を JSON v0 で受理できることを確認）
|
|
||||||
|
|
||||||
Next Phase — Selfhost Parser/Compiler in Nyash（着手準備完了）
|
|
||||||
- 目的: Nyash スクリプトで Parser/Emitter を実装し、Ny → JSON v0 → Bridge → MIR 実行の自己ホスト路線に移行。
|
|
||||||
- ステップ（最小 MVP）:
|
|
||||||
1) `apps/selfhost-compiler/` に ParserBox/EmitterBox を Nyash で実装（Stage‑2 構文、JSON v0 出力）。
|
|
||||||
2) ランナーに `NYASH_USE_NY_COMPILER=1` ゲートを追加し、子プロセス/pipe で JSON v0 を受け取って Bridge→MIR 実行。
|
|
||||||
3) curated LLVM スモークの一部を自己ホスト経路で通す（PyVMは非対象、LLVMで検証）。
|
|
||||||
4) CI に自己ホスト最小ジョブを追加（timeout/静音運用、PHI‑on 既定）。
|
|
||||||
- ガード/ポリシー:
|
|
||||||
- 既存 Rust Parser/Emitter はフォールバックとして保持（`NYASH_SKIP_TOML_ENV=1` で隔離可能）。
|
|
||||||
- 仕様差が出た場合は LLVM 側の意味論に合わせて Nyash 実装を調整。
|
|
||||||
|
|
||||||
MIR13 Plan（Phase‑15 終盤）
|
|
||||||
- Bridge/Builder: PHI を生成しない（受理は維持）。If/Loop の合流は LLVM Resolver に任せる。
|
|
||||||
- llvmlite: Resolver を使い、BB 先頭で PHI 合成。ループは preheader/cond/body の CFG から搬送値を復元（break は exit 側でマージ）。
|
|
||||||
- Smoke: LLVM はまず loop‑only（break/continue）を常時緑化。例外系（throw/try）は IR 降ろし込み整備後に復帰。
|
|
||||||
- 詳細設計: `docs/private/papers/paper-e-loop-signal-ir/mir-evolution-plan.md` に MIR14→MIR13→MIR17 の段階的移行計画を記載。
|
|
||||||
|
|
||||||
Array/Map Literals Plan（Syntax Sugar）
|
|
||||||
- Stage‑1: Array literal `[e1, e2, ...]` を実装（ゲート: `NYASH_SYNTAX_SUGAR_LEVEL=basic|full` または `NYASH_ENABLE_ARRAY_LITERAL=1`）。
|
|
||||||
- Lowering: `new ArrayBox()` → 各要素を評価 → `.push(elem)` を左から右に順に発行 → 最後に配列値を返す。
|
|
||||||
- 末尾カンマ許可。
|
|
||||||
- スモーク: `apps/tests/array_literal_basic.nyash`（size/順序/副作用1回性）。
|
|
||||||
- Stage‑2: Map literal `{ "k": v, ... }`（文字列キー限定）を実装（ゲート: `NYASH_SYNTAX_SUGAR_LEVEL=basic|full` or `NYASH_ENABLE_MAP_LITERAL=1`）。
|
|
||||||
- Lowering: `new MapBox()` → 各ペアを評価 → `.set("k", v)` を左から右に順に発行 → 最後に map 値を返す。
|
|
||||||
- 末尾カンマ許可。識別子キー糖 `{name: v}` は次フェーズ。
|
|
||||||
- スモーク: `apps/tests/map_literal_basic.nyash`（size/get/順序検証）。
|
|
||||||
- Stage‑3: 識別子キー糖 `{name: v}` と末尾カンマを強化（任意）。
|
|
||||||
|
|
||||||
Gates / Semantics
|
|
||||||
- 左から右で評価（一度だけ）。push/set 失敗は即時伝播（既存 BoxCall 規約に追従）。
|
|
||||||
- IR 変更なし（BoxCall/MethodCall のみ）。将来 `with_capacity(n)` 最適化は任意で追加。
|
|
||||||
|
|
||||||
Decision Log (2025‑09‑15)
|
|
||||||
- Q: 警告削減（`ops_ext.rs` / `selfhost.rs`）を先にやる？それとも挙動スモークを先に回す？
|
|
||||||
- A: スモークを先に実施。理由は以下。
|
|
||||||
- リファクタ直後は回帰検出を最優先（PyVM/自己ホスト/Bridge の3レーンで即座に検証）。
|
|
||||||
- 警告削減は挙動非変化を原則とするが、微妙なスコープや保存スロットの触りが混入し得るため、先に“緑”を固める。
|
|
||||||
Namespaces / Using（現状）
|
|
||||||
- 解決順（決定性）: 1) ローカル/コア → 2) エイリアス（nyash.toml/env）→ 3) 相対/using.paths → 4) プラグイン（短名/qualified）
|
|
||||||
- 曖昧時はエラー＋候補提示（qualified または alias を要求）。
|
|
||||||
- モード切替: Relaxed（既定）/Strict（`NYASH_PLUGIN_REQUIRE_PREFIX=1` または toml `[plugins] require_prefix=true`）
|
|
||||||
- needs 糖衣は using の同義（Runner で alias 登録）。
|
|
||||||
- Plugins は統合名前空間。qualified `network.HttpClient` 常時許可。
|
|
||||||
- nyash.toml（MVP）: `[aliases]`/`[plugins]`（グローバル `require_prefix` のみ反映。per‑plugin は導線のみ）
|
|
||||||
- Index とキャッシュ（Runner）:
|
|
||||||
- BoxIndex（グローバル）: `plugin_boxes`, `aliases` を保持。plugins init 後に構築。
|
|
||||||
- Resolve Cache（グローバル）: `tgt|base|strict|paths` キーで再解決回避。
|
|
||||||
- `NYASH_RESOLVE_TRACE=1`: 解決手順/キャッシュヒット/未解決候補をログ出力。
|
|
||||||
|
|
||||||
- スモークが緑＝基礎健全性確認後に、静的ノイズの除去を安全に一気通貫で行う。
|
|
||||||
|
|
||||||
**AOT Quick**
|
|
||||||
- Array literal: `NYASH_SYNTAX_SUGAR_LEVEL=basic ./tools/build_llvm.sh tmp/aot_array_literal_main.nyash -o app && ./app`
|
|
||||||
- Map literal: `NYASH_SYNTAX_SUGAR_LEVEL=basic NYASH_ENABLE_MAP_LITERAL=1 ./tools/build_llvm.sh tmp/aot_map_literal_main.nyash -o app && ./app`
|
|
||||||
|
|
||||||
Refactoring Plan (Phase‑15 follow‑up)
|
|
||||||
- 背景: 巨大ファイル（AST/MIR/LLVM）が保守コスト増の主因。機能非変化の小刻みリファクタで視認性と変更容易性を上げる。
|
|
||||||
|
|
||||||
- 目的と範囲（非機能変更・段階適用）
|
|
||||||
1) AST（src/ast.rs:1）: 定義とヘルパの分離、将来のサブenum活用導線の整備（現行API互換）。
|
|
||||||
2) MIR Builder（src/mir/builder.rs:1）: build_module の骨格化・責務分離、既存分割（builder/*）の徹底。
|
|
||||||
3) Python LLVM（src/llvm_py/llvm_builder.py:1）: lower_function の前処理/本体分離、lower_block の責務拡張。
|
|
||||||
4) MIR 命令（src/mir/instruction.rs:1）: 構造体+トレイト導線の導入（enum への委譲を維持した非破壊移行）。
|
|
||||||
|
|
||||||
- 実施順（小PR単位、CI緑維持）
|
|
||||||
PR‑1: AST utils 抽出（非破壊）
|
|
||||||
- 追加: `src/ast/utils.rs` に classify/info/span/to_string などのヘルパを移設。
|
|
||||||
- `src/ast.rs` は ASTNode/StructureNode/ExpressionNode/StatementNode の定義中心に縮退。
|
|
||||||
- 互換維持: `pub use ast::utils::*;` で既存呼び出しを壊さない。
|
|
||||||
- 受入: 全ビルド/スモーク緑、差分はファイル移動のみ。
|
|
||||||
|
|
||||||
PR‑2: MIR Builder build_module 分割（非破壊）
|
|
||||||
- `build_module` を `prepare_module`/`lower_root`/`finalize_module` に3分割。
|
|
||||||
- 型推定（value_types→返り値）は finalize 側へ集約（現行ロジック移設）。
|
|
||||||
- 既存の exprs/stmts などの委譲を明示し、build_module 本体を「骨格のみ」に縮退。
|
|
||||||
- 受入: LLVM/PyVM/Bridge スモーク緑（挙動非変化）。
|
|
||||||
|
|
||||||
PR‑3: Python LLVM lower_function の前処理抽出
|
|
||||||
- 新設: `setup_phi_placeholders()` を導入し、PHI 宣言/CFG 依存前処理をここへ移設。
|
|
||||||
- `lower_block()` に snapshot（block_end_values 収集）までの責務を移動。メインループは薄い周回に。
|
|
||||||
- 受入: `tools/smokes/curated_llvm.sh` / `curated_llvm_stage3.sh` 緑。
|
|
||||||
|
|
||||||
PR‑4: AST ラッパー導入（非破壊導線）
|
|
||||||
- 追加: `src/ast/nodes.rs` に小さな構造体群（Assign/Return/...）。
|
|
||||||
- enum `StatementNode/ExpressionNode` を構造体で保持。`From<T> for ASTNode` / `TryFrom<ASTNode> for T` を提供。
|
|
||||||
- Builder 入口（`builder/stmts.rs`, `builder/exprs.rs`）で ASTNode → TryFrom 変換を 1 行追加し以降はサブ型で match。
|
|
||||||
- 受入: ビルド/スモーク緑（機能非変化）。
|
|
||||||
|
|
||||||
PR‑5: MIR 命令トレイト POC（Const/BinOp）
|
|
||||||
- 追加: `src/mir/instruction_kinds/` に `const_.rs`, `binop.rs`（各命令を struct 化）。
|
|
||||||
- 共通トレイト `InstructionMeta { effects(), dst(), used() }` を定義。
|
|
||||||
- `MirInstruction::{effects,dst_value,used_values}` から一部を構造体 impl に委譲（match 縮退の礎）。
|
|
||||||
- 受入: スモーク緑、`instruction_introspection.rs` の挙動非変化。
|
|
||||||
|
|
||||||
- リスクとガード
|
|
||||||
- 機能非変化を原則（挙動差分は不可）。
|
|
||||||
- CI で LLVM/Bridge を優先確認。Selfhost/E2E は任意ジョブで回す。
|
|
||||||
- PR は 400 行未満/ファイル移動中心を目安に分割。
|
|
||||||
|
|
||||||
- 参考ファイル
|
|
||||||
- AST: `src/ast.rs`, （新規）`src/ast/utils.rs`, （将来）`src/ast/nodes.rs`
|
|
||||||
- Builder: `src/mir/builder.rs`, `src/mir/builder/*`
|
|
||||||
- Python LLVM: `src/llvm_py/llvm_builder.py`
|
|
||||||
- MIR 命令: `src/mir/instruction.rs`, （新規）`src/mir/instruction_kinds/*`
|
|
||||||
|
|
||||||
Acceptance Criteria
|
|
||||||
- すべての変更は機能非変化（スモーク/CI 緑）。
|
|
||||||
- 大型関数・巨大match の見通しが改善し、追従点が局所化。
|
|
||||||
- 新規追加の導線（AST サブ型/命令トレイト）は既存 API と共存し、段階移行を可能にする。
|
|
||||||
|
|||||||
@ -103,7 +103,7 @@ TODO（bitops）
|
|||||||
- 走査: コメント（`//`, `#`）・文字列内の `include` を無視する状態機械を導入（誤検出抑制）。
|
- 走査: コメント（`//`, `#`）・文字列内の `include` を無視する状態機械を導入（誤検出抑制）。
|
||||||
- サンプル: `apps/selfhost/smokes/dep_smoke_root.nyash`（子: `dep_smoke_child.nyash`）。
|
- サンプル: `apps/selfhost/smokes/dep_smoke_root.nyash`（子: `dep_smoke_child.nyash`）。
|
||||||
|
|
||||||
出力仕様・受け入れ基準: docs/selfhost/dep_tree_min_string.md に移設（CURRENT_TASKは要点のみ表記）。
|
出力仕様・受け入れ基準: docs/development/current/selfhost/dep_tree_min_string.md に移設（CURRENT_TASKは要点のみ表記）。
|
||||||
|
|
||||||
残タスク（Phase 0 必須）
|
残タスク（Phase 0 必須）
|
||||||
- P0-2: スモーク（循環あり/なし）と合わせて確認（追加済み）。
|
- P0-2: スモーク（循環あり/なし）と合わせて確認（追加済み）。
|
||||||
@ -439,9 +439,9 @@ Phase A 進捗（実施済）
|
|||||||
- Phase 12 クローズアウト完了。言語糖衣（12.7-B/P0）と VM 分割は反映済み。
|
- Phase 12 クローズアウト完了。言語糖衣（12.7-B/P0）と VM 分割は反映済み。
|
||||||
- Phase 15（Self-Hosting: Cranelift AOT）へフォーカス移行。
|
- Phase 15（Self-Hosting: Cranelift AOT）へフォーカス移行。
|
||||||
- 設計/仕様ドキュメントとスモーク雛形を追加済み。
|
- 設計/仕様ドキュメントとスモーク雛形を追加済み。
|
||||||
- 設計: `docs/backend-cranelift-aot-design.md`
|
- 設計: `docs/design/backend-cranelift-aot-design.md`
|
||||||
- API案: `docs/interfaces/cranelift-aot-box.md`
|
- API案: `docs/design/cranelift-aot-box.md`
|
||||||
- LinkerBox: `docs/interfaces/linker-box.md`
|
- LinkerBox: `docs/design/linker-box.md`
|
||||||
- スモーク仕様: `docs/tests/aot_smoke_cranelift.md`
|
- スモーク仕様: `docs/tests/aot_smoke_cranelift.md`
|
||||||
- 雛形スクリプト: `tools/aot_smoke_cranelift.sh`, `tools/aot_smoke_cranelift.ps1`
|
- 雛形スクリプト: `tools/aot_smoke_cranelift.sh`, `tools/aot_smoke_cranelift.ps1`
|
||||||
- README にセルフホスト到達の道筋を明記（C ABI を Box 化）。
|
- README にセルフホスト到達の道筋を明記（C ABI を Box 化）。
|
||||||
@ -848,7 +848,7 @@ Phase A 進捗（実施済）
|
|||||||
- 参照
|
- 参照
|
||||||
- Phase 15 概要/ロードマップ: `docs/development/roadmap/phases/phase-15/README.md`, `docs/development/roadmap/phases/phase-15/ROADMAP.md`
|
- Phase 15 概要/ロードマップ: `docs/development/roadmap/phases/phase-15/README.md`, `docs/development/roadmap/phases/phase-15/ROADMAP.md`
|
||||||
- ハンドオフ: `docs/handoff/phase-15-handoff.md`
|
- ハンドオフ: `docs/handoff/phase-15-handoff.md`
|
||||||
- 設計/API: `docs/backend-cranelift-aot-design.md`, `docs/interfaces/*`
|
- 設計/API: `docs/design/backend-cranelift-aot-design.md`, `docs/design/*`
|
||||||
|
|
||||||
■ 合否基準（P0: Ny→MIR→MIR-Interp→VM 最小成立）
|
■ 合否基準（P0: Ny→MIR→MIR-Interp→VM 最小成立）
|
||||||
- 自作Nyashパーサ（最小サブセット）が Nyash で動作し、テスト入力から中間形式(JSON暫定)を生成できる。
|
- 自作Nyashパーサ（最小サブセット）が Nyash で動作し、テスト入力から中間形式(JSON暫定)を生成できる。
|
||||||
|
|||||||
@ -11,7 +11,8 @@ categories = ["development-tools::parsing", "interpreters"]
|
|||||||
|
|
||||||
# Default features - minimal CLI only
|
# Default features - minimal CLI only
|
||||||
[features]
|
[features]
|
||||||
default = ["cli", "plugins"]
|
default = ["cli", "plugins", "interpreter-legacy"]
|
||||||
|
interpreter-legacy = []
|
||||||
e2e = []
|
e2e = []
|
||||||
cli = []
|
cli = []
|
||||||
plugins-only = []
|
plugins-only = []
|
||||||
|
|||||||
@ -15,7 +15,7 @@
|
|||||||
---
|
---
|
||||||
|
|
||||||
開発者向けクイックスタート: `docs/DEV_QUICKSTART.md`
|
開発者向けクイックスタート: `docs/DEV_QUICKSTART.md`
|
||||||
セルフホスト1枚ガイド: `docs/self-hosting.md`
|
セルフホスト1枚ガイド: `docs/how-to/self-hosting.md`
|
||||||
|
|
||||||
## 目次
|
## 目次
|
||||||
- [Self-Hosting（自己ホスト開発）](#self-hosting)
|
- [Self-Hosting（自己ホスト開発）](#self-hosting)
|
||||||
@ -23,7 +23,7 @@
|
|||||||
|
|
||||||
<a id="self-hosting"></a>
|
<a id="self-hosting"></a>
|
||||||
## 🧪 Self-Hosting（自己ホスト開発）
|
## 🧪 Self-Hosting（自己ホスト開発）
|
||||||
- ガイド: `docs/self-hosting.md`
|
- ガイド: `docs/how-to/self-hosting.md`
|
||||||
- 最小E2E: `NYASH_DISABLE_PLUGINS=1 ./target/release/nyash --backend vm apps/selfhost-minimal/main.nyash`
|
- 最小E2E: `NYASH_DISABLE_PLUGINS=1 ./target/release/nyash --backend vm apps/selfhost-minimal/main.nyash`
|
||||||
- スモーク: `bash tools/jit_smoke.sh` / `bash tools/selfhost_vm_smoke.sh`
|
- スモーク: `bash tools/jit_smoke.sh` / `bash tools/selfhost_vm_smoke.sh`
|
||||||
- Makefile: `make run-minimal`, `make smoke-selfhost`
|
- Makefile: `make run-minimal`, `make smoke-selfhost`
|
||||||
|
|||||||
@ -15,7 +15,8 @@
|
|||||||
---
|
---
|
||||||
|
|
||||||
Developer quickstart: see `docs/DEV_QUICKSTART.md`. Changelog highlights: `CHANGELOG.md`.
|
Developer quickstart: see `docs/DEV_QUICKSTART.md`. Changelog highlights: `CHANGELOG.md`.
|
||||||
Self‑hosting one‑pager: `docs/self-hosting.md`.
|
MIR mode note: default is MIR13 (PHI-off). See `docs/development/mir/MIR13_MODE.md`.
|
||||||
|
Self‑hosting one‑pager: `docs/how-to/self-hosting.md`.
|
||||||
|
|
||||||
## Table of Contents
|
## Table of Contents
|
||||||
- [Self‑Hosting (Dev Focus)](#self-hosting)
|
- [Self‑Hosting (Dev Focus)](#self-hosting)
|
||||||
@ -23,7 +24,7 @@ Self‑hosting one‑pager: `docs/self-hosting.md`.
|
|||||||
|
|
||||||
<a id="self-hosting"></a>
|
<a id="self-hosting"></a>
|
||||||
## 🧪 Self‑Hosting (Dev Focus)
|
## 🧪 Self‑Hosting (Dev Focus)
|
||||||
- Guide: `docs/self-hosting.md`
|
- Guide: `docs/how-to/self-hosting.md`
|
||||||
- Minimal E2E: `NYASH_DISABLE_PLUGINS=1 ./target/release/nyash --backend vm apps/selfhost-minimal/main.nyash`
|
- Minimal E2E: `NYASH_DISABLE_PLUGINS=1 ./target/release/nyash --backend vm apps/selfhost-minimal/main.nyash`
|
||||||
- Smokes: `bash tools/jit_smoke.sh` / `bash tools/selfhost_vm_smoke.sh`
|
- Smokes: `bash tools/jit_smoke.sh` / `bash tools/selfhost_vm_smoke.sh`
|
||||||
- Makefile: `make run-minimal`, `make smoke-selfhost`
|
- Makefile: `make run-minimal`, `make smoke-selfhost`
|
||||||
|
|||||||
@ -178,4 +178,4 @@ The analysis reveals a well-architected system that would benefit from tactical
|
|||||||
|
|
||||||
Phase 15 Addendum (Mainline only)
|
Phase 15 Addendum (Mainline only)
|
||||||
- Implemented: extracted CLI directives scanning and fields-top lint into `src/runner/cli_directives.rs` to slim `src/runner/mod.rs` without behavior changes.
|
- Implemented: extracted CLI directives scanning and fields-top lint into `src/runner/cli_directives.rs` to slim `src/runner/mod.rs` without behavior changes.
|
||||||
- Proposed next steps (non-JIT): see `docs/refactoring/candidates_phase15.md` for focused items on Runner/LLVM/VM.
|
- Proposed next steps (non-JIT): see `docs/development/refactoring/candidates_phase15.md` for focused items on Runner/LLVM/VM.
|
||||||
|
|||||||
BIN
app_pyvm_cmp
Normal file
BIN
app_pyvm_cmp
Normal file
Binary file not shown.
@ -19,7 +19,7 @@ Quickstart
|
|||||||
|
|
||||||
Docs
|
Docs
|
||||||
|
|
||||||
- One‑page guide: `docs/self-hosting.md`
|
- One‑page guide: `docs/how-to/self-hosting.md`
|
||||||
|
|
||||||
Flags
|
Flags
|
||||||
|
|
||||||
|
|||||||
@ -3,7 +3,7 @@
|
|||||||
This quickstart summarizes the most common build/run/test flows when working on Nyash.
|
This quickstart summarizes the most common build/run/test flows when working on Nyash.
|
||||||
|
|
||||||
See also
|
See also
|
||||||
- Self‑hosting one‑pager: `docs/self-hosting.md`
|
- Self‑hosting one‑pager: `docs/how-to/self-hosting.md`
|
||||||
|
|
||||||
## Build
|
## Build
|
||||||
- VM/JIT (Cranelift): `cargo build --release --features cranelift-jit`
|
- VM/JIT (Cranelift): `cargo build --release --features cranelift-jit`
|
||||||
|
|||||||
@ -6,7 +6,7 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📂 新しいドキュメント構造（2025年8月20日再編成）
|
## 📂 ドキュメント構造（指針）
|
||||||
|
|
||||||
### 📖 [reference/](reference/) - 正式な技術仕様
|
### 📖 [reference/](reference/) - 正式な技術仕様
|
||||||
- **language/** - 言語仕様（構文、型システム、Box仕様）
|
- **language/** - 言語仕様（構文、型システム、Box仕様）
|
||||||
@ -22,6 +22,9 @@
|
|||||||
- **examples/** - 実践的なサンプルコード
|
- **examples/** - 実践的なサンプルコード
|
||||||
- **wasm-guide/** - WebAssemblyビルドガイド
|
- **wasm-guide/** - WebAssemblyビルドガイド
|
||||||
|
|
||||||
|
### 🧩 [how-to/](how-to/) - 目的別ハウツー
|
||||||
|
- 手順重視の短いガイド（前提→コマンド→検証）
|
||||||
|
|
||||||
### 🔧 [development/](development/) - 開発者向け
|
### 🔧 [development/](development/) - 開発者向け
|
||||||
- **current/** - 現在進行中のタスク（CURRENT_TASK.md等）
|
- **current/** - 現在進行中のタスク（CURRENT_TASK.md等）
|
||||||
- **roadmap/** - 開発計画
|
- **roadmap/** - 開発計画
|
||||||
@ -54,6 +57,9 @@
|
|||||||
- [実行バックエンド](reference/architecture/execution-backends.md)
|
- [実行バックエンド](reference/architecture/execution-backends.md)
|
||||||
- [プラグインシステム](reference/plugin-system/)
|
- [プラグインシステム](reference/plugin-system/)
|
||||||
- [CLIオプション早見表](tools/cli-options.md)
|
- [CLIオプション早見表](tools/cli-options.md)
|
||||||
|
|
||||||
|
### デザイン
|
||||||
|
- [設計ノート（入口）](design/)
|
||||||
|
|
||||||
### 開発状況
|
### 開発状況
|
||||||
- [現在のタスク](../CURRENT_TASK.md)
|
- [現在のタスク](../CURRENT_TASK.md)
|
||||||
@ -63,7 +69,7 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 📋 再編成について
|
## 📋 再編成について / フォルダの見分け方
|
||||||
ドキュメントは2025年8月20日に再編成されました。詳細は[REORGANIZATION_REPORT.md](REORGANIZATION_REPORT.md)を参照してください。
|
ドキュメントは2025年8月20日に再編成されました。詳細は[REORGANIZATION_REPORT.md](REORGANIZATION_REPORT.md)を参照してください。
|
||||||
|
|
||||||
旧パスから新パスへの主な変更：
|
旧パスから新パスへの主な変更：
|
||||||
@ -73,4 +79,10 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
補足:
|
||||||
|
- `reference/` は正本（仕様）。
|
||||||
|
- `guides/` は読み物、`how-to/` は手順書。
|
||||||
|
- `design/` は公開できる設計ノート。
|
||||||
|
- `private/` は下書き保管庫（将来 `reference/`/`design/` に昇格）。
|
||||||
|
|
||||||
Nyash は「Everything is Box」哲学に基づく言語です。詳細はコア概念とガイドを参照してください。
|
Nyash は「Everything is Box」哲学に基づく言語です。詳細はコア概念とガイドを参照してください。
|
||||||
|
|||||||
@ -1,42 +1,14 @@
|
|||||||
# Nyash Archive 🗄️
|
# Nyash Docs Archive
|
||||||
|
|
||||||
過去のドキュメント、設計決定、相談記録のアーカイブです。
|
This folder stores deprecated or historical documents. Links from active docs should not point here.
|
||||||
|
|
||||||
## 📂 ディレクトリ構造
|
When moving files into `archive/`:
|
||||||
|
- Add a brief note at the top explaining why it was archived and the new canonical location if any.
|
||||||
|
- Do not update content except light headers; avoid drifting from the canonical reference.
|
||||||
|
|
||||||
### consultations/
|
When searching for current information, prefer:
|
||||||
AI相談記録の保管場所
|
- `docs/reference/` (specifications)
|
||||||
- **gemini/** - Gemini AIとの相談記録
|
- `docs/guides/` (user guides)
|
||||||
- **chatgpt/** - ChatGPTとの相談記録
|
- `docs/how-to/` (task‑oriented steps)
|
||||||
- **codex/** - Codexの解析結果
|
- `docs/design/` (stable architecture notes)
|
||||||
|
|
||||||
### decisions/
|
|
||||||
過去の設計決定とその理由
|
|
||||||
- アーキテクチャ決定記録（ADR）
|
|
||||||
- 廃止された機能の説明
|
|
||||||
- 設計変更の経緯
|
|
||||||
|
|
||||||
### build-logs/
|
|
||||||
ビルドログとベンチマーク結果
|
|
||||||
- パフォーマンス測定記録
|
|
||||||
- ビルドエラーの履歴
|
|
||||||
- 最適化の記録
|
|
||||||
|
|
||||||
### old-versions/
|
|
||||||
古いバージョンのドキュメント
|
|
||||||
- 廃止された仕様
|
|
||||||
- 以前のガイドやチュートリアル
|
|
||||||
- 旧バージョンのREADME
|
|
||||||
|
|
||||||
### generated/
|
|
||||||
自動生成されたドキュメント
|
|
||||||
- MIRダンプ
|
|
||||||
- ベンチマーク結果
|
|
||||||
- コード解析レポート
|
|
||||||
|
|
||||||
## ⚠️ 注意事項
|
|
||||||
このディレクトリの内容は歴史的参照用です。重複・旧版の資料が含まれます。
|
|
||||||
最新の計画・仕様は以下を参照してください：
|
|
||||||
- 現行の計画（PLAN）: `docs/development/roadmap/phases/phase-11.8_mir_cleanup/PLAN.md`
|
|
||||||
- 技術仕様（TECHNICAL_SPEC）: `docs/development/roadmap/phases/phase-11.8_mir_cleanup/TECHNICAL_SPEC.md`
|
|
||||||
- そのほか: `/reference/`（リファレンス）, `/guides/`（利用ガイド）, `/development/`（開発状況）
|
|
||||||
|
|||||||
@ -1,9 +0,0 @@
|
|||||||
# CURRENT TASK — アーカイブ（2025‑09‑06）
|
|
||||||
|
|
||||||
このファイルは `CURRENT_TASK.md` の旧来の完全版をそのまま保存するアーカイブです。
|
|
||||||
Cranelift/AOT/JIT‑AOT 関連の詳細は今後 `docs/phase-15/cranelift/CRANELIFT_TASKS.md` 側で更新します。
|
|
||||||
|
|
||||||
注意: ここに記載のコマンドやパスは当時点のものです。最新の手順や方針は `CURRENT_TASK.md` と phase‑15 配下のドキュメントを参照してください。
|
|
||||||
|
|
||||||
（元の内容は Git 履歴から参照してください）
|
|
||||||
|
|
||||||
@ -1,22 +0,0 @@
|
|||||||
# Debug Reports
|
|
||||||
|
|
||||||
ChatGPT5さんへの調査依頼レポート集です。
|
|
||||||
|
|
||||||
## 最新レポート（2025-09-11）
|
|
||||||
|
|
||||||
### 1. chatgpt5_debug_request.md 🎯 **最重要**
|
|
||||||
プラグイン戻り値表示バグの根本原因を特定した詳細レポート：
|
|
||||||
- 問題の流れを完全に追跡
|
|
||||||
- nyrt::console.log_handleでの問題箇所を特定
|
|
||||||
- デバッグ提案を含む
|
|
||||||
|
|
||||||
### 2. chatgpt5_llvm_string_concat_bug.md
|
|
||||||
文字列連結バグも含む包括的なレポート：
|
|
||||||
- MIRでの型推論ミス（String + Integer → Integer）
|
|
||||||
- LLVMエラーの詳細
|
|
||||||
|
|
||||||
## テストファイル
|
|
||||||
`local_tests/test_plugin_*.nyash` - バグ再現用のテストファイル
|
|
||||||
|
|
||||||
## 使用方法
|
|
||||||
これらのレポートをChatGPT5に提示して、問題の修正を依頼してください。
|
|
||||||
@ -1,66 +0,0 @@
|
|||||||
# ChatGPT5さんへ：プラグイン戻り値表示バグ詳細調査レポート
|
|
||||||
|
|
||||||
## 🎯 根本原因特定完了
|
|
||||||
|
|
||||||
### 問題の流れ
|
|
||||||
1. **プラグイン戻り値取得** ✅ 正常
|
|
||||||
- `CounterBox.get()` → 整数2が返される
|
|
||||||
- L1016でvmapに生のi64値として格納
|
|
||||||
|
|
||||||
2. **LLVM console.log呼び出し** ✅ 正常
|
|
||||||
- L1270で`nyash.console.log_handle(生のi64値)`呼び出し
|
|
||||||
|
|
||||||
3. **nyrt処理** ❌ **ここに問題**
|
|
||||||
```rust
|
|
||||||
// crates/nyrt/src/lib.rs:2391-2401
|
|
||||||
pub extern "C" fn nyash_console_log_handle(handle: i64) -> i64 {
|
|
||||||
if let Some(obj) = handles::get(handle as u64) { // ← 生の値2でハンドル検索→失敗
|
|
||||||
let s = obj.to_string_box().value;
|
|
||||||
println!("{}", s);
|
|
||||||
} else {
|
|
||||||
println!("{}", handle); // ← なぜか空白表示される
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 疑問点
|
|
||||||
**なぜ`println!("{}", handle)`が空白になるのか？**
|
|
||||||
- handleには実際の値（2）が入っているはず
|
|
||||||
- なぜprintln!が何も出力しない？
|
|
||||||
|
|
||||||
## 🔍 必要な修正案
|
|
||||||
|
|
||||||
### 提案1: デバッグ出力追加
|
|
||||||
```rust
|
|
||||||
pub extern "C" fn nyash_console_log_handle(handle: i64) -> i64 {
|
|
||||||
eprintln!("DEBUG: handle={}", handle); // デバッグ出力
|
|
||||||
if let Some(obj) = handles::get(handle as u64) {
|
|
||||||
let s = obj.to_string_box().value;
|
|
||||||
println!("{}", s);
|
|
||||||
} else {
|
|
||||||
eprintln!("DEBUG: handle {} not found in registry", handle);
|
|
||||||
println!("{}", handle); // 元のコード
|
|
||||||
}
|
|
||||||
0
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 提案2: 生の整数値対応
|
|
||||||
```rust
|
|
||||||
pub extern "C" fn nyash_console_log_handle(handle: i64) -> i64 {
|
|
||||||
if let Some(obj) = handles::get(handle as u64) {
|
|
||||||
let s = obj.to_string_box().value;
|
|
||||||
println!("{}", s);
|
|
||||||
} else {
|
|
||||||
// プラグイン戻り値の生の整数を直接表示
|
|
||||||
println!("{}", handle);
|
|
||||||
eprintln!("DEBUG: Printed raw value {}", handle);
|
|
||||||
}
|
|
||||||
0
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## 🐛 追加問題: 文字列連結
|
|
||||||
MIRで`"result is: " + 2`が`String + Integer → Integer`と間違った型推論
|
|
||||||
|
|
||||||
お手数ですが、調査をお願いします！
|
|
||||||
@ -1,99 +0,0 @@
|
|||||||
# ChatGPT5さんへ：LLVM文字列連結バグ
|
|
||||||
|
|
||||||
## 問題
|
|
||||||
文字列と整数の連結でLLVMエラーが発生します。
|
|
||||||
|
|
||||||
## エラーメッセージ
|
|
||||||
```
|
|
||||||
❌ LLVM execution error: binop lhs %4 not integer
|
|
||||||
```
|
|
||||||
|
|
||||||
## テストコード
|
|
||||||
```nyash
|
|
||||||
local c = new CounterBox()
|
|
||||||
c.inc()
|
|
||||||
c.inc()
|
|
||||||
local result = c.get()
|
|
||||||
print("result is: " + result) // ← ここでエラー
|
|
||||||
print(result)
|
|
||||||
```
|
|
||||||
|
|
||||||
## MIR出力（問題箇所）
|
|
||||||
```mir
|
|
||||||
4: %3: Integer = call %0.get() // プラグイン戻り値（整数）
|
|
||||||
5: %4: String = const "result is: " // 文字列定数
|
|
||||||
6: %5: Integer = %4 Add %3 // ❌ 型が間違い！String + Integer なのに結果がInteger
|
|
||||||
7: extern_call env.console.log(%5)
|
|
||||||
```
|
|
||||||
|
|
||||||
## 期待される動作
|
|
||||||
- `String + Integer` → `String` （文字列連結）
|
|
||||||
- または専用の文字列連結命令が必要
|
|
||||||
|
|
||||||
## 関連ファイル
|
|
||||||
1. `src/backend/llvm/compiler/real.rs` - BinaryOp処理
|
|
||||||
2. `src/mir/builder/ops.rs` - MIRビルダーのBinaryOp処理
|
|
||||||
|
|
||||||
## 参考：通常の整数表示は正常
|
|
||||||
```mir
|
|
||||||
9: %6: Integer = const 42
|
|
||||||
13: extern_call env.console.log(%6) // ← これは正常に "42" と表示される
|
|
||||||
```
|
|
||||||
|
|
||||||
プラグイン戻り値自体は正しく取得できているが、文字列連結の型処理に問題があるようです。
|
|
||||||
|
|
||||||
## 追加情報：プラグイン戻り値も空白のまま
|
|
||||||
|
|
||||||
### シンプルなテストで確認
|
|
||||||
```nyash
|
|
||||||
local c = new CounterBox()
|
|
||||||
c.inc()
|
|
||||||
c.inc()
|
|
||||||
print(c.get()) // 空白が表示される（何も出力されない）
|
|
||||||
```
|
|
||||||
|
|
||||||
### MIR出力
|
|
||||||
```mir
|
|
||||||
4: %3: Integer = call %0.get()
|
|
||||||
5: extern_call env.console.log(%3) [effects: pure|io]
|
|
||||||
```
|
|
||||||
|
|
||||||
MIRには正しく`Integer`型が付いているのに、実行時は空白表示。
|
|
||||||
|
|
||||||
## 根本原因判明！🎯
|
|
||||||
|
|
||||||
### 問題1: プラグイン戻り値表示バグ
|
|
||||||
|
|
||||||
**L1016**: プラグイン戻り値（整数）は正しくvmapに格納される
|
|
||||||
```rust
|
|
||||||
crate::mir::MirType::Integer => {
|
|
||||||
vmap.insert(*d, rv); // ← 生の i64 値が入る
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**L1214-1270**: console.logは生の i64 値を受け取る
|
|
||||||
```rust
|
|
||||||
let av = *vmap.get(&args[0]).ok_or("extern arg missing")?;
|
|
||||||
// av = 生の i64 値（例: 2）
|
|
||||||
```
|
|
||||||
|
|
||||||
**L2391-2401**: nyrt::console.log_handleの問題箇所
|
|
||||||
```rust
|
|
||||||
pub extern "C" fn nyash_console_log_handle(handle: i64) -> i64 {
|
|
||||||
if let Some(obj) = handles::get(handle as u64) { // ← handles::get(2) → None
|
|
||||||
let s = obj.to_string_box().value;
|
|
||||||
println!("{}", s);
|
|
||||||
} else {
|
|
||||||
println!("{}", handle); // ← ここでhandle=2が表示されるはず
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**疑問**: なぜ`println!("{}", handle)`が空白になるのか？
|
|
||||||
|
|
||||||
### 問題2: 文字列連結バグ
|
|
||||||
MIRで`String + Integer → Integer`という間違った型推論が発生
|
|
||||||
|
|
||||||
## 調査が必要
|
|
||||||
1. handleの実際の値をログ出力で確認
|
|
||||||
2. println!が実際に呼ばれているか確認
|
|
||||||
@ -34,3 +34,4 @@ References
|
|||||||
- LOWERING_LLVM.md — lowering rules and runtime calls
|
- LOWERING_LLVM.md — lowering rules and runtime calls
|
||||||
- RESOLVER_API.md — Resolver design and usage
|
- RESOLVER_API.md — Resolver design and usage
|
||||||
- LLVM_HARNESS.md — llvmlite harness interface and usage
|
- LLVM_HARNESS.md — llvmlite harness interface and usage
|
||||||
|
|
||||||
13
docs/design/README.md
Normal file
13
docs/design/README.md
Normal file
@ -0,0 +1,13 @@
|
|||||||
|
# Nyash Design Notes
|
||||||
|
|
||||||
|
Public, stable design documents and architecture explanations.
|
||||||
|
|
||||||
|
Use for rationale, trade‑offs, and diagrams that are safe to cite.
|
||||||
|
|
||||||
|
Contents to consolidate here:
|
||||||
|
- Architecture overviews derived from ARCHITECTURE.md
|
||||||
|
- Backend design (LLVM/Cranelift) summaries
|
||||||
|
- MIR/IR evolution notes that are not drafts
|
||||||
|
|
||||||
|
Draft, exploratory, or long‑form papers should remain under `docs/private/` until finalized.
|
||||||
|
|
||||||
@ -1,29 +1,29 @@
|
|||||||
# AOT-Plan v1 Schema (Phase 15.1)
|
# AOT-Plan v1 Schema (Phase 15.1)
|
||||||
|
|
||||||
Status: draft-frozen for Phase 15.1 (extensions via `extensions` object only)
|
Status: draft-frozen for Phase 15.1 (extensions via `extensions` only)
|
||||||
|
|
||||||
- version: string, must be "1"
|
- version: string, must be "1"
|
||||||
- name: optional plan/module name
|
- name: optional plan/module name
|
||||||
- functions: array of PlanFunction
|
- functions: array of PlanFunction
|
||||||
- externs: optional array of extern identifiers (reserved; not required in 15.1)
|
- externs: optional array (reserved; not required in 15.1)
|
||||||
- exports: optional array of export names (reserved)
|
- exports: optional array (reserved)
|
||||||
- units: optional array of link units (reserved)
|
- units: optional array (reserved)
|
||||||
- extensions: optional object for forward-compatible keys
|
- extensions: optional object for forward-compatible keys
|
||||||
|
|
||||||
PlanFunction:
|
PlanFunction
|
||||||
- name: string
|
- name: string
|
||||||
- params: array of { name: string, type?: string } (informational in 15.1)
|
- params: array of { name: string, type?: string } (informational in 15.1)
|
||||||
- return_type: optional string; one of: integer, float, bool, string, void (or omitted → Unknown)
|
- return_type: optional string; one of: integer, float, bool, string, void (or omitted → Unknown)
|
||||||
- body: optional object with tagged `kind`
|
- body: optional tagged object
|
||||||
- kind = "const_return": { value: any-json (int/bool/float/string supported) }
|
- kind = "const_return": { value: any-json (int/bool/float/string) }
|
||||||
- kind = "empty": returns default 0 with Unknown type (Phase 15.1 importer behavior)
|
- kind = "empty": returns default 0 with Unknown type (15.1 importer behavior)
|
||||||
|
|
||||||
Notes:
|
Notes
|
||||||
- 15.1 importer does not emit object code; it constructs MIR13 skeletons only.
|
- 15.1 importer does not emit object code; it constructs MIR13 skeletons only.
|
||||||
- If `return_type` is omitted, importer uses Unknown to keep VM dynamic display.
|
- If `return_type` is omitted, importer uses Unknown to keep VM dynamic display.
|
||||||
- `extensions` is a free-form map; the importer ignores unknown keys.
|
- `extensions` is a free-form map; the importer ignores unknown keys.
|
||||||
|
|
||||||
Example:
|
Example
|
||||||
```
|
```
|
||||||
{
|
{
|
||||||
"version": "1",
|
"version": "1",
|
||||||
50
docs/development/mir/MIR13_MODE.md
Normal file
50
docs/development/mir/MIR13_MODE.md
Normal file
@ -0,0 +1,50 @@
|
|||||||
|
MIR13 Mode (PHI-off by default)
|
||||||
|
|
||||||
|
Overview
|
||||||
|
- Goal: Stabilize execution by turning off PHI emission in the Bridge/Builder and letting the LLVM (llvmlite) layer synthesize PHIs as needed.
|
||||||
|
- Default: MIR13 is ON by default (PHI-off). Use env flags to flip.
|
||||||
|
|
||||||
|
Why
|
||||||
|
- Fewer SSA obligations in the front-end (Bridge/Builder) reduces CFG corner cases (short‑circuit, nested if/loop merges).
|
||||||
|
- Centralizes SSA invariants in a single place (llvmlite resolver/finalizer), improving correctness and maintenance.
|
||||||
|
|
||||||
|
Flags and Behavior
|
||||||
|
- NYASH_MIR_NO_PHI (default: 1)
|
||||||
|
- 1: Bridge/Builder emit edge copies instead of PHIs at merges (MIR13).
|
||||||
|
- 0: Bridge/Builder may emit PHIs (MIR14 experimental).
|
||||||
|
- NYASH_VERIFY_ALLOW_NO_PHI (default: 1)
|
||||||
|
- Relaxes verifier checks that assume PHIs at merges.
|
||||||
|
- NYASH_LLVM_USE_HARNESS=1 (AOT via llvmlite harness)
|
||||||
|
- Resolver/finalizer synthesize PHIs at block heads when needed.
|
||||||
|
|
||||||
|
LLVM (llvmlite) Responsibilities
|
||||||
|
- setup_phi_placeholders(): predeclare JSON‑provided PHIs and collect incoming metadata.
|
||||||
|
- block_end_values: snapshot per block end to materialize predecessor values (dominance‑safe).
|
||||||
|
- finalize_phis(): wire incoming edges for declared PHIs at block heads.
|
||||||
|
- Resolver.resolve_i64():
|
||||||
|
- single‑pred: take predecessor end value;
|
||||||
|
- multi‑pred + declared PHI: reuse placeholder at block head;
|
||||||
|
- multi‑pred + no PHI: synthesize a localization PHI at the current block head (MIR13 compatibility);
|
||||||
|
- avoids reusing non‑dominating vmap values across blocks.
|
||||||
|
|
||||||
|
Bridge/Builder (JSON v0) Behavior
|
||||||
|
- If/Loop/Try are lowered without PHIs when MIR13 is ON; merges are performed with edge copies (merge_var_maps) and the final value is reconstituted by the LLVM layer if needed.
|
||||||
|
- Helper split for readability (no behavior change):
|
||||||
|
- lowering/{if_else.rs, loop_.rs, try_catch.rs, merge.rs}
|
||||||
|
|
||||||
|
Testing
|
||||||
|
- Curated LLVM (default = PHI‑off):
|
||||||
|
- tools/smokes/curated_llvm.sh (use --phi-on to exercise MIR14)
|
||||||
|
- PHI invariants/parity (AOT vs PyVM):
|
||||||
|
- tools/pyvm_vs_llvmlite.sh (default compares exit code; use CMP_STRICT=1 for stdout+exit)
|
||||||
|
- Bridge/PyVM:
|
||||||
|
- tools/selfhost_stage2_bridge_smoke.sh
|
||||||
|
|
||||||
|
How to Force PHI‑on (MIR14 experimental)
|
||||||
|
- Set: NYASH_MIR_NO_PHI=0 and run tools/smokes/curated_llvm.sh --phi-on
|
||||||
|
- Known: loop_if_phi may trip dominance issues in PHI‑on; MIR13 is the recommended default.
|
||||||
|
|
||||||
|
Known Limitations (current)
|
||||||
|
- No full tracing GC; object lifetime is managed via handle registries and Arc lifetimes.
|
||||||
|
- PHI‑on path is still being refined for some control‑flow patterns.
|
||||||
|
|
||||||
@ -33,7 +33,7 @@ Avoid: deep AOT emission/linking, cross-platform toolchain work, or scope creep
|
|||||||
## Deliverables
|
## Deliverables
|
||||||
|
|
||||||
- `tools/aot_plan/` Nyash scripts and helpers
|
- `tools/aot_plan/` Nyash scripts and helpers
|
||||||
- `docs/specs/aot_plan_v1.md` (lightweight schema)
|
- `docs/design/aot-plan-v1.md` (lightweight schema)
|
||||||
- Compiler entry to import AOT-Plan → MIR13 (feature-gated)
|
- Compiler entry to import AOT-Plan → MIR13 (feature-gated)
|
||||||
- 3 smokes + 1 golden JSON sample
|
- 3 smokes + 1 golden JSON sample
|
||||||
|
|
||||||
@ -86,4 +86,3 @@ Key takeaways aligned into this document:
|
|||||||
- Importer can read that JSON and construct MIR13 module(s) without panics
|
- Importer can read that JSON and construct MIR13 module(s) without panics
|
||||||
- VM runs those modules and matches expected string/number results for trivial bodies
|
- VM runs those modules and matches expected string/number results for trivial bodies
|
||||||
- Events present when enabled; counters reflect plan/import activity; no AOT emit performed
|
- Events present when enabled; counters reflect plan/import activity; no AOT emit performed
|
||||||
|
|
||||||
|
|||||||
19
docs/how-to/README.md
Normal file
19
docs/how-to/README.md
Normal file
@ -0,0 +1,19 @@
|
|||||||
|
# Nyash How‑To Guides
|
||||||
|
|
||||||
|
Task‑oriented, copy‑paste friendly instructions for common goals.
|
||||||
|
|
||||||
|
Use when you already know what you want to do and just need the steps.
|
||||||
|
|
||||||
|
Suggested structure (add as needed):
|
||||||
|
- Build & Run
|
||||||
|
- AOT build with LLVM
|
||||||
|
- Run with PyVM / VM / JIT
|
||||||
|
- Tooling
|
||||||
|
- Enable verbose logs
|
||||||
|
- Run curated smokes / parity checks
|
||||||
|
- Language
|
||||||
|
- Using and namespaces quick setup
|
||||||
|
- Array/Map literals gate toggles
|
||||||
|
|
||||||
|
Contributions: keep each guide short (1–2 screens), start with prerequisites, end with verify step.
|
||||||
|
|
||||||
39
docs/how-to/self-hosting.md
Normal file
39
docs/how-to/self-hosting.md
Normal file
@ -0,0 +1,39 @@
|
|||||||
|
# Self‑Hosting — How‑To（前提→手順→検証）
|
||||||
|
|
||||||
|
目的
|
||||||
|
- Ny → MIR → VM/JIT の自己ホスト経路を最短手順で動かす。
|
||||||
|
|
||||||
|
前提
|
||||||
|
- Rust（stable）: `cargo --version`
|
||||||
|
- Bash + ripgrep（WSL/Unix 推奨）
|
||||||
|
|
||||||
|
手順
|
||||||
|
1) ビルド（JIT有効）
|
||||||
|
- 実行: `cargo build --release --features cranelift-jit`
|
||||||
|
2) 最小 E2E（VM、plugins 無効）
|
||||||
|
- 実行: `NYASH_DISABLE_PLUGINS=1 ./target/release/nyash --backend vm apps/selfhost-minimal/main.nyash`
|
||||||
|
3) コアスモーク
|
||||||
|
- 実行: `bash tools/jit_smoke.sh`
|
||||||
|
4) selfhost‑minimal スモーク
|
||||||
|
- 実行: `bash tools/selfhost_vm_smoke.sh`
|
||||||
|
5) 追加（任意）
|
||||||
|
- ブートストラップ: `bash tools/bootstrap_selfhost_smoke.sh`
|
||||||
|
- ラウンドトリップ: `bash tools/ny_roundtrip_smoke.sh`
|
||||||
|
|
||||||
|
検証
|
||||||
|
- 期待出力: `Result: 0`（selfhost‑minimal）
|
||||||
|
- スモーク：全成功（非 0 は失敗）
|
||||||
|
|
||||||
|
便利フラグ
|
||||||
|
- `NYASH_DISABLE_PLUGINS=1` 外部プラグイン無効化
|
||||||
|
- `NYASH_CLI_VERBOSE=1` 実行ログ詳細
|
||||||
|
- `NYASH_JIT_THRESHOLD=1` JIT 降臨テスト
|
||||||
|
|
||||||
|
トラブルシュート
|
||||||
|
- ハング: `timeout 15s ...` を付与、`NYASH_CLI_VERBOSE=1` で詳細
|
||||||
|
- プラグインエラー: まず `NYASH_DISABLE_PLUGINS=1`
|
||||||
|
- ルート相対パスで実行／`cargo clean -p nyash` で個別クリーン
|
||||||
|
|
||||||
|
関連
|
||||||
|
- CI: `.github/workflows/smoke.yml`
|
||||||
|
- マージ運用: `docs/CONTRIBUTING-MERGE.md`
|
||||||
35
docs/how-to/smokes.md
Normal file
35
docs/how-to/smokes.md
Normal file
@ -0,0 +1,35 @@
|
|||||||
|
# Smokes — How‑To（前提→手順→検証）
|
||||||
|
|
||||||
|
目的
|
||||||
|
- 代表スモークを素早く回して、回帰を検知する。
|
||||||
|
|
||||||
|
前提
|
||||||
|
- リリースビルド済み: `cargo build --release --features llvm`
|
||||||
|
- LLVM 18 が導入済み（AOT 経路のとき）
|
||||||
|
|
||||||
|
手順（推奨ランナー）
|
||||||
|
1) LLVM curated
|
||||||
|
- 実行: `tools/smokes/curated_llvm.sh [--phi-off]`
|
||||||
|
- `--phi-off`: `NYASH_MIR_NO_PHI=1` を有効化し、検証を緩和
|
||||||
|
2) PHI 不変条件パリティ
|
||||||
|
- 実行: `tools/smokes/curated_phi_invariants.sh`
|
||||||
|
- PyVM と llvmlite の stdout/exit code を比較
|
||||||
|
|
||||||
|
手動スモーク（例）
|
||||||
|
- Core (LLVM): `examples/llvm11_core_smoke.nyash`
|
||||||
|
- Async (LLVM only):
|
||||||
|
- `apps/tests/async-await-min/main.nyash`
|
||||||
|
- `apps/tests/async-spawn-instance/main.nyash`
|
||||||
|
- `apps/tests/async-await-timeout-fixed/main.nyash`（`NYASH_AWAIT_MAX_MS=100`）
|
||||||
|
|
||||||
|
アーカイブ（非推奨）
|
||||||
|
- `tools/smokes/archive/` に旧ランナー（JIT/Cranelift 時代）が存在
|
||||||
|
- `smoke_phase_10_10.sh`, `smoke_vm_jit.sh`, `smoke_async_spawn.sh`, `jit_smoke.sh`, `aot_smoke_cranelift.sh`
|
||||||
|
- これらは基本使わず、curated 系を使用
|
||||||
|
|
||||||
|
便利フラグ
|
||||||
|
- `NYASH_LLVM_USE_HARNESS=1`: llvmlite ハーネス経由
|
||||||
|
- `NYASH_MIR_NO_PHI=1`, `NYASH_VERIFY_ALLOW_NO_PHI=1`: PHI 無しモード
|
||||||
|
|
||||||
|
検証
|
||||||
|
- 0 で成功、非 0 で失敗（CI 連携可）
|
||||||
@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
**最新の完全な言語リファレンスは以下を参照してください：**
|
**最新の完全な言語リファレンスは以下を参照してください：**
|
||||||
|
|
||||||
- **[🚀 Nyash Language Reference 2025](../language/LANGUAGE_REFERENCE_2025.md)** - 完全な言語仕様（最新版）
|
- **[🚀 Nyash Language Reference 2025](../../../../reference/language/LANGUAGE_REFERENCE_2025.md)** - 完全な言語仕様（最新版）
|
||||||
- **[📝 構文早見表](../../quick-reference/syntax-cheatsheet.md)** - よく使う構文のクイックリファレンス
|
- **[📝 構文早見表](../../quick-reference/syntax-cheatsheet.md)** - よく使う構文のクイックリファレンス
|
||||||
|
|
||||||
## 📁 このディレクトリの内容
|
## 📁 このディレクトリの内容
|
||||||
@ -20,4 +20,4 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**注意**: 言語仕様に関する最新情報は必ず [LANGUAGE_REFERENCE_2025.md](../language/LANGUAGE_REFERENCE_2025.md) を参照してください。
|
**注意**: 言語仕様に関する最新情報は必ず [LANGUAGE_REFERENCE_2025.md](../../../../reference/language/LANGUAGE_REFERENCE_2025.md) を参照してください。
|
||||||
|
|||||||
@ -1,659 +0,0 @@
|
|||||||
# 🚀 Nyash Language Reference 2025
|
|
||||||
|
|
||||||
**最終更新: 2025年9月4日 - Phase 12.7実装済み機能の正確な反映**
|
|
||||||
|
|
||||||
## 📖 概要
|
|
||||||
|
|
||||||
Nyashは「Everything is Box」哲学に基づく革新的プログラミング言語です。
|
|
||||||
Rust製インタープリターによる高性能実行と、直感的な構文により、学習しやすく実用的な言語として完成しました。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔤 **1. 予約語・キーワード完全リスト**
|
|
||||||
|
|
||||||
### **Phase 12.7で確定した15個の予約語**
|
|
||||||
| 予約語 | 用途 | 例 |
|
|
||||||
|-------|------|---|
|
|
||||||
| `box` | クラス定義 | `box MyClass { }` |
|
|
||||||
| `new` | オブジェクト生成 | `new ConsoleBox()` |
|
|
||||||
| `me` | 自己参照（thisの代わり） | `me.field = value` |
|
|
||||||
| `local` | ローカル変数宣言 | `local x, y = 10` |
|
|
||||||
| `return` | 関数リターン | `return value` |
|
|
||||||
| `from` | デリゲーション・親メソッド呼び出し | `box Child from Parent` / `from Parent.method()` |
|
|
||||||
| `birth` | コンストラクタ（統一名） | `birth(param) { }` |
|
|
||||||
| `static` | 静的Box・関数定義 | `static box Main { }` |
|
|
||||||
| `if` | 条件分岐 | `if condition { }` |
|
|
||||||
| `else` | else節 | `else { }` |
|
|
||||||
| `loop` | ループ（唯一の形式） | `loop(condition) { }` |
|
|
||||||
| `continue` | ループ継続 | `continue` |
|
|
||||||
| `peek` | パターンマッチング風分岐 | `peek value { "A" => 1, else => 0 }` |
|
|
||||||
| `try` | 例外捕獲開始 | `try { }` |
|
|
||||||
| `interface` | インターフェース定義 | `interface Comparable { }` |
|
|
||||||
|
|
||||||
### **その他の重要キーワード（予約語ではない）**
|
|
||||||
| キーワード | 用途 | 例 |
|
|
||||||
|-------|------|---|
|
|
||||||
| `override` | 明示的オーバーライド | `override speak() { }` |
|
|
||||||
| `break` | ループ脱出 | `break` |
|
|
||||||
| `catch` | 例外処理 | `catch (e) { }` |
|
|
||||||
| `finally` | 最終処理 | `finally { }` |
|
|
||||||
| `throw` | 例外発生 | `throw error` |
|
|
||||||
| `nowait` | 非同期実行 | `nowait future = task()` |
|
|
||||||
| `await` | 待機・結果取得 | `result = await future` |
|
|
||||||
| `include` | ファイル取り込み | `include "math.nyash"` |
|
|
||||||
| `print` | 出力（デバッグ用） | `print("Hello")` |
|
|
||||||
| `function`/`fn` | 関数定義 | `fn add(a,b) { }` |
|
|
||||||
| `init` | 初期化ブロック | `init { field1, field2 }` |
|
|
||||||
| `pack` | 旧コンストラクタ（互換性） | `pack(param) { }` |
|
|
||||||
| `outbox` | 所有権移転変数 | `outbox result = compute()` |
|
|
||||||
| `global` | グローバル変数 | `global CONFIG = "dev"` |
|
|
||||||
| `weak` | 弱参照修飾子 | `weak reference` |
|
|
||||||
| `using` | 名前空間インポート | `using namespace` |
|
|
||||||
|
|
||||||
### **演算子・論理**
|
|
||||||
| 演算子/キーワード | 用途 | 例 |
|
|
||||||
|-------|------|---|
|
|
||||||
| `not` | 論理否定 | `not condition` |
|
|
||||||
| `and` | 論理積 | `a and b` |
|
|
||||||
| `or` | 論理和 | `a or b` |
|
|
||||||
| `true`/`false` | 真偽値 | `flag = true` |
|
|
||||||
| `null` | null値 | `value = null` |
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📝 **2. 文法・構文仕様**
|
|
||||||
|
|
||||||
### **2.1 Box定義文法**
|
|
||||||
|
|
||||||
#### **基本Box**
|
|
||||||
```nyash
|
|
||||||
box ClassName {
|
|
||||||
# フィールド宣言（Phase 12.7形式）
|
|
||||||
field1: TypeBox # フィールド型アノテーション（P0では無視）
|
|
||||||
field2: TypeBox
|
|
||||||
field3 # 型なしも可
|
|
||||||
|
|
||||||
# コンストラクタ
|
|
||||||
birth(param1, param2) { # birth構文に統一
|
|
||||||
me.field1 = param1
|
|
||||||
me.field2 = param2
|
|
||||||
me.field3 = defaultValue()
|
|
||||||
}
|
|
||||||
|
|
||||||
# メソッド
|
|
||||||
methodName(arg1, arg2) {
|
|
||||||
return me.field1 + arg1
|
|
||||||
}
|
|
||||||
|
|
||||||
# デストラクタ（fini）
|
|
||||||
fini() {
|
|
||||||
print("Cleanup: " + me.field1)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **デリゲーションBox**
|
|
||||||
```nyash
|
|
||||||
box Child from Parent interface Comparable {
|
|
||||||
childField: TypeBox # 追加フィールド
|
|
||||||
|
|
||||||
birth(parentParam, childParam) { # birth構文に統一
|
|
||||||
from Parent.birth(parentParam) # 親コンストラクタ明示呼び出し
|
|
||||||
me.childField = childParam
|
|
||||||
}
|
|
||||||
|
|
||||||
# メソッドオーバーライド
|
|
||||||
override process(data) { # overrideキーワード必須
|
|
||||||
local result = from Parent.process(data) # 親メソッド呼び出し
|
|
||||||
return result + " (Child processed)"
|
|
||||||
}
|
|
||||||
|
|
||||||
# インターフェース実装
|
|
||||||
compareTo(other) {
|
|
||||||
return me.value - other.value
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **Static Box（推奨エントリーポイント）**
|
|
||||||
```nyash
|
|
||||||
static box Main {
|
|
||||||
console: ConsoleBox
|
|
||||||
result: IntegerBox
|
|
||||||
|
|
||||||
main() {
|
|
||||||
me.console = new ConsoleBox()
|
|
||||||
me.console.log("🎉 Everything is Box!")
|
|
||||||
return "Success"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **2.2 変数宣言**
|
|
||||||
|
|
||||||
#### **基本パターン**
|
|
||||||
```nyash
|
|
||||||
# 単一宣言
|
|
||||||
local x
|
|
||||||
local name = "初期値"
|
|
||||||
|
|
||||||
# 複数宣言
|
|
||||||
local a, b, c
|
|
||||||
local x = 10, y = 20, z # 混合初期化
|
|
||||||
|
|
||||||
# 所有権移転（static関数内）
|
|
||||||
static function Factory.create() {
|
|
||||||
outbox product # 呼び出し側に所有権移転
|
|
||||||
product = new Item()
|
|
||||||
return product
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **変数宣言厳密化システム（2025-08-09実装）**
|
|
||||||
```nyash
|
|
||||||
# ✅ 正しい - 明示宣言必須
|
|
||||||
local temp
|
|
||||||
temp = 42
|
|
||||||
|
|
||||||
# ❌ エラー - 未宣言変数への代入
|
|
||||||
x = 42 # RuntimeError: 未宣言変数 + 修正提案表示
|
|
||||||
```
|
|
||||||
|
|
||||||
### **2.3 制御構文**
|
|
||||||
|
|
||||||
#### **条件分岐**
|
|
||||||
```nyash
|
|
||||||
if condition {
|
|
||||||
# 処理
|
|
||||||
} else if condition2 {
|
|
||||||
# 処理2
|
|
||||||
} else {
|
|
||||||
# else処理
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **ループ（統一構文）**
|
|
||||||
```nyash
|
|
||||||
# ✅ 唯一の正しい形式
|
|
||||||
loop(condition) {
|
|
||||||
# ループ本体
|
|
||||||
if exitCondition {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
if skipCondition {
|
|
||||||
continue # Phase 12.7で追加
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# ❌ 削除済み - 使用不可
|
|
||||||
while condition { } # パーサーエラー
|
|
||||||
loop() { } # パーサーエラー
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **Peek式（Phase 12.7で追加）**
|
|
||||||
```nyash
|
|
||||||
# パターンマッチング風の分岐
|
|
||||||
local result = peek value {
|
|
||||||
"A" => 100,
|
|
||||||
"B" => 200,
|
|
||||||
"C" => 300,
|
|
||||||
else => 0 # else必須
|
|
||||||
}
|
|
||||||
|
|
||||||
# 文の形式も可
|
|
||||||
peek status {
|
|
||||||
"error" => {
|
|
||||||
print("Error occurred")
|
|
||||||
return null
|
|
||||||
},
|
|
||||||
"success" => {
|
|
||||||
print("All good")
|
|
||||||
},
|
|
||||||
else => {
|
|
||||||
print("Unknown status")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **2.4 演算子・式**
|
|
||||||
|
|
||||||
#### **🚀 新実装: 関数オーバーロードシステム**
|
|
||||||
```nyash
|
|
||||||
# Rust風トレイトベース演算子（2025-08-10実装完了）
|
|
||||||
sum = 10 + 20 # IntegerBox + IntegerBox = IntegerBox
|
|
||||||
concat = "Hi" + " !" # StringBox + StringBox = StringBox
|
|
||||||
repeat = "Ha" * 3 # StringBox * IntegerBox = "HaHaHa"
|
|
||||||
mixed = 42 + " answer" # 混合型 → 自動文字列結合フォールバック
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **演算子優先順位**
|
|
||||||
```nyash
|
|
||||||
result = a + b * c / d - e # 算術演算子は標準的優先順位
|
|
||||||
logic = not a and b or c # not > and > or
|
|
||||||
compare = (x > y) and (z <= w) # 比較は括弧推奨
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **論理演算子**
|
|
||||||
```nyash
|
|
||||||
# キーワード版（推奨）
|
|
||||||
canAccess = level >= 5 and hasKey
|
|
||||||
isValid = not (isEmpty or hasError)
|
|
||||||
|
|
||||||
# シンボル版（互換）
|
|
||||||
result = condition && other || fallback # 利用可能だが非推奨
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **特殊演算子（Phase 12.7実装済み）**
|
|
||||||
```nyash
|
|
||||||
# ? 演算子 - Result伝播
|
|
||||||
local data = readFile(path)? # エラーなら早期return
|
|
||||||
|
|
||||||
# ラムダ式
|
|
||||||
local add = fn(x, y) { return x + y }
|
|
||||||
local double = fn(x) { x * 2 } # 単一式なら省略可
|
|
||||||
|
|
||||||
# await式
|
|
||||||
local result = await asyncTask()
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🏗️ **3. Box構文詳細ガイド**
|
|
||||||
|
|
||||||
### **3.1 Everything is Box 原則**
|
|
||||||
|
|
||||||
```nyash
|
|
||||||
# すべての値がBox
|
|
||||||
number = 42 # IntegerBox
|
|
||||||
text = "hello" # StringBox
|
|
||||||
flag = true # BoolBox
|
|
||||||
array = new ArrayBox() # ArrayBox
|
|
||||||
console = new ConsoleBox() # ConsoleBox
|
|
||||||
|
|
||||||
# 統一的なメソッド呼び出し
|
|
||||||
print(number.to_string_box().value) # "42"
|
|
||||||
print(array.length()) # 配列長
|
|
||||||
console.log("Everything is Box!") # コンソール出力
|
|
||||||
```
|
|
||||||
|
|
||||||
### **3.2 コンストラクタパターン**
|
|
||||||
|
|
||||||
#### **パラメータ付きコンストラクタ**
|
|
||||||
```nyash
|
|
||||||
box Person {
|
|
||||||
public name: StringBox
|
|
||||||
public email: StringBox
|
|
||||||
private age: IntegerBox
|
|
||||||
|
|
||||||
birth(personName, personAge) { # birth構文に統一
|
|
||||||
me.name = personName
|
|
||||||
me.age = personAge
|
|
||||||
me.email = me.name + "@example.com" # 計算フィールド
|
|
||||||
}
|
|
||||||
|
|
||||||
# ファクトリーメソッド
|
|
||||||
static createGuest() {
|
|
||||||
outbox guest
|
|
||||||
guest = new Person("Guest", 0)
|
|
||||||
return guest
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# 使用例
|
|
||||||
person = new Person("Alice", 25)
|
|
||||||
guest = Person.createGuest()
|
|
||||||
```
|
|
||||||
|
|
||||||
### **3.3 継承とインターフェース**
|
|
||||||
|
|
||||||
#### **デリゲーションチェーン**
|
|
||||||
```nyash
|
|
||||||
# 基底Box
|
|
||||||
box Animal {
|
|
||||||
public name: StringBox
|
|
||||||
public species: StringBox
|
|
||||||
|
|
||||||
birth(animalName, animalSpecies) {
|
|
||||||
me.name = animalName
|
|
||||||
me.species = animalSpecies
|
|
||||||
}
|
|
||||||
|
|
||||||
speak() {
|
|
||||||
return me.name + " makes a sound"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# デリゲーション
|
|
||||||
box Dog from Animal {
|
|
||||||
breed: StringBox # 追加フィールド
|
|
||||||
|
|
||||||
birth(dogName, dogBreed) {
|
|
||||||
from Animal.birth(dogName, "Canine") # 親コンストラクタ呼び出し
|
|
||||||
me.breed = dogBreed
|
|
||||||
}
|
|
||||||
|
|
||||||
override speak() { # 明示的オーバーライド
|
|
||||||
return me.name + " barks: Woof!"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# インターフェース実装
|
|
||||||
box Cat from Animal interface Playful {
|
|
||||||
# Playfulインターフェースの実装必須
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **3.4 Static Boxパターン**
|
|
||||||
|
|
||||||
#### **名前空間・ユーティリティ**
|
|
||||||
```nyash
|
|
||||||
static box MathUtils {
|
|
||||||
PI: FloatBox
|
|
||||||
E: FloatBox
|
|
||||||
|
|
||||||
# 注意: static初期化ブロックは未実装
|
|
||||||
# 初期化はメソッド内で行う
|
|
||||||
|
|
||||||
add(a, b) {
|
|
||||||
return a + b
|
|
||||||
}
|
|
||||||
|
|
||||||
circleArea(radius) {
|
|
||||||
# 初回アクセスで初期化パターン
|
|
||||||
if me.PI == null {
|
|
||||||
me.PI = 3.14159265
|
|
||||||
}
|
|
||||||
return me.PI * radius * radius
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# 使用法
|
|
||||||
area = MathUtils.circleArea(5)
|
|
||||||
sum = MathUtils.add(10, 20)
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **アプリケーションエントリーポイント**
|
|
||||||
```nyash
|
|
||||||
# 🎯 推奨: Static Box Main パターン
|
|
||||||
static box Main {
|
|
||||||
console: ConsoleBox
|
|
||||||
result: IntegerBox
|
|
||||||
|
|
||||||
main() {
|
|
||||||
me.console = new ConsoleBox()
|
|
||||||
me.console.log("🚀 Starting application...")
|
|
||||||
|
|
||||||
# アプリケーションロジック
|
|
||||||
me.result = processData()
|
|
||||||
|
|
||||||
return "Application completed successfully"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 **4. 最新機能・革新技術**
|
|
||||||
|
|
||||||
### **4.1 Arc<Mutex> Revolution（2025-08-10）**
|
|
||||||
```nyash
|
|
||||||
# 全16種類のBox型が統一Arc<Mutex>パターンで実装
|
|
||||||
# 完全なスレッドセーフティと高性能を両立
|
|
||||||
|
|
||||||
array = new ArrayBox()
|
|
||||||
array.push(10) # スレッドセーフな追加
|
|
||||||
array.push(20)
|
|
||||||
item = array.get(0) # スレッドセーフな取得
|
|
||||||
|
|
||||||
json = new JSONBox()
|
|
||||||
json.set("name", "Alice") # 並行安全な操作
|
|
||||||
data = json.stringify() # JSON文字列化
|
|
||||||
```
|
|
||||||
|
|
||||||
### **4.2 Rust風トレイトベース演算子（2025-08-10）**
|
|
||||||
```nyash
|
|
||||||
# AI大相談会で決定された最適設計
|
|
||||||
# 静的・動的ハイブリッドディスパッチによる高性能実現
|
|
||||||
|
|
||||||
# 整数演算
|
|
||||||
result = 100 - 25 # IntegerBox間演算 → IntegerBox
|
|
||||||
product = 6 * 7 # 高速静的ディスパッチ
|
|
||||||
|
|
||||||
# 文字列操作
|
|
||||||
greeting = "Hello" + " World" # 文字列結合
|
|
||||||
repeated = "Echo" * 3 # "EchoEchoEcho"
|
|
||||||
|
|
||||||
# 混合型フォールバック
|
|
||||||
message = "Answer: " + 42 # "Answer: 42"
|
|
||||||
|
|
||||||
# Boolean演算
|
|
||||||
boolSum = true + false # 1 (IntegerBox)
|
|
||||||
```
|
|
||||||
|
|
||||||
### **4.3 変数宣言厳密化（2025-08-09）**
|
|
||||||
```nyash
|
|
||||||
# メモリ安全性・非同期安全性保証システム
|
|
||||||
|
|
||||||
static box Calculator {
|
|
||||||
private memory: ArrayBox # 必須フィールド宣言
|
|
||||||
|
|
||||||
calculate() {
|
|
||||||
local temp # 必須ローカル変数宣言
|
|
||||||
temp = me.memory * 2
|
|
||||||
return temp
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 **4.4 Phase 12.7実装済み機能**
|
|
||||||
|
|
||||||
### **Peek式 - パターンマッチング風分岐**
|
|
||||||
```nyash
|
|
||||||
# 式として使用（値を返す）
|
|
||||||
local grade = peek score {
|
|
||||||
100 => "Perfect",
|
|
||||||
90 => "Excellent",
|
|
||||||
80 => "Good",
|
|
||||||
else => "Needs improvement"
|
|
||||||
}
|
|
||||||
|
|
||||||
# 文として使用（アクション実行）
|
|
||||||
peek command {
|
|
||||||
"save" => {
|
|
||||||
saveFile()
|
|
||||||
print("Saved!")
|
|
||||||
},
|
|
||||||
"quit" => {
|
|
||||||
cleanup()
|
|
||||||
return
|
|
||||||
},
|
|
||||||
else => print("Unknown command")
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **Continue文**
|
|
||||||
```nyash
|
|
||||||
loop(i < 100) {
|
|
||||||
if i % 2 == 0 {
|
|
||||||
continue # 偶数をスキップ
|
|
||||||
}
|
|
||||||
process(i)
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **フィールド型アノテーション**
|
|
||||||
```nyash
|
|
||||||
box Person {
|
|
||||||
name: StringBox # 型情報を明記（P0では無視）
|
|
||||||
age: IntegerBox
|
|
||||||
email # 型なしも可
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **?演算子（Result伝播）**
|
|
||||||
```nyash
|
|
||||||
# ResultBoxのエラーを自動的に早期return
|
|
||||||
local data = readFile("config.json")?
|
|
||||||
local parsed = parseJSON(data)?
|
|
||||||
return parsed.get("version")
|
|
||||||
```
|
|
||||||
|
|
||||||
### **Lambda式**
|
|
||||||
```nyash
|
|
||||||
# 基本形
|
|
||||||
local add = fn(x, y) { return x + y }
|
|
||||||
|
|
||||||
# 単一式の場合（returnは省略可）
|
|
||||||
local double = fn(x) { x * 2 }
|
|
||||||
|
|
||||||
# 高階関数での使用
|
|
||||||
array.map(fn(x) { x * x })
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ⚡ **5. 実装済みBox型ライブラリ**
|
|
||||||
|
|
||||||
### **5.1 基本型**
|
|
||||||
- `StringBox` - 文字列（split, find, replace, trim等）
|
|
||||||
- `IntegerBox` - 64bit整数
|
|
||||||
- `FloatBox` - 64bit浮動小数点数
|
|
||||||
- `BoolBox` - 真偽値
|
|
||||||
- `NullBox` - null値
|
|
||||||
- `VoidBox` - void値
|
|
||||||
|
|
||||||
### **5.2 コレクション**
|
|
||||||
- `ArrayBox` - 動的配列（push, pop, get, set, join等）
|
|
||||||
- `MapBox` - 連想配列・辞書
|
|
||||||
|
|
||||||
### **5.3 システム・I/O**
|
|
||||||
- `ConsoleBox` - コンソール入出力
|
|
||||||
- `DebugBox` - デバッグ支援・メモリ追跡
|
|
||||||
- `FileBox` - ファイルシステム操作（プラグイン）
|
|
||||||
|
|
||||||
### **5.4 数学・時間**
|
|
||||||
- `MathBox` - 数学関数（sin, cos, log, sqrt等）
|
|
||||||
- `TimeBox` - 時刻操作・タイマー
|
|
||||||
- `RandomBox` - 乱数生成・選択・シャッフル
|
|
||||||
|
|
||||||
### **5.5 データ処理**
|
|
||||||
- `JSONBox` - JSON解析・生成（parse, stringify, get, set）
|
|
||||||
- `RegexBox` - 正規表現（test, find, replace, split）
|
|
||||||
- `BufferBox` - バイナリデータ処理
|
|
||||||
- `StreamBox` - ストリーム処理
|
|
||||||
|
|
||||||
### **5.6 ネットワーク・Web**
|
|
||||||
- `HttpClientBox` - HTTP通信（プラグイン）
|
|
||||||
- `WebDisplayBox` - HTML表示（WASM）
|
|
||||||
- `WebConsoleBox` - ブラウザコンソール（WASM）
|
|
||||||
- `WebCanvasBox` - Canvas描画（WASM）
|
|
||||||
|
|
||||||
### **5.7 GUI・マルチメディア**
|
|
||||||
- `EguiBox` - デスクトップGUI（Windows/Linux、プラグイン）
|
|
||||||
- `SoundBox` - 音声再生
|
|
||||||
|
|
||||||
### **5.8 特殊用途**
|
|
||||||
- `FutureBox` - 非同期処理結果
|
|
||||||
- `ResultBox` - エラー処理（Ok/Err）
|
|
||||||
- `TokenBox` - キャンセルトークン
|
|
||||||
- `FunctionBox` - 第一級関数
|
|
||||||
- `P2PBox` - P2P通信（プラグイン）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎯 **6. パフォーマンス・デザイン原則**
|
|
||||||
|
|
||||||
### **6.1 メモリ安全性**
|
|
||||||
- Rust所有権システムによる完全なメモリ安全性
|
|
||||||
- Arc<Mutex>によるスレッドセーフな共有状態管理
|
|
||||||
- 自動参照カウント + 明示的デストラクタ（fini）
|
|
||||||
|
|
||||||
### **6.2 実行効率**
|
|
||||||
- 統一されたBox型システムによる最適化
|
|
||||||
- 静的・動的ハイブリッドディスパッチで高速演算
|
|
||||||
- パーサー無限ループ対策（--debug-fuel）
|
|
||||||
|
|
||||||
### **6.3 開発効率**
|
|
||||||
- 変数宣言厳密化による早期エラー検出
|
|
||||||
- 包括的デバッグ機能（DebugBox）
|
|
||||||
- 直感的な"Everything is Box"概念
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📚 **7. 学習パス・ベストプラクティス**
|
|
||||||
|
|
||||||
### **7.1 初心者向け学習順序**
|
|
||||||
1. **基本概念**: Everything is Box哲学理解
|
|
||||||
2. **基本構文**: 変数宣言・制御構文・演算子
|
|
||||||
3. **Box定義**: 基本的なクラス作成
|
|
||||||
4. **Static Box Main**: アプリケーションエントリーポイント
|
|
||||||
5. **継承・インターフェース**: オブジェクト指向機能
|
|
||||||
|
|
||||||
### **7.2 推奨コーディングスタイル**
|
|
||||||
```nyash
|
|
||||||
# ✅ 推奨スタイル
|
|
||||||
static box Main {
|
|
||||||
public console: ConsoleBox # 公開フィールド明示
|
|
||||||
public result: IntegerBox
|
|
||||||
|
|
||||||
main() {
|
|
||||||
me.console = new ConsoleBox()
|
|
||||||
|
|
||||||
local data # 変数事前宣言
|
|
||||||
data = processInput()
|
|
||||||
|
|
||||||
me.result = data # 明確な代入
|
|
||||||
return "Success"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **7.3 よくある間違いと対策**
|
|
||||||
```nyash
|
|
||||||
# ❌ よくある間違い
|
|
||||||
public { field1 field2 } # 旧構文 → 使用不可
|
|
||||||
x = 42 # 変数未宣言 → ランタイムエラー
|
|
||||||
while condition { } # 非対応構文 → パーサーエラー
|
|
||||||
this.field # thisは使用不可 → me.fieldを使用
|
|
||||||
|
|
||||||
# ✅ 正しい書き方（Phase 12.7後）
|
|
||||||
field1: TypeBox # フィールド宣言（型は省略可）
|
|
||||||
field2 # 型なしフィールド
|
|
||||||
local x = 42 # 事前宣言必須
|
|
||||||
loop(condition) { } # 統一ループ構文
|
|
||||||
me.field # self参照はmeのみ
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📌 **8. 糖衣構文（Phase 12.7-B）**
|
|
||||||
|
|
||||||
### 実装済み（ゲート: `NYASH_SYNTAX_SUGAR_LEVEL=basic|full`）
|
|
||||||
```nyash
|
|
||||||
# パイプライン
|
|
||||||
result = data |> normalize() |> transform() |> process
|
|
||||||
|
|
||||||
# セーフアクセス + デフォルト
|
|
||||||
name = user?.profile?.name ?? "guest"
|
|
||||||
|
|
||||||
# 複合代入
|
|
||||||
x += 1; y *= 2
|
|
||||||
|
|
||||||
# 範囲（内部的には Range(a,b)）
|
|
||||||
loop(i in 1 .. 5) { /* ... */ }
|
|
||||||
```
|
|
||||||
|
|
||||||
### 拡張（段階適用予定・設計済み）
|
|
||||||
```nyash
|
|
||||||
let {x, y} = point
|
|
||||||
let [first, second, ...rest] = array
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**🎉 Nyash 2025は、AI協働設計による最先端言語システムとして、シンプルさと強力さを完全に両立しました。**
|
|
||||||
|
|
||||||
*最終更新: 2025年9月4日 - Phase 12.7実装済み機能の正確な反映*
|
|
||||||
@ -4,7 +4,7 @@
|
|||||||
|
|
||||||
**最新の完全な言語リファレンスは以下を参照してください：**
|
**最新の完全な言語リファレンスは以下を参照してください：**
|
||||||
|
|
||||||
- **[🚀 Nyash Language Reference 2025](../language/LANGUAGE_REFERENCE_2025.md)** - 完全な言語仕様（最新版）
|
- **[🚀 Nyash Language Reference 2025](../../../reference/language/LANGUAGE_REFERENCE_2025.md)** - 完全な言語仕様（最新版）
|
||||||
- **[📝 構文早見表](../../quick-reference/syntax-cheatsheet.md)** - よく使う構文のクイックリファレンス
|
- **[📝 構文早見表](../../quick-reference/syntax-cheatsheet.md)** - よく使う構文のクイックリファレンス
|
||||||
|
|
||||||
## 📁 このディレクトリの内容
|
## 📁 このディレクトリの内容
|
||||||
@ -20,4 +20,4 @@
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
**注意**: 言語仕様に関する最新情報は必ず [LANGUAGE_REFERENCE_2025.md](../language/LANGUAGE_REFERENCE_2025.md) を参照してください。
|
**注意**: 言語仕様に関する最新情報は必ず [LANGUAGE_REFERENCE_2025.md](../../../reference/language/LANGUAGE_REFERENCE_2025.md) を参照してください。
|
||||||
|
|||||||
@ -1,659 +0,0 @@
|
|||||||
# 🚀 Nyash Language Reference 2025
|
|
||||||
|
|
||||||
**最終更新: 2025年9月4日 - Phase 12.7実装済み機能の正確な反映**
|
|
||||||
|
|
||||||
## 📖 概要
|
|
||||||
|
|
||||||
Nyashは「Everything is Box」哲学に基づく革新的プログラミング言語です。
|
|
||||||
Rust製インタープリターによる高性能実行と、直感的な構文により、学習しやすく実用的な言語として完成しました。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🔤 **1. 予約語・キーワード完全リスト**
|
|
||||||
|
|
||||||
### **Phase 12.7で確定した15個の予約語**
|
|
||||||
| 予約語 | 用途 | 例 |
|
|
||||||
|-------|------|---|
|
|
||||||
| `box` | クラス定義 | `box MyClass { }` |
|
|
||||||
| `new` | オブジェクト生成 | `new ConsoleBox()` |
|
|
||||||
| `me` | 自己参照（thisの代わり） | `me.field = value` |
|
|
||||||
| `local` | ローカル変数宣言 | `local x, y = 10` |
|
|
||||||
| `return` | 関数リターン | `return value` |
|
|
||||||
| `from` | デリゲーション・親メソッド呼び出し | `box Child from Parent` / `from Parent.method()` |
|
|
||||||
| `birth` | コンストラクタ（統一名） | `birth(param) { }` |
|
|
||||||
| `static` | 静的Box・関数定義 | `static box Main { }` |
|
|
||||||
| `if` | 条件分岐 | `if condition { }` |
|
|
||||||
| `else` | else節 | `else { }` |
|
|
||||||
| `loop` | ループ（唯一の形式） | `loop(condition) { }` |
|
|
||||||
| `continue` | ループ継続 | `continue` |
|
|
||||||
| `peek` | パターンマッチング風分岐 | `peek value { "A" => 1, else => 0 }` |
|
|
||||||
| `try` | 例外捕獲開始 | `try { }` |
|
|
||||||
| `interface` | インターフェース定義 | `interface Comparable { }` |
|
|
||||||
|
|
||||||
### **その他の重要キーワード（予約語ではない）**
|
|
||||||
| キーワード | 用途 | 例 |
|
|
||||||
|-------|------|---|
|
|
||||||
| `override` | 明示的オーバーライド | `override speak() { }` |
|
|
||||||
| `break` | ループ脱出 | `break` |
|
|
||||||
| `catch` | 例外処理 | `catch (e) { }` |
|
|
||||||
| `finally` | 最終処理 | `finally { }` |
|
|
||||||
| `throw` | 例外発生 | `throw error` |
|
|
||||||
| `nowait` | 非同期実行 | `nowait future = task()` |
|
|
||||||
| `await` | 待機・結果取得 | `result = await future` |
|
|
||||||
| `include` | ファイル取り込み | `include "math.nyash"` |
|
|
||||||
| `print` | 出力（デバッグ用） | `print("Hello")` |
|
|
||||||
| `function`/`fn` | 関数定義 | `fn add(a,b) { }` |
|
|
||||||
| `init` | 初期化ブロック | `init { field1, field2 }` |
|
|
||||||
| `pack` | 旧コンストラクタ（互換性） | `pack(param) { }` |
|
|
||||||
| `outbox` | 所有権移転変数 | `outbox result = compute()` |
|
|
||||||
| `global` | グローバル変数 | `global CONFIG = "dev"` |
|
|
||||||
| `weak` | 弱参照修飾子 | `weak reference` |
|
|
||||||
| `using` | 名前空間インポート | `using namespace` |
|
|
||||||
|
|
||||||
### **演算子・論理**
|
|
||||||
| 演算子/キーワード | 用途 | 例 |
|
|
||||||
|-------|------|---|
|
|
||||||
| `not` | 論理否定 | `not condition` |
|
|
||||||
| `and` | 論理積 | `a and b` |
|
|
||||||
| `or` | 論理和 | `a or b` |
|
|
||||||
| `true`/`false` | 真偽値 | `flag = true` |
|
|
||||||
| `null` | null値 | `value = null` |
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📝 **2. 文法・構文仕様**
|
|
||||||
|
|
||||||
### **2.1 Box定義文法**
|
|
||||||
|
|
||||||
#### **基本Box**
|
|
||||||
```nyash
|
|
||||||
box ClassName {
|
|
||||||
# フィールド宣言（Phase 12.7形式）
|
|
||||||
field1: TypeBox # フィールド型アノテーション（P0では無視）
|
|
||||||
field2: TypeBox
|
|
||||||
field3 # 型なしも可
|
|
||||||
|
|
||||||
# コンストラクタ
|
|
||||||
birth(param1, param2) { # birth構文に統一
|
|
||||||
me.field1 = param1
|
|
||||||
me.field2 = param2
|
|
||||||
me.field3 = defaultValue()
|
|
||||||
}
|
|
||||||
|
|
||||||
# メソッド
|
|
||||||
methodName(arg1, arg2) {
|
|
||||||
return me.field1 + arg1
|
|
||||||
}
|
|
||||||
|
|
||||||
# デストラクタ（fini）
|
|
||||||
fini() {
|
|
||||||
print("Cleanup: " + me.field1)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **デリゲーションBox**
|
|
||||||
```nyash
|
|
||||||
box Child from Parent interface Comparable {
|
|
||||||
childField: TypeBox # 追加フィールド
|
|
||||||
|
|
||||||
birth(parentParam, childParam) { # birth構文に統一
|
|
||||||
from Parent.birth(parentParam) # 親コンストラクタ明示呼び出し
|
|
||||||
me.childField = childParam
|
|
||||||
}
|
|
||||||
|
|
||||||
# メソッドオーバーライド
|
|
||||||
override process(data) { # overrideキーワード必須
|
|
||||||
local result = from Parent.process(data) # 親メソッド呼び出し
|
|
||||||
return result + " (Child processed)"
|
|
||||||
}
|
|
||||||
|
|
||||||
# インターフェース実装
|
|
||||||
compareTo(other) {
|
|
||||||
return me.value - other.value
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **Static Box（推奨エントリーポイント）**
|
|
||||||
```nyash
|
|
||||||
static box Main {
|
|
||||||
console: ConsoleBox
|
|
||||||
result: IntegerBox
|
|
||||||
|
|
||||||
main() {
|
|
||||||
me.console = new ConsoleBox()
|
|
||||||
me.console.log("🎉 Everything is Box!")
|
|
||||||
return "Success"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **2.2 変数宣言**
|
|
||||||
|
|
||||||
#### **基本パターン**
|
|
||||||
```nyash
|
|
||||||
# 単一宣言
|
|
||||||
local x
|
|
||||||
local name = "初期値"
|
|
||||||
|
|
||||||
# 複数宣言
|
|
||||||
local a, b, c
|
|
||||||
local x = 10, y = 20, z # 混合初期化
|
|
||||||
|
|
||||||
# 所有権移転（static関数内）
|
|
||||||
static function Factory.create() {
|
|
||||||
outbox product # 呼び出し側に所有権移転
|
|
||||||
product = new Item()
|
|
||||||
return product
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **変数宣言厳密化システム（2025-08-09実装）**
|
|
||||||
```nyash
|
|
||||||
# ✅ 正しい - 明示宣言必須
|
|
||||||
local temp
|
|
||||||
temp = 42
|
|
||||||
|
|
||||||
# ❌ エラー - 未宣言変数への代入
|
|
||||||
x = 42 # RuntimeError: 未宣言変数 + 修正提案表示
|
|
||||||
```
|
|
||||||
|
|
||||||
### **2.3 制御構文**
|
|
||||||
|
|
||||||
#### **条件分岐**
|
|
||||||
```nyash
|
|
||||||
if condition {
|
|
||||||
# 処理
|
|
||||||
} else if condition2 {
|
|
||||||
# 処理2
|
|
||||||
} else {
|
|
||||||
# else処理
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **ループ（統一構文）**
|
|
||||||
```nyash
|
|
||||||
# ✅ 唯一の正しい形式
|
|
||||||
loop(condition) {
|
|
||||||
# ループ本体
|
|
||||||
if exitCondition {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
if skipCondition {
|
|
||||||
continue # Phase 12.7で追加
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# ❌ 削除済み - 使用不可
|
|
||||||
while condition { } # パーサーエラー
|
|
||||||
loop() { } # パーサーエラー
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **Peek式（Phase 12.7で追加）**
|
|
||||||
```nyash
|
|
||||||
# パターンマッチング風の分岐
|
|
||||||
local result = peek value {
|
|
||||||
"A" => 100,
|
|
||||||
"B" => 200,
|
|
||||||
"C" => 300,
|
|
||||||
else => 0 # else必須
|
|
||||||
}
|
|
||||||
|
|
||||||
# 文の形式も可
|
|
||||||
peek status {
|
|
||||||
"error" => {
|
|
||||||
print("Error occurred")
|
|
||||||
return null
|
|
||||||
},
|
|
||||||
"success" => {
|
|
||||||
print("All good")
|
|
||||||
},
|
|
||||||
else => {
|
|
||||||
print("Unknown status")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **2.4 演算子・式**
|
|
||||||
|
|
||||||
#### **🚀 新実装: 関数オーバーロードシステム**
|
|
||||||
```nyash
|
|
||||||
# Rust風トレイトベース演算子（2025-08-10実装完了）
|
|
||||||
sum = 10 + 20 # IntegerBox + IntegerBox = IntegerBox
|
|
||||||
concat = "Hi" + " !" # StringBox + StringBox = StringBox
|
|
||||||
repeat = "Ha" * 3 # StringBox * IntegerBox = "HaHaHa"
|
|
||||||
mixed = 42 + " answer" # 混合型 → 自動文字列結合フォールバック
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **演算子優先順位**
|
|
||||||
```nyash
|
|
||||||
result = a + b * c / d - e # 算術演算子は標準的優先順位
|
|
||||||
logic = not a and b or c # not > and > or
|
|
||||||
compare = (x > y) and (z <= w) # 比較は括弧推奨
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **論理演算子**
|
|
||||||
```nyash
|
|
||||||
# キーワード版（推奨）
|
|
||||||
canAccess = level >= 5 and hasKey
|
|
||||||
isValid = not (isEmpty or hasError)
|
|
||||||
|
|
||||||
# シンボル版（互換）
|
|
||||||
result = condition && other || fallback # 利用可能だが非推奨
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **特殊演算子（Phase 12.7実装済み）**
|
|
||||||
```nyash
|
|
||||||
# ? 演算子 - Result伝播
|
|
||||||
local data = readFile(path)? # エラーなら早期return
|
|
||||||
|
|
||||||
# ラムダ式
|
|
||||||
local add = fn(x, y) { return x + y }
|
|
||||||
local double = fn(x) { x * 2 } # 単一式なら省略可
|
|
||||||
|
|
||||||
# await式
|
|
||||||
local result = await asyncTask()
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🏗️ **3. Box構文詳細ガイド**
|
|
||||||
|
|
||||||
### **3.1 Everything is Box 原則**
|
|
||||||
|
|
||||||
```nyash
|
|
||||||
# すべての値がBox
|
|
||||||
number = 42 # IntegerBox
|
|
||||||
text = "hello" # StringBox
|
|
||||||
flag = true # BoolBox
|
|
||||||
array = new ArrayBox() # ArrayBox
|
|
||||||
console = new ConsoleBox() # ConsoleBox
|
|
||||||
|
|
||||||
# 統一的なメソッド呼び出し
|
|
||||||
print(number.to_string_box().value) # "42"
|
|
||||||
print(array.length()) # 配列長
|
|
||||||
console.log("Everything is Box!") # コンソール出力
|
|
||||||
```
|
|
||||||
|
|
||||||
### **3.2 コンストラクタパターン**
|
|
||||||
|
|
||||||
#### **パラメータ付きコンストラクタ**
|
|
||||||
```nyash
|
|
||||||
box Person {
|
|
||||||
public name: StringBox
|
|
||||||
public email: StringBox
|
|
||||||
private age: IntegerBox
|
|
||||||
|
|
||||||
birth(personName, personAge) { # birth構文に統一
|
|
||||||
me.name = personName
|
|
||||||
me.age = personAge
|
|
||||||
me.email = me.name + "@example.com" # 計算フィールド
|
|
||||||
}
|
|
||||||
|
|
||||||
# ファクトリーメソッド
|
|
||||||
static createGuest() {
|
|
||||||
outbox guest
|
|
||||||
guest = new Person("Guest", 0)
|
|
||||||
return guest
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# 使用例
|
|
||||||
person = new Person("Alice", 25)
|
|
||||||
guest = Person.createGuest()
|
|
||||||
```
|
|
||||||
|
|
||||||
### **3.3 継承とインターフェース**
|
|
||||||
|
|
||||||
#### **デリゲーションチェーン**
|
|
||||||
```nyash
|
|
||||||
# 基底Box
|
|
||||||
box Animal {
|
|
||||||
public name: StringBox
|
|
||||||
public species: StringBox
|
|
||||||
|
|
||||||
birth(animalName, animalSpecies) {
|
|
||||||
me.name = animalName
|
|
||||||
me.species = animalSpecies
|
|
||||||
}
|
|
||||||
|
|
||||||
speak() {
|
|
||||||
return me.name + " makes a sound"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# デリゲーション
|
|
||||||
box Dog from Animal {
|
|
||||||
breed: StringBox # 追加フィールド
|
|
||||||
|
|
||||||
birth(dogName, dogBreed) {
|
|
||||||
from Animal.birth(dogName, "Canine") # 親コンストラクタ呼び出し
|
|
||||||
me.breed = dogBreed
|
|
||||||
}
|
|
||||||
|
|
||||||
override speak() { # 明示的オーバーライド
|
|
||||||
return me.name + " barks: Woof!"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# インターフェース実装
|
|
||||||
box Cat from Animal interface Playful {
|
|
||||||
# Playfulインターフェースの実装必須
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **3.4 Static Boxパターン**
|
|
||||||
|
|
||||||
#### **名前空間・ユーティリティ**
|
|
||||||
```nyash
|
|
||||||
static box MathUtils {
|
|
||||||
PI: FloatBox
|
|
||||||
E: FloatBox
|
|
||||||
|
|
||||||
# 注意: static初期化ブロックは未実装
|
|
||||||
# 初期化はメソッド内で行う
|
|
||||||
|
|
||||||
add(a, b) {
|
|
||||||
return a + b
|
|
||||||
}
|
|
||||||
|
|
||||||
circleArea(radius) {
|
|
||||||
# 初回アクセスで初期化パターン
|
|
||||||
if me.PI == null {
|
|
||||||
me.PI = 3.14159265
|
|
||||||
}
|
|
||||||
return me.PI * radius * radius
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
# 使用法
|
|
||||||
area = MathUtils.circleArea(5)
|
|
||||||
sum = MathUtils.add(10, 20)
|
|
||||||
```
|
|
||||||
|
|
||||||
#### **アプリケーションエントリーポイント**
|
|
||||||
```nyash
|
|
||||||
# 🎯 推奨: Static Box Main パターン
|
|
||||||
static box Main {
|
|
||||||
console: ConsoleBox
|
|
||||||
result: IntegerBox
|
|
||||||
|
|
||||||
main() {
|
|
||||||
me.console = new ConsoleBox()
|
|
||||||
me.console.log("🚀 Starting application...")
|
|
||||||
|
|
||||||
# アプリケーションロジック
|
|
||||||
me.result = processData()
|
|
||||||
|
|
||||||
return "Application completed successfully"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 **4. 最新機能・革新技術**
|
|
||||||
|
|
||||||
### **4.1 Arc<Mutex> Revolution（2025-08-10）**
|
|
||||||
```nyash
|
|
||||||
# 全16種類のBox型が統一Arc<Mutex>パターンで実装
|
|
||||||
# 完全なスレッドセーフティと高性能を両立
|
|
||||||
|
|
||||||
array = new ArrayBox()
|
|
||||||
array.push(10) # スレッドセーフな追加
|
|
||||||
array.push(20)
|
|
||||||
item = array.get(0) # スレッドセーフな取得
|
|
||||||
|
|
||||||
json = new JSONBox()
|
|
||||||
json.set("name", "Alice") # 並行安全な操作
|
|
||||||
data = json.stringify() # JSON文字列化
|
|
||||||
```
|
|
||||||
|
|
||||||
### **4.2 Rust風トレイトベース演算子（2025-08-10）**
|
|
||||||
```nyash
|
|
||||||
# AI大相談会で決定された最適設計
|
|
||||||
# 静的・動的ハイブリッドディスパッチによる高性能実現
|
|
||||||
|
|
||||||
# 整数演算
|
|
||||||
result = 100 - 25 # IntegerBox間演算 → IntegerBox
|
|
||||||
product = 6 * 7 # 高速静的ディスパッチ
|
|
||||||
|
|
||||||
# 文字列操作
|
|
||||||
greeting = "Hello" + " World" # 文字列結合
|
|
||||||
repeated = "Echo" * 3 # "EchoEchoEcho"
|
|
||||||
|
|
||||||
# 混合型フォールバック
|
|
||||||
message = "Answer: " + 42 # "Answer: 42"
|
|
||||||
|
|
||||||
# Boolean演算
|
|
||||||
boolSum = true + false # 1 (IntegerBox)
|
|
||||||
```
|
|
||||||
|
|
||||||
### **4.3 変数宣言厳密化（2025-08-09）**
|
|
||||||
```nyash
|
|
||||||
# メモリ安全性・非同期安全性保証システム
|
|
||||||
|
|
||||||
static box Calculator {
|
|
||||||
private memory: ArrayBox # 必須フィールド宣言
|
|
||||||
|
|
||||||
calculate() {
|
|
||||||
local temp # 必須ローカル変数宣言
|
|
||||||
temp = me.memory * 2
|
|
||||||
return temp
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🚀 **4.4 Phase 12.7実装済み機能**
|
|
||||||
|
|
||||||
### **Peek式 - パターンマッチング風分岐**
|
|
||||||
```nyash
|
|
||||||
# 式として使用（値を返す）
|
|
||||||
local grade = peek score {
|
|
||||||
100 => "Perfect",
|
|
||||||
90 => "Excellent",
|
|
||||||
80 => "Good",
|
|
||||||
else => "Needs improvement"
|
|
||||||
}
|
|
||||||
|
|
||||||
# 文として使用（アクション実行）
|
|
||||||
peek command {
|
|
||||||
"save" => {
|
|
||||||
saveFile()
|
|
||||||
print("Saved!")
|
|
||||||
},
|
|
||||||
"quit" => {
|
|
||||||
cleanup()
|
|
||||||
return
|
|
||||||
},
|
|
||||||
else => print("Unknown command")
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **Continue文**
|
|
||||||
```nyash
|
|
||||||
loop(i < 100) {
|
|
||||||
if i % 2 == 0 {
|
|
||||||
continue # 偶数をスキップ
|
|
||||||
}
|
|
||||||
process(i)
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **フィールド型アノテーション**
|
|
||||||
```nyash
|
|
||||||
box Person {
|
|
||||||
name: StringBox # 型情報を明記（P0では無視）
|
|
||||||
age: IntegerBox
|
|
||||||
email # 型なしも可
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **?演算子（Result伝播）**
|
|
||||||
```nyash
|
|
||||||
# ResultBoxのエラーを自動的に早期return
|
|
||||||
local data = readFile("config.json")?
|
|
||||||
local parsed = parseJSON(data)?
|
|
||||||
return parsed.get("version")
|
|
||||||
```
|
|
||||||
|
|
||||||
### **Lambda式**
|
|
||||||
```nyash
|
|
||||||
# 基本形
|
|
||||||
local add = fn(x, y) { return x + y }
|
|
||||||
|
|
||||||
# 単一式の場合（returnは省略可）
|
|
||||||
local double = fn(x) { x * 2 }
|
|
||||||
|
|
||||||
# 高階関数での使用
|
|
||||||
array.map(fn(x) { x * x })
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## ⚡ **5. 実装済みBox型ライブラリ**
|
|
||||||
|
|
||||||
### **5.1 基本型**
|
|
||||||
- `StringBox` - 文字列（split, find, replace, trim等）
|
|
||||||
- `IntegerBox` - 64bit整数
|
|
||||||
- `FloatBox` - 64bit浮動小数点数
|
|
||||||
- `BoolBox` - 真偽値
|
|
||||||
- `NullBox` - null値
|
|
||||||
- `VoidBox` - void値
|
|
||||||
|
|
||||||
### **5.2 コレクション**
|
|
||||||
- `ArrayBox` - 動的配列（push, pop, get, set, join等）
|
|
||||||
- `MapBox` - 連想配列・辞書
|
|
||||||
|
|
||||||
### **5.3 システム・I/O**
|
|
||||||
- `ConsoleBox` - コンソール入出力
|
|
||||||
- `DebugBox` - デバッグ支援・メモリ追跡
|
|
||||||
- `FileBox` - ファイルシステム操作（プラグイン）
|
|
||||||
|
|
||||||
### **5.4 数学・時間**
|
|
||||||
- `MathBox` - 数学関数（sin, cos, log, sqrt等）
|
|
||||||
- `TimeBox` - 時刻操作・タイマー
|
|
||||||
- `RandomBox` - 乱数生成・選択・シャッフル
|
|
||||||
|
|
||||||
### **5.5 データ処理**
|
|
||||||
- `JSONBox` - JSON解析・生成（parse, stringify, get, set）
|
|
||||||
- `RegexBox` - 正規表現（test, find, replace, split）
|
|
||||||
- `BufferBox` - バイナリデータ処理
|
|
||||||
- `StreamBox` - ストリーム処理
|
|
||||||
|
|
||||||
### **5.6 ネットワーク・Web**
|
|
||||||
- `HttpClientBox` - HTTP通信（プラグイン）
|
|
||||||
- `WebDisplayBox` - HTML表示（WASM）
|
|
||||||
- `WebConsoleBox` - ブラウザコンソール（WASM）
|
|
||||||
- `WebCanvasBox` - Canvas描画（WASM）
|
|
||||||
|
|
||||||
### **5.7 GUI・マルチメディア**
|
|
||||||
- `EguiBox` - デスクトップGUI（Windows/Linux、プラグイン）
|
|
||||||
- `SoundBox` - 音声再生
|
|
||||||
|
|
||||||
### **5.8 特殊用途**
|
|
||||||
- `FutureBox` - 非同期処理結果
|
|
||||||
- `ResultBox` - エラー処理（Ok/Err）
|
|
||||||
- `TokenBox` - キャンセルトークン
|
|
||||||
- `FunctionBox` - 第一級関数
|
|
||||||
- `P2PBox` - P2P通信（プラグイン）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎯 **6. パフォーマンス・デザイン原則**
|
|
||||||
|
|
||||||
### **6.1 メモリ安全性**
|
|
||||||
- Rust所有権システムによる完全なメモリ安全性
|
|
||||||
- Arc<Mutex>によるスレッドセーフな共有状態管理
|
|
||||||
- 自動参照カウント + 明示的デストラクタ（fini）
|
|
||||||
|
|
||||||
### **6.2 実行効率**
|
|
||||||
- 統一されたBox型システムによる最適化
|
|
||||||
- 静的・動的ハイブリッドディスパッチで高速演算
|
|
||||||
- パーサー無限ループ対策（--debug-fuel）
|
|
||||||
|
|
||||||
### **6.3 開発効率**
|
|
||||||
- 変数宣言厳密化による早期エラー検出
|
|
||||||
- 包括的デバッグ機能（DebugBox）
|
|
||||||
- 直感的な"Everything is Box"概念
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📚 **7. 学習パス・ベストプラクティス**
|
|
||||||
|
|
||||||
### **7.1 初心者向け学習順序**
|
|
||||||
1. **基本概念**: Everything is Box哲学理解
|
|
||||||
2. **基本構文**: 変数宣言・制御構文・演算子
|
|
||||||
3. **Box定義**: 基本的なクラス作成
|
|
||||||
4. **Static Box Main**: アプリケーションエントリーポイント
|
|
||||||
5. **継承・インターフェース**: オブジェクト指向機能
|
|
||||||
|
|
||||||
### **7.2 推奨コーディングスタイル**
|
|
||||||
```nyash
|
|
||||||
# ✅ 推奨スタイル
|
|
||||||
static box Main {
|
|
||||||
public console: ConsoleBox # 公開フィールド明示
|
|
||||||
public result: IntegerBox
|
|
||||||
|
|
||||||
main() {
|
|
||||||
me.console = new ConsoleBox()
|
|
||||||
|
|
||||||
local data # 変数事前宣言
|
|
||||||
data = processInput()
|
|
||||||
|
|
||||||
me.result = data # 明確な代入
|
|
||||||
return "Success"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### **7.3 よくある間違いと対策**
|
|
||||||
```nyash
|
|
||||||
# ❌ よくある間違い
|
|
||||||
public { field1 field2 } # 旧構文 → 使用不可
|
|
||||||
x = 42 # 変数未宣言 → ランタイムエラー
|
|
||||||
while condition { } # 非対応構文 → パーサーエラー
|
|
||||||
this.field # thisは使用不可 → me.fieldを使用
|
|
||||||
|
|
||||||
# ✅ 正しい書き方（Phase 12.7後）
|
|
||||||
field1: TypeBox # フィールド宣言（型は省略可）
|
|
||||||
field2 # 型なしフィールド
|
|
||||||
local x = 42 # 事前宣言必須
|
|
||||||
loop(condition) { } # 統一ループ構文
|
|
||||||
me.field # self参照はmeのみ
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 📌 **8. 糖衣構文（Phase 12.7-B）**
|
|
||||||
|
|
||||||
### 実装済み（ゲート: `NYASH_SYNTAX_SUGAR_LEVEL=basic|full`）
|
|
||||||
```nyash
|
|
||||||
# パイプライン
|
|
||||||
result = data |> normalize() |> transform() |> process
|
|
||||||
|
|
||||||
# セーフアクセス + デフォルト
|
|
||||||
name = user?.profile?.name ?? "guest"
|
|
||||||
|
|
||||||
# 複合代入
|
|
||||||
x += 1; y *= 2
|
|
||||||
|
|
||||||
# 範囲（内部的には Range(a,b)）
|
|
||||||
loop(i in 1 .. 5) { /* ... */ }
|
|
||||||
```
|
|
||||||
|
|
||||||
### 拡張（段階適用予定・設計済み）
|
|
||||||
```nyash
|
|
||||||
let {x, y} = point
|
|
||||||
let [first, second, ...rest] = array
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**🎉 Nyash 2025は、AI協働設計による最先端言語システムとして、シンプルさと強力さを完全に両立しました。**
|
|
||||||
|
|
||||||
*最終更新: 2025年9月4日 - Phase 12.7実装済み機能の正確な反映*
|
|
||||||
@ -4,9 +4,9 @@ This index points to the currently maintained architectural documents:
|
|||||||
|
|
||||||
- Core Concepts: reference/architecture/nyash_core_concepts.md
|
- Core Concepts: reference/architecture/nyash_core_concepts.md
|
||||||
- Execution Backends: reference/architecture/execution-backends.md
|
- Execution Backends: reference/architecture/execution-backends.md
|
||||||
- Lowering Contexts: LOWERING_CONTEXTS.md
|
- Lowering Contexts: ../../design/LOWERING_CONTEXTS.md
|
||||||
- LLVM Layer Overview: LLVM_LAYER_OVERVIEW.md
|
- LLVM Layer Overview: ../../design/LLVM_LAYER_OVERVIEW.md
|
||||||
- VM Overview: VM_README.md
|
- VM Overview: VM_README.md
|
||||||
- Cranelift AOT design: backend-cranelift-aot-design.md
|
- Cranelift AOT design: ../../design/backend-cranelift-aot-design.md
|
||||||
|
|
||||||
Note: Some long-form papers reside under `private/papers/reference/architecture/`.
|
Note: Some long-form papers reside under `private/papers/reference/architecture/`.
|
||||||
|
|||||||
@ -4,5 +4,5 @@ For the full guide, see:
|
|||||||
- execution-backends.md (legacy location kept up to date)
|
- execution-backends.md (legacy location kept up to date)
|
||||||
|
|
||||||
Additional references:
|
Additional references:
|
||||||
- backend-llvm-implementation-guide.md
|
- ../../design/backend-llvm-implementation-guide.md
|
||||||
- VM_README.md
|
- VM_README.md
|
||||||
|
|||||||
@ -1,6 +1,659 @@
|
|||||||
# Language Reference (2025)
|
# 🚀 Nyash Language Reference 2025
|
||||||
|
|
||||||
The canonical 2025 language reference currently lives here:
|
**最終更新: 2025年9月4日 - Phase 12.7実装済み機能の正確な反映**
|
||||||
- private/papers/reference/language/LANGUAGE_REFERENCE_2025.md
|
|
||||||
|
|
||||||
This stub exists to provide a stable public path under `docs/reference/language/`.
|
## 📖 概要
|
||||||
|
|
||||||
|
Nyashは「Everything is Box」哲学に基づく革新的プログラミング言語です。
|
||||||
|
Rust製インタープリターによる高性能実行と、直感的な構文により、学習しやすく実用的な言語として完成しました。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔤 **1. 予約語・キーワード完全リスト**
|
||||||
|
|
||||||
|
### **Phase 12.7で確定した15個の予約語**
|
||||||
|
| 予約語 | 用途 | 例 |
|
||||||
|
|-------|------|---|
|
||||||
|
| `box` | クラス定義 | `box MyClass { }` |
|
||||||
|
| `new` | オブジェクト生成 | `new ConsoleBox()` |
|
||||||
|
| `me` | 自己参照（thisの代わり） | `me.field = value` |
|
||||||
|
| `local` | ローカル変数宣言 | `local x, y = 10` |
|
||||||
|
| `return` | 関数リターン | `return value` |
|
||||||
|
| `from` | デリゲーション・親メソッド呼び出し | `box Child from Parent` / `from Parent.method()` |
|
||||||
|
| `birth` | コンストラクタ（統一名） | `birth(param) { }` |
|
||||||
|
| `static` | 静的Box・関数定義 | `static box Main { }` |
|
||||||
|
| `if` | 条件分岐 | `if condition { }` |
|
||||||
|
| `else` | else節 | `else { }` |
|
||||||
|
| `loop` | ループ（唯一の形式） | `loop(condition) { }` |
|
||||||
|
| `continue` | ループ継続 | `continue` |
|
||||||
|
| `peek` | パターンマッチング風分岐 | `peek value { "A" => 1, else => 0 }` |
|
||||||
|
| `try` | 例外捕獲開始 | `try { }` |
|
||||||
|
| `interface` | インターフェース定義 | `interface Comparable { }` |
|
||||||
|
|
||||||
|
### **その他の重要キーワード（予約語ではない）**
|
||||||
|
| キーワード | 用途 | 例 |
|
||||||
|
|-------|------|---|
|
||||||
|
| `override` | 明示的オーバーライド | `override speak() { }` |
|
||||||
|
| `break` | ループ脱出 | `break` |
|
||||||
|
| `catch` | 例外処理 | `catch (e) { }` |
|
||||||
|
| `finally` | 最終処理 | `finally { }` |
|
||||||
|
| `throw` | 例外発生 | `throw error` |
|
||||||
|
| `nowait` | 非同期実行 | `nowait future = task()` |
|
||||||
|
| `await` | 待機・結果取得 | `result = await future` |
|
||||||
|
| `include` | ファイル取り込み | `include "math.nyash"` |
|
||||||
|
| `print` | 出力（デバッグ用） | `print("Hello")` |
|
||||||
|
| `function`/`fn` | 関数定義 | `fn add(a,b) { }` |
|
||||||
|
| `init` | 初期化ブロック | `init { field1, field2 }` |
|
||||||
|
| `pack` | 旧コンストラクタ（互換性） | `pack(param) { }` |
|
||||||
|
| `outbox` | 所有権移転変数 | `outbox result = compute()` |
|
||||||
|
| `global` | グローバル変数 | `global CONFIG = "dev"` |
|
||||||
|
| `weak` | 弱参照修飾子 | `weak reference` |
|
||||||
|
| `using` | 名前空間インポート | `using namespace` |
|
||||||
|
|
||||||
|
### **演算子・論理**
|
||||||
|
| 演算子/キーワード | 用途 | 例 |
|
||||||
|
|-------|------|---|
|
||||||
|
| `not` | 論理否定 | `not condition` |
|
||||||
|
| `and` | 論理積 | `a and b` |
|
||||||
|
| `or` | 論理和 | `a or b` |
|
||||||
|
| `true`/`false` | 真偽値 | `flag = true` |
|
||||||
|
| `null` | null値 | `value = null` |
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📝 **2. 文法・構文仕様**
|
||||||
|
|
||||||
|
### **2.1 Box定義文法**
|
||||||
|
|
||||||
|
#### **基本Box**
|
||||||
|
```nyash
|
||||||
|
box ClassName {
|
||||||
|
# フィールド宣言（Phase 12.7形式）
|
||||||
|
field1: TypeBox # フィールド型アノテーション（P0では無視）
|
||||||
|
field2: TypeBox
|
||||||
|
field3 # 型なしも可
|
||||||
|
|
||||||
|
# コンストラクタ
|
||||||
|
birth(param1, param2) { # birth構文に統一
|
||||||
|
me.field1 = param1
|
||||||
|
me.field2 = param2
|
||||||
|
me.field3 = defaultValue()
|
||||||
|
}
|
||||||
|
|
||||||
|
# メソッド
|
||||||
|
methodName(arg1, arg2) {
|
||||||
|
return me.field1 + arg1
|
||||||
|
}
|
||||||
|
|
||||||
|
# デストラクタ（fini）
|
||||||
|
fini() {
|
||||||
|
print("Cleanup: " + me.field1)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **デリゲーションBox**
|
||||||
|
```nyash
|
||||||
|
box Child from Parent interface Comparable {
|
||||||
|
childField: TypeBox # 追加フィールド
|
||||||
|
|
||||||
|
birth(parentParam, childParam) { # birth構文に統一
|
||||||
|
from Parent.birth(parentParam) # 親コンストラクタ明示呼び出し
|
||||||
|
me.childField = childParam
|
||||||
|
}
|
||||||
|
|
||||||
|
# メソッドオーバーライド
|
||||||
|
override process(data) { # overrideキーワード必須
|
||||||
|
local result = from Parent.process(data) # 親メソッド呼び出し
|
||||||
|
return result + " (Child processed)"
|
||||||
|
}
|
||||||
|
|
||||||
|
# インターフェース実装
|
||||||
|
compareTo(other) {
|
||||||
|
return me.value - other.value
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **Static Box（推奨エントリーポイント）**
|
||||||
|
```nyash
|
||||||
|
static box Main {
|
||||||
|
console: ConsoleBox
|
||||||
|
result: IntegerBox
|
||||||
|
|
||||||
|
main() {
|
||||||
|
me.console = new ConsoleBox()
|
||||||
|
me.console.log("🎉 Everything is Box!")
|
||||||
|
return "Success"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### **2.2 変数宣言**
|
||||||
|
|
||||||
|
#### **基本パターン**
|
||||||
|
```nyash
|
||||||
|
# 単一宣言
|
||||||
|
local x
|
||||||
|
local name = "初期値"
|
||||||
|
|
||||||
|
# 複数宣言
|
||||||
|
local a, b, c
|
||||||
|
local x = 10, y = 20, z # 混合初期化
|
||||||
|
|
||||||
|
# 所有権移転（static関数内）
|
||||||
|
static function Factory.create() {
|
||||||
|
outbox product # 呼び出し側に所有権移転
|
||||||
|
product = new Item()
|
||||||
|
return product
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **変数宣言厳密化システム（2025-08-09実装）**
|
||||||
|
```nyash
|
||||||
|
# ✅ 正しい - 明示宣言必須
|
||||||
|
local temp
|
||||||
|
temp = 42
|
||||||
|
|
||||||
|
# ❌ エラー - 未宣言変数への代入
|
||||||
|
x = 42 # RuntimeError: 未宣言変数 + 修正提案表示
|
||||||
|
```
|
||||||
|
|
||||||
|
### **2.3 制御構文**
|
||||||
|
|
||||||
|
#### **条件分岐**
|
||||||
|
```nyash
|
||||||
|
if condition {
|
||||||
|
# 処理
|
||||||
|
} else if condition2 {
|
||||||
|
# 処理2
|
||||||
|
} else {
|
||||||
|
# else処理
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **ループ（統一構文）**
|
||||||
|
```nyash
|
||||||
|
# ✅ 唯一の正しい形式
|
||||||
|
loop(condition) {
|
||||||
|
# ループ本体
|
||||||
|
if exitCondition {
|
||||||
|
break
|
||||||
|
}
|
||||||
|
if skipCondition {
|
||||||
|
continue # Phase 12.7で追加
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# ❌ 削除済み - 使用不可
|
||||||
|
while condition { } # パーサーエラー
|
||||||
|
loop() { } # パーサーエラー
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **Peek式（Phase 12.7で追加）**
|
||||||
|
```nyash
|
||||||
|
# パターンマッチング風の分岐
|
||||||
|
local result = peek value {
|
||||||
|
"A" => 100,
|
||||||
|
"B" => 200,
|
||||||
|
"C" => 300,
|
||||||
|
else => 0 # else必須
|
||||||
|
}
|
||||||
|
|
||||||
|
# 文の形式も可
|
||||||
|
peek status {
|
||||||
|
"error" => {
|
||||||
|
print("Error occurred")
|
||||||
|
return null
|
||||||
|
},
|
||||||
|
"success" => {
|
||||||
|
print("All good")
|
||||||
|
},
|
||||||
|
else => {
|
||||||
|
print("Unknown status")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### **2.4 演算子・式**
|
||||||
|
|
||||||
|
#### **🚀 新実装: 関数オーバーロードシステム**
|
||||||
|
```nyash
|
||||||
|
# Rust風トレイトベース演算子（2025-08-10実装完了）
|
||||||
|
sum = 10 + 20 # IntegerBox + IntegerBox = IntegerBox
|
||||||
|
concat = "Hi" + " !" # StringBox + StringBox = StringBox
|
||||||
|
repeat = "Ha" * 3 # StringBox * IntegerBox = "HaHaHa"
|
||||||
|
mixed = 42 + " answer" # 混合型 → 自動文字列結合フォールバック
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **演算子優先順位**
|
||||||
|
```nyash
|
||||||
|
result = a + b * c / d - e # 算術演算子は標準的優先順位
|
||||||
|
logic = not a and b or c # not > and > or
|
||||||
|
compare = (x > y) and (z <= w) # 比較は括弧推奨
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **論理演算子**
|
||||||
|
```nyash
|
||||||
|
# キーワード版（推奨）
|
||||||
|
canAccess = level >= 5 and hasKey
|
||||||
|
isValid = not (isEmpty or hasError)
|
||||||
|
|
||||||
|
# シンボル版（互換）
|
||||||
|
result = condition && other || fallback # 利用可能だが非推奨
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **特殊演算子（Phase 12.7実装済み）**
|
||||||
|
```nyash
|
||||||
|
# ? 演算子 - Result伝播
|
||||||
|
local data = readFile(path)? # エラーなら早期return
|
||||||
|
|
||||||
|
# ラムダ式
|
||||||
|
local add = fn(x, y) { return x + y }
|
||||||
|
local double = fn(x) { x * 2 } # 単一式なら省略可
|
||||||
|
|
||||||
|
# await式
|
||||||
|
local result = await asyncTask()
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🏗️ **3. Box構文詳細ガイド**
|
||||||
|
|
||||||
|
### **3.1 Everything is Box 原則**
|
||||||
|
|
||||||
|
```nyash
|
||||||
|
# すべての値がBox
|
||||||
|
number = 42 # IntegerBox
|
||||||
|
text = "hello" # StringBox
|
||||||
|
flag = true # BoolBox
|
||||||
|
array = new ArrayBox() # ArrayBox
|
||||||
|
console = new ConsoleBox() # ConsoleBox
|
||||||
|
|
||||||
|
# 統一的なメソッド呼び出し
|
||||||
|
print(number.to_string_box().value) # "42"
|
||||||
|
print(array.length()) # 配列長
|
||||||
|
console.log("Everything is Box!") # コンソール出力
|
||||||
|
```
|
||||||
|
|
||||||
|
### **3.2 コンストラクタパターン**
|
||||||
|
|
||||||
|
#### **パラメータ付きコンストラクタ**
|
||||||
|
```nyash
|
||||||
|
box Person {
|
||||||
|
public name: StringBox
|
||||||
|
public email: StringBox
|
||||||
|
private age: IntegerBox
|
||||||
|
|
||||||
|
birth(personName, personAge) { # birth構文に統一
|
||||||
|
me.name = personName
|
||||||
|
me.age = personAge
|
||||||
|
me.email = me.name + "@example.com" # 計算フィールド
|
||||||
|
}
|
||||||
|
|
||||||
|
# ファクトリーメソッド
|
||||||
|
static createGuest() {
|
||||||
|
outbox guest
|
||||||
|
guest = new Person("Guest", 0)
|
||||||
|
return guest
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# 使用例
|
||||||
|
person = new Person("Alice", 25)
|
||||||
|
guest = Person.createGuest()
|
||||||
|
```
|
||||||
|
|
||||||
|
### **3.3 継承とインターフェース**
|
||||||
|
|
||||||
|
#### **デリゲーションチェーン**
|
||||||
|
```nyash
|
||||||
|
# 基底Box
|
||||||
|
box Animal {
|
||||||
|
public name: StringBox
|
||||||
|
public species: StringBox
|
||||||
|
|
||||||
|
birth(animalName, animalSpecies) {
|
||||||
|
me.name = animalName
|
||||||
|
me.species = animalSpecies
|
||||||
|
}
|
||||||
|
|
||||||
|
speak() {
|
||||||
|
return me.name + " makes a sound"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# デリゲーション
|
||||||
|
box Dog from Animal {
|
||||||
|
breed: StringBox # 追加フィールド
|
||||||
|
|
||||||
|
birth(dogName, dogBreed) {
|
||||||
|
from Animal.birth(dogName, "Canine") # 親コンストラクタ呼び出し
|
||||||
|
me.breed = dogBreed
|
||||||
|
}
|
||||||
|
|
||||||
|
override speak() { # 明示的オーバーライド
|
||||||
|
return me.name + " barks: Woof!"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# インターフェース実装
|
||||||
|
box Cat from Animal interface Playful {
|
||||||
|
# Playfulインターフェースの実装必須
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### **3.4 Static Boxパターン**
|
||||||
|
|
||||||
|
#### **名前空間・ユーティリティ**
|
||||||
|
```nyash
|
||||||
|
static box MathUtils {
|
||||||
|
PI: FloatBox
|
||||||
|
E: FloatBox
|
||||||
|
|
||||||
|
# 注意: static初期化ブロックは未実装
|
||||||
|
# 初期化はメソッド内で行う
|
||||||
|
|
||||||
|
add(a, b) {
|
||||||
|
return a + b
|
||||||
|
}
|
||||||
|
|
||||||
|
circleArea(radius) {
|
||||||
|
# 初回アクセスで初期化パターン
|
||||||
|
if me.PI == null {
|
||||||
|
me.PI = 3.14159265
|
||||||
|
}
|
||||||
|
return me.PI * radius * radius
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
# 使用法
|
||||||
|
area = MathUtils.circleArea(5)
|
||||||
|
sum = MathUtils.add(10, 20)
|
||||||
|
```
|
||||||
|
|
||||||
|
#### **アプリケーションエントリーポイント**
|
||||||
|
```nyash
|
||||||
|
# 🎯 推奨: Static Box Main パターン
|
||||||
|
static box Main {
|
||||||
|
console: ConsoleBox
|
||||||
|
result: IntegerBox
|
||||||
|
|
||||||
|
main() {
|
||||||
|
me.console = new ConsoleBox()
|
||||||
|
me.console.log("🚀 Starting application...")
|
||||||
|
|
||||||
|
# アプリケーションロジック
|
||||||
|
me.result = processData()
|
||||||
|
|
||||||
|
return "Application completed successfully"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 **4. 最新機能・革新技術**
|
||||||
|
|
||||||
|
### **4.1 Arc<Mutex> Revolution（2025-08-10）**
|
||||||
|
```nyash
|
||||||
|
# 全16種類のBox型が統一Arc<Mutex>パターンで実装
|
||||||
|
# 完全なスレッドセーフティと高性能を両立
|
||||||
|
|
||||||
|
array = new ArrayBox()
|
||||||
|
array.push(10) # スレッドセーフな追加
|
||||||
|
array.push(20)
|
||||||
|
item = array.get(0) # スレッドセーフな取得
|
||||||
|
|
||||||
|
json = new JSONBox()
|
||||||
|
json.set("name", "Alice") # 並行安全な操作
|
||||||
|
data = json.stringify() # JSON文字列化
|
||||||
|
```
|
||||||
|
|
||||||
|
### **4.2 Rust風トレイトベース演算子（2025-08-10）**
|
||||||
|
```nyash
|
||||||
|
# AI大相談会で決定された最適設計
|
||||||
|
# 静的・動的ハイブリッドディスパッチによる高性能実現
|
||||||
|
|
||||||
|
# 整数演算
|
||||||
|
result = 100 - 25 # IntegerBox間演算 → IntegerBox
|
||||||
|
product = 6 * 7 # 高速静的ディスパッチ
|
||||||
|
|
||||||
|
# 文字列操作
|
||||||
|
greeting = "Hello" + " World" # 文字列結合
|
||||||
|
repeated = "Echo" * 3 # "EchoEchoEcho"
|
||||||
|
|
||||||
|
# 混合型フォールバック
|
||||||
|
message = "Answer: " + 42 # "Answer: 42"
|
||||||
|
|
||||||
|
# Boolean演算
|
||||||
|
boolSum = true + false # 1 (IntegerBox)
|
||||||
|
```
|
||||||
|
|
||||||
|
### **4.3 変数宣言厳密化（2025-08-09）**
|
||||||
|
```nyash
|
||||||
|
# メモリ安全性・非同期安全性保証システム
|
||||||
|
|
||||||
|
static box Calculator {
|
||||||
|
private memory: ArrayBox # 必須フィールド宣言
|
||||||
|
|
||||||
|
calculate() {
|
||||||
|
local temp # 必須ローカル変数宣言
|
||||||
|
temp = me.memory * 2
|
||||||
|
return temp
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 **4.4 Phase 12.7実装済み機能**
|
||||||
|
|
||||||
|
### **Peek式 - パターンマッチング風分岐**
|
||||||
|
```nyash
|
||||||
|
# 式として使用（値を返す）
|
||||||
|
local grade = peek score {
|
||||||
|
100 => "Perfect",
|
||||||
|
90 => "Excellent",
|
||||||
|
80 => "Good",
|
||||||
|
else => "Needs improvement"
|
||||||
|
}
|
||||||
|
|
||||||
|
# 文として使用（アクション実行）
|
||||||
|
peek command {
|
||||||
|
"save" => {
|
||||||
|
saveFile()
|
||||||
|
print("Saved!")
|
||||||
|
},
|
||||||
|
"quit" => {
|
||||||
|
cleanup()
|
||||||
|
return
|
||||||
|
},
|
||||||
|
else => print("Unknown command")
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### **Continue文**
|
||||||
|
```nyash
|
||||||
|
loop(i < 100) {
|
||||||
|
if i % 2 == 0 {
|
||||||
|
continue # 偶数をスキップ
|
||||||
|
}
|
||||||
|
process(i)
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### **フィールド型アノテーション**
|
||||||
|
```nyash
|
||||||
|
box Person {
|
||||||
|
name: StringBox # 型情報を明記（P0では無視）
|
||||||
|
age: IntegerBox
|
||||||
|
email # 型なしも可
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### **?演算子（Result伝播）**
|
||||||
|
```nyash
|
||||||
|
# ResultBoxのエラーを自動的に早期return
|
||||||
|
local data = readFile("config.json")?
|
||||||
|
local parsed = parseJSON(data)?
|
||||||
|
return parsed.get("version")
|
||||||
|
```
|
||||||
|
|
||||||
|
### **Lambda式**
|
||||||
|
```nyash
|
||||||
|
# 基本形
|
||||||
|
local add = fn(x, y) { return x + y }
|
||||||
|
|
||||||
|
# 単一式の場合（returnは省略可）
|
||||||
|
local double = fn(x) { x * 2 }
|
||||||
|
|
||||||
|
# 高階関数での使用
|
||||||
|
array.map(fn(x) { x * x })
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚡ **5. 実装済みBox型ライブラリ**
|
||||||
|
|
||||||
|
### **5.1 基本型**
|
||||||
|
- `StringBox` - 文字列（split, find, replace, trim等）
|
||||||
|
- `IntegerBox` - 64bit整数
|
||||||
|
- `FloatBox` - 64bit浮動小数点数
|
||||||
|
- `BoolBox` - 真偽値
|
||||||
|
- `NullBox` - null値
|
||||||
|
- `VoidBox` - void値
|
||||||
|
|
||||||
|
### **5.2 コレクション**
|
||||||
|
- `ArrayBox` - 動的配列（push, pop, get, set, join等）
|
||||||
|
- `MapBox` - 連想配列・辞書
|
||||||
|
|
||||||
|
### **5.3 システム・I/O**
|
||||||
|
- `ConsoleBox` - コンソール入出力
|
||||||
|
- `DebugBox` - デバッグ支援・メモリ追跡
|
||||||
|
- `FileBox` - ファイルシステム操作（プラグイン）
|
||||||
|
|
||||||
|
### **5.4 数学・時間**
|
||||||
|
- `MathBox` - 数学関数（sin, cos, log, sqrt等）
|
||||||
|
- `TimeBox` - 時刻操作・タイマー
|
||||||
|
- `RandomBox` - 乱数生成・選択・シャッフル
|
||||||
|
|
||||||
|
### **5.5 データ処理**
|
||||||
|
- `JSONBox` - JSON解析・生成（parse, stringify, get, set）
|
||||||
|
- `RegexBox` - 正規表現（test, find, replace, split）
|
||||||
|
- `BufferBox` - バイナリデータ処理
|
||||||
|
- `StreamBox` - ストリーム処理
|
||||||
|
|
||||||
|
### **5.6 ネットワーク・Web**
|
||||||
|
- `HttpClientBox` - HTTP通信（プラグイン）
|
||||||
|
- `WebDisplayBox` - HTML表示（WASM）
|
||||||
|
- `WebConsoleBox` - ブラウザコンソール（WASM）
|
||||||
|
- `WebCanvasBox` - Canvas描画（WASM）
|
||||||
|
|
||||||
|
### **5.7 GUI・マルチメディア**
|
||||||
|
- `EguiBox` - デスクトップGUI（Windows/Linux、プラグイン）
|
||||||
|
- `SoundBox` - 音声再生
|
||||||
|
|
||||||
|
### **5.8 特殊用途**
|
||||||
|
- `FutureBox` - 非同期処理結果
|
||||||
|
- `ResultBox` - エラー処理（Ok/Err）
|
||||||
|
- `TokenBox` - キャンセルトークン
|
||||||
|
- `FunctionBox` - 第一級関数
|
||||||
|
- `P2PBox` - P2P通信（プラグイン）
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 **6. パフォーマンス・デザイン原則**
|
||||||
|
|
||||||
|
### **6.1 メモリ安全性**
|
||||||
|
- Rust所有権システムによる完全なメモリ安全性
|
||||||
|
- Arc<Mutex>によるスレッドセーフな共有状態管理
|
||||||
|
- 自動参照カウント + 明示的デストラクタ（fini）
|
||||||
|
|
||||||
|
### **6.2 実行効率**
|
||||||
|
- 統一されたBox型システムによる最適化
|
||||||
|
- 静的・動的ハイブリッドディスパッチで高速演算
|
||||||
|
- パーサー無限ループ対策（--debug-fuel）
|
||||||
|
|
||||||
|
### **6.3 開発効率**
|
||||||
|
- 変数宣言厳密化による早期エラー検出
|
||||||
|
- 包括的デバッグ機能（DebugBox）
|
||||||
|
- 直感的な"Everything is Box"概念
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📚 **7. 学習パス・ベストプラクティス**
|
||||||
|
|
||||||
|
### **7.1 初心者向け学習順序**
|
||||||
|
1. **基本概念**: Everything is Box哲学理解
|
||||||
|
2. **基本構文**: 変数宣言・制御構文・演算子
|
||||||
|
3. **Box定義**: 基本的なクラス作成
|
||||||
|
4. **Static Box Main**: アプリケーションエントリーポイント
|
||||||
|
5. **継承・インターフェース**: オブジェクト指向機能
|
||||||
|
|
||||||
|
### **7.2 推奨コーディングスタイル**
|
||||||
|
```nyash
|
||||||
|
# ✅ 推奨スタイル
|
||||||
|
static box Main {
|
||||||
|
public console: ConsoleBox # 公開フィールド明示
|
||||||
|
public result: IntegerBox
|
||||||
|
|
||||||
|
main() {
|
||||||
|
me.console = new ConsoleBox()
|
||||||
|
|
||||||
|
local data # 変数事前宣言
|
||||||
|
data = processInput()
|
||||||
|
|
||||||
|
me.result = data # 明確な代入
|
||||||
|
return "Success"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### **7.3 よくある間違いと対策**
|
||||||
|
```nyash
|
||||||
|
# ❌ よくある間違い
|
||||||
|
public { field1 field2 } # 旧構文 → 使用不可
|
||||||
|
x = 42 # 変数未宣言 → ランタイムエラー
|
||||||
|
while condition { } # 非対応構文 → パーサーエラー
|
||||||
|
this.field # thisは使用不可 → me.fieldを使用
|
||||||
|
|
||||||
|
# ✅ 正しい書き方（Phase 12.7後）
|
||||||
|
field1: TypeBox # フィールド宣言（型は省略可）
|
||||||
|
field2 # 型なしフィールド
|
||||||
|
local x = 42 # 事前宣言必須
|
||||||
|
loop(condition) { } # 統一ループ構文
|
||||||
|
me.field # self参照はmeのみ
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📌 **8. 糖衣構文（Phase 12.7-B）**
|
||||||
|
|
||||||
|
### 実装済み（ゲート: `NYASH_SYNTAX_SUGAR_LEVEL=basic|full`）
|
||||||
|
```nyash
|
||||||
|
# パイプライン
|
||||||
|
result = data |> normalize() |> transform() |> process
|
||||||
|
|
||||||
|
# セーフアクセス + デフォルト
|
||||||
|
name = user?.profile?.name ?? "guest"
|
||||||
|
|
||||||
|
# 複合代入
|
||||||
|
x += 1; y *= 2
|
||||||
|
|
||||||
|
# 範囲（内部的には Range(a,b)）
|
||||||
|
loop(i in 1 .. 5) { /* ... */ }
|
||||||
|
```
|
||||||
|
|
||||||
|
### 拡張（段階適用予定・設計済み）
|
||||||
|
```nyash
|
||||||
|
let {x, y} = point
|
||||||
|
let [first, second, ...rest] = array
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**🎉 Nyash 2025は、AI協働設計による最先端言語システムとして、シンプルさと強力さを完全に両立しました。**
|
||||||
|
|
||||||
|
*最終更新: 2025年9月4日 - Phase 12.7実装済み機能の正確な反映*
|
||||||
|
|||||||
@ -104,3 +104,36 @@ Notes
|
|||||||
- Phase 15 keeps resolution in the Runner to minimize parser complexity. Future phases may leverage `meta.usings` for compiler decisions.
|
- Phase 15 keeps resolution in the Runner to minimize parser complexity. Future phases may leverage `meta.usings` for compiler decisions.
|
||||||
- Unknown fields in the top‑level JSON (like `meta`) are ignored by the current bridge.
|
- Unknown fields in the top‑level JSON (like `meta`) are ignored by the current bridge.
|
||||||
- 未解決時（非strict）は実行を継続し、`NYASH_RESOLVE_TRACE=1` で候補を提示。strict時はエラーで候補を表示。
|
- 未解決時（非strict）は実行を継続し、`NYASH_RESOLVE_TRACE=1` で候補を提示。strict時はエラーで候補を表示。
|
||||||
|
|
||||||
|
## Include/Export (Phase 1)
|
||||||
|
|
||||||
|
Simple include expression for file‑scoped modules（Phase 1 提案）。将来は `using`/Runner 解決へ統合予定。
|
||||||
|
|
||||||
|
Overview
|
||||||
|
- One file exports one static box. `include(path)` evaluates the file and returns that Box instance.
|
||||||
|
|
||||||
|
Syntax
|
||||||
|
```
|
||||||
|
local Math = include "lib/math.nyash"
|
||||||
|
local r = Math.add(1, 2)
|
||||||
|
```
|
||||||
|
|
||||||
|
Rules
|
||||||
|
- Single static box per file（0/複数はエラー）
|
||||||
|
- Expression form: `include(...)` は Box インスタンスを返す式
|
||||||
|
- Caching: 同一パスは一度だけ評価（2回目以降はキャッシュ返却）
|
||||||
|
- Path resolution（MVP）:
|
||||||
|
- Relative allowed; absolute discouraged
|
||||||
|
- nyash.toml `[include.roots]` で `std=/stdlib` 等のルート定義を許可
|
||||||
|
- 省略拡張は `.nyash`、ディレクトリなら `index.nyash`
|
||||||
|
|
||||||
|
Backends
|
||||||
|
- Interpreter: 実行時に評価し Box を返す
|
||||||
|
- VM/AOT: MIR Builder が対象ファイルを読み取り、同一 MIR モジュールに static box を降ろす（専用 MIR 命令は追加しない）
|
||||||
|
|
||||||
|
Limitations
|
||||||
|
- 循環 include の検出/診断は未実装（後続で active-load 追跡と経路表示を追加）
|
||||||
|
|
||||||
|
Rationale
|
||||||
|
- MIR 仕様に変更を入れず、実用的なモジュール分割を提供
|
||||||
|
- Everything‑is‑Box に整合（モジュール=Box、メソッド/フィールド=API）
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user