[Docs] Clarify programmatic usage with ESM support

website/docs/performance.md

@@ -6,14 +6,18 @@ These tricks will make ts-node faster.
 
 ## Skip typechecking
 
-It is often better to use `tsc --noEmit` to typecheck as part of your tests or linting. In these cases, ts-node can skip typechecking.
+It is often better to typecheck as part of your tests or linting.  You can use `tsc --noEmit` to do this.  In these cases, ts-node can skip typechecking making it much faster.
+
+To skip typechecking in ts-node, do one of the following:
 
 * Enable [swc](./swc.md)
   * This is by far the fastest option
 * Enable [`transpileOnly`](./options.md#transpileonly) to skip typechecking without swc
 
 ## With typechecking
 
+If you absolutely must use ts-node for typechecking:
+
 * Avoid dynamic `require()` which may trigger repeated typechecking; prefer `import`
 * Try with and without `--files`; one may be faster depending on your project
 * Check `tsc --showConfig`; make sure all executed files are included

website/docs/usage.md

@@ -85,4 +85,6 @@ node --loader ts-node/esm --inspect ./index.ts
 
 You can require ts-node and register the loader for future requires by using `require('ts-node').register({ /* options */ })`.
 
+Note that this does not support ESM, node currently does not offer a way to programmatically add hooks when using ES modules. If you want to programmatically use ts-node with ESM support you need to write your own module loader which wraps ts-node and then invoke it in one of the ways described above.
+
 Check out our [API](./api.md) for more features.