docs: clarify programmatic api usage

Author: privatenumber

docs/.vitepress/config.ts

@@ -30,7 +30,7 @@ export default defineConfig({
 		siteTitle: 'tsx',
 
 		editLink: {
-			pattern: 'https://github.com/privatenumber/tsx/edit/develop/docs/:path',
+			pattern: 'https://github.com/privatenumber/tsx/edit/master/docs/:path',
 			text: 'Edit this page on GitHub',
 		},
 

docs/index.md

@@ -2,7 +2,7 @@
 
 `tsx` stands for _TypeScript Execute_, and it's a simple command to run TypeScript in Node.js.
 
-Because `tsx` is basically an alias to `node`, you can use it the same way:
+`tsx` is basically an alias to `node`, so you can use it the same way:
 
 <div class="tsx-before-after">
 
@@ -12,11 +12,11 @@ node file.js
 <span class="hidden sm:block">→</span>
 <span class="sm:hidden">↓</span>
 ```sh
-tsx file.js
+tsx file.ts
 ```
 </div>
 
-<sub>Since it's Node.js underneath, all command-line flags are supported. Use `tsx` as you would use `node`!</sub>
+All Node.js command-line flags are supported—use `tsx` the same way you would use `node`!
 
 ## Features
 

docs/node/cjs.md

@@ -30,6 +30,9 @@ Load `tsx/cjs` at the top of your entry-file:
 
 ```js
 require('tsx/cjs')
+
+// Now you can load TS files
+require('./file.ts')
 ```
 
 ### Registration & Unregistration

docs/node/esm.md

@@ -32,6 +32,15 @@ NODE_OPTIONS='--loader tsx/esm' npx some-binary
 
 ## Programmatic API
 
+Load `tsx/esm` at the top of your entry-file:
+
+```js
+import 'tsx/esm'
+
+// Now you can load TS files
+await import('./file.ts')
+```
+
 ### Registration & Unregistration
 
 ```js
@@ -40,6 +49,8 @@ import { register } from 'tsx/esm/api'
 // register tsx enhancement
 const unregister = register()
 
+await import('./file.ts')
+
 // Unregister when needed
 unregister()
 ```

docs/node/index.md

@@ -34,4 +34,7 @@ NODE_OPTIONS='--import tsx' npx eslint
 Load `tsx` at the top of your entry-file:
 ```js
 import 'tsx'
+
+// Now you can load TS files
+await import('./file.ts')
 ```