miam.js is a parser combinator framework written in TypeScript. It is highly inspired by the excellent nom project. A special focus is brough on the type system to provide as much safety as possible, and to avoid consuming too much memory. Thus, the goal of miam.js is to provide a safe and relatively fast framework to build parsers.

miam.js is written in TypeScript, a language that compiles into JavaScript.

• Zero-copy: The parsers do not copy the string being analysed despite the fact that they are all pure,
• Safe parsing: We commit to bring as much safety as possible regarding the current tooling and languages we have. All means (like type system) are used to provide a safe framework to develop new parsers,
• Speed: No benchmark yet, but we hope that our approach with zero-copy will help to be fast,
• Lightweight: All the type system disappears at compile-time (from TypeScript to JavaScript); the resulting files are small (≈5Kb).

tag("abc")

concat(tag("abc"), tag("def"))

alt(tag("abc"), tag("def"))

opt(tag("abc"))

regex(/a[bc]/)

map(
    tag("abc"),
    abc => abc.toUpperCase()
)

label_do(
    {
        first: tag("abc"),
        second: tag("def")
    },
    ({first, second}) => {
        return {
            head: first,
            tail: second
        }
    )
)

precede(tag("prefix"), tag("subject"))

terminate(tag("subject"), tag("suffix"))

fold_many_m_n(
    1,
    3,
    [],
    (accumulator: Array, item: string) => {
        accumulator.push(item);
        return accumulator;
    },
    tag("abc")
);

many_0(tag("abc"))

many_1(tag("abc"))

See the examples/ directory for some examples.

The test/unit/ directory contains a nice overview of the API too.

Still under development. Please don't use it right now :-). API is under stabilisation.