Add docs about JavaScript & TypeScript

Author: jmsche

bundles/best_practices.rst

@@ -604,7 +604,39 @@ to the ``peerDependencies``:
 
 In this case, the file located at ``[assets directory]/dist/controller.js`` will be exposed.
 
-To use it in a template (e.g. one defined in your bundle) you can use it like this:
+.. tip::
+
+    You can either write raw JS in this ``dist/controller.js`` file, or you can e.g. write your controller with
+    TypeScript and transpile it to JavaScript.
+
+    Here is an example to do so:
+
+    1. Add the following to your ``package.json`` file:
+
+    .. code-block:: json
+
+        {
+            "scripts": {
+                "build": "babel src --extensions .ts -d dist"
+            },
+            "devDependencies": {
+                "@babel/cli": "^7.20.7",
+                "@babel/core": "^7.20.12",
+                "@babel/plugin-proposal-class-properties": "^7.18.6",
+                "@babel/preset-env": "^7.20.2",
+                "@babel/preset-typescript": "^7.18.6",
+                "@hotwired/stimulus": "^3.2.1"
+                "typescript": "^4.9.5"
+            }
+        }
+
+    2. Run either ``npm install`` or ``yarn install`` to install the new dependencies.
+
+    3. Write your Stimulus controller with TypeScript in ``src/controller.ts``.
+
+    4. Run ``npm run build`` or ``yarn run build`` to transpile your TypeScript controller into JavaScript.
+
+To use your controller in a template (e.g. one defined in your bundle) you can use it like this:
 
 .. code-block:: html+twig