root: upgraded angular to use SSG and SSR + PWA capabilities

The existing Angular workspace is severely outdated and confusing.
Since Angular 17 released SSG, SSR, and PWA, we should implement
them. Hence, let's do this.

This patch upgrades angular to use SSG and SSR + PWA capabilities
in root repository.

Co-authored-by: Shuralyov, Jean <jean.shuralyov@proton.me>
Co-authored-by: Galyna, Cory <cory.galyna@gmail.com>
Co-authored-by: (Holloway) Chew, Kean Ho <me@hollowaykeanho.com>
Signed-off-by: (Holloway) Chew, Kean Ho <me@hollowaykeanho.com>

Author: 3 people

srcANGULAR/.ci/build_unix-any.sh renamed to Angular/.ci/build_unix-any.sh

@@ -33,6 +33,7 @@ ${PROJECT_SKU}-docs_any-any
 "
 
 
+FS_Remake_Directory "${PROJECT_PATH_ROOT}/${PROJECT_PATH_BUILD}"
 
 
 I18N_Activate_Environment
@@ -56,6 +57,19 @@ fi
 
 
 
+___source="${PROJECT_PATH_ROOT}/${PROJECT_ANGULAR}/dist/browser"
+___dest="${PROJECT_PATH_ROOT}/${PROJECT_PATH_DOCS}"
+I18N_Export "$___dest"
+FS_Make_Directory "$___dest"
+FS_Copy_All "${___source}/" "$___dest"
+if [ $? -ne 0 ]; then
+        I18N_Export_Failed
+        return 1
+fi
+
+
+
+
 # placeholding flag files
 old_IFS="$IFS"
 while IFS="" read -r __line || [ -n "$__line" ]; do

srcANGULAR/.ci/build_windows-any.ps1 renamed to Angular/.ci/build_windows-any.ps1

@@ -32,6 +32,7 @@ $__placeholders = @(
 )
 
 
+$null = FS-Remake-Directory "${env:PROJECT_PATH_ROOT}\${env:PROJECT_PATH_BUILD}"
 
 
 $null = I18N-Activate-Environment
@@ -56,6 +57,19 @@ if ($___process -ne 0) {
 
 
 
+$___source = "${env:PROJECT_PATH_ROOT}\${env:PROJECT_ANGULAR}\dist\browser"
+$___dest = "${env:PROJECT_PATH_ROOT}\${env:PROJECT_PATH_DOCS}"
+$null = I18N-Export "${___dest}"
+$null = FS-Make-Directory "${___dest}"
+$___process = FS-Copy-All "${___source}\" "${___dest}"
+if ($___process -ne 0) {
+	$null = I18N-Export-Failed
+	return 1
+}
+
+
+
+
 # placeholding flag files
 foreach ($__line in $__placeholders) {
 	if ($(STRINGS-Is-Empty "${__line}") -eq 0) {

srcANGULAR/.ci/materialize_unix-any.sh renamed to Angular/.ci/materialize_unix-any.sh

@@ -0,0 +1,79 @@
+# AutomataCI Static Site Generator Angular Setup
+
+This document is mainly for Angular developer to understand what is going on
+with the organization here. Most of the resources are the same.
+
+
+
+
+## Directory Structures
+
+Unlike what was recommended by Angular, AutomataCI prepares 2 separate
+components directories:
+
+1. `contents/` - organize the pages
+2. `services/` - where your libraries and components stays
+
+The `contents/` structures the website page hirarchy and imports the `services/`
+libraries to construct the page.
+
+
+
+
+## Server-Side Rendering (SSR) or Static Site Generation (SSG) First
+
+There is a high chance this project is likely being used to generate JAM Stack.
+Hence, AutomataCI prioritizes the SSR and SSG (pre-rendering) facilities.
+
+
+
+
+## Setting website Base URL
+
+To set the Base URL, make sure you update the `baseHref` and `deployUrl` data
+inside `angular.json`:
+
+```
+diff --git a/angular/angular.json b/angular/angular.json
+index 5379d9e..fb2e8fa 100644
+--- a/angular/angular.json
++++ b/angular/angular.json
+@@ -46,6 +46,8 @@
+           },
+           "configurations": {
+             "production": {
++              "baseHref": "https://www.example.com/",
++              "deployUrl": "https://www.example.com/",
+               "budgets": [
+                 {
+                   "type": "initial",
+```
+
+Then make sure you edit `assets/CNAME` and add only the domain name inside. This
+is for GitHub or GitLab authentication use.
+
+Then update the `assets/manifest.webmanifest` for PWA settings. Specifically,
+look for `start_url` and etc.
+
+
+
+
+## For development
+
+Everything is the same as Angular: `$ ng serve`
+
+
+
+
+## For Tests
+
+Everything is the same as Angular: `$ ng test` OR `$ ng e2e`
+
+
+
+
+## For Production
+
+Everything is the same as Angular: `$ ng build`
+
+For full automation, use: `$ ./automataCI/ci.sh.ps1 build`

srcANGULAR/.ci/materialize_windows-any.ps1 renamed to Angular/.ci/materialize_windows-any.ps1

@@ -7,32 +7,47 @@
       "projectType": "application",
       "schematics": {},
       "root": "",
-      "sourceRoot": "src",
+      "sourceRoot": ".",
       "prefix": "app",
       "architect": {
         "build": {
           "builder": "@angular-devkit/build-angular:application",
           "options": {
+            "crossOrigin": "anonymous",
             "outputPath": {
-              "base": "../public"
+              "base": "dist",
+              "browser": "browser",
+              "server": "server"
             },
-            "index": "src/index.html",
+            "index": "app.html",
             "polyfills": [
               "zone.js"
             ],
             "tsConfig": "tsconfig.app.json",
-            "assets": [
-              "src/favicon.ico",
-              "src/assets"
-            ],
+            "assets": [{
+              "glob": "**/*",
+              "input": "assets",
+              "output": "."
+            }],
             "styles": [
-              "src/styles.css"
+              "app.css"
+            ],
+            "scripts": [
+              "app.js"
             ],
-            "scripts": [],
-            "browser": "src/main.ts"
+            "browser": "main.ts",
+            "server": "main.server.ts",
+            "prerender": {
+              "routesFile": "prerender-routes.txt"
+            },
+            "ssr": {
+              "entry": "server.ts"
+            }
           },
           "configurations": {
             "production": {
+              "baseHref": "https://www.example.com/",
+              "deployUrl": "https://www.example.com/",
               "budgets": [
                 {
                   "type": "initial",
@@ -45,7 +60,8 @@
                   "maximumError": "4kb"
                 }
               ],
-              "outputHashing": "all"
+              "outputHashing": "all",
+              "serviceWorker": "ngsw-config.json"
             },
             "development": {
               "optimization": false,
@@ -83,14 +99,17 @@
               "zone.js/testing"
             ],
             "tsConfig": "tsconfig.spec.json",
-            "assets": [
-              "src/favicon.ico",
-              "src/assets"
-            ],
+            "assets": [{
+              "glob": "**/*",
+              "input": "assets",
+              "output": "."
+            }],
             "styles": [
-              "src/styles.css"
+              "app.css"
             ],
-            "scripts": []
+            "scripts": [
+              "app.js"
+            ]
           }
         }
       }