Gramr

Gramr is a lightweight library for building combinator-based parsers. Whether you're parsing a string into tokens or transforming token streams into ASTs, Gramr makes it straightforward, efficient, and fun.

🌟 Features

• Composable Parsers: Build complex parsers by combining simple, reusable ones.
• Tokenization Made Easy: Define your grammar for tokenizing strings with intuitive combinators.
• Flexible AST Generation: Seamlessly convert token streams into Abstract Syntax Trees.
• Lightweight: Minimal overhead, zero dependency.
• Typesafe: Every rule is strictly type-annotated.

🚀 Installation

Install Gramr using your favorite package manager:

# npm
npm install gramr-ts

# yarn
yarn add gramr-ts

✨ Basic Usage

Here’s how you can get started:

1. Tokenize a String

import { Lex } from 'gramr-ts/lex';
import { Rule } from 'gramr-ts/rule';
import { $ } from 'gramr-ts/pipe'

const tokenize = Lex.create(
  [
    $(Lex.anyOf('0123456789'))(Rule.collect({ min: 1 }))(Lex.slice)(
      Rule.map((value) => ({ type: 'number', value })),
    ).$,
    $(Lex.exact('+'))(Rule.as({ type: 'plus' })).$,
  ],
  Lex.isWhitespace,
);

const tokens = tokenize('3 + 5');
// Output: [{ type: 'number', value: '3' }, { type: 'plus' }, { type: 'number', value: '5' }]
console.log(tokens);