docs: add custom compiler example

examples/custom_compiler/BUILD.bazel

@@ -0,0 +1,27 @@
+"""Shows the use of an alternative compiler, in this case the ngc compiler from Angular.
+
+The compiler has to use the same CLI as `tsc` for this to work.
+"""
+
+load("@aspect_rules_ts//ts:defs.bzl", "ts_project")
+load("@npm//examples:@angular/compiler-cli/package_json.bzl", "bin")
+
+bin.ngc_binary(
+    name = "ngc",
+)
+
+ts_project(
+    name = "compile",
+    srcs = [
+        # Shows that ts_project accepts any file@npm//examples:@angular/compiler-cli/s in srcs, because it can't assume
+        # the tsc compiler is the only one used.
+        "component.ng.html",
+        "component.ts",
+    ],
+    args = ["--listFiles"],
+    tsc = ":ngc",
+    deps = [
+        "//examples:node_modules/@angular/core",
+        "//examples:node_modules/@types/node",
+    ],
+)

examples/custom_compiler/component.ng.html

@@ -0,0 +1 @@
+<div>{{thing}}</div>

examples/custom_compiler/component.ts

@@ -0,0 +1,8 @@
+import { Component } from '@angular/core'
+
+@Component({
+    templateUrl: './component.ng.html',
+})
+export class Comp {
+    thing: string = ''
+}

examples/custom_compiler/tsconfig.json

@@ -0,0 +1,9 @@
+{
+    "compilerOptions": {
+        "module": "es2015",
+        "moduleResolution": "node",
+        "lib": ["ES2015", "DOM"],
+        "composite": false,
+        "experimentalDecorators": true
+    }
+}

examples/package.json

@@ -1,6 +1,9 @@
 {
     "private": true,
     "dependencies": {
+        "@angular/core": "14",
+        "@angular/compiler": "14",
+        "@angular/compiler-cli": "14",
         "@babel/cli": "7.18.9",
         "@babel/core": "7.18.9",
         "@babel/parser": "7.18.9",
@@ -9,6 +12,7 @@
         "@types/jasmine": "*",
         "@types/node": "18.6.1",
         "date-fns": "2.29.1",
+        "rxjs": "7",
         "typescript": "4.8.2"
     }
 }