Step 365: Add WAT parser and pipeline routing

This commit is contained in:
Bill
2026-02-16 09:49:50 -07:00
parent 0f6e5333ae
commit 219b828030
6 changed files with 444 additions and 0 deletions

View File

@@ -2164,4 +2164,13 @@ target_link_libraries(step364_test PRIVATE
tree_sitter_javascript tree_sitter_typescript
tree_sitter_java tree_sitter_rust tree_sitter_go)
add_executable(step365_test tests/step365_test.cpp)
target_include_directories(step365_test PRIVATE src)
target_link_libraries(step365_test PRIVATE
nlohmann_json::nlohmann_json
unofficial::tree-sitter::tree-sitter
tree_sitter_python tree_sitter_cpp tree_sitter_elisp
tree_sitter_javascript tree_sitter_typescript
tree_sitter_java tree_sitter_rust tree_sitter_go)
# Step 12: Dear ImGui shell scaffolding created (main.cpp exists but not built due to dependencies)

View File

@@ -122,6 +122,10 @@ public:
auto pr = CParser::parseCWithDiagnostics(source);
diags = std::move(pr.diagnostics);
return std::move(pr.module);
} else if (language == "wat" || language == "wasm") {
auto pr = WatParser::parseWatWithDiagnostics(source);
diags = std::move(pr.diagnostics);
return std::move(pr.module);
}
return nullptr;
}

View File

@@ -165,3 +165,4 @@ private:
#include "ast/KotlinParser.h"
#include "ast/CSharpParser.h"
#include "ast/CParser.h"
#include "ast/WatParser.h"

231
editor/src/ast/WatParser.h Normal file
View File

@@ -0,0 +1,231 @@
#pragma once
#include "ASTNode.h"
#include "Module.h"
#include "Function.h"
#include "Variable.h"
#include "Parameter.h"
#include "Type.h"
#include "Import.h"
#include "Statement.h"
#include "Expression.h"
#include "PreprocessorNodes.h"
#include "../ast/Parser.h"
#include <algorithm>
#include <regex>
#include <string>
#include <vector>
class WatParser {
public:
static std::unique_ptr<Module> parseWat(const std::string& source) {
auto module = std::make_unique<Module>();
module->id = IdGenerator::next("mod");
module->name = "parsed_wat_module";
module->targetLanguage = "wat";
std::string cleaned = stripComments(source);
for (const auto& expr : topLevelExprs(cleaned)) {
if (startsWith(expr, "(func")) {
module->addChild("functions", parseFunction(expr));
} else if (startsWith(expr, "(import")) {
parseImport(expr, module.get());
} else if (startsWith(expr, "(export")) {
auto* p = new PragmaDirective(IdGenerator::next("prag"), "export");
module->addChild("statements", p);
} else if (startsWith(expr, "(global")) {
parseGlobal(expr, module.get());
} else if (startsWith(expr, "(memory")) {
auto* p = new PragmaDirective(IdGenerator::next("prag"), "memory");
module->addChild("statements", p);
} else if (startsWith(expr, "(table")) {
auto* p = new PragmaDirective(IdGenerator::next("prag"), "table");
module->addChild("statements", p);
}
}
return module;
}
static ParseResult parseWatWithDiagnostics(const std::string& source) {
ParseResult result;
result.module = parseWat(source);
return result;
}
private:
static std::string stripComments(const std::string& source) {
std::string out;
out.reserve(source.size());
bool lineComment = false;
for (size_t i = 0; i < source.size(); ++i) {
char c = source[i];
char n = (i + 1 < source.size()) ? source[i + 1] : '\0';
if (!lineComment && c == ';' && n == ';') {
lineComment = true;
out += " ";
++i;
continue;
}
if (lineComment && c == '\n') {
lineComment = false;
out.push_back(c);
continue;
}
out.push_back(lineComment ? ' ' : c);
}
return out;
}
static std::vector<std::string> topLevelExprs(const std::string& source) {
std::vector<std::string> out;
int depth = 0;
int moduleDepth = -1;
size_t moduleStart = std::string::npos;
for (size_t i = 0; i < source.size(); ++i) {
if (source[i] == '(') {
++depth;
if (moduleDepth == -1 && startsWithAt(source, i, "(module")) {
moduleDepth = depth;
} else if (moduleDepth != -1 && depth == moduleDepth + 1) {
moduleStart = i;
}
} else if (source[i] == ')') {
if (moduleDepth != -1 && moduleStart != std::string::npos &&
depth == moduleDepth + 1) {
out.push_back(trim(source.substr(moduleStart, i - moduleStart + 1)));
moduleStart = std::string::npos;
}
--depth;
if (depth < moduleDepth) moduleDepth = -1;
}
}
if (out.empty()) {
std::string t = trim(source);
if (startsWith(t, "(func") || startsWith(t, "(module")) out.push_back(t);
}
return out;
}
static Function* parseFunction(const std::string& expr) {
auto* fn = new Function();
fn->id = IdGenerator::next("fn");
fn->name = parseFunctionName(expr);
std::regex paramRx(R"(\(\s*param\s+(\$[A-Za-z_][\w\.-]*|[A-Za-z_][\w\.-]*)\s+([A-Za-z0-9_\.]+)\s*\))");
for (auto it = std::sregex_iterator(expr.begin(), expr.end(), paramRx);
it != std::sregex_iterator(); ++it) {
std::smatch m = *it;
auto* p = new Parameter(IdGenerator::next("param"), trim(m[1].str()));
p->setChild("type", makeType(m[2].str()));
fn->addChild("parameters", p);
}
std::regex resultRx(R"(\(\s*result\s+([A-Za-z0-9_\.]+)\s*\))");
std::smatch resultMatch;
if (std::regex_search(expr, resultMatch, resultRx)) {
fn->setChild("returnType", makeType(resultMatch[1].str()));
}
std::regex localRx(R"(\(\s*local\s+(\$[A-Za-z_][\w\.-]*|[A-Za-z_][\w\.-]*)\s+([A-Za-z0-9_\.]+)\s*\))");
for (auto it = std::sregex_iterator(expr.begin(), expr.end(), localRx);
it != std::sregex_iterator(); ++it) {
std::smatch m = *it;
auto* v = new Variable(IdGenerator::next("var"), trim(m[1].str()));
v->setChild("type", makeType(m[2].str()));
fn->addChild("body", v);
}
appendInstructionNodes(expr, fn);
return fn;
}
static void parseImport(const std::string& expr, Module* module) {
std::regex importRx(
R"wat(\(\s*import\s+"([^"]+)"\s+"([^"]+)"\s+\(\s*func\s*(\$[A-Za-z_][\w\.-]*)?)wat");
std::smatch m;
if (std::regex_search(expr, m, importRx)) {
std::string modName = trim(m[1].str());
std::string name = trim(m[2].str());
auto* imp = new Import(IdGenerator::next("imp"), modName + "." + name, "runtime", "");
module->addChild("imports", imp);
}
}
static void parseGlobal(const std::string& expr, Module* module) {
std::regex gRx(R"(\(\s*global\s+(\$[A-Za-z_][\w\.-]*|[A-Za-z_][\w\.-]*)?)");
std::smatch m;
std::string name = "global_" + IdGenerator::next("g");
if (std::regex_search(expr, m, gRx) && !trim(m[1].str()).empty()) {
name = trim(m[1].str());
}
auto* v = new Variable(IdGenerator::next("var"), name);
v->setChild("type", new PrimitiveType(IdGenerator::next("type"), "i32"));
module->addChild("variables", v);
}
static void appendInstructionNodes(const std::string& expr, Function* fn) {
if (expr.find("i32.add") != std::string::npos) {
auto* b = new BinaryOperation();
b->id = IdGenerator::next("bin");
b->op = "+";
b->setChild("left", new IntegerLiteral(IdGenerator::next("lit"), 0));
b->setChild("right", new IntegerLiteral(IdGenerator::next("lit"), 0));
fn->addChild("body", b);
}
std::regex callRx(R"(\bcall\s+(\$[A-Za-z_][\w\.-]*|[A-Za-z_][\w\.-]*))");
std::smatch callMatch;
if (std::regex_search(expr, callMatch, callRx)) {
auto* c = new FunctionCall();
c->id = IdGenerator::next("call");
c->functionName = trim(callMatch[1].str());
fn->addChild("body", c);
}
if (expr.find("(if") != std::string::npos) {
auto* ifs = new IfStatement();
ifs->id = IdGenerator::next("if");
ifs->setChild("condition", new BooleanLiteral(IdGenerator::next("bool"), true));
fn->addChild("body", ifs);
}
if (expr.find("(block") != std::string::npos || expr.find("(loop") != std::string::npos) {
auto* block = new Block();
block->id = IdGenerator::next("blk");
fn->addChild("body", block);
}
}
static ASTNode* makeType(const std::string& watType) {
std::string t = trim(watType);
return new PrimitiveType(IdGenerator::next("type"), t);
}
static std::string parseFunctionName(const std::string& expr) {
std::regex nameRx(R"(\(\s*func\s+(\$[A-Za-z_][\w\.-]*|[A-Za-z_][\w\.-]*))");
std::smatch m;
if (std::regex_search(expr, m, nameRx)) {
return trim(m[1].str());
}
return "wat_function_" + IdGenerator::next("fn");
}
static std::string trim(const std::string& s) {
size_t start = s.find_first_not_of(" \t\r\n");
if (start == std::string::npos) return "";
size_t end = s.find_last_not_of(" \t\r\n");
return s.substr(start, end - start + 1);
}
static bool startsWith(const std::string& value, const std::string& prefix) {
return value.rfind(prefix, 0) == 0;
}
static bool startsWithAt(const std::string& value, size_t pos, const std::string& prefix) {
if (pos + prefix.size() > value.size()) return false;
return value.compare(pos, prefix.size(), prefix) == 0;
}
};

View File

@@ -0,0 +1,158 @@
// Step 365: WAT Parser (12 tests)
#include <cassert>
#include <iostream>
#include <string>
#include <vector>
#include "ast/WatParser.h"
#include "Pipeline.h"
static bool hasBodyNode(const Function* fn, const std::string& conceptType) {
for (auto* n : fn->getChildren("body")) {
if (n->conceptType == conceptType) return true;
}
return false;
}
int main() {
int passed = 0;
// Test 1: module parsing
{
std::string src = "(module (func $add (param $x i32) (param $y i32) (result i32)))";
auto mod = WatParser::parseWat(src);
assert(mod != nullptr);
assert(mod->targetLanguage == "wat");
std::cout << "Test 1 PASSED: module parse\n";
passed++;
}
// Test 2: function with params/result
{
std::string src = "(module (func $add (param $x i32) (param $y i32) (result i32)))";
auto mod = WatParser::parseWat(src);
assert(mod->getChildren("functions").size() == 1);
auto* fn = static_cast<Function*>(mod->getChildren("functions")[0]);
assert(fn->name == "$add");
assert(fn->getChildren("parameters").size() == 2);
auto* ret = fn->getChild("returnType");
assert(ret != nullptr && ret->conceptType == "PrimitiveType");
std::cout << "Test 2 PASSED: function params/result\n";
passed++;
}
// Test 3: local variables
{
std::string src = "(module (func $f (local $tmp i32) (result i32)))";
auto mod = WatParser::parseWat(src);
auto* fn = static_cast<Function*>(mod->getChildren("functions")[0]);
assert(hasBodyNode(fn, "Variable"));
std::cout << "Test 3 PASSED: local variable parse\n";
passed++;
}
// Test 4: export declarations
{
std::string src = "(module (func $f) (export \"f\" (func $f)))";
auto mod = WatParser::parseWat(src);
bool hasExportPragma = false;
for (auto* s : mod->getChildren("statements")) {
if (s->conceptType == "PragmaDirective") hasExportPragma = true;
}
assert(hasExportPragma);
std::cout << "Test 4 PASSED: export declaration parse\n";
passed++;
}
// Test 5: import declarations
{
std::string src = "(module (import \"env\" \"print\" (func $print (param $x i32))))";
auto mod = WatParser::parseWat(src);
assert(!mod->getChildren("imports").empty());
std::cout << "Test 5 PASSED: import declaration parse\n";
passed++;
}
// Test 6: global variables
{
std::string src = "(module (global $g (mut i32) (i32.const 0)))";
auto mod = WatParser::parseWat(src);
assert(!mod->getChildren("variables").empty());
std::cout << "Test 6 PASSED: global variable parse\n";
passed++;
}
// Test 7: i32.add -> BinaryOperation
{
std::string src = "(module (func $add (param $x i32) (param $y i32) (result i32) local.get $x local.get $y i32.add))";
auto mod = WatParser::parseWat(src);
auto* fn = static_cast<Function*>(mod->getChildren("functions")[0]);
assert(hasBodyNode(fn, "BinaryOperation"));
std::cout << "Test 7 PASSED: i32.add mapped to BinaryOperation\n";
passed++;
}
// Test 8: call -> FunctionCall
{
std::string src = "(module (func $f call $helper) (func $helper))";
auto mod = WatParser::parseWat(src);
auto* fn = static_cast<Function*>(mod->getChildren("functions")[0]);
assert(hasBodyNode(fn, "FunctionCall"));
std::cout << "Test 8 PASSED: call mapped to FunctionCall\n";
passed++;
}
// Test 9: if -> IfStatement
{
std::string src = "(module (func $f (if (result i32) (then (i32.const 1)) (else (i32.const 0)))))";
auto mod = WatParser::parseWat(src);
auto* fn = static_cast<Function*>(mod->getChildren("functions")[0]);
assert(hasBodyNode(fn, "IfStatement"));
std::cout << "Test 9 PASSED: if mapped to IfStatement\n";
passed++;
}
// Test 10: nested block/loop keeps structural block node
{
std::string src = "(module (func $f (block (loop (br 0)))))";
auto mod = WatParser::parseWat(src);
auto* fn = static_cast<Function*>(mod->getChildren("functions")[0]);
assert(hasBodyNode(fn, "Block"));
std::cout << "Test 10 PASSED: block/loop structural mapping\n";
passed++;
}
// Test 11: empty module
{
std::string src = "(module)";
auto mod = WatParser::parseWat(src);
assert(mod != nullptr);
assert(mod->getChildren("functions").empty());
std::cout << "Test 11 PASSED: empty module parse\n";
passed++;
}
// Test 12: wat/wasm pipeline route and type preservation
{
std::string src = "(module (func $f (param $x i64) (result f64)))";
Pipeline p;
std::vector<ParseDiagnostic> diags;
auto mod = p.parse(src, "wat", diags);
assert(mod != nullptr);
auto* fn = static_cast<Function*>(mod->getChildren("functions")[0]);
auto* param = static_cast<Parameter*>(fn->getChildren("parameters")[0]);
auto* pType = static_cast<PrimitiveType*>(param->getChild("type"));
auto* rType = static_cast<PrimitiveType*>(fn->getChild("returnType"));
assert(pType->kind == "i64");
assert(rType->kind == "f64");
auto mod2 = p.parse(src, "wasm", diags);
assert(mod2 != nullptr);
std::cout << "Test 12 PASSED: pipeline wat/wasm routing + type preservation\n";
passed++;
}
std::cout << "\nResults: " << passed << "/12\n";
assert(passed == 12);
return 0;
}

View File

@@ -2203,6 +2203,47 @@ projection behavior, and MCP tool contract stability.
- `editor/src/CrossLanguageProjector.h` remains within header size limit
(`596` lines <= `600`)
### Step 365: WAT Parser
**Status:** PASS (12/12 tests)
Added a standalone WebAssembly text-format parser (`wat`/`wasm`) and wired it
into the shared parsing pipeline.
**Files created:**
- `editor/src/ast/WatParser.h` — WAT parser support:
- `parseWat(...)` and `parseWatWithDiagnostics(...)`
- balanced-expression scanning inside `(module ...)`
- function parsing for params/results/locals
- import/export/global/memory/table top-level mapping
- instruction-shape mapping for `i32.add`, `call`, `if`, `block`, `loop`
- line-comment stripping for `;; ...`
- `editor/tests/step365_test.cpp` — 12 tests covering:
1. module parsing
2. function params/results
3. locals
4. exports
5. imports
6. globals
7. `i32.add` mapping
8. `call` mapping
9. `if` mapping
10. block/loop mapping
11. empty module
12. pipeline `wat` and `wasm` routing + type preservation
**Files modified:**
- `editor/src/ast/Parser.h` — include `ast/WatParser.h`
- `editor/src/Pipeline.h` — add parse routing for `\"wat\"` and `\"wasm\"`
- `editor/CMakeLists.txt``step365_test` target
**Verification run:**
- `step365_test` — PASS (12/12) new step coverage
- `step364_test` — PASS (8/8) regression coverage
- `step363_test` — PASS (12/12) regression coverage
**Architecture gate check:**
- `editor/src/ast/WatParser.h` is within header size limit (`231` lines)
# Roadmap Planning — Sprints 12-25+
## Status: Planning Complete (Sprints 12-19 detailed, 20-25 in roadmap.md)