ANTLR Parser for RCL

This package contains the ANTLR4 grammar and parser for the RCL language.

Building

The ANTLR parser requires Java to generate the TypeScript parser from the grammar files.

$3

- Java 17 or later must be installed
- Run ./install-java.sh for installation instructions

$3

``bash


Install dependencies

bun install

Generate parser and build TypeScript

bun run build
`

This will:
1. Generate TypeScript parser files from the ANTLR grammar
2. Fix import paths in the generated files
3. Compile TypeScript to JavaScript

Development

$3

- src/RclLexer.g4 - Lexer grammar (tokenization rules)
- src/RclParser.g4 - Parser grammar (syntax rules)
- src/RclLexerBase.ts - Base class for lexer with Python-like indentation support

$3

The src/generated/ directory contains the generated parser files. These are created by ANTLR and should not be edited manually.

Using Pre-built Parser

If you cannot install Java, you can:

1. Ask someone with Java to run bun run build and commit the generated files
2. Use the pre-built parser from a CI/CD system
3. Use a Docker container with Java pre-installed

Testing

`bash
bun test
``

Tests include:
- Grammar validation
- Parser functionality
- Context variable support