apollovm 1.6.2

apollovm: ^1.6.2 copied to clipboard

Language Server — expression-body member ranges #

• Members with an expression body are now fully covered by their documentSymbol range. A => expr; member (Dart/C#) previously stopped at its name, and a brace-less = expr member (Kotlin) even swallowed the next member because the scanner never recovered. The token indexer now consumes the expression: the => form extends to its terminating ;, and the brace-less = form is bounded to the end of its line (so the following member is still recognized). Balanced ()/[]/{} inside the expression (e.g. a map literal body => {1: 2}) are handled without corrupting brace tracking. Works for both class and enum members.

Language Server — enum members after the constant list #

• Enum members declared after the constant list are now recognized as real members. Everything after the ; that ends an enum's constant list (fields, constructors, methods) was being swallowed as bogus enum constants (named int, const, final, …), so documentSymbol gave enum methods no body range and did not recognize enum constructors at all. The token indexer now tracks the constant-list terminator per enum: after it, identifiers in the enum body are parsed like class members — real kinds and full-body ranges. Pure-constant enums (enum E { a, b, c }) are unaffected; class constructors were already handled correctly.

Language Server — member-aware completion and full-body symbol ranges #

• documentSymbol ranges now span a member's whole body, not just its signature. Previously only class/enum declarations had their range extended to the closing }; a function/method/constructor stopped at the end of its name, so an editor "select symbol" or outline action only highlighted the signature. The token indexer now tracks member bodies too — skipping the parameter list first, so Dart named-parameter braces ({ ... }) are not mistaken for the body — and extends fullEnd to the body's closing }. Bodyless members (abstract/;-terminated) are left unchanged. The narrower selectionRange (the name) is untouched.
• Completion on this. / super. proposes the enclosing type's members. A member-access position is now recognized and answered with just that type's fields and methods (with their real kinds), instead of the full grab-bag of every identifier plus keywords.
• Completion keeps real symbol kinds even when the buffer does not parse. The this. case leaves the source unparseable, which had emptied the AST symbol table and degraded every proposal to a plain identifier. Completion now also draws on the token-index declarations (which survive a failed parse), so methods and fields keep their proper kinds mid-edit. Local variables and parameters continue to be surfaced from the raw token stream.

Language Server — better completion and parse-error locations #

• Completion now surfaces in-scope identifiers, and works while the buffer does not parse. Previously textDocument/completion only offered AST symbols (top-level/members) plus keywords — so mid-edit, when the parse fails (the common case), it fell back to keywords only. It now also harvests identifiers from the raw token stream, which survives a failed parse and includes local variables and parameters the symbol table omits. Results are de-duplicated and ranked: local-scope symbols, then other symbols, then harvested identifiers, then keywords. The partial token under the cursor is skipped.
• Parse-error diagnostics locate a missing ;. ApolloVM's PEG parser reports a generic "end of input expected" at offset 0 for most structural mistakes; the LSP layer already recovered the real position for bracket imbalances, and now also for a missing statement terminator in ;-required languages (Dart, Java, C#). A balanced-but-unterminated statement is pinned to the end of the offending value (with an expected ';' hint) instead of defaulting to the top of the file. The heuristic is conservative — it skips continuation shapes (operators, ., ?, :, ,, open brackets, continuation keywords like return, and annotations) and does not apply to languages where ; is optional/absent (Kotlin, JavaScript, Lua, Python).

• Docs: fix the ApolloVM Web Demo link — the live playground is served at the site root (https://apollovm.github.io/apollovm_web_example/), not the old /www/ path.

MCP — web compatibility #

• package:apollovm/apollovm_mcp.dart is now fully web-safe — it imports no dart:io and no dart:isolate, so the MCP server and every apollovm.* / apollovm.lsp.* tool compile and run in a browser (dart2js / DDC). Construct ApolloMcpServer on any StreamChannel<String> (e.g. a web MessageChannel) and drive all tools in-process. (In 1.4.0 the apollovm.lsp.* tools were documented as web-safe, but apollovm_mcp.dart still transitively imported dart:io/dart:isolate, so a web build failed to compile.)
• The dart:io-only pieces moved to a new package:apollovm/apollovm_mcp_io.dart (which re-exports apollovm_mcp.dart): serveStdio, HttpSseTransport and the CommandMcp CLI group. Native embedders and the apollovm CLI import this. Migration: if you imported serveStdio / HttpSseTransport / CommandMcp from apollovm_mcp.dart, switch that import to apollovm_mcp_io.dart (a one-line change).
• The per-tool timeout executor is now platform-selected (mirroring wasm_runtime.dart): a killable-isolate executor on native, and an in-process executor with a cooperative timeout on the web (no dart:isolate). Tools in McpLimits.isolateTools therefore still run, degrading to a soft timeout on the web.
• New cross-platform test test/mcp/web_compat_test.dart runs the tools, the in-process LspClient and the server under dart test --platform chrome, guarding the web-safe surface against future dart:io/dart:isolate leaks.

MCP — code-inspection tools (LSP) #

• The MCP server now exposes ApolloVM's LSP features as apollovm.lsp.* tools, so an AI agent can inspect code the way an editor does. Results carry precise LSP line/character ranges.
  • apollovm.lsp.diagnostics — errors/warnings with ranges.
  • apollovm.lsp.symbols — document outline (nested symbols + ranges).
  • apollovm.lsp.hover — signature, type and documentation at a position.
  • apollovm.lsp.definition — declaration location at a position.
  • apollovm.lsp.references — all references at a position.
  • apollovm.lsp.completion — completion proposals at a position.
  • apollovm.lsp.workspaceSymbols — symbol search across multiple in-memory files (codebase-wide lookup).
• Each tool is stateless and web-safe (backed by the in-process LspService; no socket, no dart:io), runs in-process or inside an isolate like the other bounded tools, and honors the existing maxSourceChars limit. The parser is selected from the language argument, so a mismatched URI cannot change it.
• New public API in package:apollovm/apollovm_mcp.dart: LspRuntime, buildLspTools, computeLspTool, isLspTool, lspToolNames. The CLI apollovm mcp call gained --line, --character and --query flags.
• New example example/apollovm_example_mcp_lsp.dart.

Language Server Protocol — in-process API (no socket) #

• New LspService in package:apollovm/apollovm_lsp.dart: a document-oriented facade that embeds an in-process LspServer and exposes the language features as plain typed Dart calls — no transport, no socket and no initialize/initialized handshake to run by hand. Being dart:io-free it runs unchanged in a browser (compiled to JS) or an AI agent.
  • One-shot analyze(uri, text) returns the buffer's diagnostics directly; open/change/close manage documents (versions tracked automatically); every query resolves against the current buffer.
  • Typed helpers: hover, definition, documentSymbols, completion, references, documentHighlight, prepareRename, rename, workspaceSymbols, plus a diagnostics stream and a ready (InitializeResult) future.
  • LspService.wrap(client) layers the same convenience over an existing LspClient (e.g. one connected to a remote server).
• New example example/apollovm_example_lsp_api.dart drives the whole flow through LspService with no transport wiring.

Language Server Protocol — new server features #

• textDocument/documentHighlight — highlights every occurrence of the identifier under the cursor, marking the declaration site as Write and other uses as Read (documentHighlightProvider capability).
• textDocument/prepareRename — validates a rename target, returning its range and placeholder, or null when the cursor is not on an identifier (advertised via the rename provider's prepareProvider).

Language Server Protocol — client #

• New LspClient in package:apollovm/apollovm_lsp.dart: a JSON-RPC client that consumes the ApolloVM LspServer. It correlates responses to the requests it sends, streams server-pushed diagnostics (Stream<PublishDiagnosticsParams> get diagnostics), and exposes typed helpers — initialize, didOpen/didChange/didClose, hover, definition, documentSymbol, completion, references, documentHighlight, prepareRename, rename, workspaceSymbol, shutdown/exit — plus low-level sendRequest/sendNotification.
• LspClient.inProcess() pairs a client with a fresh LspServer over a linked MessageLspEndpoint pair, all in one isolate — no subprocess, no dart:io. The client works over any LspEndpoint, so an out-of-process server can be driven with LspClient(StreamLspEndpoint(out, in)).
• LspEndpoint now routes JSON-RPC responses (previously ignored) to a new onResponse hook, enabling the client role. Pure-server usage is unchanged.
• Protocol data types gained fromJson factories (Hover, Location, Diagnostic, DocumentSymbol, CompletionItem, TextEdit, WorkspaceEdit), and new types were added: InitializeResult, ServerInfo, PublishDiagnosticsParams, WorkspaceSymbol, CompletionList, DocumentHighlight/DocumentHighlightKind, PrepareRenameResult.
• New example example/apollovm_example_lsp.dart drives a full session (handshake, diagnostics, symbols, hover, definition, completion, highlight, prepare-rename, rename) through LspClient.inProcess().

• Fix broken 1.2.0 package on pub.dev: the .pubignore pattern lsp/ was unanchored, so besides the intended root lsp/ dev-tooling directory it also stripped lib/src/lsp/ (the LSP implementation) from the published archive, making dart pub global activate apollovm fail to compile. The pattern is now anchored as /lsp/.
• .pubignore now also repeats the relevant .gitignore exclusions (*.exe, *.iml, etc.), since a .pubignore file replaces .gitignore for publishing — 1.2.0 accidentally shipped a 7 MB bin/apollovm.exe.

Language Server Protocol (LSP 3.17) server #

• A Dart-first language server is now part of the apollovm package, exposed as a separate library package:apollovm/apollovm_lsp.dart (the existing package:apollovm/apollovm.dart exports are unchanged). Source lives in lib/src/lsp/.
• Runnable two ways. Locally over stdio via a new CLI subcommand apollovm lsp; and embedded / web — the library imports no dart:io, so a browser IDE or an AI agent can drive it with decoded JSON-RPC messages via MessageLspEndpoint (no byte framing). StreamLspEndpoint provides Content-Length framing for stdio/sockets. Both share a transport-agnostic LspEndpoint.
• The server keeps the ApolloVM core read-only: because the AST carries no source positions and the parser discards comments, a small self-contained scanner re-scans raw text for identifier/declaration positions and correlates them back to the AST (the source of truth for semantics). Four strictly separated layers keep LSP logic out of the parser — transport, protocol (LSP 3.17 types), analysis (parse/index/resolve), and server (handlers).
• Implemented: initialize/shutdown, incremental diagnostics (parse + unresolvable core imports), documentSymbol, hover (kind/signature/type/ documentation), definition; plus single-file references/rename and a basic ranked completion.
• Parse-error diagnostics are located precisely: since the core parser reports a generic "end of input expected" at offset 0 for most structural mistakes, the server runs a bracket-balance analysis to underline the real culprit (e.g. an unclosed (/{) with a hint, instead of pointing at the top of the file.
• Companion assets live under lsp/ (excluded from the published package via .pubignore): a VS Code client (lsp/vscode), an example workspace (lsp/example_workspace), and a latency benchmark (lsp/benchmark).
• Verified with dart analyze (clean), 17 passing tests in test/lsp/ (including full stdio and message-level protocol sessions), and a benchmark comfortably under its latency targets (open, hover, completion).

Optional Dart package importer (pub.dev / pubspec-compatible) #

• package: imports can now be resolved against real pub packages, via an optional importer exposed at package:apollovm/apollovm_pub.dart (kept out of the web-safe apollovm.dart).
  • Pluggable PackageProvider: PackageConfigProvider (default, VM-only, zero extra deps — resolves through .dart_tool/package_config.json, exact pub semantics) and PubDevProvider (web-compatible) — downloads archives from pub.dev or a configurable/private/mirror host, extracts them in memory, caches them (MemoryPackageCache by default, FilePackageCache on the VM), and honors pubspec version constraints. Built on web-safe libraries only (http, archive, pub_semver, yaml — no dart:io), so it runs on the VM and in the browser.
  • Web/CORS: PubDevProvider accepts an injectable http.Client, a custom host, and a rewriteUrl hook to route requests through a CORS proxy — a ready-made proxy ships in tool/pub_cors_proxy.dart.
  • DartPackageLoader + DartPackageImporter.provision() fetch each reachable package: import transitively and load its source into the VM; injected via the new settable ApolloVM.moduleLoader. A generic CompositeModuleLoader chains loaders.
  • CLI: apollovm run/translate --pub (with --pub-host / --pub-cache) resolves package: imports before executing.
  • Promotes http, archive, pub_semver, yaml to direct dependencies (all web-safe); only the filesystem members (PackageConfigProvider, FilePackageCache) are behind conditional imports with web stubs.
  • See doc/module_resolution.md and example/apollovm_example_pub_importer.dart.

Language-agnostic package/module import system #

• Cross-module imports now resolve and execute. A source file can import symbols (classes, functions, enums, type aliases) from other loaded modules, normalized into a single canonical AST regardless of language.
  • Enriched ASTStatementImport (named/show/hide, wildcard, whole-module prefix alias, per-symbol alias) plus new ASTStatementExport and ASTTypeAlias nodes.
  • New web-safe resolution layer (lib/src/resolution/): pluggable ModuleLoader (in-memory VMModuleLoader), four-level SymbolTables + ImportScope, ModuleResolver, a DependencyGraph (Tarjan cycle detection, Kahn topological order, incremental affectedBy invalidation), structured ImportDiagnostics (missing module/symbol, duplicate symbol, circular import, invalid export), a ResolutionCache, and the ModuleResolutionEngine facade.
  • ApolloVM.resolve() returns aggregated diagnostics; resolution is triggered lazily by the runner and invalidated incrementally on loadCodeUnit.
  • Parse + generate wired for Dart, TypeScript, and Python (named/show/ hide/wildcard/alias/re-export/typedef); other languages keep basic imports and compile unchanged against the additive AST.
  • Golden-test harness extended for multi-<source> (cross-module) tests.
  • See doc/module_resolution.md and example/apollovm_example_imports.dart.

New language: Go #

• Added first-class Go support — ApolloVM can now parse, execute, and translate Go source (.go / go, alias golang) through the shared AST, bidirectionally with every other supported language (and on-the-fly Wasm).
• Implemented under lib/src/languages/go/ (go_grammar_lexer.dart, go_grammar.dart, go_generator.dart, go_parser.dart, go_runner.dart) and wired into ApolloVM (getParser/createRunner/createCodeGenerator and the .go file-extension mapping).
• Supported: top-level and struct receiver methods (func (o *Name) m(...)), struct types with fields and factory constructors (func NewName(...) *Name), var/:= type inference, if/else if/else, the four for forms (C-style, condition-only as while, range as for-each, infinite / do-while), Go switch (no fall-through), slices/maps ([]T{…}, map[K]V{…}), closures, all arithmetic/comparison/logical/bitwise operators, string + concatenation, and fmt.Println (normalized to the VM's print).
• Go has no classes: a class is modeled as a struct + receiver methods (the same idiom Lua uses for tables), so OOP code round-trips across all languages. See the README feature tables for the full per-feature matrix; try/catch/throw, inheritance/interfaces, rich enums and generics are not yet implemented for Go.

MCP-native runtime: expose ApolloVM to AI agents over the Model Context Protocol #

• New apollovm mcp command group exposes ApolloVM as an MCP (Model Context Protocol) server and tools, turning it into a programmable, sandboxed execution engine for AI agents. Built on the official dart_mcp SDK. Subcommands: mcp serve (run the server over stdio or HTTP/SSE via --http <port>), mcp list (tool definitions), mcp call <tool> (one-shot tool invocation for scripting/CI), mcp info, mcp schema, and mcp doctor.
• Seven tools: apollovm.parse, apollovm.execute, apollovm.translate, apollovm.ast, apollovm.symbols, apollovm.types, apollovm.wasm — parse, run, translate, compile to Wasm, and inspect AST / symbol graph / type table across all supported languages.
• Security model: file/network access denied by construction (only print is exposed; inputs are inline source only); apollovm.execute runs in a killable isolate so a hard timeout is enforced even against runaway synchronous loops (per-tool configurable via --isolate-tools); input/output size caps (--max-source-chars, --max-output-chars); best-effort process-level memory.
• New public library package:apollovm/apollovm_mcp.dart (ApolloMcpServer, serveStdio, HttpSseTransport, McpLimits, computeTool).
• Added dependency dart_mcp: ^0.5.2 (and stream_channel). New mcp-tagged integration tests under test/mcp/. See doc/MCP.md.

CLI: run executes .wasm files through the Wasm runtime #

• apollovm run foo.wasm now runs the binary module via the Wasm runtime (ApolloRunnerWasm) instead of trying to decode it as UTF-8 source. The file is loaded as a BinaryCodeUnit, parsed for its exported functions by ApolloParserWasm, and its entry function (e.g. main) is invoked — closing the compile → run loop from the command line.
• The .wasm file extension now maps to the wasm language in ApolloVM.parseLanguageFromFilePathExtension.

Wasm backend: integer division semantics (/ on ints) + division-by-zero #

• / on integer operands is now integer (truncating) division in Java/Kotlin/C# — where the expression resolves to int — instead of an f64 quotient (so 10 / 3 is 3, not 3.33). Dart's / keeps its double result; ~/ is unchanged.
• Integer division by zero raises a catchable exception whose message matches the interpreter (IntegerDivisionByZeroException for /, Unsupported operation: Infinity or NaN toInt for ~/). Applies to both ~/ and integer /.
• A print whose argument is built from a value that just raised (e.g. the quotient in print('q = ${a ~/ b}')) is skipped when an exception is pending, matching the interpreter, which never reaches the print.

These fix the Dart, Java and Kotlin exception (try/catch/finally) examples.

Wasm backend: num (TypeScript/JS number) + switch on a boxed scrutinee #

• num (a TypeScript/JavaScript number) is now supported in the Wasm backend. A plain num has no fixed width; the VM treats integer-valued numbers as int, so num is represented as i64. This fixes string interpolation/concatenation of a num (e.g. "sum=" + (a + b)), switch on a num scrutinee, and num arithmetic — unblocking the TypeScript Class, Conditional, Exceptions and Switch examples.
• switch on a boxed dynamic/Object scrutinee (e.g. a List<Object> element) now compiles: the scrutinee is unboxed to a concrete i64 to drive the integer branch table.
• Scalar Object/dynamic entry-point parameters are now marshalled. An untyped parameter (e.g. a JavaScript/Python main(a, b), or an explicit Dart dynamic parameter) is passed as a host-allocated box instead of a raw scalar the module would read as a garbage pointer — fixing the JavaScript, Lua and Python Class/Conditional/Switch examples, which previously ran with all arguments seen as 0. (The apollovm_sig section is now emitted whenever a public function has an Object/dynamic parameter, and a plain num is tagged as int so it is passed as a raw i64 rather than boxed.)
• Anonymous functions with an untyped parameter (n => n * 2 from C#/Lua/Python) now compile: the parameter type is inferred from its body. A nested closure's return no longer makes the enclosing (void) function non-void.
• Named nested function declarations (let twice = (n) => …, which JavaScript/TypeScript parse as a function declaration rather than a var) are hoisted and lowered to a direct call.
• A boxed value flows into and out of an Object/dynamic slot. A concrete value passed to a generic T field/parameter (represented as a boxed Object) is boxed; a boxed value used in arithmetic or passed to a typed numeric parameter is unboxed. This makes generic Box<T> (Dart, Java, Kotlin, C#, TypeScript) work.
• More boxed-operand operations. A var whose initializer is a boxed-operand expression (e.g. var s = a + b where a/b are Object[]/List<Object> elements) is refined to the result's concrete type, and the == 0 fast path (i64.eqz) unboxes a boxed operand first. Fixes the Java Class example and the JavaScript try/catch example.

Wasm backend: collection-to-String + dynamic arithmetic on boxed values #

• Map/List → String coercion in print(...) / string interpolation (e.g. print('Map: $m'), '$list'). Renders Dart's {k: v, …} / [e, …] form by scanning the runtime key/value (or element) buffers and coercing each entry through the existing string-coercion path. (Nested collections inside a Map/List toString still throw a clear UnimplementedError.)
• Arithmetic and comparison on boxed Object/dynamic operands, such as values read from a List<Object> (args[1] + 5, args[2] ~/ 2, args[3] * 3, c > 120). These carry a box pointer, not a number; they are now unboxed to a concrete numeric value (dispatching on the runtime box tag: int→i64, double→f64) before the operation, instead of feeding the pointer into i64.add/f64.div (which produced invalid Wasm).
• A boxed Object value flowing into a typed numeric Map/List slot (e.g. <String,int>{'a': a} where a is dynamic) is unboxed to match the slot's i64/f64 width.

Wasm backend: anonymous functions assigned to a var and called directly #

• Lambdas stored in a var and invoked by name now compile (e.g. var twice = (int n) => n * 2; … twice(x)). The return type is inferred from the body when no typed call context provides it, and the variable adopts the closure's concrete function signature so the call resolves.
• Fixed a latent bug where anonymous functions were exported with an empty name; two closures then collided on the same "" export name, producing an invalid module. Anonymous functions are internal (table-dispatched) and are no longer exported.
• Optimization: a capture-free closure assigned to a var that is only ever called (never used as a value, reassigned, or captured) is lowered to a direct call — no environment heap allocation, no call_indirect, and the function-table / element sections are omitted entirely. Closures used as first-class values or that capture variables keep the environment + table path.

Wasm backend: rich-enum field/method reads in a print context #

• Fixed garbage values when a rich-enum instance field or method result was passed through print(...) / string interpolation (e.g. print(p.gravity) or print('${p.mult(2)}')). The lazily-generated enum-entry initializer baked its constructor call index during an early discovery pass, before the print/double_to_str host imports were registered; those imports then shifted every function index, so the cached call landed on a host import instead of the enum constructor. Enum-entry initializer bodies are now generated lazily (after the import count is final), so the call indices are correct. Reading the same field/method outside a print (e.g. return p.gravity) was already correct.

Wasm backend: close several Dart → WebAssembly gaps #

• Unqualified sibling class-method calls now resolve: a method can call a sibling static method by bare name (dbl(x) instead of Foo.dbl(x)), including with named arguments and omitted default parameters.
• String + <number> concatenation (from Java/Kotlin/C#/JS/TS, e.g. "n=" + n) compiles, coercing the numeric operand to a String.
• switch on a String scrutinee (content equality) and switch on an enum scrutinee (compared by ordinal). switch on int already worked. Also fixes a general function-end edge case: a control construct (switch/if/while) that returns on all paths as the last statement (e.g. after a var declaration) compiled to a function that fell off its end without a return value.
• Rich-enum methods that take an enum-typed parameter (double ratio(Planet p)) compile; C#/TypeScript explicit-value enums expose .value.
• Typed catch-all clauses (on Exception catch (e) / catch (Exception e)) compile instead of failing on the declared exception type.
• Known remaining gaps (documented, with skipped reproduction tests): Map/ List → String coercion, generic (Box<T>) primitive fields, lambdas, and switch on a boxed dynamic/Object scrutinee.

Named / keyword arguments #

• Function, method and constructor calls can now pass arguments by name, bound to parameters by name rather than position (so call-site order is free): Dart foo(a: 1, b: 2), Kotlin foo(a = 1), C# foo(a: 1), Python foo(a=1).
• Dart also parses explicit named-parameter declarations (int f({int a, int b})), optional-positional groups ([int b]), and the same forms in constructors (Box({this.w, this.h})); the other languages declare parameters positionally and allow any of them to be passed by name, matching each language's semantics.
• Runtime, parsing and code generation all round-trip: a call's named arguments regenerate in each language's syntax (a: v / a = v / a=v) and re-parse to the same result. Languages without a native named-argument concept (Java, JavaScript, TypeScript, Lua) are unaffected and keep positional calls.
• Wasm: the on-the-fly WebAssembly compiler accepts named-argument calls, reordering them into the callee's positional parameter slots.

Default values for optional and named parameters #

• Optional and named parameters can declare a default value that is used when the argument is omitted: Dart int f({int a = 5}) / [int b = 3], Kotlin fun f(a: Int = 5), C# void F(int a = 5), Python def f(a=5) (including default-bearing constructor parameters, e.g. Box({this.w = 2})). Defaults are evaluated at call time, round-trip through code generation, and are overridden by any supplied positional or named argument. The Wasm compiler also fills omitted parameters with their (constant) default expressions.

CLI: compile command (WebAssembly) #

• New apollovm compile [-o out.wasm] [--target wasm] <source> command compiles a source file to a WebAssembly binary via the on-the-fly Wasm compiler, writing one .wasm file per generated module (alongside run and translate).

Tests reorganized by concern #

• The test/ suite is grouped into unit/, features/, languages/, wasm/, integration/ and meta/ subdirectories (no behavior change).

Rich enums (enum entries are const class instances) #

• Enums are redesigned: an enum is a class and each entry is a cached const instance — a singleton, so == is identity — replacing the int-ordinal model. Every entry carries index (ordinal) and name, and EnumName.values lists them. Dart enhanced enums work: entries with constructor arguments, fields, and methods (Planet.earth.gravity()). Explicit-value entries (C#/TypeScript Medium = 5) expose the value via .value.
• Parsing: Dart, Java and Kotlin parse rich-enum entry args + members.
• Generation: Java/Kotlin emit native rich enums; C#/TypeScript/Python emit a class + static-const-instances idiom (simple enums are unchanged).
• Wasm: enum entries compile to heap instances (lazily built, cached per entry); .index/.name/fields/methods and EnumName.values all work.
• Breaking change: an enum entry is no longer an int — use Color.blue.index (and .value for explicit = N entries) instead of int x = Color.blue.

Constructors & instantiation for JavaScript and Python #

• JavaScript: a constructor(...) class method is now parsed as a real constructor, and new Foo(...) / Foo(...) instantiate the class (running the constructor, which can assign this.x = …). Round-trips to constructor(...) and translates to other languages.
• Python: self.x = … attribute assignment is now parsed, __init__ is treated as the constructor, and Foo(...) instantiates the class. The generator emits def __init__(self, …). (Previously instance-field assignment was unimplemented, so __init__ wasn't usable end-to-end.)
• Both round-trip across languages (e.g. a JS/Python class with a constructor translates to a runnable Dart class). The README OOP table marks JS and Python "Constructors & instantiation" as supported.

async/await for JavaScript, TypeScript, C# and Python #

• These languages now parse async functions/methods (and async arrows / lambdas) and the await expression, joining Dart. Parsed code executes on the shared async runtime, round-trips back to its source language, and translates across languages (e.g. C# async Task<int> ⇄ Dart Future<int> … async).
• C# and Python also gained async code generation (async/async def); the JavaScript and TypeScript generators already emitted it.
• await now unwraps any awaitable type — Future<T>, Promise<T> (TypeScript) and Task<T> (C#) — to its value type T, so awaiting a typed result infers the correct type. A shared word-boundary keyword token keeps identifiers like awaiter from being read as await + er.
• The README "Control flow & operators" table gains an async/await row.

Wasm: static methods + boxed Object #

• The WebAssembly compiler now supports static class methods: each is synthesized as an exported module function under the qualified Class.method name (no this), generated like a top-level function. ApolloRunnerWasm gains executeClassMethod, resolving the export by that name.
• New boxed representation for Object/dynamic values: an i32 pointer to a 16-byte heap cell [tag@0][typeId@4][payload@8]. Concrete values flowing into an Object slot are boxed, and toString() dispatches on the box tag (int/double/bool/String, plus boxed instances by typeId). Enables List<Object>/List<dynamic> literals and arguments with mixed element types, marshalled host-side by ApolloRunnerWasm.
• A homogeneous list literal initializing a List<Object>/List<dynamic> variable (e.g. List<Object> x = [1, 2, 3]) now boxes its elements. The literal infers a concrete element type (List<int>) and previously stored unboxed values that the boxed read path misread (garbage output or an out-of-bounds trap); the declared target element type is now honored.
• Validated against both the AST interpreter and the compiled+executed Wasm module.

Only static methods are callable without an instance #

• A non-static class method now requires a class instance to run. The interpreter's executeClassMethod (and any internal call that reaches a non-static method with no this in context, e.g. a static method calling an instance sibling) throws ApolloVMRuntimeError instead of silently running against an auto-created instance. Pass classInstanceObject / classInstanceFields to run a non-static method, or mark the entry method static. This matches the Wasm backend, where only static methods are exported.
• ApolloRunnerWasm.executeClassMethod now reports a clear error for a non-static target (only static methods are exported) and rejects being given a class instance (the Wasm backend has no instance-method entry points).
• The Wasm generator rejects a receiver-less call to a non-static method (e.g. a static method calling an instance sibling) with a clear UnsupportedError.
• Examples and the README run entry methods as static where they hold no instance state, or supply an instance otherwise.

Tests #

• Test files now carry dart test tags: a backend tag (wasm, plus wasm-gc/wasm-chrome for browser-only Wasm tests) and per-source-language tags (dart, java, kotlin, javascript, typescript, lua, csharp, python). E.g. dart test -t wasm, dart test -t kotlin, or dart test -x wasm-gc for the native wasm_run CI.

Wasm: control flow + bitwise #

• The WebAssembly compiler now supports do/while, switch/case (integer, C-style fall-through), break, continue, and the bitwise operators & | ^ << >> and unary ~. Loops now wrap their body in a continue block and WasmContext tracks structured-control depth so break/continue emit correct relative branch labels. Each construct is validated against both the AST interpreter and the compiled+executed Wasm module.

Bitwise operators: Kotlin and Lua #

• Kotlin: infix and/or/xor/shl/shr and x.inv() (bitwise NOT).
• Lua: &/|/~ (xor)/<</>> and unary ~, leaving ~= (not-equals) and ^ (exponent) intact.

Kotlin member visibility #

• Parse and generate member modifiers (private/public/internal/ protected, plus open/override/abstract/final/const) on Kotlin methods/fields/constructors; method visibility round-trips.

Fixes #

• Java: private members no longer fail with "Can't be private and public" (the modifiers parser derived isPublic from private).

Docs #

• New "Supported Features" section in the README: per-language control-flow / operator matrix (with a Wasm column) and a Classes/types/OOP matrix.

enum runtime value access #

• EnumType.entry now resolves at runtime to the entry's value: its explicit value when present (C# Level.Medium → 5), otherwise its ordinal index (Dart Color.blue → 2). ASTRoot.getNodeIdentifier resolves user classes/enums by name; enum entry access short-circuits in ASTExpressionObjectGetterAccess.

Generics #

• Parse generic type annotations in Java and C# (List<Integer>, Map<String,Integer> m, Box<T>); well-known collections map to the shared array/map types, other generic types keep their type arguments and round-trip.
• Support generic class declarations and instantiation across the languages that have generics: class Wrapper<T> { T value; … } plus new Wrapper<int>(10) / Wrapper<int>(10). Class type parameters are erased to dynamic in member types; generic type arguments on calls are parsed. Runs end-to-end in Dart, Java, C#, Kotlin and TypeScript.
• Type system: generic erasure in ASTType.acceptsType — a raw type and a parameterized one of the same name are mutually compatible (so a Wrapper instance binds to a Wrapper<int> variable).

Fixes #

• Java for-each now generates the colon form for (Type x : coll) instead of the invalid for (var x in coll), so generated Java re-parses.
• Kotlin val/var keywords now require a word boundary, so identifiers like value are no longer mangled (e.g. a constructor parameter value was read as ue).
• Kotlin and TypeScript class instantiation/constructors now execute: a constructor with an omitted class name (constructor(...)) resolves its type from the enclosing class, and TypeScript constructor(...) is parsed as a real constructor so new Foo(...) works.

Language: C# — lambda parsing #

• Parse C# lambda expressions (x => x * 2, (a, b) => a + b, (int a) => { ... }, () => 0); previously C# could only generate lambda syntax, not read it.
• Delegate type names (Func, Action, Delegate, Function) map to the shared function type, so a lambda value binds to a delegate-typed parameter.

Control flow: switch/case, break, continue, do/while #

• New shared AST/runtime nodes (ASTStatementBreak, ASTStatementContinue, ASTStatementDoWhileLoop, ASTStatementSwitch/ASTSwitchCase). break/ continue propagate through ASTBlock and are consumed by the enclosing loop/switch; for still runs its increment on continue.
• switch uses C-style fall-through (break ends a case; default runs when no case matches). An ASTStatementSwitch.fallThrough flag disables fall-through for languages whose construct has none.
• Parsing + code generation added to the C-style languages: Dart, Java, C#, JavaScript, TypeScript (each case body accepts a braced block or a bare run of statements).
• Mapped to each non-C-style language's idiom:
  • Kotlin: break/continue, do { } while (c), and when (e) { v -> …; else -> … } (no fall-through).
  • Python: break/continue, and match/case (case _: is the default; no fall-through). Python has no do/while.
  • Lua: break, and repeat … until <cond> mapped to a do-while (the condition is negated; the generator unwraps it to emit until <cond>).
• New golden tests under test/tests_definitions/*_control_flow*.test.xml for all eight languages.

Bitwise operators #

• New operators &, |, ^, <<, >> (binary) and ~ (unary complement), with shared AST/runtime evaluation (int operands) and precedence (shift, then AND/XOR/OR, between arithmetic and comparison).
• Parsed and generated in Dart, Java, C#, JavaScript, TypeScript, Python. Java additionally gains the previously-missing %, && and || operators.
• Not added for Kotlin (bitwise are infix functions and/or/shl/inv) or Lua (~ is xor and ^ is exponentiation) — their non-symbolic forms need bespoke handling.
• New golden tests test/tests_definitions/*_bitwise.test.xml.

enum (Java, C#, Kotlin, Python) #

• Enum declaration parsing + generation extended to Java (enum E { … }), C# (enum E { A = 1, … }), Kotlin (enum class E { … }) and Python (class E(Enum): …), joining the existing Dart/TypeScript support.
• Declaration + round-trip only (matching the prior Dart/TS level); runtime enum-value access is a separate future enhancement.
• New golden tests test/tests_definitions/*_enum.test.xml.

Language: C# #

• New self-contained C# language support (csharp, also accepting cs and c#) able to parse, run and translate, at the same level of compatibility as Dart and Java: classes, fields (incl. initial values), constructors, methods and modifiers (public/private/static/readonly/…), using directives, variable declarations (var and typed), the full expression set (arithmetic/comparison/logical operators, ternary ?:, ++/--, negation), string concatenation, if/else if/else, for, foreach (T x in coll), while, try/catch/finally, throw, lambdas (=>), and List<T> / Dictionary<K,V> collection initializers.
• C# types map to the shared AST (int/long/short → int, double/float/ decimal → double, bool, string, object, …) so code translates cleanly to/from every other supported language.
• Registered in ApolloVM (getParser, createRunner, createCodeGenerator) and exported from apollovm.dart; .cs files resolve to the csharp language.
• New golden tests under test/tests_definitions/csharp_*.test.xml.

Lambda / anonymous-function input parsing (Java, Kotlin, Lua) #

• Java: parse lambdas as expressions — (a, b) -> expr, (int a) -> { ... }, x -> x * 2, () -> 0 (typed or untyped parameters).
• Kotlin: parse lambdas { x -> x * 2 }, { x: Int, y: Int -> x + y }, { 42 }; the last expression is the implicit return value.
• Lua: parse anonymous functions function(x) ... end.
• Closures now round-trip (parse → execute → regenerate) in these languages, not just generate.

Wasm: host imports no longer corrupt module-function call indices #

• A module-function call index is importCount + position, but host imports (env.print, env.int_to_str, …) are registered lazily while bodies are generated. A call emitted before an import was registered (e.g. calling a function and then print-ing, including across await points) got a stale index and produced invalid Wasm (type mismatch). The import-discovery pass that freezes importCount before the real pass now runs for all modules (it only touches idempotent state, so import-free modules stay byte-identical).
• Fixes async/await functions that call other functions and print between awaits, which now run identically on the interpreter and Wasm.

Wasm: closures capture variables by reference #

• Captured variables are now "boxed" into shared heap cells: the closure environment holds pointers to the cells (not copied values), so a variable mutated after a closure is created — or mutated by the closure — is visible on both sides, matching the interpreter. Each closure instance still gets its own cell (e.g. two counters created from the same factory are independent).

Ternary / conditional expressions #

• Parse condition ? a : b in Dart, Java, JavaScript and TypeScript, plus the native conditional-expression forms a if condition else b (Python) and if (condition) a else b (Kotlin).
• New ASTExpressionConditional AST node (only the selected branch is evaluated); generated idiomatically per target: ?: (Dart/Java/JS/TS), a if c else b (Python), if (c) a else b (Kotlin), c and a or b (Lua), and a value-typed if/else block in Wasm.

Anonymous functions / lambdas / closures #

• New ASTExpressionLiteralFunction AST node that captures the defining scope (closure semantics); function values held in variables/parameters are now invocable.
• Parse anonymous functions: (x) => … / (x) { … } (Dart), (x) => … / x => … (JavaScript, TypeScript) and lambda x: … (Python).
• Generate anonymous functions for every target: arrow forms (Dart/JS/TS), Java (x) -> …, Kotlin { x -> … }, Lua function(x) … end, Python lambda x: ….

Dart function types #

• Parse function types int Function(int n), void Function() and Function(int n) (omitted return type → dynamic); ASTTypeFunction accepts any other function type, and function types are generated as int Function(int) (Dart) / bare Function elsewhere.

Wasm: closures via function table + call_indirect #

• Added Table and Element sections and the call_indirect instruction. A function value is an i32 pointer to a heap environment struct [tableSlot, captured…]; each closure function takes a hidden environment pointer and reads its captured variables from it.
• Concrete signatures are inferred for capture-less closures, untyped lambda parameters, capturing closures, and closures returned through a concrete Function return type. Each closure instance gets its own heap environment.
• Not yet supported in Wasm: polymorphic dynamic-return function types (a Function(int) parameter called with both an int- and a double-returning lambda) — these report a clear error and still work on the interpreter.

Bug fixes #

• Python: self.method() and self.field now round-trip correctly; fixed a self.field getter parse crash and a stack overflow on self-referential bindings (s = s + i) during code generation.
• Local function declarations were duplicated in regenerated code after a function was executed (addFunction is now idempotent and block generation no longer emits a statement-level function twice).
• Fixed doubled indentation of nested function declarations.

Documentation #

• Added Python to the package description and the README (a Python language section and updated the TODO list).

Python language support #

• Added Python language support (parse, run, and code-generation target), emitting strict, idiomatic Python 3.
  • Indentation-significant blocks are handled by an INDENT/DEDENT/NEWLINE pre-tokenizer (PythonIndentationPreprocessor), so the petitparser grammar consumes Python suites like braces; implicit ((/[/{) and explicit (\) line continuations, blank/comment lines, and string literals are handled, and the source is dedented by its common minimum indentation (so a uniformly-indented embedded block parses like a flush-left one).
  • Strict generation: PEP-484 type hints when the AST type is statically known (def f(x: int) -> int:, x: str = ..., List[T]/Dict[K, V]), with a dynamic/untyped fallback; ==/!=, and/or/not, // integer division, True/False/None, f-strings for interpolation, and self-based methods.
  • Supports functions, variables (Python first-binding-is-declaration scoping), arithmetic/comparison/boolean expressions, if/elif/else, while, for ... in, try/except/finally + raise, class with methods, lists & dicts, and import/from ... import.
  • Registered python (py / .py) across getParser, createRunner, createCodeGenerator, and the CLI.

Wasm: print accepts any value (not only String) #

• int / double reuse the host number-to-string imports (env.int_to_str / env.double_to_str); bool lowers in-module to the interned "true" / "false" literals (via select); print(null) prints "null". String interpolation gained the same parity.
• The interpreter's mapped print now accepts null (nullable Object?), and a bool argument passed to a public Wasm function is marshalled to its i32 ABI value.

Classes and instantiation (Dart, Java, and Wasm) #

• The new keyword is now parsed in Dart and Java (new User()); new User() and User() resolve to the same constructor (boundary-safe, so identifiers like newValue are unaffected). Java also gained a generic new ClassName(args) rule (previously only new ArrayList<…>() / new HashMap<…>() were recognized).
• Classes that declare no constructor get an implicit default (zero-arg) constructor — on the interpreter and the Wasm backend; field initializers still apply.
• Constructors that set fields: this.field parameters, and constructor bodies that assign fields (this.field = value and bare field = value, with parameters shadowing same-named fields, e.g. User(int id) { this.id = id; }). Fixed empty-parameter constructors with a body (User() { … }), which threw a parser cast error.
• A class method can instantiate sibling classes and call top-level functions (ASTClass.getFunction falls back to the enclosing ASTRoot) — essential for Java, where all code lives in a class.
• Dart arrow (expression-bodied) functions and methods: T name(params) => expr; (e.g. String toString() => '…';), for top-level functions and instance methods, including void bodies. Desugars to { return expr; }.
• WebAssembly compilation of classes (first slice): single classes (no inheritance) with int / double / bool / String / object-reference fields, constructors (this.field params, field initializers, default and body constructors), instance methods, in-code instantiation, and method calls (p.sum() and implicit-this foo()). An object is an i32 pointer to a bump-allocated struct; methods take this as the first parameter; a discovery pass registers host imports before the code section so cross-function call indices stay correct.

Object field access on instances (read and write) #

• Field assignment obj.field = value (and this.field = value), including compound operators (+=, -=, *=, /=, ~/=), via a new ASTExpressionObjectSetterAssignment node — added to the Dart, Java, Kotlin, JavaScript and TypeScript grammars, the shared source generator (round-trips back to obj.field = value), and the Wasm backend (stores at recv + offset).
• Field read obj.field is now supported in Java (which had no object getter-access rule); this.field reads resolve to the current instance's field across all languages (previously routed to a local-getter lookup and failed with "Can't find getter").

print(obj) calls the user-defined toString() #

• Interpreter: print(instance) invokes a user-declared toString() (a class without one still prints the default Class{…} representation), and ASTExternalFunction.call now awaits resolved argument values so an async resolver result isn't passed through as a Future.
• Wasm: print(instance) (and string coercion / interpolation) calls the instance's compiled toString() and prints the resulting string handle.

This makes programs like the following compile and run on Wasm with interpreter-parity:

class User {
  int id;
  String name;
  User(this.id, this.name);
  String toString() => 'User#$id<$name>';
}
void main() {
  var user = new User(123, 'Joe');
  print(user);
  print(user.id * 1000);
}

Not included: inheritance / interfaces / abstract / static members / polymorphism.

• Wasm throw / try / catch / finally: exception handling now compiles to WebAssembly (previously deferred / loud-failure), engine-agnostic — no Wasm exception-handling proposal required.
  • A function that uses (or transitively calls) exceptions is lowered to a $pc-dispatched CFG (like the Asyncify transform but without suspension), so a throw is an absolute jump to the nearest handler — no fragile relative br bookkeeping. The thrown value + an in-flight flag live in a small fixed exception region of linear memory.
  • Supported: throw of int/double/bool/String/object values; typed (on T catch), untyped, and multiple catch clauses; type matching that mirrors the interpreter (ASTType.acceptsType, e.g. on double accepts an int); finally on every exit path (normal, caught, propagated, and return-through-finally, with return-in-finally overriding); throw inside if/while/for; cross-function propagation (a callee sets the pending flag + returns, each call site re-checks it); and catching VM traps — integer division by zero (1 ~/ 0) raises a catchable String instead of trapping the module.
  • Deferred (these fail loudly rather than miscompile): async/await combined with exceptions in the same function, for-each containing a throw, multiple raising operations in a single statement, and return <throwing call> directly inside a try.

• Exception handling: throw, try / catch / finally for Dart, Java, Kotlin, JavaScript and TypeScript (parse, run and translate).
  • New AST nodes ASTStatementThrow, ASTStatementTryCatch and ASTCatchClause; a thrown value is carried by the new ApolloVMThrownException.
  • Catch semantics (faithful to Dart's catch (e)): an untyped catch catches both user thrown values and built-in VM runtime errors (e.g. integer division by zero, surfaced as their message String); a typed clause matches user-thrown values by type. The universal supertypes (Object, dynamic, Exception, Throwable, Error) act as catch-all so an untyped catch round-trips faithfully across languages.
  • finally always runs (on normal completion, after a caught throw, or on a return inside try/catch), and a return inside finally overrides.
  • Per-language catch syntax on both parse and generation: Dart on T catch (e) / catch (e), Java catch (T e) (untyped → catch (Exception e)), Kotlin catch (e: T) (untyped → catch (e: Throwable)), JS/TS catch (e).
  • Wasm try/catch/throw is deferred: it fails loudly (no silent miscompile).

• Wasm Asyncify: awaits inside for-each over a list. for (T e in it) is desugared in the CFG into an indexed loop (__i = 0; while (__i < it.length) { T e = it[__i]; body; __i++ }), so awaits in the body really suspend. it[__i] uses the normal list index-access; the index/length are temp locals spilled/restored on the Asyncify frame stack, and the only non-AST bit (the length read + index reset) is emitted via a small per-block raw hook. The iterable must be a list variable; other iterables fall back to synchronous-collapse. Tested end-to-end through ApolloRunnerWasm.

• TypeScript language support (parse, run, translate):

  • New language at lib/src/languages/typescript/ts/: ApolloParserTypeScript, TypeScriptGrammarDefinition, TypeScriptGrammarLexer, ApolloCodeGeneratorTypeScript, ApolloRunnerTypeScript.
  • Superset of JavaScript: all JS features plus type annotations on variables, parameters, return types and class fields (number/string/boolean/any/void, T[]/Array<T>), interfaces, enums, and access modifiers (public/private/protected/readonly/ static/abstract).
  • Code generation emits idiomatic TypeScript (type annotations, interface, enum, abstract class, member modifiers) and erases types cleanly when targeting JavaScript.
  • Registered 'typescript'/'ts' in the parser/runner/generator factories and the .ts file-extension mapping; CLI apollovm run/translate support .ts.
  • Tests: TypeScript test definitions under test/tests_definitions/ plus the test/hello_world.ts fixture and example/apollovm_example_typescript.dart.

• Generalized class/member modeling in the shared AST (used by Dart and TypeScript):

  • ASTModifiers: added isAbstract and isProtected (and modifierAbstract).
  • ASTClassNormal: added kind (ASTClassKind.normalClass / abstractClass / interface), plus optional superClassName and implementsTypes.
  • New ASTClassEnum (extends ASTClassNormal) with ASTEnumEntry entries.
  • ASTClassField: added a modifiers field (e.g. static/private/readonly).
  • Dart now parses and generates abstract class, enum, extends/implements, abstract (body-less) methods, and static fields; these cross-translate between Dart, TypeScript and JavaScript.

• Wasm Asyncify: awaits inside control flow (if/if-else/else if, while, for), plus return await ... and x = await .... The generator lowers such async functions into a CFG of basic blocks and emits a program-counter state machine — a loop + br_table dispatch over a $pc local, with $pc spilled/restored on the Asyncify frame stack alongside the locals. Awaits become block boundaries; leaf (host) and internal (module- async) awaits both work inside loops/branches, composing with multi-frame unwinding. Functions whose awaits are all top-level keep the linear path. Awaits nested inside expressions (t = t + await f(), return await f() + 1, await f() + await g()) are hoisted into temp locals automatically. Remaining unsupported shapes (for-each, awaits in loop/branch conditions) fall back to synchronous-collapse. Tested end-to-end through ApolloRunnerWasm.

• async/await support (real asynchrony) — Dart parse/run/translate and JavaScript translation:

  • AST: new ASTModifiers.isAsync, new ASTExpressionAwait expression, and a new abstract generateASTExpressionAwait generator hook. Reuses the existing ASTTypeFuture/ASTValueFuture (added ASTTypeFuture.futureValueType).
  • Runtime: an async function returns a first-class future immediately (a non-awaited call yields an ASTValueFuture that can be stored and awaited later); await suspends on real Dart Futures, including those returned by external functions declared with a Future<...> return type. ASTEntryPointBlock.execute awaits the entry future before tearing down the entry-point context (external mapper, current context).
  • Dart grammar: parses the async body keyword (after the parameter list) and the await prefix expression; Future<T> types parse to ASTTypeFuture; the await/async contextual keywords no longer shadow identifiers (e.g. awaiter) or get read as a type name.
  • Code generation: Dart emits ... ) async { and await ; JavaScript emits async function / async name( and await .
  • Wasm: async/await compiles via synchronous collapse — the backend runs synchronously, so Future<T> collapses to T (effectiveReturnType) and await is a value pass-through. Compute-style async Dart compiles to Wasm and matches the AST interpreter.
  • Wasm real-suspension Asyncify prototype (test/apollovm_wasm_asyncify_prototype_test.dart): a hand-assembled two-frame module proves real suspension against the live WasmRuntime — a running call unwinds to the host (saving live locals to linear memory), the host awaits a real Dart Future, then re-invokes the export which rewinds and resumes. Demonstrates multi-frame state preservation, exactly-once prologue execution, and two concurrent computations interleaving by host delay.
  • Wasm Asyncify code generation: the generator emits the unwind/rewind state machine for an async function whose awaits are statement-level calls — a low-memory Asyncify control region (WasmModuleContext) with a LIFO frame stack, live-local spill/restore, br_table resume dispatch supporting multiple await points in one function, and multi-frame unwinding: an async function may await another module async function (an internal frame) as well as a host import (a leaf). The unwind propagates up every frame on the call stack to the host and rewinds back down (an eligibility fixed-point decides which async functions transform; the rest use synchronous-collapse). Validated against the live runtime in test/apollovm_wasm_asyncify_codegen_test.dart and the multi-frame / mixed-await cases in test/apollovm_wasm_asyncify_runner_test.dart. Shapes that still fall back to synchronous-collapse: awaits nested in control flow, multiple awaits in one statement, and async recursion.
  • Wasm Asyncify runner integration: ApolloRunnerWasm.executeFunction now detects real-suspension async functions (flagged in apollovm_sig) and drives their unwind/rewind loop, awaiting a real Dart Future from a host function registered via the new ApolloRunnerWasm.mapWasmAsyncFunction API. So real-suspension async/await works end-to-end through the VM (test/apollovm_wasm_asyncify_runner_test.dart). A br_table multi-await/multi-frame transform is the remaining follow-up.
  • Kotlin async/await translation: an async function maps to a suspend fun (the declared Future<T> collapses to T), and await e becomes just e (suspension is implicit when calling a suspend function in coroutines).
  • Tests: test/apollovm_async_test.dart (parse, real-suspension ordering, await chains, top-level async, identifier guard, Dart/JS/Kotlin translation) and test/apollovm_wasm_async_test.dart (AST-vs-compiled-Wasm parity).

• Lua language support (parse, run, and translate):
  • New lib/src/languages/lua/ module: ApolloParserLua, LuaGrammarDefinition/LuaGrammarLexer, ApolloCodeGeneratorLua and ApolloRunnerLua, all built on the shared AST (no AST changes).
  • Grammar covers top-level and local functions, local/global variables, if/elseif/else, while, numeric and generic for ... in ipairs(...), return, expressions/operators (and/or/not, ~=, .. concatenation), table constructors (list and map), and a table-based class convention (Name = {}, Name.__index = Name, function Name:method(...)) grouped into the shared class AST. Return types are inferred (void vs dynamic).
  • Generator emits idiomatic Lua: keyword-delimited blocks with end, local variables, .. string concatenation, and/or/not/~=, table literals, and self./self: prefixing inside methods.
  • Registered in ApolloVM (getParser/createRunner/createCodeGenerator).
  • Tests in test/apollovm_lua_test.dart cover parse+run, translate+re-execute to Dart/Lua/Kotlin, and bidirectional table-based classes.

• Kotlin language support (parse, run, and translate), reaching parity with the existing Java feature set:
  • New lib/src/languages/kotlin/ module: ApolloParserKotlin, KotlinGrammarDefinition/KotlinGrammarLexer, ApolloCodeGeneratorKotlin and ApolloRunnerKotlin, all built on the shared AST (no AST changes).
  • Grammar covers top-level and class fun declarations, val/var declarations (with type inference), Int/Double/Boolean/String/ Unit/Any/List/Map types, if/else, for (x in ...), while, expressions/operators, listOf/mapOf literals, and "$x" / "${expr}" string templates. println is normalized to the VM's print.
  • Registered in ApolloVM (getParser/createRunner/createCodeGenerator); .kt files already mapped to kotlin.
  • Tests in test/apollovm_kotlin_test.dart cover parse+run and Kotlin→Dart/Java/Kotlin translation round-trips.
• JavaScript (modern ES) language support — fully bidirectional:
  • Parser (ApolloParserJavaScript, JavaScriptGrammarDefinition, JavaScriptGrammarLexer): parses .js/javascript source into the shared ApolloVM AST. Covers classes (fields + methods, static, constructor), top-level function declarations, let/const/var, for/for...of/while, if/else if/else, list literals, ++/--, compound assignment, strict equality (===/!==), and single/double-quoted strings plus back-tick template literals with ${ … } interpolation. Untyped sites map to dynamic; method/function return types are inferred as void (no value-return) or dynamic.
  • Code generator (ApolloCodeGeneratorJavaScript): emits idiomatic modern JS from any loaded AST (Dart, Java, or JS) — let/const, template literals for string interpolation, for...of, top-level functions, untyped params/fields, ===/!==, and Math.trunc(a / b) for integer division.
  • Runner (ApolloRunnerJavaScript): executes JS-parsed ASTs in the VM (subject to the VM's existing limitation that arithmetic requires concrete/inferable types — dynamic-typed arithmetic is unsupported, as for Dart dynamic).
  • Registered javascript/js in ApolloVM.getParser, createRunner, and createCodeGenerator.
  • CLI: apollovm run/translate now work on .js files (the .js extension already mapped to javascript); added a test/hello_world.js fixture and updated the CLI banner to "Dart, Java and JavaScript".
  • Tests: added javascript_basic_* definitions (parse + execute + round-trip + cross-translation to Dart/Java) and a JavaScript generation block to the Dart class-function test.
  • Follow-ups: destructuring, spread, async/await, true constructor semantics with this.x parameters, and full ESM are not yet supported.
• CLI bug fix: apollovm translate printed Instance of 'Future<StringBuffer>' instead of the translated source — writeAllSources() was stringified without await. Fixed for all languages.
• Runtime fix — for-each / for...of over any iterable: ASTStatementForEach only accepted an ASTValueArray, so iterating a list bound to a dynamic/Object variable (which resolves to a plain ASTValueStatic) threw at runtime. It now iterates any resolved Iterable (and Map values), and wraps each element into a concretely-typed ASTValue (via ASTValue.fromValue) so per-element operations (e.g. arithmetic, string concatenation) work. Affects all languages; enables JavaScript for...of over arrays.
• Runtime fix — arithmetic/comparison on dynamically-typed operands: binary operators (+ - * / % == != > < …) dispatched on the operand's static ASTValue.type and only handled concrete primitives, so two dynamic/var/Object operands (e.g. untyped JavaScript parameters) threw Can't perform '+' operation with types: dynamic + dynamic even when the runtime values were real numbers/strings. ASTExpressionOperation.run now resolves each "boxed"/untyped operand to its concrete ASTValue (via ASTValue.fromValue) before dispatching. Affects all languages; enables executing parsed JavaScript arithmetic.
• JavaScript / is now floating-point division (ASTExpressionOperator.divideAsDouble), matching JS semantics (7 / 2 === 3.5) instead of integer division.
• JavaScript arrow functions: a named arrow assignment (const add = (a, b) => a + b;, const square = n => n * n;, const greet = () => { … };) is parsed and desugared to a named function declaration — callable by name (add(1, 2)), at top level or as a local statement, with expression or block bodies. Translates to a regular function/method on output. Anonymous arrows passed as callbacks (true closures) are a follow-up.
• Code generation fix — logical negation of a complex operand: !(a > b) was emitted as !a > b (which re-parses as (!a) > b). The negated operand is now parenthesized when complex. Affects all languages.
• Tests: broad JavaScript coverage added — parse + execute + translate (to Dart/Java where applicable) + re-execute the generated code: javascript_basic_vars, branches, while_loop, for_loop, comparisons, division, negation, this_method, plus the earlier class_function, control_flow, for_of, arithmetic, and arrow-function definitions.
• Docs/examples: added per-language runnable examples under example/ — apollovm_example_java.dart, apollovm_example_kotlin.dart and apollovm_example_javascript.dart (each load + run + translate to Dart, with verified output) — and fixed the existing apollovm_example.dart to await writeAllSources() (was printing Instance of 'Future<StringBuffer>'). README updated with a Kotlin section and the CLI banner now reads "Dart, Java, Kotlin and JavaScript".

• Wasm collections — compound subscript assignment (P3, part 9):

  • m[k] += v (and -=, *=, /=, ~/=) and the same for list indices a[i] += v now compile to Wasm. Lowered by desugaring c[k] OP= v into c[k] = c[k] OP v, so it reuses the existing get/set codegen and works for maps (int/String keys) and lists across int/double values. Matches the interpreter on both wasm_run and Chrome (e.g. a frequency counter can now use m[w] += 1 directly).

• Wasm collections — map parameters & returns (P3, part 8):

  • Functions can now accept and return whole Maps across the host boundary. The runner marshals a Dart Map into the module's map layout (header + parallel key/value buffers, via the exported __alloc) for Map parameters, and decodes a returned map-header pointer back into a Dart Map. Covers int/String keys × int/double/String/bool values, including round-tripping and returning a map built with m[k] = v.
  • The apollovm_sig custom section now encodes a map type as [7, <key tag>, <value tag>], so raw-byte modules self-describe their key/value types. Element read/write was factored into shared helpers used by both list and map marshalling.

• Wasm collections — map .keys / .values + iteration (P3, part 7):

  • m.keys and m.values now compile to Wasm: each materializes a fresh list by copying the map's parallel key (or value) buffer (which already has the list element layout), so for (var k in m.keys) / for (var v in m.values) work via the existing list for-each. Matches the interpreter on both wasm_run and Chrome.
  • The for-each loop-variable type resolver now derives the element type from the map (m.keys → key type, m.values → value type) so the loop variable is correctly typed.

• Wasm collections — maps with String keys (P3, part 6):

  • Map<String, V> now compiles to Wasm (V = int/double/String/bool): literals, m[k] get, m[k] = v set, .length/.isEmpty/.isNotEmpty, and .containsKey(k). Matches the interpreter on both wasm_run and Chrome.
  • String keys are stored as i32 pointers and compared by content via a synthesized __streq(a, b) helper (length check + byte loop), so e.g. containsKey("app") correctly returns false for a map keyed by "apple", and multi-byte UTF-8 keys work.

• Wasm collections — maps with int keys (P3, part 5):

  • Map<int, V> now compiles to Wasm (V = int/double/String/bool). A map value is an i32 pointer to a 16-byte header [length][capacity][keysPtr][valuesPtr] with parallel key/value buffers; lookup/set is a linear scan with i64 key equality. Matches the interpreter on both wasm_run and Chrome.
  • Supported: map literals (incl. empty {}), m[k] get, m[k] = v set (in-place update or append, growing both buffers when full), .length, .isEmpty/.isNotEmpty, and .containsKey(k).
  • Also adds Wasm list index assignment a[i] = v (the subscript-assignment AST node now lowers to Wasm for both maps and lists).
  • Out of scope for this slice: String keys (need a string-equality helper), .keys/.values/iteration, map parameters/returns, and compound subscript assignment (m[k] += v) — note m[k] = m[k] + 1 already works.

• Dart subscript assignment — m[k] = v and a[i] = v (frontend + interpreter):

  • The grammar now parses container-entry assignment targets (previously the assignment left-hand side was only a bare variable, so m[k] = v / a[i] = v failed with a SyntaxError). Compound operators (+=, -=, *=, /=, ~/=) are supported, e.g. m["x"] += 1 for building a frequency map.
  • New AST node ASTExpressionVariableEntryAssignment; new ASTValue.writeKey/writeIndex write into the underlying Map/List in place. A Map is always written by key (even a numeric one); a List by index. Round-trips through the code generators (parse → regenerate → re-parse).
  • Empty collection inference fix: an empty {} literal (typed Map<dynamic,dynamic>) is now assignable to a typed map such as Map<String,int> — ASTTypeMap.acceptsType treats a dynamic key/value component as a wildcard, matching how lists already ignore their element type for assignment (so Map<String,int> m = {}; works, like List<int> a = [];).

• Dart Map support — frontend + interpreter (read/query; prerequisite for Wasm maps):

  • Grammar fix: Map<K,V> type annotations now parse. mapTyped() was missing the value-type parser (it accepted only Map<K,> and read the , token as the value type), so every Map<int,int> declaration failed with a SyntaxError. Key/value types also accept List<...> (e.g. Map<String,List<int>>).
  • Map literals now infer their key/value types from entries (mirroring list literals) instead of being hardcoded to Map<dynamic,dynamic>, so Map<int,int> m = {1:10} assigns cleanly. ASTExpressionMapLiteral.resolveType returns the Map type (it previously returned just the value type).
  • Map index by key: m[k] now does a key lookup for any Map (the access was incorrectly routed to positional/list indexing whenever the key was numeric, so int-keyed maps failed).
  • New core Map class (CoreClassMap): getters .length/.isEmpty/.isNotEmpty/.keys/.values and methods .containsKey/.containsValue/.remove/.clear. .keys/.values resolve to List<keyType>/List<valueType> so iterating them yields properly-typed elements.
  • Maps work as function parameters.
  • Note: map subscript assignment (m[k] = v) is a follow-up (the grammar's assignment target is still a bare variable).
  • Functions can now accept and return whole lists across the host boundary. The runner marshals a Dart List into module memory (header + elements buffer, via the exported __alloc) for List parameters, and decodes a returned list-header pointer back into a Dart List. Covers int/double/String/bool element lists, including round-tripping (List<int> echo(List<int> a)) and building a result with .add before returning it.
  • The apollovm_sig custom section now carries list types as [6, <element tag>] (was a single opaque tag), so modules loaded from raw bytes self-describe their list element types; the runner uses 64-bit element reads/writes via BigInt so it works on both the Dart VM and dart2js (Chrome).
  • A String/List parameter now also forces an exported __alloc (previously only String params did), so list-only functions can be fed their arguments.

• Wasm collections — String & bool element lists (P3, part 3):

  • List<String> and List<bool> now compile to Wasm: literals, index reads a[i], for (var e in a), .add, and the .first/.last/.isEmpty/.isNotEmpty/.length getters all work (elements stored as i32 — a string pointer or a 0/1 boolean). Matches the interpreter on both wasm_run and Chrome.
  • Maps remain a later slice.

• Wasm collections — growable lists .add + getters (P3, part 2):

  • List values are now an indirect handle: a 12-byte header [length:i32][capacity:i32][dataPtr:i32] pointing at a separately-allocated elements buffer. This makes .add aliasing-safe — growing reallocates the data buffer (doubling capacity, memory.copying existing elements) and updates the header in place, so existing references observe the new length/contents.
  • list.add(x) now compiles to Wasm for int/double lists (including starting from an empty [] literal), growing linear memory on demand.
  • New list getters compiled to Wasm: .first, .last, .isEmpty, .isNotEmpty.
  • bool-returning functions loaded from raw Wasm bytes now decode correctly: the apollovm_sig custom section is emitted for bool returns (not just String signatures), and the runner maps the i32 0/1 back to a Dart bool.

• Wasm collections — lists, read + iterate (P3, part 1):

  • int/double list literals compile to linear-memory blocks; index reads a[i], the .length getter, and for (var e in a) now compile to Wasm (matching the interpreter, on both wasm_run and Chrome).
  • Lists currently stay internal (return scalars); list parameters/returns and maps are later slices.

• Wasm generator — major feature expansion (ApolloGeneratorWasm), moving toward full Dart parity:

  • Loops: while and for loops now compile to Wasm (block/loop/br_if/br), including return from inside a loop. Added the br opcode helper and recursion into loop bodies when collecting function locals.
  • Function calls: local function invocation (calling other top-level functions, including recursion) via a function-index table threaded through the generator and a Wasm.call.
  • Operators: integer modulo % (i64.rem_s), logical &&/|| (i32.and/i32.or), logical negation ! (i32.eqz), and unary minus - (f64.neg / i64 multiply-by--1).
  • Booleans: bool literals and bool-typed locals (represented as Wasm i32).
  • Bug fix: the == 0 fast-path (i64.eqz) was incorrectly applied to any operator with a literal-0 right operand (e.g. x > 0 compiled as x == 0). It is now restricted to the equals operator.
  • Short-circuit && / ||: now compile to an if/else so the right operand is only evaluated when needed. The AST interpreter was also made short-circuiting, so interpreted and compiled execution stay consistent (and match Dart).
  • Full Dart % semantics: integer and double modulo now return the Dart-correct non-negative result in [0, |b|) for negative operands (sign-corrected via scratch locals); double % is computed as a - trunc(a / b) * b.
  • Fix: compound assignment (+=, -=, *=, …) emitted its operation to a discarded buffer (missing out/context), producing broken code; now applied to the real output.

• Tests: added Wasm coverage for every feature above plus a combined integration test (prime counting / sum-of-squares using loops + calls + logic + modulo), all executed against the real compiled-and-run Wasm module.

• Wasm strings — String parameters + memory.grow (P2, part 5, completes the strings milestone):

  • Functions taking String parameters now work: the runner encodes the Dart string into module memory (via the exported __alloc, guided by the apollovm_sig param tags) and passes the i32 pointer. Enables String echo(String s), String greet(String name), etc.
  • The allocator (both the exported __alloc and the inline concat allocator) now grows linear memory on demand (memory.size/memory.grow), so large strings/concatenations no longer trap.

• Wasm strings — number→string interpolation (P2, part 4):

  • Interpolation of int/double ("n=$n", "${a + b}") now compiles to Wasm via host imports env.int_to_str/env.double_to_str; the host formats the number (matching the interpreter; doubles via ASTTypeDouble.doubleToString) and writes it into module memory.
  • Adds a synthesized, exported __alloc bump-allocator function so host imports can allocate strings in the module's memory (reentrant host→module calls), plus value-returning host imports and i64↔BigInt marshalling on the web.

• Wasm strings — String-returning functions (P2, part 3):

  • Functions returning String now work: the value is an i32 pointer the runner decodes back into a Dart String.
  • Modules are now self-describing: a custom apollovm_sig section records each public function's high-level return/parameter type tags, so the runner can marshal strings even for modules loaded from raw bytes. Emitted only when a public signature involves a String (pure-numeric modules stay byte-identical).

• Wasm strings — concatenation + bump allocator (P2, part 2):

  • A mutable heap-pointer Global ($hp) bump allocator; runtime string allocation via __alloc + memory.copy.
  • String +, adjacent string literals, and $var interpolation of String variables now compile to Wasm (left-folded binary concatenation producing a fresh [len:i32][utf8] string). Validated on wasm_run and Chrome.
  • Note: bump-and-leak (no free yet); number→string interpolation and string returns are later slices.

• Wasm linear-memory foundation + strings (P2, part 1 — print of string literals):

  • The generator now emits Import / Memory / Global / Data sections and offsets the function-index space past imported functions (a body-first two-pass build). Modules with no strings/imports remain byte-identical.
  • String literals are interned into a static data segment as [len:i32][utf8]; a String value is an i32 pointer into the exported linear memory.
  • print(stringLiteral) lowers to a host import env.print(i32). The runtime layer (WasmRuntime/WasmModule) now wires host imports at instantiation and exposes exported memory reads, on both the native (wasm_run) and browser runtimes; the runner decodes the pointer and routes to externalPrintFunction.
  • New wasm.dart memory opcodes (i32/i64 load/store, load8_u/store8, memory.size/grow/copy/fill) and section-id helpers.

• Test infrastructure — WebAssembly GC validation path:

  • Established a browser (dart test -p chrome) parity harness that runs generated Wasm on Chrome's own engine. The native wasm_run backend (wasmtime 14 / wasmi 0.31) does not support the WebAssembly GC proposal; Chrome (v119+) does.
  • Added a wasm-gc test tag (dart_test.yaml) and a WasmGC capability spike; CI's wasm_run-based jobs exclude the tag (--exclude-tags wasm-gc) while the Chrome job runs it. This gates the planned dual-target (linear-memory + WasmGC) backend work.

• Bug fixes:

  • Loop return propagation: a return inside a for, while, or for-each loop was ignored (the loop shadowed runStatus with a fresh instance and never broke on return). Returns now propagate and stop iteration correctly.
  • ASTType equality: ASTTypeBool, ASTTypeString, ASTTypeObject, ASTTypeConstructorThis, ASTTypeVar, ASTTypeDynamic, ASTTypeNull, and ASTTypeVoid mistakenly checked other is ASTTypeInt, so equal instances never compared equal. Each now checks its own type.
  • ASTTypeMap: building a map from a flat key/value list read from the (empty) target map instead of the input list, producing an empty map.
  • Java generator (_escapeString): backslashes were not escaped, producing invalid Java string literals (e.g. "a\b" instead of "a\\b").
  • ASTExpression.literalNumType returned ASTNumType.int for double literals.
  • Corrected the operator symbol shown in ASTValueString/ASTValueNum comparison/equality error messages.

• Tests:

  • Increased line coverage from ~64.6% to ~70.9%.
  • Added regression tests for all the fixes above and extensive unit/integration tests for ASTValue, ASTType, ApolloVM, expressions, the core library, and the Wasm generator.

• Dependencies:

  • data_serializer: ^1.2.1 -> ^1.2.2
  • test: ^1.31.0 -> ^1.31.1

• DartGrammarDefinition:
  • Updated getTypeByName to treat 'const' as an unmodifiable variable type alongside 'final'.
  • Modified classFieldDeclaration, constructorTypedParameterDeclaration, statementVariableDeclaration, and parameterDeclaration parsers to accept both final and const tokens as optional modifiers.
  • Adjusted logic in statementVariableDeclaration to recognize 'const' as unmodifiable and handle it similarly to 'final'.

• ApolloCodeGeneratorDart:
  • generateASTExpression:
    • Fixed string template merging logic to correctly handle variable accesses and literal strings by swapping checks on expression1 and expression2.
    • Improved merging of adjacent quoted strings with different quote types by adding _tryMergeQuotedStrings and related helper methods.
    • Added robust checks for unescaped quotes inside strings to safely convert quote types.
  • Added helper methods:
    • _isQuotedString, _isSingleQuoteString, _isDoubleQuoteString
    • _canConvertQuote, _convertQuote
    • _mergeQuotedStrings, _tryMergeQuotedStrings
• DartGrammarDefinition:
  • Refactored expression parsing to delegate expression operation precedence and logical operator handling to computeFinalExpression.
• DartGrammarLexer:
  • Refactored to extend new BaseGrammarLexer abstract class.
  • Moved common lexer methods and token handling to BaseGrammarLexer.
  • Updated whitespace and comment parsers to static methods for reuse.
• BaseGrammarLexer (new):
  • Added as base class for grammar lexers with common token and identifier parsing.
  • Added expression operation precedence handling via computeFinalExpression and reduceExpressionBlock.
• Java11GrammarLexer:
  • Refactored to extend BaseGrammarLexer.
  • Removed duplicated token and identifier parsing code.
  • Updated whitespace and comment parsers to static methods.
• Java11GrammarDefinition:
  • Refactored expression parsing to use computeFinalExpression for operator precedence.
• Tests:
  • Added comprehensive Dart arithmetic and logical expression tests covering operator precedence, mixed numeric types, and complex expressions.
  • Updated multiple Dart and Java11 test definitions to normalize expression grouping from a + (b + c) to (a + b) + c for consistent operator associativity.
  • Fixed string concatenation tests to correctly merge adjacent string literals and variables.
  • Updated WASM tests to fix generated bytecode for integer operations.
  • Fixed linear regression and forecast tests with corrected arithmetic expressions.
  • Improved test outputs to reflect corrected expression evaluation and string concatenation results.

• ASTExpressionFunctionInvocation and related classes:

  • Added mixin WithCallChainFunction to support chained function invocations.
  • Added field chainFunctionInvocation to hold chained calls.
  • Updated function invocation methods to generate chained calls in code generation (ApolloCodeGenerator).
  • Updated runtime execution to process chained function calls after the main call.

• ApolloCodeGenerator:

  • Refactored function invocation code to use _generateChainFunctionInvocation helper for chained calls.

• Dart grammar (dart_grammar.dart):

  • Updated expressionGetterAccess parser to parse and attach chained function invocations.

• CoreClassPrimitive:

  • Removed _functionToString field and initialization.

• CoreClassString:

  • Added _functionToString external class function returning self.toString().

• CoreClassInt:

  • Added _functionToString external class function returning self.toString().

• CoreClassDouble:

  • Added _functionToString external class function with custom logic:
    • If the double is an integer value, returns string with .0 suffix.
    • Otherwise, returns standard toString().

• ASTExpressionVariableEntryAccess:

  • Replaced _asyncTry with _run2 to improve element access with proper type casting.
  • Added generic _readElement<V> method to read elements with type safety.
  • Updated readIndexASTValue and readKeyASTValue to return typed ASTValue<V>.

• ASTExpressionFunctionInvocation and subclasses:

  • Added support for chained function invocations via new chainFunctionInvocation field.
  • Updated run methods to invoke chained functions sequentially after the initial call.
  • Added _callChainFunction helper to process chained calls asynchronously.
  • Added ASTExpressionChainFunctionInvocation class representing chained function calls.
  • Updated toString methods to include chained function calls.
  • Updated constructors and parsing to support chained function invocations.

• ASTExpressionObjectFunctionInvocation, ASTExpressionObjectEntryFunctionInvocation, ASTExpressionGroupFunctionInvocation:

  • Updated constructors and run methods to support chained function invocations.
  • Added caching of function class for performance.
  • Improved error handling and function resolution with chained calls.

• lib/src/apollovm_code_generator.dart:

  • Updated code generator to output chained function invocations in generated code.

• Grammar updates (dart_grammar.dart, java11_grammar.dart):

  • Added parsing rules for chained function invocations (expressionChainFunctionInvocation).
  • Updated function invocation parsers to parse and attach chained function calls.

• ASTValue:

  • Added generic static method fromValue<V> to convert dynamic values to typed ASTValue<V>.
  • Added readIndexASTValue<V> and readKeyASTValue<V> methods returning typed ASTValue<V>.

• CoreClassString:

  • Added new external string functions: replaceFirst, trimLeft, trimRight, padLeft, padRight, lastIndexOf, codeUnitAt.
  • Registered new functions in getFunction with case-insensitive support.

• ASTClass:

  • Added toString override for better debug output.

• ASTExpressionVariableEntryAccess:

  • Refactored run method to use nested resolveMapped calls for asynchronous handling.
  • Added private helper _asyncTry to unify index/key reading logic with async support.
  • Added private helper __throwReadNPE to throw detailed ApolloVMNullPointerException with stack trace on read failures.
  • Improved error messages for index/key read failures including variable, index/key, size, and value details.

• ASTExpressionObjectEntryFunctionInvocation:

  • Added class-level documentation with code examples for usage of object entry function calls like obj[i].fx(args) and obj[key].fx(args).

• ASTValue:

  • Updated readKey method signature to accept nullable Object? key parameter for better null safety.

• ASTValueStatic:

  • Updated readKey method signature to accept nullable Object? key.

• CoreClassBase and CoreClassPrimitive:
  • Added _functionToString external function returning the string representation of the instance.
• CoreClassString, CoreClassInt, CoreClassDouble, CoreClassList:
  • Added support for the toString core function, returning the respective _functionToString.

• ASTSingleLineStatementBlock:

  • Added new subclass of ASTBlock that allows only a single statement.
  • Overrides addStatement to enforce single statement constraint.
  • Overrides toString to output the single statement without braces.

• ApolloCodeGenerator:

  • Added support for ASTSingleLineStatementBlock in generateASTNode dispatch.
  • Added generateASTSingleLineStatementBlock method to generate single-line statement blocks.
  • Updated generateASTBlock to delegate to generateASTSingleLineStatementBlock if block is single-line.
  • Updated generateASTBranchIfBlock to generate single-line blocks without braces.

• ApolloGenerator:

  • Added abstract method generateASTSingleLineStatementBlock.
  • Added support for ASTSingleLineStatementBlock in generateASTNode dispatch.

• ApolloGeneratorWasm:

  • Implemented generateASTSingleLineStatementBlock to generate the single statement.

• Dart and Java11 grammars:

  • Added ASTSingleLineStatementBlock parsing support.
  • Added codeBlockOrSingleLineBlock parser to accept either a block or a single-line block.
  • Updated branchIfBlock parser to accept single-line blocks as branch bodies.

• Added new AST statement classes:

  • ASTStatementBlock representing a block of statements.
  • ASTStatementFunctionDeclaration representing a function declaration statement.

• ApolloCodeGenerator:

  • Added support for generating code for ASTStatementFunctionDeclaration and ASTStatementBlock.
  • Added methods generateASTStatementFunctionDeclaration and generateASTStatementBlock.

• ApolloGenerator interface:

  • Added abstract methods generateASTStatementFunctionDeclaration and generateASTStatementBlock.
  • Updated statement dispatch to handle ASTStatementFunctionDeclaration and ASTStatementBlock.

• ApolloGeneratorWasm:

  • Added generateASTStatementBlock implementation.
  • Added stub for generateASTStatementFunctionDeclaration (throws UnimplementedError).

• apollovm_ast_statement.dart:

  • Added ASTStatementBlock class wrapping an ASTBlock with proper context and run behavior.
  • Added ASTStatementFunctionDeclaration class wrapping an ASTFunctionDeclaration with run behavior registering the function in the context.

• apollovm_ast_toplevel.dart:

  • Extended ASTFunctionDeclaration with:
    • toASTValueFunction method to convert to ASTValueFunction.
    • toFunction method to convert to a Dart Function with limited support for zero or one positional parameter.
    • resolveFunctionType and callFunctionTyped helpers for function type resolution and invocation.

• apollovm_ast_type.dart:

  • Added ASTTypeFunction representing function types with optional return type and parameters.
  • Added callCasted helper method for generic type casting.

• apollovm_ast_value.dart:

  • Added ASTValueFunction wrapping a Dart Function with proper type and invocation support.
  • Implemented equality, hashCode, and string representation for ASTValueFunction.

• apollovm_utils.dart:

  • Added resolveGeneric<T>() helper function for generic type resolution.

• dart_grammar.dart:

  • Extended grammar to parse function declarations as top-level definitions and statements.
  • Added parsing support for ASTStatementFunctionDeclaration and ASTStatementBlock.
  • Allowed optional return type in function declarations.
  • Updated statement parser to include function declarations and blocks.

• ASTExpressionObjectEntryFunctionInvocation:

  • Added new AST expression class to represent calls to class object entry functions.
  • Implements function resolution and invocation on class instances or static context.
  • Overrides run and toString methods for execution and debugging.

• ApolloCodeGenerator:

  • Added support for generating code for ASTExpressionObjectEntryFunctionInvocation.
  • Updated generateASTExpression method to handle ASTExpressionObjectEntryFunctionInvocation.

• ApolloGenerator interface:

  • Added abstract method generateASTExpressionObjectEntryFunctionInvocation.

• ApolloGeneratorWasm:

  • Added stub implementation for generateASTExpressionObjectEntryFunctionInvocation throwing UnimplementedError.

• Dart and Java11 grammars:

  • Added parsing rule expressionObjectEntryFunctionInvocation to support syntax for object entry function invocation expressions.

• Added ApolloImportManager to manage package/library imports and resolve core packages.
• VMContext:
  • Made sealed class.
  • Added importManager field and import method to support import resolution and delegation to parent contexts.
  • Updated function and external function lookup to consider imported functions.
• Added VMScopeContext as a final subclass of VMContext for scoped runtime contexts.
• Updated VMClassContext and other runtime contexts to be final and use VMScopeContext for nested scopes.
• ASTStatementImport:
  • New AST node to represent import statements.
  • Supports running import in a context, throwing on failure.
• ASTRoot:
  • Supports tracking and running import statements.
  • Considers imported functions in function resolution.
• ApolloRunner:
  • Added importManager field and initialization with default import manager.
  • Supports auto-import of dart:math core package.
  • Passes importManager to execution and function lookup calls.
• CorePackageBase and CorePackageMath:
  • Added path getter for core package identification.
• Code generators (dart, java11, wasm):
  • Added support for generating import statements (ASTStatementImport).
• Dart and Java11 grammar:
  • Added parsing of import statements into ASTStatementImport.
• Test framework:
  • Added support for auto-import-dart-math attribute in test XML.
  • Tests updated to import dart:math and use pow function.
• Various runtime and AST classes:
  • Updated to use VMScopeContext instead of base VMContext for nested scopes.
  • Updated VMObject field value methods to use VMScopeContext.
• Minor fixes and improvements in import handling, context management, and code generation.

• DartGrammarDefinition:
  • Changed type of finalExpressionOp from ASTExpressionOperation? to ASTExpression?.
  • Updated cast of expressionOp from ASTExpressionOperation to ASTExpression.

• ApolloCodeGenerator:

  • generateASTValueDouble: replaced manual double string formatting with ASTTypeDouble.doubleToString for consistent double string representation.

• ASTStatementVariableDeclaration:

  • _runImpl2: updated type cast check to allow dynamic type to bypass cast validation.

• ASTTypeDouble:

  • Added static method doubleToString to format double values consistently, optionally allowing scientific notation.
  • Updated toString method of ASTTypeNum to return 'num' instead of 'double'.

• ASTValueAsString and ASTValuesListAsString:

  • Updated string conversion to use valueToString method that formats doubles using ASTTypeDouble.doubleToString.

• CorePackageMath:

  • Updated math function external static function wrappers to explicitly type parameters as num and return ASTTypeDouble.instance for functions returning double values.

• Test framework (apollovm_languages_test_definition.dart):

  • Moved output printing before output assertion in _testCall for clearer test logs.

• Added new ASTExpression subclass ASTExpressionNegative to represent unary negative expressions.
• Added new ASTExpression subclass ASTExpressionGroupFunctionInvocation to represent function calls on grouped expressions (e.g., (-d).toStringAsFixed(4)).
• ApolloCodeGenerator:
  • Updated generateASTExpression to handle ASTExpressionNegative and ASTExpressionGroupFunctionInvocation.
  • Added methods generateASTExpressionNegative and generateASTExpressionGroupFunctionInvocation.
  • Refactored function invocation code into private _generateFunctionInvocation helper.
• ApolloGenerator interface:
  • Added abstract methods generateASTExpressionNegative and generateASTExpressionGroupFunctionInvocation.
  • Updated generateASTExpression to support new expression types.
• apollovm_ast_expression.dart:
  • Added implementation of ASTExpressionNegative with type resolution, runtime evaluation, and string representation.
  • Added implementation of ASTExpressionGroupFunctionInvocation with function resolution and invocation logic.
• Dart and Java11 grammars:
  • Added parsing support for unary negative expressions (-expr).
  • Added parsing support for group function invocations (e.g., (expr).func(args)).
• ApolloGeneratorWasm:
  • Added stub implementations for generateASTExpressionNegative and generateASTExpressionGroupFunctionInvocation.
  • Updated expression generation dispatch to handle new expression types.

• ASTStatementWhileLoop:

  • Added new AST node class representing a while loop statement.
  • Implemented run method to execute the loop with proper context handling.
  • Added type resolution returning ASTTypeVoid.instance.
  • Added children and node resolution methods.

• ApolloCodeGenerator:

  • Added support for generating code for ASTStatementWhileLoop in generateASTStatement.
  • Implemented generateASTStatementWhileLoop method to generate while loop source code.

• ApolloGenerator:

  • Added abstract method generateASTStatementWhileLoop.
  • Added dispatch for ASTStatementWhileLoop in generateASTStatement.

• DartGrammarDefinition:

  • Added statementWhileLoop parser to parse while loop statements.
  • Integrated statementWhileLoop into the main statement parser.

• Java11GrammarDefinition:

  • Added statementWhileLoop parser to parse while loop statements.
  • Integrated statementWhileLoop into the main statement parser.

• ApolloGeneratorWasm:

  • Added stub for generateASTStatementWhileLoop method throwing UnimplementedError.
  • Added dispatch for ASTStatementWhileLoop in generateASTStatement.

• Tests:

  • Added new test dart_basic_printFibonacci.test.xml demonstrating while loop usage in Dart source and generated code.

• ASTInvocableDeclaration:

  • Replaced ASTFunctionDeclaration with generic ASTInvocableDeclaration for function and constructor declarations.
  • Added ASTClassConstructorDeclaration for class constructors with support for this parameters.
  • Added resolveRuntimeType method to support runtime type resolution with context and node.
  • Updated call and run methods to support async and context-aware execution.
  • Added initializeVariables for constructor variable initialization.

• ASTParametersDeclaration:

  • Made generic over parameter type P.
  • Added ASTConstructorParametersDeclaration and ASTFunctionParametersDeclaration subclasses.
  • Updated parameter accessors and type checks to use generic parameter type.

• ASTParameterDeclaration:

  • Added ASTConstructorParameterDeclaration with thisParameter flag.
  • Added extensions for filtering this parameters.

• ASTFunctionSet and ASTConstructorSet:

  • Introduced generic base ASTInvokableSet with single and multiple implementations.
  • Added ASTConstructorSet for constructors, similar to function sets.

• ASTClassNormal:

  • Added support for constructors with ASTConstructorSet.
  • Added methods to add, get, and check constructors by name and signature.
  • Updated resolveNode to resolve constructors.

• ASTRoot:

  • Updated getFunction to return constructors if matching class name and signature.

• ASTExpression and ASTValue:

  • Added resolveRuntimeType and getHashcodeValue methods for runtime type and value hashing.
  • Updated equality and hashCode to use getHashcodeValue.

• ASTExpressionFunctionInvocation and subclasses:

  • Updated to use ASTInvocableDeclaration for function retrieval.
  • Updated run method to support async and context-aware invocation.

• ASTExpressionObjectGetterAccess:

  • Updated getter retrieval and runtime type resolution to support async and context-aware evaluation.
  • Added _runGetter helper for getter invocation.

• ASTStatementVariableDeclaration:

  • Added unmodifiable flag.
  • Updated type resolution and run implementation to use resolveRuntimeType.

• ASTType:

  • Added ASTTypeConstructorThis singleton for constructor this parameter.
  • Added resolveRuntimeType method.

• ASTVariable:

  • Added resolveRuntimeType method.

• CorePackageBase and CoreClassMixin:

  • Updated external function and class function creation to use ASTFunctionParametersDeclaration.

• CoreClassList:

  • Added first and last getters with runtime component type resolution.
  • Added empty constructor list and related methods.

• DartGrammarDefinition and Java11GrammarDefinition:

  • Added parsing support for class constructors with parameters and optional blocks.
  • Updated function and constructor parameter parsing to use ASTFunctionParametersDeclaration and ASTConstructorParametersDeclaration.
  • Added parsing for this constructor parameters.

• ApolloCodeGeneratorDart and ApolloCodeGeneratorJava11:

  • Added generateASTClassConstructorDeclaration method to generate constructor code.
  • Updated function parameter generation to use generic parameter declaration.

• ApolloParserWasm:

  • Updated WASM function parsing to use ASTFunctionParametersDeclaration.

• Test:

  • Added new test dart_basic_linearRegression.test.xml with Dart source for linear regression and forecast.
  • Added new test dart_basic_calculateShippingCost.test.xml for shipping cost calculation.
  • Updated test runner to include new tests.

• ASTValueNum:

  • from method:
    • Added optional asDouble parameter to control numeric type coercion.
    • Improved parsing logic to preserve numeric intent from strings containing decimal points or exponents by forcing double representation.
    • Added error handling for unsupported input types when asDouble is specified.

• Added ASTExpressionNullValue class to represent null literal expressions.

• ASTScopeVariable:

  • Special handling for variable named 'null' to resolve as ASTValueNull.

• ApolloCodeGenerator:

  • Added generateASTExpressionNullValue method to generate code for null expressions.
  • Updated generateASTExpression to handle ASTExpressionNullValue.
  • generateASTValueDouble:
    • Fixed formatting of double values to ensure consistent decimal representation.
    • Added handling to convert scientific notation doubles to fixed decimal format with appropriate fraction digits.
  • Added helper method fractionDigitsFromScientificNotation to determine the number of fraction digits needed for doubles in scientific notation.

• ApolloGenerator interface:

  • Added generateASTExpressionNullValue method.
  • Updated generateASTExpression to handle ASTExpressionNullValue.

• ApolloRunner:

  • Added optional importCorePackageMath parameter to constructor and createRunner method.
  • When importCorePackageMath is true, maps math functions from CorePackageMath to external functions.

• CorePackageMath:

  • New core package providing Dart dart:math functions as external functions for ApolloVM.
  • Includes pow, sqrt, sin, cos, tan, asin, acos, atan, atan2, log, exp, abs, min, max.

• Language grammars (dart, java11):

  • Added parsing support for null literal expressions producing ASTExpressionNullValue.

• Language runners (dart, java11, wasm):

  • Added support for importCorePackageMath parameter in constructors.

• ApolloGeneratorWasm:

  • Added stub for generateASTExpressionNullValue throwing UnimplementedError.
  • Updated generateASTExpression to handle ASTExpressionNullValue.

• Test framework:

  • Added new test dart_basic_stdv.test.xml demonstrating usage of math functions (pow, sqrt) and null checks.
  • Updated test runner to create runners with importCorePackageMath: true to enable math functions in tests.

• ASTAssignmentOperator:
  • Added new operator divideAsInt with symbol '~/'.
  • Updated asASTExpressionOperator getter to support divideAsInt.
  • Updated getASTAssignmentOperator and getASTAssignmentOperatorText to handle divideAsInt and its assignment form '~/='.
• ASTExpressionVariableAssignment:
  • Added support for divideAsInt operator in evaluation and string representation.
• Dart grammar (dart_grammar.dart):
  • Extended assigmentOperator parser to recognize '~/=' operator.
• Java11 grammar (java11_grammar.dart):
  • No changes for divideAsInt operator (remains unsupported).

• ASTExpressionListLiteral:

  • resolveType: updated to return ASTTypeArray of the specified type or deduced common element type.
  • children: fixed to include type correctly.

• ASTStatementVariableDeclaration:

  • Constructor enhanced to handle ASTExpressionListLiteral values with type adjustments or cast exceptions.

• ASTStatementForEach:

  • Added variableType field.
  • Constructor updated to accept variableType.

• ASTType:

  • Added commonType method to find common compatible type between two types.

• ASTTypeArray:

  • toValue: improved to cast ASTValueArray to correct generic type if needed.

• ASTValueArray:

  • Added cast method to convert to another generic type with optional component type.

• Dart grammar (dart_grammar.dart):

  • statementForEach parser updated to parse explicit variable type before variable name.
  • expressionListLiteral parser updated to infer common element type if not specified.

• Java11 grammar (java11_grammar.dart):

  • statementForEach parser updated to parse explicit variable type before variable name.

• Tests:

  • Added Dart test for findMax(List<int> numbers) function with multiple test cases including empty list handling.

• ASTStatementForEach:

  • Added new AST statement class representing a for-each loop with a variable name, iterable expression, and loop block.
  • Implements run method to iterate over an iterable AST value, declaring the loop variable in a nested context and running the loop block.
  • Resolves type as void.

• ApolloCodeGenerator:

  • Added support for generating code for ASTStatementForEach in generateASTStatement.
  • Implemented generateASTStatementForEach method to output a for-in loop syntax with variable declaration and loop block.

• ApolloGenerator:

  • Added abstract method generateASTStatementForEach.
  • Updated generateASTStatement to dispatch to generateASTStatementForEach for ASTStatementForEach.

• Dart language grammar (dart_grammar.dart):

  • Added parser statementForEach to parse Dart-style for-each loops (for (var x in iterable) { ... }).
  • Added helper parser _forEachVariableDecl to parse optional var or final before variable name.

• Java language grammar (java11_grammar.dart):

  • Added parser statementForEach to parse Java-style for-each loops (for (Type var : iterable) { ... }).

• CI:

  • .github/workflows/dart.yml: updated actions/checkout from v3 to v6 and codecov/codecov-action from v3 to v5.

• apollovm.dart:

  • Exported new utility file src/apollovm_utils.dart.

• apollovm_runner.dart:

  • ApolloRunner:
    • executeClassMethod: changed to async, added parameter normalization before execution.
    • Added normalizeParameters method to normalize positional and named parameters against AST function declarations.
    • executeFunction: added parameter normalization for top-level functions.
    • Improved parameter handling for function execution.

• apollovm_utils.dart (new):

  • Added utilities for generic typed list conversion and case-insensitive map key lookup.
  • Extensions on List for typed list creation and on Map for case-insensitive key lookup.

• apollovm_ast_toplevel.dart:

  • ASTFunctionDeclaration:
    • Added normalizeParameters, normalizePositionalParameters, and normalizeNamedParameters methods to convert and normalize parameters according to function declarations.
  • Added extension IterableASTFunctionDeclarationExtension with resolveBestMatchBySignature to select best matching function overload by parameter signature.

• apollovm_ast_type.dart:

  • ASTType:
    • Added fromType factory to create ASTType from Dart Type.
    • Added toASTValue method to convert native values to ASTValue according to type.
  • Added toASTValue overrides in primitive and collection types (ASTTypeBool, ASTTypeNum, ASTTypeInt, ASTTypeDouble, ASTTypeString, ASTTypeNull, ASTTypeVoid, ASTTypeArray, ASTTypeArray2D, ASTTypeMap, ASTTypeFuture).
  • Added static fromType methods for ASTTypeArray and ASTTypeMap to create instances from Dart generic types.
  • ASTTypeArray and CoreClassList:
    • Added typed singleton instances for common generic types (e.g., List<String>, List<int>, etc.).
    • Added factory constructors and fromType methods to resolve types generically.
  • ASTTypeMap:
    • Added fromType method for common map generic types.
  • ASTTypeFuture:
    • Added toASTValue override to handle conversion from native or future values.

• apollovm_ast_value.dart:

  • ASTValue.from factory:
    • Added support for ASTTypeBool to create ASTValueBool.

• apollovm_core_base.dart:

  • ApolloVMCore.getClass:
    • Added optional generics parameter.
    • List class resolution now uses CoreClassList.fromType with generic type.
  • CoreClassList:
    • Converted to generic class CoreClassList<T>.
    • Added typed singleton instances for common generic types.
    • Added fromType static method to resolve generic list classes.
    • Constructor updated to accept generic type and resolve ASTTypeArray accordingly.

• wasm_runner.dart:

  • ApolloRunnerWasm:
    • Added parameter normalization before calling Wasm functions.

• wasm_runtime.dart:

  • Added ensureBooted() method and lastBootError getter to WasmRuntime interface.

• wasm_runtime_dart_html.dart, wasm_runtime_generic.dart, wasm_runtime_web.dart:

  • Implemented ensureBooted() as no-op and lastBootError as null.

• wasm_runtime_io.dart:

  • Added boot logic with error capture.
  • Implemented ensureBooted() to call boot.
  • Added lastBootError getter.

• Tests (apollovm_languages_test_definition.dart):

  • Updated _parseJsonList to return untyped List without generic type conversion.
  • Removed redundant generic list conversion helpers from test file.
  • Updated tests to call .toListOfType() extension for typed list checks.

• Tests (apollovm_wasm_test.dart):

  • Added call to wasmRuntime.ensureBooted() before checking support.
  • On unsupported runtime, print last boot error for diagnostics.

• Added support for external getters in ApolloVM:

  • New class ApolloExternalGetterMapper to map Dart getters to ApolloVM.
  • Added getGetter and getMappedExternalGetter methods in VMContext for getter resolution.
  • Extended ASTBlock with getter management (addGetter, getGetter, etc.).
  • Added ASTGetterDeclaration and related classes (ASTClassGetterDeclaration, ASTExternalGetter, ASTExternalClassGetter) to represent getters in the AST.
  • Added ASTExpressionGetterAccess base class and subclasses ASTExpressionLocalGetterAccess and ASTExpressionObjectGetterAccess for getter expressions.
  • Updated DartGrammarDefinition to parse getter access expressions.
  • Updated ApolloCodeGenerator and ApolloGenerator interfaces and implementations to generate code for getter access expressions.
  • Added externalGetterMapper field to VMContext to support external getter mapping.

• Core library updates:

  • Added CoreClassList class implementing core List type support with external class functions and getters for common list operations (add, remove, length, isEmpty, sublist, etc.).
  • Refactored core class base and primitive classes to use CoreClassMixin for external function and getter creation.

• ASTExpressionOperator:

  • Added new operators: remainder, and, or.
  • Updated getASTExpressionOperator and getASTExpressionOperatorText to support %, &&, and ||.

• ASTExpressionOperation:

  • Updated resolveType to handle remainder, and, and or operators.
  • Added evaluation methods:
    • operatorRemainder for % operator supporting int and double operands.
    • operatorAnd and operatorOr for logical && and || with boolean coercion.
  • Added private helper _toBoolean to convert various ASTValue types to boolean.
  • Updated throwOperationError to handle new operators.

• ASTValue and subclasses:

  • Added % operator support in ASTValueNum, ASTValueInt, and ASTValueDouble.
  • Fixed incorrect error messages in base ASTValue operator overrides.
  • Added operator ~/(ASTValue other) implementations in ASTValueInt and ASTValueDouble.
  • Updated operator return types for numeric operations to be more specific (ASTValueNum).

• DartGrammarDefinition:

  • Extended expressionOperator parser to recognize %, &&, and ||.
  • Updated expression parsing logic to:
    • Split expressions into blocks separated by logical operators && and ||.
    • Resolve % operator with higher precedence within blocks.
    • Correctly build AST for logical expressions combining blocks with && and ||.

• WasmGenerator:

  • Added default case throwing UnsupportedError for unsupported operators in WASM code generation.

• ASTTypeVar:

  • Added unmodifiable field to distinguish var and final types.
  • Added static instance instanceUnmodifiable for final.
  • Updated constructor to accept unmodifiable flag and set name accordingly.
  • Updated toString and equality to reflect unmodifiable state.

• ApolloVMCore:

  • Added support for double and Double core classes returning CoreClassDouble.

• CoreClassPrimitive:

  • Added helper _externalClassFunctionArgs2 for external class functions with two parameters.

• CoreClassString:

  • Added many new external class functions:
    • length, isEmpty, isNotEmpty
    • substring, indexOf, startsWith, endsWith
    • trim, split, replaceAll
  • Updated getFunction to support these new string functions.

• CoreClassInt:

  • Added external static function tryParse.
  • Added external class functions:
    • compareTo, abs, sign, clamp, remainder, toRadixString, toDouble
  • Updated getFunction to support new int functions.

• Added new class CoreClassDouble:

  • External static functions: parseDouble (alias parse), tryParse, valueOf.
  • External class functions: compareTo, abs, sign, clamp, remainder, toStringAsFixed, toStringAsExponential, toStringAsPrecision, toInt, round, floor, ceil, truncate.
  • Implements getFunction to provide these functions.

• ApolloCodeGeneratorDart:

  • Improved string literal concatenation handling:
    • Added support for concatenating multiple string literals including raw and multiline strings.
    • Added helper writeAllStrings to write concatenated string parts correctly.
    • Improved splitting and merging of string literal blocks to avoid unnecessary concatenations.
    • Preserves multiline string formatting and raw string prefixes.

• DartGrammarDefinition:

  • Added support for final keyword returning ASTTypeVar(unmodifiable: true).
  • Updated literalString parser to support concatenation of multiple string literals into ASTValueStringConcatenation.

• Java11GrammarDefinition:

  • Added support for final keyword returning ASTTypeVar(unmodifiable: true).

• DartGrammarDefinition:

  • getTypeByName: added support for Dart types void and bool.

• DartGrammarLexer:

  • stringContentQuotedLexicalTokenEscaped: added handling of unnecessary escape sequences for characters (, ), {, }, and space in string literals.

• Tests:

  • Added dart_basic_sumOrDouble.test.xml with a test for a Dart function sumOrDouble.
  • Added dart_basic_main_print_multi_line.test.xml testing multi-line string printing.
  • Added dart_basic_main_print_unnecessary_escape.test.xml testing string literals with unnecessary escape sequences and ASCII art printing.

• ApolloCodeGenerator and ApolloCodeGeneratorDart:

  • generateASTExpressionOperation: updated to conditionally group complex expressions with parentheses based on operator and presence of literal strings to improve expression formatting and string interpolation merging.
  • Improved string concatenation merging for add operator when involving variables and literal strings.

• ASTExpression and subclasses (ASTExpressionOperation, ASTExpressionVariableAssignment, ASTExpressionVariableDirectOperation, ASTExpressionNegation, ASTExpressionFunctionInvocation, etc.):

  • Added isComplex getter to distinguish complex expressions.
  • Added hasLiteralString and hasDescendantLiteralString to detect literal strings in expression trees.
  • Updated toString methods to support optional grouping with parentheses for clarity.
  • Updated ASTExpressionOperation.toString to optionally wrap expressions in parentheses.
  • Updated ASTExpressionVariableAssignment and ASTExpressionVariableDirectOperation to provide detailed toString implementations reflecting operators.
  • Added childrenOperations and descendantChildrenOperations helpers for expression traversal.

• ASTAssignmentOperator enum:

  • Added symbol field for operator symbol representation.

• lib/apollovm.dart:

  • Added library-level documentation describing ApolloVM as a portable VM supporting Dart, Java, and WebAssembly compilation.
  • Changed library apollovm; to a library directive without a name.

• AST classes (lib/src/ast/):

  • Updated children getters to use null-aware spread operators (...? and ?) for optional fields in:
    • ASTExpressionListLiteral
    • ASTExpressionMapLiteral
    • ASTStatementVariableDeclaration
    • ASTBranchIfElseBlock
    • ASTBranchIfElseIfsElseBlock
    • ASTType
    • ASTTypeGenericVariable

• pubspec.yaml:

  • Updated dependencies:
    • petitparser from ^6.1.0 to ^7.0.2
    • lints from ^3.0.0 to ^6.1.0
    • dependency_validator from ^3.2.3 to ^5.0.5
    • xml from ^6.5.0 to ^6.6.1

• Tests (test/apollovm_languages_extended_test.dart, test/apollovm_version_test.dart):

  • Added library; directive at the top of test files for consistency.

• WasmRuntime:

  • Added WasmModuleFunction typedef to represent a WebAssembly-exported function with metadata including the Dart function and a varArgs flag.
  • Updated WasmModule.getFunction signature to return WasmModuleFunction<F>? instead of just F?.

• WasmRunnerWasm:

  • Updated function invocation logic in ApolloRunnerWasm to handle WasmModuleFunction with varArgs flag.
  • Added special handling for functions with no arguments and functions expecting a single List argument.

• wasm_runtime_generic.dart:

  • Updated WasmModuleGeneric.getFunction to return null as WasmModuleFunction<F>?.

• wasm_runtime_io.dart:

  • Updated WasmModuleIO.getFunction to return a WasmModuleFunction with varArgs: true.

• wasm_runtime_dart_html.dart:

  • Deprecated WasmRuntimeDartHTML in favor of WasmRuntimeWeb.
  • Updated WasmModuleBrowser.getFunction to return a WasmModuleFunction with varArgs: true.
  • Updated createWasmRuntime to return WasmRuntimeDartHTML with deprecation warning.

• wasm_runtime_web.dart:

  • New WasmRuntimeWeb implementation using dart:js_interop and web package.
  • Added JS interop bindings for WebAssembly APIs using extension types.
  • Implemented WasmModuleBrowser wrapping _WasmInstance with proper JS interop.
  • getFunction returns a Dart function wrapping JS function calls with argument conversion and varArgs: false.
  • Added utilities to convert JS BigInt to Dart num or BigInt.
  • Updated createWasmRuntime to return WasmRuntimeWeb.
  • Added extensions for JS function invocation and JSAny type checks and casts.

• pubspec.yaml:

  • Added dependency on web: ^1.1.1.

• Tests:

  • Added new tests operation3 and operation4 verifying multi-parameter Dart functions compiled to Wasm and executed correctly.

• Updated minimum Dart SDK constraint to >=3.10.0 <4.0.0.

• Dependency updates:

  • swiss_knife: ^3.3.14
  • async_extension: ^1.2.22
  • data_serializer: ^1.2.1
  • petitparser: ^6.1.0
  • collection: ^1.19.1
  • args: ^2.7.0
  • wasm_run: ^0.1.0+2
  • crypto: ^3.0.7
  • path: ^1.9.1
  • test: ^1.31.0

• Reformatted code for Dart 3.10+

• lib/src/languages/wasm/wasm_runtime_browser.dart

  • Suppress deprecated dart:html usage warning with // ignore: deprecated_member_use import directive

• wasm_run: ^0.1.0+1

• New ASTExpressionVariableDirectOperation (++ and -- operators).

• New StrictType interface for equalsStrict over ASTTypeInt and ASTTypeDouble.

• ApolloGeneratorWasm:

  • Improve auto casting to int32/int64 and float32/float64.
  • Implemented generateASTExpressionVariableDirectOperation.

• sdk: '>=3.3.0 <4.0.0'

• swiss_knife: ^3.2.0

• data_serializer: ^1.1.0

• petitparser: ^6.0.2

• path: ^1.9.0

• lints: ^3.0.0

• dependency_validator: ^3.2.3

• test: ^1.25.2

• xml: ^6.5.0

• WasmRuntime: new VM implementation.
• wasm_runtime_io.dart:
• Dart CI: wasm_run:setup (install dynamic library)
• wasm_run: ^0.0.1+3

• ASTTypeDouble:
  • acceptsType: now also accepts an ASTTypeInt.
• wasm_generator.dart:
  • Fix isBits64.
• Improve Wasm test coverage.

• ASTNode:

  • Now is a mixin.
  • getNodeIdentifier: added optional parameter requester.
  • Added children and descendantChildren.

• ASTFunctionDeclaration:

  • getNodeIdentifier: now can also resolve identifiers inside statements.

• Wasm:

  • Encode function names with UTF-8.
  • Wasm64: added i64WrapToi32.

• WasmContext:

  • Added returns state.

• ApolloGeneratorWasm:

  • Added _autoConvertStackTypes.
  • generateASTStatementReturnValue and generateASTStatementReturnVariable:
    • Auto cast returning types.

• Dart CI: added job test_exe.

• Improve variable type resolution while compiling to Wasm.

• Improve type resolution of ASTTypeVar.
• Optimize some async methods.

• ASTBranchIfElseBlock and ASTBranchIfElseIfsElseBlock:

  • blockElse: optional.

• ASTParametersDeclaration:

  • Added allParameters.

• ASTTypeInt and ASTTypeDouble:

  • Added bits
  • Added ASTTypeInt.instance32 and ASTTypeInt.instance64.
  • Added ASTTypeDouble.instance32 and ASTTypeDouble.instance64.

• ASTValueNum:

  • Added field negative.

• ApolloGeneratorWasm:

  • Changed to 64 bits.
  • Wasm: split in Wasm32 and Wasm64 with improved opcodes.
  • Allow operations with different types (auto casting).
  • Handle unreachable end of function cases.
  • Implemented:
    • generateASTValue, generateASTValueDouble, generateASTValueInt.
    • generateASTExpressionVariableAssignment, generateASTStatementExpression
    • generateASTBranchIfBlock, generateASTBranchIfElseBlock, generateASTBranchIfElseIfsElseBlock.
    • generateASTStatementReturnWithExpression, generateASTStatementReturn, generateASTStatementReturnValue.

• ApolloParserWasm:

  • Identify if an ASTTypeInt or ASTTypeDouble type is a 32 or 64 bits.

• ApolloRunnerWasm:

  • Use the parsed Wasm functions (AST) to normalize the parameters before calling the Wasm function.

• WasmModule:

  • Added resolveReturnedValue.
    • Browser implementation: when the function returns a f64, the JS bigint needs to be converted to a Dart BigInt.

• New WasmModuleExecutionError.

• pubspec.yaml: update description.

• ApolloRunner:
  • getFunctionCodeUnit: fix returned codeUnit when allowClassMethod = true.

• New SourceCodeUnit and BinaryCodeUnit.

  • CodeUnit now is abstract:
    • Renamed field source to code.

• Using SourceCodeUnit instead of CodeUnit when necessary.

• ApolloParser renamed to ApolloCodeParser:

  • Allows binary code parsing (not only strings).
  • New ApolloSourceCodeParser.

• ApolloRunner:

  • Added getFunctionCodeUnit.

• Using Leb128 from package data_serializer.

• BytesOutput now extends BytesEmitter (from data_serializer).

• ApolloGeneratorWasm:

  • generateASTExpressionOperation: allow operations with different types (auto casting from int to double).

• New WasmRuntime and WasmModule.

  • Implementation: WasmRuntimeBrowser.

• New WasmModuleLoadError.

• WasmContext:

  • Added stack status to help code generation.

• data_serializer: ^1.0.11

• wasm_interop: ^2.0.1

• crypto: ^3.0.3

• path: ^1.8.3

• Renamed ApolloLanguageRunner to ApolloRunner.
• Organize runners implementation files.

• README.md: added Wasm example.
• Minor fixes.

• New ApolloGeneratorWasm.

  • Basic support to compile the AST tree to Wasm.

• New BytesOutput for binary code generation.

• data_serializer: ^1.0.10

• ApolloVMNullPointerException and ApolloVMCastException now extends ApolloVMRuntimeError.
• AST implementation:
  • Changes some StateError while executing to ApolloVMRuntimeError.
• New abstract ApolloCodeUnitStorage:
  • Implementations:
    • ApolloSourceCodeStorage, ApolloSourceCodeStorageMemory.
    • ApolloBinaryCodeStorage, ApolloBinaryCodeStorageMemory.
    • ApolloGenericCodeStorageMemory.
• ApolloGenerator now defines the output type.
• New GeneratedOutput.

• pubspec.yaml:
  • Added issue_tracker
  • Added topics.
  • Added screenshots.
• README.md:
  • Added Codecov badge and link.

• Update pubspec.yaml description.
• README.md: added TODO list.

• ApolloCodeGenerator:
  • generateASTValueStringExpression: try to preserve single quotes in concatenations sequence.
• Java 11:
  • Added support for ArrayList and HashMap literals.

• ASTRoot:
  • Added getClassWithMethod.
• CodeNamespace:
  • Added getCodeUnitWithClassMethod.
• ApolloLanguageRunner:
  • executeFunction: added parameter allowClassMethod.
• Added ASTExpressionListLiteral and ASTExpressionMapLiteral:
  • Support in dart and java grammar.

• ApolloVM:
  • loadCodeUnit now throws a SyntaxError with extended details.
• ParseResult:
  • Added fields codeUnit, errorPosition and errorLineAndColumn.
  • Added getters errorLine and errorMessageExtended
• Added ASTExpressionNegation:
  • Added support for dart and java11.

• ASTNode implementations:
  • Implement toString with a pseudo-code version of the node to facilitate debugging.
• Fixed parsing of comments in Dart and Java 11.

• Dart CI: update and optimize jobs.

• sdk: '>=3.0.0 <4.0.0'

• swiss_knife: ^3.1.5

• async_extension: ^1.2.5

• petitparser: ^6.0.1

• collection: ^1.18.0

• args: ^2.4.2

• lints: ^2.1.1

• test: ^1.24.6

• xml: ^6.4.2

• path: ^1.8.3

• Improved GitHub CI:
  • Added browser tests.
• Optimize imports.
• Clean code and new lints adjusts.
• sdk: '>=2.15.0 <3.0.0'
• swiss_knife: ^3.1.1
• async_extension: ^1.0.9
• petitparser: ^5.0.0
• collection: ^1.16.0
• args: ^2.3.1
• lints: ^2.0.0
• dependency_validator: ^3.2.2
• test: ^1.21.4
• pubspec: ^2.3.0
• xml: ^6.1.0
• path: ^1.8.2

• Using async_extension to optimize async calls.
  • Removed internal extensions with similar functionality.
• Migrated from pedantic to lints.
• Fixed missing await in ASTExpressionVariableAssignment.
• lints: ^1.0.1
• swiss_knife: ^3.0.8
• async_extension: ^1.0.6
• petitparser: ^4.2.0

• Improve ApolloVMCore:
  • Implementing portable int class for dart and java11:
    • parse, parseInt.
• Code generation:
  • Correctly normalize int and Integer for dart and java11.
• Improve async optimization.

• Implement static class accessor, to allow calls to static functions.
• Initial version of ApolloVMCore:
  • Implementing portable String class for dart and java11:
    • Mapping: contains, toUpperCase, toLowerCase, valueOf.
• Fixed class field code generation for dart and java11.
• async optimization:
  • Avoid instantiation of Future, using FutureOrExtension and ListFutureOrExtension:
    • resolve, resolveMapped and resolveAllMapped.
• Improved languages tests, to also executed regenerated code.

• Runner:
  • Strong types.
    • var types can be resolved.
    • ASTTypedNode: nodes can be typed, and resolution is performed and cached while running.
  • Optimize resolution of functions.
• Grammar:
  • Dart & Java:
    • var types to be resolved at runtime.

• Generator:
  • Dart & Java:
    • Improve String concatenation with variables.

• Grammar:
  • Dart & Java:
    • Added for loop statement: ASTStatementForLoop.
• Adjust README.md.

• ApolloVM:
  • parseLanguageFromFilePathExtension
• ApolloLanguageRunner:
  • tryExecuteFunction
  • tryExecuteClassFunction
• Executable:
  • apollovm
• args: ^2.0.0
• pubspec: ^2.0.1
• path: ^1.8.0

• Improve tests, to tests definitions directory of XML files.

• caseInsensitive option for:
  • setField, getField, getFunctionWithName, getFunction,getClass

• Better handling of function signature and how to pass positional and named parameters.

• Added ASTClass.getFieldsMap.
• ASTEntryPointBlock.execute with extra parameters classInstanceObject and classInstanceFields.
• Change signature ofdartRunner.executeFunction and javaRunner.executeClassMethod.
  • Now they use named parameters for positionalParameters and namedParameters.

• Grammar:
  • Java & Dart:
    • Parse boolean literal.
• Improve API documentation.

• API Documentation.

• Fix call of function using dynamic type in parameter value.
• Code Generator:
  • Better formatting for classes and methods.
• Grammar:
  • Dart:
    • Fix parsing of function with multiple parameters.
  • Java:
    • Class fields.
    • Fix parsing of function with multiple parameters.
    • Return statements ;

• Grammars:
  • Dart & Java11:
    • Fix parsing of multiple parameters.
• Runner:
  • Fix division with double and int.
• Code Generator:
  • Dart & Java11:
    • Fix variable assigment duplicated ';'.
  • Dart:
    • Improve string template regeneration, specially when parsed code comes from Java.
• Improved example.

• ASTBlock: added functionsNames.
• ASTClass: added fields and fieldsNames.
• ApolloLanguageRunner: added getClass.

• AST:
  • ASTClassFunctionDeclaration: To ensure that any class function is parsed from a class block and also ensure that is running from a class block.
• Generator:
  • Dart:
    • Fix non class function: due static modifier.
  • Java:
    • Will throw an exception if the generation of a function without a class is attempted.
• Runner:
  • Fix class object instance context.

• Grammar & Runner:
  • Dart & Java:
    • Class fields.
    • Class object instance fields at runtime.
• Code Generator:
  • Dart & Java:
    • Fix return statement with value/expression ;
  • Java:
    • Better/shorter code for String concatenation.

• Grammars & Code Generators & Runner:
  • Dart & Java11:
    • Better definition of static methods.
    • Class object instance.

• Renamed:
  • ASTCodeBlock -> ASTBlock.
  • ASTCodeRoot -> ASTRoot.
  • ASTCodeClass -> ASTClass.
• Added support to async calls in ASTNode execution.
  • Any part of an ASTNode can have an async resolution. This allows the mapping of external functions that returns a Future or other languages that accepts async at any point.
• Better mapping of external functions:
  • Better Identification of number of parameters of mapped functions.
• Now an ASTRoot or an ASTClass are initialized:
  • Class/Root statements are executed once, and a context for each Class/Root is held during VM execution.

• Refactor:
  • Split apollovm_ast.dart into multiple ast/apollovm_ast_*.dart files.

• Code Generators:
  • Fix else branch indentation.

• Fix package description.
• Renamed Java8 to Java11:
  • Java 11 is closer to Dart 2 than Java 8.
• Grammars & Code Generators:
  • Dart & Java11:
    • Support if, else if and else branches.

• Added type ASTTypeBool and value ASTValueBool.
• Added ApolloVMNullPointerException.
• Grammars & Code Generators:
  • Dart & Java8:
    • Support to expression comparison operators ==, !=, >, <, >=, <=.
• Upgrade: petitparser: ^4.1.0

• Grammars:
  • Dart:
    • Added support for string templates:
      • including variable access: $x.
      • including expressions: ${ x * 2 }.
      • Not implemented for multiline string yet.
  • Java8:
    • Support for string concatenation.
• Code Generators:
  • Java8:
    • Translate string templates to Java String concatenations.

• Grammars:
  • Dart:
    • Raw single line and raw multiline line strings.
    • Improved parser tests for literal String.

• Added type check:
  • ASTType.isInstance.
  • Function call now checks type signature and type inheritance.
• Grammars:
  • Dart:
    • Single line and multiline line strings with escaped chars.
  • Java8:
    • Single line strings with escaped chars.

• Removed ASTCodeGenerator, that is language specific now: ApolloCodeGenerator.
• Better external function mapping.
• Grammars:
  • Dart:
    • Expression operations: +, -, *, /, ~/.
  • Java8:
    • Expression operations: +, -, *, /.
• Improved tests.

• Improved execution:
  • Now can call a class method or a function.
• Improved code generation:
  • Now supporting Java8 and Dart.
• Grammars:
  • Dart:
    • Basic class definition.
  • Java8:
    • Basic class definition.

• Basic Dart and Java8 support.
• Initial version, created by Stagehand