feat(doc): move template outlet

apps/angular/context-outlet-type/.eslintrc.json

@@ -0,0 +1,18 @@
+{
+  "extends": ["../../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts"],
+      "extends": [
+        "plugin:@nx/angular",
+        "plugin:@angular-eslint/template/process-inline-templates"
+      ]
+    },
+    {
+      "files": ["*.html"],
+      "extends": ["plugin:@nx/angular-template"],
+      "rules": {}
+    }
+  ]
+}

apps/angular/context-outlet-type/README.md

@@ -0,0 +1,13 @@
+# Typed ContextOutlet
+
+> Author: Thomas Laforge
+
+### Run Application
+
+```bash
+npx nx serve angular-context-outlet-type
+```
+
+### Documentation and Instruction
+
+Challenge documentation is [here](https://angular-challenges.vercel.app/challenges/angular/4-angular-context-outlet-typed/).

apps/angular/context-outlet-type/project.json

@@ -0,0 +1,87 @@
+{
+  "name": "angular-context-outlet-type",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "projectType": "application",
+  "sourceRoot": "apps/angular/context-outlet-type/src",
+  "prefix": "app",
+  "targets": {
+    "build": {
+      "executor": "@angular-devkit/build-angular:browser",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/apps/angular/context-outlet-type",
+        "index": "apps/angular/context-outlet-type/src/index.html",
+        "main": "apps/angular/context-outlet-type/src/main.ts",
+        "polyfills": "apps/angular/context-outlet-type/src/polyfills.ts",
+        "tsConfig": "apps/angular/context-outlet-type/tsconfig.app.json",
+        "inlineStyleLanguage": "scss",
+        "assets": [
+          "apps/angular/context-outlet-type/src/favicon.ico",
+          "apps/angular/context-outlet-type/src/assets"
+        ],
+        "styles": ["apps/angular/context-outlet-type/src/styles.scss"],
+        "scripts": []
+      },
+      "configurations": {
+        "production": {
+          "budgets": [
+            {
+              "type": "initial",
+              "maximumWarning": "500kb",
+              "maximumError": "1mb"
+            },
+            {
+              "type": "anyComponentStyle",
+              "maximumWarning": "2kb",
+              "maximumError": "4kb"
+            }
+          ],
+          "fileReplacements": [
+            {
+              "replace": "apps/angular/context-outlet-type/src/environments/environment.ts",
+              "with": "apps/angular/context-outlet-type/src/environments/environment.prod.ts"
+            }
+          ],
+          "outputHashing": "all"
+        },
+        "development": {
+          "buildOptimizer": false,
+          "optimization": false,
+          "vendorChunk": true,
+          "extractLicenses": false,
+          "sourceMap": true,
+          "namedChunks": true
+        }
+      },
+      "defaultConfiguration": "production"
+    },
+    "serve": {
+      "executor": "@angular-devkit/build-angular:dev-server",
+      "configurations": {
+        "production": {
+          "browserTarget": "angular-context-outlet-type:build:production"
+        },
+        "development": {
+          "browserTarget": "angular-context-outlet-type:build:development"
+        }
+      },
+      "defaultConfiguration": "development"
+    },
+    "extract-i18n": {
+      "executor": "@angular-devkit/build-angular:extract-i18n",
+      "options": {
+        "browserTarget": "angular-context-outlet-type:build"
+      }
+    },
+    "lint": {
+      "executor": "@nx/linter:eslint",
+      "options": {
+        "lintFilePatterns": [
+          "apps/angular/context-outlet-type/**/*.ts",
+          "apps/angular/context-outlet-type/**/*.html"
+        ]
+      }
+    }
+  },
+  "tags": []
+}

apps/angular/context-outlet-type/src/app/app.component.ts

@@ -0,0 +1,46 @@
+import { NgTemplateOutlet } from '@angular/common';
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { ListComponent } from './list.component';
+import { PersonComponent } from './person.component';
+
+@Component({
+  standalone: true,
+  imports: [NgTemplateOutlet, PersonComponent, ListComponent],
+  selector: 'app-root',
+  template: `
+    <person [person]="person">
+      <ng-template #personRef let-name let-age="age">
+        {{ name }}: {{ age }}
+      </ng-template>
+    </person>
+
+    <list [list]="students">
+      <ng-template #listRef let-student let-i="index">
+        {{ student.name }}: {{ student.age }} - {{ i }}
+      </ng-template>
+    </list>
+
+    <list [list]="cities">
+      <ng-template #listRef let-city let-i="index">
+        {{ city.name }}: {{ city.country }} - {{ i }}
+      </ng-template>
+    </list>
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class AppComponent {
+  person = {
+    name: 'toto',
+    age: 3,
+  };
+
+  students = [
+    { name: 'toto', age: 3 },
+    { name: 'titi', age: 4 },
+  ];
+
+  cities = [
+    { name: 'Paris', country: 'France' },
+    { name: 'Berlin', country: 'Germany' },
+  ];
+}

apps/angular/context-outlet-type/src/app/list.component.ts

@@ -0,0 +1,33 @@
+import { CommonModule } from '@angular/common';
+import {
+  ChangeDetectionStrategy,
+  Component,
+  ContentChild,
+  Input,
+  TemplateRef,
+} from '@angular/core';
+
+@Component({
+  selector: 'list',
+  standalone: true,
+  imports: [CommonModule],
+  template: `
+    <div *ngFor="let item of list; index as i">
+      <ng-container
+        *ngTemplateOutlet="
+          listTemplateRef || emptyRef;
+          context: { $implicit: item, appList: item, index: i }
+        ">
+      </ng-container>
+    </div>
+
+    <ng-template #emptyRef> No Template </ng-template>
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ListComponent<TItem extends object> {
+  @Input() list!: TItem[];
+
+  @ContentChild('listRef', { read: TemplateRef })
+  listTemplateRef!: TemplateRef<unknown>;
+}

apps/angular/context-outlet-type/src/app/person.component.ts

@@ -0,0 +1,28 @@
+import { NgTemplateOutlet } from '@angular/common';
+import { Component, ContentChild, Input, TemplateRef } from '@angular/core';
+
+interface Person {
+  name: string;
+  age: number;
+}
+
+@Component({
+  standalone: true,
+  imports: [NgTemplateOutlet],
+  selector: 'person',
+  template: `
+    <ng-container
+      *ngTemplateOutlet="
+        personTemplateRef || emptyRef;
+        context: { $implicit: person.name, age: person.age }
+      "></ng-container>
+
+    <ng-template #emptyRef> No Template </ng-template>
+  `,
+})
+export class PersonComponent {
+  @Input() person!: Person;
+
+  @ContentChild('#personRef', { read: TemplateRef })
+  personTemplateRef!: TemplateRef<unknown>;
+}

apps/angular/context-outlet-type/src/environments/environment.prod.ts

@@ -0,0 +1,3 @@
+export const environment = {
+  production: true,
+};

apps/angular/context-outlet-type/src/environments/environment.ts

@@ -0,0 +1,16 @@
+// This file can be replaced during build by using the `fileReplacements` array.
+// `ng build` replaces `environment.ts` with `environment.prod.ts`.
+// The list of file replacements can be found in `angular.json`.
+
+export const environment = {
+  production: false,
+};
+
+/*
+ * For easier debugging in development mode, you can import the following file
+ * to ignore zone related error stack frames such as `zone.run`, `zoneDelegate.invokeTask`.
+ *
+ * This import should be commented out in production mode because it will have a negative impact
+ * on performance if an error is thrown.
+ */
+// import 'zone.js/plugins/zone-error';  // Included with Angular CLI.

apps/angular/context-outlet-type/src/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>ContextOutletType</title>
+    <base href="/" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" type="image/x-icon" href="favicon.ico" />
+  </head>
+  <body>
+    <app-root></app-root>
+  </body>
+</html>

apps/angular/context-outlet-type/src/main.ts

@@ -0,0 +1,10 @@
+import { enableProdMode } from '@angular/core';
+import { bootstrapApplication } from '@angular/platform-browser';
+import { AppComponent } from './app/app.component';
+import { environment } from './environments/environment';
+
+if (environment.production) {
+  enableProdMode();
+}
+
+bootstrapApplication(AppComponent).catch((err) => console.error(err));

apps/angular/context-outlet-type/src/polyfills.ts

@@ -0,0 +1,52 @@
+/**
+ * This file includes polyfills needed by Angular and is loaded before the app.
+ * You can add your own extra polyfills to this file.
+ *
+ * This file is divided into 2 sections:
+ *   1. Browser polyfills. These are applied before loading ZoneJS and are sorted by browsers.
+ *   2. Application imports. Files imported after ZoneJS that should be loaded before your main
+ *      file.
+ *
+ * The current setup is for so-called "evergreen" browsers; the last versions of browsers that
+ * automatically update themselves. This includes recent versions of Safari, Chrome (including
+ * Opera), Edge on the desktop, and iOS and Chrome on mobile.
+ *
+ * Learn more in https://angular.io/guide/browser-support
+ */
+
+/***************************************************************************************************
+ * BROWSER POLYFILLS
+ */
+
+/**
+ * By default, zone.js will patch all possible macroTask and DomEvents
+ * user can disable parts of macroTask/DomEvents patch by setting following flags
+ * because those flags need to be set before `zone.js` being loaded, and webpack
+ * will put import in the top of bundle, so user need to create a separate file
+ * in this directory (for example: zone-flags.ts), and put the following flags
+ * into that file, and then add the following code before importing zone.js.
+ * import './zone-flags';
+ *
+ * The flags allowed in zone-flags.ts are listed here.
+ *
+ * The following flags will work for all browsers.
+ *
+ * (window as any).__Zone_disable_requestAnimationFrame = true; // disable patch requestAnimationFrame
+ * (window as any).__Zone_disable_on_property = true; // disable patch onProperty such as onclick
+ * (window as any).__zone_symbol__UNPATCHED_EVENTS = ['scroll', 'mousemove']; // disable patch specified eventNames
+ *
+ *  in IE/Edge developer tools, the addEventListener will also be wrapped by zone.js
+ *  with the following flag, it will bypass `zone.js` patch for IE/Edge
+ *
+ *  (window as any).__Zone_enable_cross_context_check = true;
+ *
+ */
+
+/***************************************************************************************************
+ * Zone JS is required by default for Angular itself.
+ */
+import 'zone.js'; // Included with Angular CLI.
+
+/***************************************************************************************************
+ * APPLICATION IMPORTS
+ */

apps/angular/context-outlet-type/src/styles.scss

@@ -0,0 +1 @@
+/* You can add global styles to this file, and also import other style files */

apps/angular/context-outlet-type/tsconfig.app.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../../dist/out-tsc",
+    "types": [],
+    "target": "ES2022",
+    "useDefineForClassFields": false
+  },
+  "files": ["src/main.ts", "src/polyfills.ts"],
+  "include": ["src/**/*.d.ts"],
+  "exclude": ["jest.config.ts", "**/*.test.ts", "**/*.spec.ts"]
+}

apps/angular/context-outlet-type/tsconfig.editor.json

@@ -0,0 +1,7 @@
+{
+  "extends": "./tsconfig.json",
+  "include": ["**/*.ts"],
+  "compilerOptions": {
+    "types": []
+  }
+}

apps/angular/context-outlet-type/tsconfig.json

@@ -0,0 +1,28 @@
+{
+  "extends": "../../../tsconfig.base.json",
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.app.json"
+    },
+    {
+      "path": "./tsconfig.editor.json"
+    }
+  ],
+  "compilerOptions": {
+    "target": "es2020",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "angularCompilerOptions": {
+    "enableI18nLegacyMessageIdFormat": false,
+    "strictInjectionParameters": true,
+    "strictInputAccessModifiers": true,
+    "strictTemplates": true
+  }
+}