ARCHITECTURE: Migrate to TypeScript

TypeScript is a strict superset of JavaScript that adds optional static typing and that adopts the latest ECMAScript features before they are broadly deployed by browser vendors. It gets transpiled to JavaScript for deployment, and the support for debugging using sourcemaps is currently good.

The following steps need to happen:

• setup build system to use TypeScript and Rollup to bundle the (JavaScript) sources
• convert JavaScript files to TypeScript by adding type annotation, particularly for arguments and return values
• correct any errors that will be discovered as part of this process (mistyped property names is a common one)
• switch the test harness from tape to jest

Once completed, the codebase will be easier to maintain and the MathLive interface will have a “native” TypeScript interface (instead of the current one which is generated from JSDoc annotations and is not as expressive as desirable as a result). This will make the integration of MathLive in TypeScript projects easier. On the other hand, this should be transparent for JavaScript projects using MathLive, as the regular JavaScript API will still be available.

[NSoiffer]

It looks pretty good, but options: any is not helpful. It would be much more helpful to have a comment to explain the options or maybe better from a code correctness point of view, eliminate “any” and be specific about what the options really are from a type point of view.

Similarly, “string” is not helpful – what values can the string take on?

I did spot a bug dealing with links on http://cortexjs.io/docs/mathlive/#("core"%3Anamespace).(ParseMode%3Atype):

textToSpeechRulesOptions?: {[key: string]: string};A set of key/value pairs that can be used to configure the speech rule engine.Which options are available depends on the speech rule engine in use. There are no options available with MathLive’s built-in engine. The options for the SRE engine are documented {@link:https://github.com/zorkow/speech-rule-engine | here}

One the webpage, that link is just plain text, not a clickable link.

[physedo]

Very Good