feat: typed parser return value

[g-plane]

Previously, type of the return value of parse function is any. This PR makes it strongly typed.

Additions:

• The options can be undefined now and all the properties of options can be undefined. That is, all the code below are valid:

// We can omit the options:
parse('source code')

// All properties are optional:
parse('source code', {})

• The properties of the parser result are dynamic. For example, if we disable the tokens option like this:

let ast = parse('', { tokens: false })

The tokens property will not exist in the variable ast.

Instead, if we enable the tokens option:

let ast = parse('', { tokens: true })

We can find that an additional tokens property is existed on the ast.

[JamesHenry]

Great addition, @g-plane! I had to prioritize getting in the big PR from Ben, would you mind updating this?

Thanks!

[g-plane]

What does it need to be updated?

[j-f1]

@g-plane It looks like there are merge conflicts now.

[g-plane]

Oh, I'm using mobile phone now so I cannot see the conflicts notice. Sorry!

[j-f1]

You should try GitHawk! </ad>

_{Sent with GitHawk}

[g-plane]

@JamesHenry Problems are fixed.

[JamesHenry]

This filename logic is now separately defined 3 times within this file, can we promote it to be defined once at a higher level?

Other than that the PR LGTM

[g-plane]

Updated.

[JamesHenry]

Thanks!

[JamesHenry]

🎉 This PR is included in version 5.2.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀