1.4.1 and beforeEmit documentation

Author: Perryvw

docs/api/plugins.md

@@ -131,7 +131,7 @@ export default plugin;
 
 ### `afterPrint`
 
-The `afterPrint` function is called _after_ tstl has finished its work, except for resolving dependencies and calculating output paths. You can use this to modify the list of output files and do direct string modifications to them.
+The `afterPrint` function is called _after_ tstl has translated the input program to Lua, but before resolving dependencies and before bundling if configured. You can use this to modify the list of output files and do direct string modifications to them.
 
 ```ts
 import * as ts from "typescript";
@@ -152,3 +152,26 @@ const plugin: tstl.Plugin = {
 
 export default plugin;
 ```
+
+### `beforeEmit`
+
+The `beforeEmit` function is called after the input program has been translated to Lua, after external dependencies have been resolved and included, and after bundling (if configured).
+
+```ts
+import * as ts from "typescript";
+import * as tstl from "typescript-to-lua";
+
+const plugin: tstl.Plugin = {
+  beforeEmit(program: ts.Program, options: tstl.CompilerOptions, emitHost: tstl.EmitHost, result: tstl.EmitFile[]) {
+    void program;
+    void options;
+    void emitHost;
+
+    for (const file of result) {
+      file.code = "-- Comment added by beforeEmit plugin\n" + file.code;
+    }
+  },
+};
+
+export default plugin;
+```

package-lock.json

@@ -35,7 +35,7 @@
         "react-json-tree": "^0.15.0",
         "react-monaco-editor": "^0.43.0",
         "stream-browserify": "^3.0.0",
-        "typescript-to-lua": "1.4.0"
+        "typescript-to-lua": "1.4.1"
     },
     "devDependencies": {
         "@ark120202/typescript-config": "^2.2.0",