doc: type the codebase

[sverweij]

Description

• adds types-as-comments in javascript files and puts the @ ts-check thing in them so they're indeed checked
• updates the existing type definitions + adds a few new ones

This PR is a part 1 of several. This PR covers:

• bin & cli
• general modules in src
• transform
• parse - except for scxml which is partly typed
• transform
• render: the smcat renderer

TODO (for in a separate PR):

• the renderers
• the scxml parser

For both of these we'll need to describe the scjson schema (type). The dot massaging code will need a separate .d.ts as well

Motivation and Context

First step in migrating the code base to TypeScript

How Has This Been Tested?

• [x] green ci

Types of changes

• [ ] Bug fix (non-breaking change which fixes an issue)
• [ ] Documentation only change
• [x] Refactor (non-breaking change which fixes an issue without changing functionality)
• [ ] New feature (non-breaking change which adds functionality)
• [ ] Breaking change (fix or feature that would cause existing functionality to change)

Checklist

• [x] :book:

  • My change doesn't require a documentation update, or ...
  • it does and I have updated it

• [x] :balance_scale:

  • The contribution will be subject to The MIT license, and I'm OK with that.
  • The contribution is my own original work.
  • I am ok with the stuff in CONTRIBUTING.md.

[codeclimate[bot]]

Code Climate has analyzed commit 00fb7233 and detected 0 issues on this pull request.

The test coverage on the diff in this pull request is 100.0% (100% is the threshold).

This pull request will bring the total coverage in the repository to 100.0% (0.0% change).

View more on Code Climate.