@travetto/compiler

Compiler

Compiler

Install: @travetto/compiler

npm install @travetto/compiler

This module expands upon Typescript, with supplemental functionality:

• Read tsconfig.json from the project directory to provide
• Supports on-the-fly compilation, nothing needs to be compiled ahead of time
• Enhanced AST transformations, and transformer registration [object Object]
• Intelligent caching of source files to minimize recompilation
• Support for detecting changes in sources files at runtime
• Allows for hot-reloading of classes during development
  • Utilizes es2015 Proxys to allow for swapping out implementation at runtime Additionally, there is support for common AST transformations via Transformation

Debugging

When dealing with transformers, logging is somewhat tricky as the compiler executes before the code is loaded. To that end, the file compiler.log is created in the cache directory during the compilation process. This is a location that transformers should be free to log to, for debugging, and any additional feedback.

CLI

The module provides the ability to clear the compilation cache to handle any inconsistencies that may arise.

TODO: Describe cli behavior