Merge branch 'development'

Author: BeSpunky

.devcontainer/devcontainer.json

@@ -0,0 +1,62 @@
+// For format details, see https://aka.ms/devcontainer.json. For config options, see the
+// README at: https://github.com/devcontainers/templates/tree/main/src/typescript-node
+{
+  "name": "angular-zen",
+  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
+  "image": "mcr.microsoft.com/devcontainers/typescript-node:0-18",
+  "features": {
+      "ghcr.io/devcontainers-contrib/features/pnpm:2": {
+          "version": "latest"
+      },
+      "ghcr.io/devcontainers-contrib/features/firebase-cli": {
+          "version": "latest"
+      }
+  },
+  // Use 'forwardPorts' to make a list of ports inside the container available locally.
+  "forwardPorts": [
+      // ng serve
+      4200
+  ],
+  // Define where the code will reside inside the container
+  "workspaceFolder": "/code",
+  // Bind mount the local code folder to allow faster reads and writes between the container and the host
+  "workspaceMount": "source=${localWorkspaceFolder},target=/code,type=bind,consistency=consistent",
+  "mounts": [
+      // Declare the node_modules folder as a volume for faster reads and writes
+      "source=node_modules,target=/code/node_modules,type=volume" //,
+      // Share the local pnpm global store on the host with the container (The PNPM_GLOBAL_STORE_PATH arg should match the target specified here).
+      // This allows faster installations of packages by utilizing the already installed packages.
+      // "source=${localEnv:PNPM_HOME}/store,target=/code/.pnpm-store,type=bind"
+  ],
+  // Use 'postCreateCommand' to run commands after the container is created.
+  "postCreateCommand": "pnpm install",
+  // Configure tool-specific properties.
+  "customizations": {
+      "vscode": {
+          // Add the IDs of extensions you want installed when the container is created.
+          "extensions": [
+              "dbaeumer.vscode-eslint",
+              "gkalpak.aio-docs-utils",
+              "angular.ng-template",
+              "ms-azuretools.vscode-docker",
+              "nrwl.angular-console",
+              "meganrogge.template-string-converter",
+              "plievone.vscode-template-literal-editor",
+              "gruntfuggly.todo-tree",
+              "wallabyjs.wallaby-vscode",
+              "williamragstad.wr-docthis",
+              "jakearl.search-editor-apply-changes",
+              "wallabyjs.quokka-vscode",
+              "yzhang.markdown-all-in-one",
+              "eamodio.gitlens",
+              "tobermory.es6-string-html",
+              "wwm.better-align",
+              "jannisx11.batch-rename-extension",
+              "matthewthorning.align-vertically",
+              "nicoespeon.abracadabra"
+          ]
+      }
+  },
+  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
+  "remoteUser": "root"
+}

.eslintrc.json

@@ -30,6 +30,13 @@
       "files": ["*.js", "*.jsx"],
       "extends": ["plugin:@nrwl/nx/javascript"],
       "rules": {}
+    },
+    {
+      "files": ["*.spec.ts", "*.spec.tsx", "*.spec.js", "*.spec.jsx"],
+      "env": {
+        "jest": true
+      },
+      "rules": {}
     }
   ]
 }

.gitignore

@@ -7,6 +7,7 @@
 
 # dependencies
 node_modules
+.pnpm-store
 
 # IDEs and editors
 /.idea

.npmrc

@@ -0,0 +1,2 @@
+strict-peer-dependencies=false
+auto-install-peers=true

.pnpm-debug.log

@@ -0,0 +1 @@
+{}

.prettierignore

@@ -0,0 +1,4 @@
+# Add files here to ignore them from prettier formatting
+
+/dist
+/coverage

.prettierrc

@@ -0,0 +1,3 @@
+{
+  "singleQuote": true
+}

README.md

@@ -30,8 +30,28 @@
     You may use the library as you'd like, with any app, under the MIT license.
 </p>
 
+## 📢 What's new
+<h3 align="center">Checkout the new <code>useNavigationX()</code> function!</h3>
+<center>
+    ✨ <a href="https://bs-angular-zen.web.app/docs/zen/additional-documentation/routerxmodule/navigationx.html">Strong-typed and auto generated navigation system for Angular (PREVIEW)</a>
+</center>
+
+<p align="center">
+    <img src="https://bs-angular-zen.web.app/docs/zen/.attachments/navigation-x-usage.png"/>
+</p>
+
+<br/>
+<center>
+    ⚒️ <a href="https://bs-angular-zen.web.app/docs/zen/additional-documentation/routerxmodule/utils.html">Other util functions (PREVIEW)</a>
+</center>
+<br/>
+
 ## ✨ The Highlights
 
+[✨ Strong-typed and auto generated navigation system for Angular (PREVIEW)](https://bs-angular-zen.web.app/docs/zen/additional-documentation/routerxmodule/navigationx.html)
+
+[⚒️ Standalone routing utils (PREVIEW)](https://bs-angular-zen.web.app/docs/zen/additional-documentation/routerxmodule/utils.html)
+
 [👁️ `*observe` directives](https://bs-angular-zen.web.app/docs/zen/additional-documentation/coremodule/observemodule.html) - Super easy RxJS integration.
 
 [👁️ `*onObserver` directives](https://bs-angular-zen.web.app/docs/zen/additional-documentation/coremodule/onobservermodule.html) - Conditional template rendering according to observable states.
@@ -59,11 +79,13 @@
 [🗣 `LocalizedRouteAware`](https://bs-angular-zen.web.app/docs/zen/additional-documentation/languageintegrationmodule/localizedrouteaware-\(abstract\).html) - Create route aware services and components with language integration.
 
 ## Versions
-Version 5.0.0 was regenerated based on Angular 13.
+Starting from v14, zen versions will stick to Angular's major versions.
 
-Previous versions of the library were based on a workspace generated using Angular 7 which has been gradually updated and tested up to Angular 11.
+> Version 5.0.0 was regenerated based on Angular 13.
 
-Compatibility with older versions is possible but not guaranteed.
+> Previous versions of the library were based on a workspace generated using Angular 7 which has been gradually updated and tested up to Angular 11.
+> 
+> Compatibility with older versions is possible but not guaranteed.
 
 [Full change log](https://bs-angular-zen.web.app/docs/zen/changelog.html)