feat(doc): move permissions

apps/angular/permissions/.eslintrc.json

@@ -0,0 +1,36 @@
+{
+  "extends": ["../../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts"],
+      "extends": [
+        "plugin:@nx/angular",
+        "plugin:@angular-eslint/template/process-inline-templates"
+      ],
+      "rules": {
+        "@angular-eslint/directive-selector": [
+          "error",
+          {
+            "type": "attribute",
+            "prefix": "app",
+            "style": "camelCase"
+          }
+        ],
+        "@angular-eslint/component-selector": [
+          "error",
+          {
+            "type": "element",
+            "prefix": "app",
+            "style": "kebab-case"
+          }
+        ]
+      }
+    },
+    {
+      "files": ["*.html"],
+      "extends": ["plugin:@nx/angular-template"],
+      "rules": {}
+    }
+  ]
+}

apps/angular/permissions/README.md

@@ -0,0 +1,13 @@
+# Structural Directive
+
+> Author: Thomas Laforge
+
+### Run Application
+
+```bash
+npx nx serve angular-permissions
+```
+
+### Documentation and Instruction
+
+Challenge documentation is [here](https://angular-challenges.vercel.app/challenges/angular/6-angular-permissions/).

apps/angular/permissions/project.json

@@ -0,0 +1,87 @@
+{
+  "name": "angular-permissions",
+  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
+  "projectType": "application",
+  "sourceRoot": "apps/angular/permissions/src",
+  "prefix": "app",
+  "targets": {
+    "build": {
+      "executor": "@angular-devkit/build-angular:browser",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/apps/angular/permissions",
+        "index": "apps/angular/permissions/src/index.html",
+        "main": "apps/angular/permissions/src/main.ts",
+        "polyfills": "apps/angular/permissions/src/polyfills.ts",
+        "tsConfig": "apps/angular/permissions/tsconfig.app.json",
+        "inlineStyleLanguage": "scss",
+        "assets": [
+          "apps/angular/permissions/src/favicon.ico",
+          "apps/angular/permissions/src/assets"
+        ],
+        "styles": ["apps/angular/permissions/src/styles.scss"],
+        "scripts": []
+      },
+      "configurations": {
+        "production": {
+          "budgets": [
+            {
+              "type": "initial",
+              "maximumWarning": "500kb",
+              "maximumError": "1mb"
+            },
+            {
+              "type": "anyComponentStyle",
+              "maximumWarning": "2kb",
+              "maximumError": "4kb"
+            }
+          ],
+          "fileReplacements": [
+            {
+              "replace": "apps/angular/permissions/src/environments/environment.ts",
+              "with": "apps/angular/permissions/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-permissions:build:production"
+        },
+        "development": {
+          "browserTarget": "angular-permissions:build:development"
+        }
+      },
+      "defaultConfiguration": "development"
+    },
+    "extract-i18n": {
+      "executor": "@angular-devkit/build-angular:extract-i18n",
+      "options": {
+        "browserTarget": "angular-permissions:build"
+      }
+    },
+    "lint": {
+      "executor": "@nx/linter:eslint",
+      "options": {
+        "lintFilePatterns": [
+          "apps/angular/permissions/**/*.ts",
+          "apps/angular/permissions/**/*.html"
+        ]
+      }
+    }
+  },
+  "tags": []
+}

apps/angular/permissions/src/app/app.component.ts

@@ -0,0 +1,11 @@
+import { Component } from '@angular/core';
+import { RouterOutlet } from '@angular/router';
+
+@Component({
+  standalone: true,
+  imports: [RouterOutlet],
+  selector: 'app-root',
+  template: ` <router-outlet></router-outlet> `,
+  styles: [],
+})
+export class AppComponent {}

apps/angular/permissions/src/app/app.config.ts

@@ -0,0 +1,6 @@
+import { ApplicationConfig } from '@angular/core';
+import { provideRouter } from '@angular/router';
+import { APP_ROUTES } from './routes';
+export const appConfig: ApplicationConfig = {
+  providers: [provideRouter(APP_ROUTES)],
+};

apps/angular/permissions/src/app/button.component.ts

@@ -0,0 +1,13 @@
+/* eslint-disable @angular-eslint/component-selector */
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+
+@Component({
+  standalone: true,
+  selector: 'button[app-button]',
+  template: `<ng-content></ng-content>`,
+  host: {
+    class: 'border border-blue-700 bg-blue-400 p-2 rounded-sm text-white',
+  },
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ButtonComponent {}

apps/angular/permissions/src/app/dashboard/admin.component.ts

@@ -0,0 +1,15 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { RouterLink } from '@angular/router';
+import { ButtonComponent } from '../button.component';
+
+@Component({
+  selector: 'app-dashboard',
+  standalone: true,
+  imports: [RouterLink, ButtonComponent],
+  template: `
+    <p>dashboard for Admin works!</p>
+    <button app-button routerLink="/">Logout</button>
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class AdminDashboardComponent {}

apps/angular/permissions/src/app/dashboard/manager.component.ts

@@ -0,0 +1,15 @@
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { RouterLink } from '@angular/router';
+import { ButtonComponent } from '../button.component';
+
+@Component({
+  selector: 'app-dashboard',
+  standalone: true,
+  imports: [RouterLink, ButtonComponent],
+  template: `
+    <p>dashboard for Manager works!</p>
+    <button app-button routerLink="/">Logout</button>
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class ManagerDashboardComponent {}

apps/angular/permissions/src/app/has-role.directive.ts

@@ -0,0 +1,68 @@
+/* eslint-disable @angular-eslint/directive-selector */
+import { NgIfContext } from '@angular/common';
+import {
+  Directive,
+  Input,
+  OnDestroy,
+  OnInit,
+  TemplateRef,
+  ViewContainerRef,
+} from '@angular/core';
+import { Role } from './user.model';
+import { UserStore } from './user.store';
+
+@Directive({
+  selector: '[hasRole], [hasRoleIsAdmin]',
+  standalone: true,
+  providers: [provideDestroyService()],
+})
+export class HasRoleDirective implements OnInit, OnDestroy {
+  @Input('hasRole') role: Role | Role[] | undefined = undefined;
+
+  @Input('hasRoleIsAdmin') isAdmin = false;
+
+  @Input('hasRoleIsAdminElseTemplate')
+  elseTemplate?: TemplateRef<NgIfContext> | null;
+
+  constructor(
+    private templateRef: TemplateRef<unknown>,
+    private viewContainer: ViewContainerRef,
+    private store: UserStore
+  ) {}
+
+  ngOnDestroy(): void {
+    console.log('on destroy');
+  }
+
+  ngOnInit(): void {
+    console.log(this.role, this.isAdmin, this.elseTemplate);
+    if (this.isAdmin) {
+      this.store.isAdmin$.subscribe((isAdmin) => {
+        console.log(isAdmin);
+        isAdmin ? this.addTemplate() : this.addElseTemplate();
+      });
+    }
+    // else if (this.role) {
+    //   this.store
+    //     .hasAnyRole(this.role)
+    //     .subscribe((hasPermission) =>
+    //       hasPermission ? this.addTemplate() : this.addElseTemplate()
+    //     );
+    // } else {
+    //   this.addTemplate();
+    // }
+  }
+
+  private addTemplate() {
+    console.log('Add');
+    this.viewContainer.clear();
+    this.viewContainer.createEmbeddedView(this.templateRef);
+  }
+
+  private addElseTemplate() {
+    console.log('ici');
+    this.viewContainer.clear();
+    this.elseTemplate &&
+      this.viewContainer.createEmbeddedView(this.elseTemplate);
+  }
+}

apps/angular/permissions/src/app/information.component.ts

@@ -0,0 +1,24 @@
+import { CommonModule } from '@angular/common';
+import { ChangeDetectionStrategy, Component } from '@angular/core';
+import { UserStore } from './user.store';
+
+@Component({
+  selector: 'app-information',
+  standalone: true,
+  imports: [CommonModule],
+  template: `
+    <h2 class="mt-10 text-xl">Information Panel</h2>
+    <!-- admin can see everything -->
+    <div>visible only for super admin</div>
+    <div>visible if manager</div>
+    <div>visible if manager and/or reader</div>
+    <div>visible if manager and/or writer</div>
+    <div>visible if client</div>
+    <div>visible for everyone</div>
+  `,
+  changeDetection: ChangeDetectionStrategy.OnPush,
+})
+export class InformationComponent {
+  user$ = this.userStore.user$;
+  constructor(private userStore: UserStore) {}
+}

apps/angular/permissions/src/app/login.component.ts

@@ -0,0 +1,63 @@
+import { Component } from '@angular/core';
+import { RouterLink } from '@angular/router';
+import { ButtonComponent } from './button.component';
+import { InformationComponent } from './information.component';
+import {
+  admin,
+  client,
+  everyone,
+  manager,
+  reader,
+  readerAndWriter,
+  writer,
+} from './user.model';
+import { UserStore } from './user.store';
+
+@Component({
+  standalone: true,
+  imports: [InformationComponent, RouterLink, ButtonComponent],
+  selector: 'app-login',
+  template: `
+    <header class="flex gap-3 items-center">
+      Log as :
+      <button app-button (click)="admin()">Admin</button>
+      <button app-button (click)="manager()">Manager</button>
+      <button app-button (click)="reader()">Reader</button>
+      <button app-button (click)="writer()">Writer</button>
+      <button app-button (click)="readerWriter()">Reader and Writer</button>
+      <button app-button (click)="client()">Client</button>
+      <button app-button (click)="everyone()">Client</button>
+    </header>
+
+    <app-information></app-information>
+
+    <button app-button class=" mt-10" routerLink="enter">
+      Enter application
+    </button>
+  `,
+})
+export class LoginComponent {
+  constructor(private userStore: UserStore) {}
+
+  admin() {
+    this.userStore.add(admin);
+  }
+  manager() {
+    this.userStore.add(manager);
+  }
+  reader() {
+    this.userStore.add(reader);
+  }
+  writer() {
+    this.userStore.add(writer);
+  }
+  readerWriter() {
+    this.userStore.add(readerAndWriter);
+  }
+  client() {
+    this.userStore.add(client);
+  }
+  everyone() {
+    this.userStore.add(everyone);
+  }
+}

apps/angular/permissions/src/app/routes.ts

@@ -0,0 +1,14 @@
+export const APP_ROUTES = [
+  {
+    path: '',
+    loadComponent: () =>
+      import('./login.component').then((m) => m.LoginComponent),
+  },
+  {
+    path: 'enter',
+    loadComponent: () =>
+      import('./dashboard/admin.component').then(
+        (m) => m.AdminDashboardComponent
+      ),
+  },
+];

apps/angular/permissions/src/app/user.model.ts

@@ -0,0 +1,49 @@
+export type Role = 'MANAGER' | 'WRITER' | 'READER' | 'CLIENT';
+
+export interface User {
+  name: string;
+  isAdmin: boolean;
+  roles: Role[];
+}
+
+export const admin: User = {
+  name: 'admin',
+  isAdmin: true,
+  roles: [],
+};
+
+export const manager: User = {
+  name: 'manager',
+  isAdmin: false,
+  roles: ['MANAGER'],
+};
+
+export const writer: User = {
+  name: 'writer',
+  isAdmin: false,
+  roles: ['WRITER'],
+};
+
+export const reader: User = {
+  name: 'reader',
+  isAdmin: false,
+  roles: ['READER'],
+};
+
+export const readerAndWriter: User = {
+  name: 'reader',
+  isAdmin: false,
+  roles: ['READER', 'WRITER'],
+};
+
+export const client: User = {
+  name: 'client',
+  isAdmin: false,
+  roles: ['CLIENT'],
+};
+
+export const everyone: User = {
+  name: 'client',
+  isAdmin: false,
+  roles: [],
+};

apps/angular/permissions/src/app/user.store.ts

@@ -0,0 +1,15 @@
+import { Injectable } from '@angular/core';
+import { BehaviorSubject } from 'rxjs';
+import { User } from './user.model';
+
+@Injectable({
+  providedIn: 'root',
+})
+export class UserStore {
+  private user = new BehaviorSubject<User | undefined>(undefined);
+  user$ = this.user.asObservable();
+
+  add(user: User) {
+    this.user.next(user);
+  }
+}

apps/angular/permissions/src/environments/environment.prod.ts

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

apps/angular/permissions/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/permissions/src/index.html

@@ -0,0 +1,13 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>Permissions</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/permissions/src/main.ts

@@ -0,0 +1,15 @@
+import { appConfig } from './app/app.config';
+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, appConfig).catch((err) =>
+  console.error(err)
+);

apps/angular/permissions/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/permissions/src/styles.scss

@@ -0,0 +1,5 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/* You can add global styles to this file, and also import other style files */

apps/angular/permissions/tailwind.config.js

@@ -0,0 +1,14 @@
+const { createGlobPatternsForDependencies } = require('@nx/angular/tailwind');
+const { join } = require('path');
+
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  content: [
+    join(__dirname, 'src/**/!(*.stories|*.spec).{ts,html}'),
+    ...createGlobPatternsForDependencies(__dirname),
+  ],
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

apps/angular/permissions/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/permissions/tsconfig.editor.json

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

apps/angular/permissions/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
+  }
+}