feat(typescript): Move to BuilderProgram API

[NotWoods]

Rollup Plugin Name: typescript

This PR contains:

• bugfix
• feature
• refactor
• documentation
• other

Are tests included?

• yes (bugfixes and features will not be merged without tests)
• no

Breaking Changes?

• yes (breaking changes will not be merged unless absolutely necessary)
• no

List any relevant issue numbers: #216, #205, #204, #70, #61

Description

This is another refactor to move from LanguageService (meant for IDEs) to BuilderProgram (meant for partial recomplation). This makes some big changes to the plugin to better align with what Typescript does: rather than Rollup giving us files to transform and the plugin transforming them on the fly, Typescript detects all source files and does a entire project transpilation at the very start. This is similar to Jake Archibald's simple-ts plugin, except the compilation is done in-memory rather than with a temp directory. BuilderProgram is also used by Webpack's ts-loader. Since the behavior is better aligned with Typescript, this fixes some odd inconsistencies in the typechecking like #204 and #211.

We now support the declaration and declarationMap options with this change! When generating declaration files, the outDir must be set and be pointed to Rollup's output dir (or some subfolder). This allows us to use Rollup's asset emit API, and other plugins can then intercept these assets to potentially bundle the declaration files later. We currently emit each file separately, similar to rollup-plugin-typescript2.

This also adds experimental support for incremental builds, and paves the way for project references/build mode too.

Breaking changes

All files discovered by Typescript will be compiled. The include/exclude filter can be used to filter out the files that Typescript finds. By default, all files in a directory with the tsconfig.json will be included, so most projects should not need additional changes. Our tests have been updated to have tsconfig.json files in each fixture directory, since we don't want all fixtures to be compiled for each test.

tslib can no longer be overriden by passing in source code directly. Now, it must be a path to a file. This better aligns with other plugins and is probably the expected behavior. Users can migrate by placing their custom tslib source code inside a file in their project, then including a path to it inside the plugin options.

The declaration, declarationMap, incremental, and tsBuildInfoFile options are no longer ignored. If these options are set, then a Rollput output dir must be used and Typescript's outDir/declarationDir must be located inside of it.Compilationn will fail if these directories are not set to be within dir.

We also fail compilation if the deprecated out option is used, or if the incompatible outFile is used.

[paulrostorp]

Is this ready for review ?

[NotWoods]

Yes