Antlers Parser Extract

This repository contains an extracted copy of the Antlers parser and lexer sources from the VS Code Antlers language server:

• Source: https://github.com/Stillat/vscode-antlers-language-server/tree/main/server/src
• Extracted from main at commit 74d6f49ebf1f102d9128f543c652f78c11ee5765
• Upstream commit date: 2025-05-29
• License: MIT, preserved in LICENSE.md

Layout

• src/ is the upstream server/src tree
• src/runtime/lexer/antlersLexer.ts is the lexer
• src/runtime/parser/documentParser.ts is the document parser
• src/runtime/parser/languageParser.ts is the language expression parser
• src/index.ts re-exports the main parser/lexer entrypoints

Build

npm install
npm run build

Tests

Run the parser test suite with:

npm test

The current tests are built around examples from the Statamic Antlers documentation:

• Source docs: https://statamic.dev/frontend/antlers
• test/statamic-docs.variables.test.js covers variable, modifier, path access, and expression examples
• test/statamic-docs.operators.test.js covers control flow, assignment, switch, and advanced operator examples
• test/statamic-docs.tags-and-escapes.test.js covers tag pairs, parameters, self-closing tags, escaping, comments, and PHP delimiters

These tests are intended to verify that the extracted parser accepts real-world Antlers syntax shown in the official docs, not just the original upstream unit cases. A few documented behaviors that are not yet modeled by this extraction are noted inline in the test files rather than being asserted as failures.

Notes

The parser and lexer are not isolated single files upstream. They depend on a larger runtime and support tree, so this extraction preserves the upstream source layout rather than trying to hand-prune dependencies.