From 21caa3eb727d056ef424df0c76afa5069290d105 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 11:50:42 +0800
Subject: [PATCH 001/129] chore: Auto build docs if only src/docs is changed

---
 .github/workflows/lint.yml | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 44e2f4cb1..c84632264 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -19,6 +19,16 @@ jobs:
         node-version: [16.x]
     steps:
       - uses: actions/checkout@v3
+        if: ${{ github.event_name == 'pull_request' }}
+        with:
+          fetch-depth: 2
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          ref: ${{ github.event.pull_request.head.ref }}
+
+      - uses: actions/checkout@v3
+        if: ${{ github.event_name != 'pull_request' }}
+        with:
+          fetch-depth: 2
 
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v3
@@ -38,5 +48,27 @@ jobs:
       - name: Run Linting
         run: yarn lint
 
+      - name: Run changed-files using the fork point of a pull request
+        id: changed-files-fork-point
+        uses: tj-actions/changed-files@v29
+        with:
+          use_fork_point: 'true'
+          files: |
+            src/docs/*
+
+      - name: Run step if any file(s) in the docs folder change
+        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        run: |
+          echo "Only files in the src/docs folder has changed."
+          echo "List all the files that have changed: ${{ steps.changed-files-specific.outputs.all_changed_files }}"
+          yarn docs:build
+
+      - name: Commit changes
+        uses: EndBug/add-and-commit@v9
+        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        with:
+          message: 'Update docs'
+          add: 'docs/*'
+
       - name: Verify Docs
         run: yarn docs:verify

From 058f1c2edf4908f0bbb63e955bee6e6e359f7caf Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 11:55:33 +0800
Subject: [PATCH 002/129] chore: Update docs path

---
 .github/workflows/lint.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index aa80e5c6e..13b2c4ebe 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -54,7 +54,7 @@ jobs:
         with:
           use_fork_point: 'true'
           files: |
-            src/docs/*
+            packages/mermaid/src/docs/*
 
       - name: Run step if any file(s) in the docs folder change
         if: steps.changed-files-fork-point.outputs.only_modified == 'true'
@@ -68,7 +68,7 @@ jobs:
         if: steps.changed-files-fork-point.outputs.only_modified == 'true'
         with:
           message: 'Update docs'
-          add: 'docs/*'
+          add: 'packages/mermaid/docs/*'
 
       - name: Verify Docs
         run: pnpm run docs:verify

From 8d9800c72709206a182db190df5b4e0447d79aa4 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 11:57:19 +0800
Subject: [PATCH 003/129] fix(docs): Test auto commit

---
 packages/mermaid/src/docs/classDiagram.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/mermaid/src/docs/classDiagram.md b/packages/mermaid/src/docs/classDiagram.md
index f46d3689c..51383fb6a 100644
--- a/packages/mermaid/src/docs/classDiagram.md
+++ b/packages/mermaid/src/docs/classDiagram.md
@@ -1,7 +1,8 @@
 # Class diagrams
 
 > "In software engineering, a class diagram in the Unified Modeling Language (UML) is a type of static structure diagram that describes the structure of a system by showing the system's classes, their attributes, operations (or methods), and the relationships among objects."
-> Wikipedia
+>
+> -Wikipedia
 
 The class diagram is the main building block of object-oriented modeling. It is used for general conceptual modeling of the structure of the application, and for detailed modeling to translate the models into programming code. Class diagrams can also be used for data modeling. The classes in a class diagram represent both the main elements, interactions in the application, and the classes to be programmed.
 

From d367e832bed51bd60204316f1765f4df2e863619 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 12:00:59 +0800
Subject: [PATCH 004/129] fix(docs): Test auto commit

---
 .github/workflows/lint.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 13b2c4ebe..c0b0a7f28 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -21,9 +21,9 @@ jobs:
       - uses: actions/checkout@v3
         if: ${{ github.event_name == 'pull_request' }}
         with:
+          # repository: ${{ github.event.pull_request.head.repo.full_name }}
+          # ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 2
-          repository: ${{ github.event.pull_request.head.repo.full_name }}
-          ref: ${{ github.event.pull_request.head.ref }}
 
       - uses: actions/checkout@v3
         if: ${{ github.event_name != 'pull_request' }}

From 75db08a60c944e749b5fac5558dc49725fbe858f Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 12:05:48 +0800
Subject: [PATCH 005/129] fix(docs): Test auto commit

---
 .github/workflows/lint.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index c0b0a7f28..fc1121c71 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -57,7 +57,7 @@ jobs:
             packages/mermaid/src/docs/*
 
       - name: Run step if any file(s) in the docs folder change
-        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        if: steps.changed-files-fork-point.outputs.any_modified == 'true'
         run: |
           echo "Only files in the src/docs folder has changed."
           echo "List all the files that have changed: ${{ steps.changed-files-specific.outputs.all_changed_files }}"
@@ -65,7 +65,7 @@ jobs:
 
       - name: Commit changes
         uses: EndBug/add-and-commit@v9
-        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        if: steps.changed-files-fork-point.outputs.any_modified == 'true'
         with:
           message: 'Update docs'
           add: 'packages/mermaid/docs/*'

From 1d8d677d81570628545437ff2adb487dc6c0d51e Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 14:03:44 +0800
Subject: [PATCH 006/129] fix: File location

---
 .github/workflows/lint.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index fc1121c71..6ca6b3519 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -55,6 +55,7 @@ jobs:
           use_fork_point: 'true'
           files: |
             packages/mermaid/src/docs/*
+            packages/mermaid/src/docs.mts
 
       - name: Run step if any file(s) in the docs folder change
         if: steps.changed-files-fork-point.outputs.any_modified == 'true'
@@ -68,7 +69,7 @@ jobs:
         if: steps.changed-files-fork-point.outputs.any_modified == 'true'
         with:
           message: 'Update docs'
-          add: 'packages/mermaid/docs/*'
+          add: 'docs/*'
 
       - name: Verify Docs
         run: pnpm run docs:verify

From 3bae25fe6b353d3621ab4e68d3eee47b47ed8305 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 14:15:28 +0800
Subject: [PATCH 007/129] split lint docs action

---
 .github/workflows/lint-docs.yml | 63 +++++++++++++++++++++++++++++++++
 .github/workflows/lint.yml      | 33 -----------------
 2 files changed, 63 insertions(+), 33 deletions(-)
 create mode 100644 .github/workflows/lint-docs.yml

diff --git a/.github/workflows/lint-docs.yml b/.github/workflows/lint-docs.yml
new file mode 100644
index 000000000..68bda942a
--- /dev/null
+++ b/.github/workflows/lint-docs.yml
@@ -0,0 +1,63 @@
+name: Lint Docs
+
+on:
+  pull_request:
+    types:
+      - opened
+      - synchronize
+      - ready_for_review
+
+permissions:
+  contents: write
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node-version: [16.x]
+    steps:
+      - uses: actions/checkout@v3
+        if: ${{ github.event_name == 'pull_request' }}
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          ref: ${{ github.event.pull_request.head.ref }}
+          fetch-depth: 0
+
+      - uses: pnpm/action-setup@v2
+        # uses version from "packageManager" field in package.json
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
+        with:
+          cache: pnpm
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install Packages
+        run: |
+          pnpm install --frozen-lockfile
+        env:
+          CYPRESS_CACHE_FOLDER: .cache/Cypress
+
+      - name: Run changed-files using the fork point of a pull request
+        id: changed-files-fork-point
+        uses: tj-actions/changed-files@v29
+        with:
+          use_fork_point: 'true'
+          files: |
+            packages/mermaid/src/docs/*
+            packages/mermaid/src/docs.mts
+
+      - name: Run step if any file(s) in the docs folder change
+        if: steps.changed-files-fork-point.outputs.any_modified == 'true'
+        run: |
+          echo "Only files in the src/docs folder has changed."
+          echo "List all the files that have changed: ${{ steps.changed-files-specific.outputs.all_changed_files }}"
+          yarn docs:build
+
+      - name: Commit changes
+        uses: EndBug/add-and-commit@v9
+        if: steps.changed-files-fork-point.outputs.any_modified == 'true'
+        with:
+          message: 'Update docs'
+          add: 'docs/*'
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 6ca6b3519..dd2f7aa3b 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -19,16 +19,6 @@ jobs:
         node-version: [16.x]
     steps:
       - uses: actions/checkout@v3
-        if: ${{ github.event_name == 'pull_request' }}
-        with:
-          # repository: ${{ github.event.pull_request.head.repo.full_name }}
-          # ref: ${{ github.event.pull_request.head.ref }}
-          fetch-depth: 2
-
-      - uses: actions/checkout@v3
-        if: ${{ github.event_name != 'pull_request' }}
-        with:
-          fetch-depth: 2
 
       - uses: pnpm/action-setup@v2
         # uses version from "packageManager" field in package.json
@@ -48,28 +38,5 @@ jobs:
       - name: Run Linting
         run: pnpm run lint
 
-      - name: Run changed-files using the fork point of a pull request
-        id: changed-files-fork-point
-        uses: tj-actions/changed-files@v29
-        with:
-          use_fork_point: 'true'
-          files: |
-            packages/mermaid/src/docs/*
-            packages/mermaid/src/docs.mts
-
-      - name: Run step if any file(s) in the docs folder change
-        if: steps.changed-files-fork-point.outputs.any_modified == 'true'
-        run: |
-          echo "Only files in the src/docs folder has changed."
-          echo "List all the files that have changed: ${{ steps.changed-files-specific.outputs.all_changed_files }}"
-          yarn docs:build
-
-      - name: Commit changes
-        uses: EndBug/add-and-commit@v9
-        if: steps.changed-files-fork-point.outputs.any_modified == 'true'
-        with:
-          message: 'Update docs'
-          add: 'docs/*'
-
       - name: Verify Docs
         run: pnpm run docs:verify

From 8d6af3dfedd7fb564e889496db6e2e12e1eec012 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 14:21:54 +0800
Subject: [PATCH 008/129] split lint docs action

---
 .github/workflows/lint-docs.yml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/lint-docs.yml b/.github/workflows/lint-docs.yml
index 68bda942a..60faeda31 100644
--- a/.github/workflows/lint-docs.yml
+++ b/.github/workflows/lint-docs.yml
@@ -20,8 +20,8 @@ jobs:
       - uses: actions/checkout@v3
         if: ${{ github.event_name == 'pull_request' }}
         with:
-          repository: ${{ github.event.pull_request.head.repo.full_name }}
-          ref: ${{ github.event.pull_request.head.ref }}
+          # repository: ${{ github.event.pull_request.head.repo.full_name }}
+          # ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 0
 
       - uses: pnpm/action-setup@v2
@@ -49,7 +49,7 @@ jobs:
             packages/mermaid/src/docs.mts
 
       - name: Run step if any file(s) in the docs folder change
-        if: steps.changed-files-fork-point.outputs.any_modified == 'true'
+        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
         run: |
           echo "Only files in the src/docs folder has changed."
           echo "List all the files that have changed: ${{ steps.changed-files-specific.outputs.all_changed_files }}"
@@ -57,7 +57,7 @@ jobs:
 
       - name: Commit changes
         uses: EndBug/add-and-commit@v9
-        if: steps.changed-files-fork-point.outputs.any_modified == 'true'
+        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
         with:
           message: 'Update docs'
           add: 'docs/*'

From 9c5c85d34ac1777a93b8e80b15720a5fccbeb57c Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 14:24:51 +0800
Subject: [PATCH 009/129] Run doc lint only if files changed

---
 .github/workflows/lint-docs.yml | 33 ++++++++++++++++++---------------
 1 file changed, 18 insertions(+), 15 deletions(-)

diff --git a/.github/workflows/lint-docs.yml b/.github/workflows/lint-docs.yml
index 60faeda31..734363a22 100644
--- a/.github/workflows/lint-docs.yml
+++ b/.github/workflows/lint-docs.yml
@@ -24,21 +24,6 @@ jobs:
           # ref: ${{ github.event.pull_request.head.ref }}
           fetch-depth: 0
 
-      - uses: pnpm/action-setup@v2
-        # uses version from "packageManager" field in package.json
-
-      - name: Setup Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
-        with:
-          cache: pnpm
-          node-version: ${{ matrix.node-version }}
-
-      - name: Install Packages
-        run: |
-          pnpm install --frozen-lockfile
-        env:
-          CYPRESS_CACHE_FOLDER: .cache/Cypress
-
       - name: Run changed-files using the fork point of a pull request
         id: changed-files-fork-point
         uses: tj-actions/changed-files@v29
@@ -48,6 +33,24 @@ jobs:
             packages/mermaid/src/docs/*
             packages/mermaid/src/docs.mts
 
+      - uses: pnpm/action-setup@v2
+        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        # uses version from "packageManager" field in package.json
+
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v3
+        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        with:
+          cache: pnpm
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install Packages
+        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        run: |
+          pnpm install --frozen-lockfile
+        env:
+          CYPRESS_CACHE_FOLDER: .cache/Cypress
+
       - name: Run step if any file(s) in the docs folder change
         if: steps.changed-files-fork-point.outputs.only_modified == 'true'
         run: |

From 0a547e524e1b6f9b98489a847670dea6733d10ab Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 14:30:46 +0800
Subject: [PATCH 010/129] Run doc lint only if files changed

---
 .github/workflows/lint-docs.yml | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/.github/workflows/lint-docs.yml b/.github/workflows/lint-docs.yml
index 734363a22..20caab6f0 100644
--- a/.github/workflows/lint-docs.yml
+++ b/.github/workflows/lint-docs.yml
@@ -18,17 +18,17 @@ jobs:
         node-version: [16.x]
     steps:
       - uses: actions/checkout@v3
-        if: ${{ github.event_name == 'pull_request' }}
-        with:
-          # repository: ${{ github.event.pull_request.head.repo.full_name }}
-          # ref: ${{ github.event.pull_request.head.ref }}
-          fetch-depth: 0
+        # if: ${{ github.event_name == 'pull_request' }}
+        # with:
+        # fetch-depth: 0
+        # repository: ${{ github.event.pull_request.head.repo.full_name }}
+        # ref: ${{ github.event.pull_request.head.ref }}
 
       - name: Run changed-files using the fork point of a pull request
         id: changed-files-fork-point
         uses: tj-actions/changed-files@v29
         with:
-          use_fork_point: 'true'
+          # use_fork_point: 'true'
           files: |
             packages/mermaid/src/docs/*
             packages/mermaid/src/docs.mts

From 455c61b2cf38fd8c9739a3b97029cb935574c168 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 14:41:52 +0800
Subject: [PATCH 011/129] Run doc lint only if files changed

---
 .github/workflows/lint-docs.yml | 24 ++++++++++--------------
 1 file changed, 10 insertions(+), 14 deletions(-)

diff --git a/.github/workflows/lint-docs.yml b/.github/workflows/lint-docs.yml
index 20caab6f0..312de8b1c 100644
--- a/.github/workflows/lint-docs.yml
+++ b/.github/workflows/lint-docs.yml
@@ -18,41 +18,37 @@ jobs:
         node-version: [16.x]
     steps:
       - uses: actions/checkout@v3
-        # if: ${{ github.event_name == 'pull_request' }}
-        # with:
-        # fetch-depth: 0
-        # repository: ${{ github.event.pull_request.head.repo.full_name }}
-        # ref: ${{ github.event.pull_request.head.ref }}
+        with:
+          repository: ${{ github.event.pull_request.head.repo.full_name }}
+          ref: ${{ github.event.pull_request.head.ref }}
 
-      - name: Run changed-files using the fork point of a pull request
-        id: changed-files-fork-point
+      - name: Check if source docs are changed
+        id: changed-docs
         uses: tj-actions/changed-files@v29
         with:
-          # use_fork_point: 'true'
           files: |
             packages/mermaid/src/docs/*
             packages/mermaid/src/docs.mts
 
       - uses: pnpm/action-setup@v2
-        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
-        # uses version from "packageManager" field in package.json
+        if: steps.changed-docs.outputs.only_modified == 'true'
 
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v3
-        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        if: steps.changed-docs.outputs.only_modified == 'true'
         with:
           cache: pnpm
           node-version: ${{ matrix.node-version }}
 
       - name: Install Packages
-        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        if: steps.changed-docs.outputs.only_modified == 'true'
         run: |
           pnpm install --frozen-lockfile
         env:
           CYPRESS_CACHE_FOLDER: .cache/Cypress
 
       - name: Run step if any file(s) in the docs folder change
-        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        if: steps.changed-docs.outputs.only_modified == 'true'
         run: |
           echo "Only files in the src/docs folder has changed."
           echo "List all the files that have changed: ${{ steps.changed-files-specific.outputs.all_changed_files }}"
@@ -60,7 +56,7 @@ jobs:
 
       - name: Commit changes
         uses: EndBug/add-and-commit@v9
-        if: steps.changed-files-fork-point.outputs.only_modified == 'true'
+        if: steps.changed-docs.outputs.only_modified == 'true'
         with:
           message: 'Update docs'
           add: 'docs/*'

From 563c51d4311f1ff8b159355f8553905348d4b86a Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 3 Oct 2022 14:49:35 +0800
Subject: [PATCH 012/129] Get base sha from PR

---
 .github/workflows/lint-docs.yml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/.github/workflows/lint-docs.yml b/.github/workflows/lint-docs.yml
index 312de8b1c..d9f0ddae0 100644
--- a/.github/workflows/lint-docs.yml
+++ b/.github/workflows/lint-docs.yml
@@ -22,10 +22,22 @@ jobs:
           repository: ${{ github.event.pull_request.head.repo.full_name }}
           ref: ${{ github.event.pull_request.head.ref }}
 
+      - name: Get branch name
+        id: branch-name
+        uses: tj-actions/branch-names@v5
+
+      - uses: nrwl/last-successful-commit-action@v1
+        id: last_successful_commit_pull_request
+        with:
+          branch: ${{ steps.branch-name.outputs.base_ref_branch }}
+          workflow_id: 'lint-docs.yml'
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+
       - name: Check if source docs are changed
         id: changed-docs
         uses: tj-actions/changed-files@v29
         with:
+          base_sha: ${{ steps.last_successful_commit_pull_request.outputs.commit_hash }}
           files: |
             packages/mermaid/src/docs/*
             packages/mermaid/src/docs.mts

From d05fd25339fd4be4237a60a7710f8abc0d46b868 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Tue, 15 Nov 2022 23:59:17 +0530
Subject: [PATCH 013/129] Fix #3799: Remove `type` from package.json

---
 packages/mermaid/package.json | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 9cbc695b1..f8ff46325 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,11 +1,10 @@
 {
   "name": "mermaid",
-  "version": "9.2.2",
+  "version": "9.2.3-rc.1",
   "description": "Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",
   "types": "./dist/mermaid.d.ts",
-  "type": "commonjs",
   "exports": {
     ".": {
       "require": "./dist/mermaid.min.js",

From 3358406e685e22e7621a0e4851ac0ff02ad21f19 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 16 Nov 2022 00:06:47 +0530
Subject: [PATCH 014/129] fix: release-preview-publish.yml

---
 .github/workflows/release-preview-publish.yml | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/release-preview-publish.yml b/.github/workflows/release-preview-publish.yml
index 2b2ff559b..da12cb5cc 100644
--- a/.github/workflows/release-preview-publish.yml
+++ b/.github/workflows/release-preview-publish.yml
@@ -10,21 +10,27 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+
+      - uses: pnpm/action-setup@v2
+
       - name: Setup Node.js
         uses: actions/setup-node@v3
         with:
+          cache: pnpm
           node-version: 18.x
-      - name: Install Yarn
-        run: npm i yarn --global
+
+      - name: Install Packages
+        run: |
+          pnpm install --frozen-lockfile
+        env:
+          CYPRESS_CACHE_FOLDER: .cache/Cypress
 
       - name: Install Json
         run: npm i json --global
 
-      - name: Install Packages
-        run: yarn install --frozen-lockfile
-
       - name: Publish
         run: |
+          cd packages/mermaid
           PREVIEW_VERSION=8
           VERSION=$(echo ${{github.ref}} | tail -c +20)-preview.$PREVIEW_VERSION
           echo $VERSION

From 8d96518092ce582cbce38c391d2cb760eb33ecef Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Tue, 15 Nov 2022 13:47:16 -0800
Subject: [PATCH 015/129] accessibility.js -> ts; + set aria-roledescription;
 add spec

---
 packages/mermaid/src/accessibility.js      | 29 ---------
 packages/mermaid/src/accessibility.spec.ts | 73 ++++++++++++++++++++++
 packages/mermaid/src/accessibility.ts      | 45 +++++++++++++
 3 files changed, 118 insertions(+), 29 deletions(-)
 delete mode 100644 packages/mermaid/src/accessibility.js
 create mode 100644 packages/mermaid/src/accessibility.spec.ts
 create mode 100644 packages/mermaid/src/accessibility.ts

diff --git a/packages/mermaid/src/accessibility.js b/packages/mermaid/src/accessibility.js
deleted file mode 100644
index c59ba270c..000000000
--- a/packages/mermaid/src/accessibility.js
+++ /dev/null
@@ -1,29 +0,0 @@
-/**
- * This method will add a basic title and description element to a chart. The yy parser will need to
- * respond to getAccTitle and getAccDescription, where the title is the title element on the chart,
- * which is generally not displayed and the accDescription is the description element on the chart,
- * which is never displayed.
- *
- * The following charts display their title as a visual and accessibility element: gantt
- *
- * @param yy_parser
- * @param svg
- * @param id
- */
-export default function addSVGAccessibilityFields(yy_parser, svg, id) {
-  if (typeof svg.insert === 'undefined') {
-    return;
-  }
-
-  let title_string = yy_parser.getAccTitle();
-  let description = yy_parser.getAccDescription();
-  svg.attr('role', 'img').attr('aria-labelledby', 'chart-title-' + id + ' chart-desc-' + id);
-  svg
-    .insert('desc', ':first-child')
-    .attr('id', 'chart-desc-' + id)
-    .text(description);
-  svg
-    .insert('title', ':first-child')
-    .attr('id', 'chart-title-' + id)
-    .text(title_string);
-}
diff --git a/packages/mermaid/src/accessibility.spec.ts b/packages/mermaid/src/accessibility.spec.ts
new file mode 100644
index 000000000..29a2f125d
--- /dev/null
+++ b/packages/mermaid/src/accessibility.spec.ts
@@ -0,0 +1,73 @@
+// Spec/tests for accessibility
+
+import { setA11yDiagramInfo, addSVGa11yTitleDescription } from './accessibility';
+
+import { MockedD3 } from './tests/MockedD3';
+
+const fauxSvgNode = new MockedD3();
+
+const MockedDiagramDb = {
+  getAccTitle: vi.fn().mockReturnValue('the title'),
+  getAccDescription: vi.fn().mockReturnValue('the description'),
+};
+
+describe('setA11yDiagramInfo', () => {
+  it('sets the aria-roledescription to the diagram type', () => {
+    // @ts-ignore  Required to easily handle the d3 select types
+    const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+    setA11yDiagramInfo(fauxSvgNode, 'flowchart');
+    expect(svg_attr_spy).toHaveBeenCalledWith('aria-roledescription', 'flowchart');
+  });
+});
+
+describe('addSVGa11yTitleDescription', () => {
+  const testDiagramDb = MockedDiagramDb;
+  const givenId = 'theBaseId';
+
+  describe('with the given svg d3 object:', () => {
+    it('does nothing if there is no insert defined', () => {
+      const noInsertSvg = {
+        attr: vi.fn(),
+      };
+      const noInsert_attr_spy = vi.spyOn(noInsertSvg, 'attr').mockReturnValue(noInsertSvg);
+      addSVGa11yTitleDescription(testDiagramDb, noInsertSvg, givenId);
+      expect(noInsert_attr_spy).not.toHaveBeenCalled();
+    });
+
+    it('sets aria-labelledby to the title id and the description id inserted as children', () => {
+      // @ts-ignore Required to easily handle the d3 select types
+      const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+      addSVGa11yTitleDescription(testDiagramDb, fauxSvgNode, givenId);
+      expect(svg_attr_spy).toHaveBeenCalledWith(
+        'aria-labelledby',
+        `chart-title-${givenId} chart-desc-${givenId}`
+      );
+    });
+
+    it('inserts a title tag as the first child with the text set to the accTitle returned by the diagram db', () => {
+      const faux_title = new MockedD3();
+      const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+      // @ts-ignore  Required to easily handle the d3 select types
+      const title_attr_spy = vi.spyOn(faux_title, 'attr').mockReturnValue(faux_title);
+      const title_text_spy = vi.spyOn(faux_title, 'text');
+
+      addSVGa11yTitleDescription(testDiagramDb, fauxSvgNode, givenId);
+      expect(svg_insert_spy).toHaveBeenCalledWith('title', ':first-child');
+      expect(title_attr_spy).toHaveBeenCalledWith('id', `chart-title-` + givenId);
+      expect(title_text_spy).toHaveBeenNthCalledWith(2, 'the title');
+    });
+
+    it('inserts a desc tag as the 2nd child with the text set to accDescription returned by the diagram db', () => {
+      const faux_desc = new MockedD3();
+      const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_desc);
+      // @ts-ignore  Required to easily handle the d3 select types
+      const desc_attr_spy = vi.spyOn(faux_desc, 'attr').mockReturnValue(faux_desc);
+      const desc_text_spy = vi.spyOn(faux_desc, 'text');
+
+      addSVGa11yTitleDescription(testDiagramDb, fauxSvgNode, givenId);
+      expect(svg_insert_spy).toHaveBeenCalledWith('desc', ':first-child');
+      expect(desc_attr_spy).toHaveBeenCalledWith('id', `chart-desc-` + givenId);
+      expect(desc_text_spy).toHaveBeenNthCalledWith(1, 'the description');
+    });
+  });
+});
diff --git a/packages/mermaid/src/accessibility.ts b/packages/mermaid/src/accessibility.ts
new file mode 100644
index 000000000..246a88f66
--- /dev/null
+++ b/packages/mermaid/src/accessibility.ts
@@ -0,0 +1,45 @@
+/**
+ * Accessibility (a11y) functions, types, helpers
+ *
+ */
+
+// This is just a convenience alias to make it clear the type is a d3 object. (It's easier to make it 'any' instead of the comple typing set in d3)
+type D3object = any;
+
+/**
+ * Set the accessibility (a11y) information for the svg d3 object using the given diagram type
+ * Note that the svg element role _should_ be mapped to a 'graphics-document' by default. Thus we don't set it here, but can set it in the future if needed.
+ * @param svg - d3 object that contains the SVG HTML element
+ * @param diagramType - diagram name for to the aria-roledescription
+ */
+export function setA11yDiagramInfo(svg: D3object, diagramType: string) {
+  svg.attr('aria-roledescription', diagramType);
+}
+
+/**
+ * This method will add a basic title and description element to a chart. The yy parser will need to
+ * respond to getAccTitle and getAccDescription,
+ * where the accessible title is the title element on the chart.
+ *
+ * Note that the accessible title is generally _not_ displayed
+ * and the accessible description is never displayed.
+ *
+ *
+ * The following charts display their title as a visual and accessibility element: gantt.  TODO fix this
+ *
+ * @param diagramDb - the 'db' object/module for a diagram. Must respond to getAccTitle() and getAccDescription()
+ * @param svg - the d3 object that represents the svg element
+ * @param baseId - the id to use as the base for the title and description
+ */
+export function addSVGa11yTitleDescription(diagramDb: any, svg: D3object, baseId: string) {
+  if (typeof svg.insert === 'undefined') {
+    return;
+  }
+
+  const titleId = 'chart-title-' + baseId;
+  const descId = 'chart-desc-' + baseId;
+
+  svg.attr('aria-labelledby', titleId + ' ' + descId);
+  svg.insert('desc', ':first-child').attr('id', descId).text(diagramDb.getAccDescription());
+  svg.insert('title', ':first-child').attr('id', titleId).text(diagramDb.getAccTitle());
+}

From 0d9566dd711374a35fc872f4a327d4a518dfd04b Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Tue, 15 Nov 2022 13:48:35 -0800
Subject: [PATCH 016/129] diagrams: use a11y title,desc specific method (was
 renamed)

---
 packages/mermaid/src/diagrams/c4/c4Renderer.js                | 4 ++--
 packages/mermaid/src/diagrams/class/classRenderer-v2.js       | 4 ++--
 packages/mermaid/src/diagrams/class/classRenderer.js          | 4 ++--
 packages/mermaid/src/diagrams/er/erRenderer.js                | 4 ++--
 packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js    | 4 ++--
 packages/mermaid/src/diagrams/flowchart/flowRenderer.js       | 4 ++--
 packages/mermaid/src/diagrams/gantt/ganttRenderer.js          | 4 ++--
 packages/mermaid/src/diagrams/git/gitGraphRenderer.js         | 4 ++--
 packages/mermaid/src/diagrams/pie/pieRenderer.js              | 4 ++--
 .../mermaid/src/diagrams/requirement/requirementRenderer.js   | 4 ++--
 packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts    | 4 +++-
 packages/mermaid/src/diagrams/state/stateRenderer-v2.js       | 4 ++--
 packages/mermaid/src/diagrams/state/stateRenderer.js          | 4 ++--
 packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts | 3 ++-
 14 files changed, 29 insertions(+), 26 deletions(-)

diff --git a/packages/mermaid/src/diagrams/c4/c4Renderer.js b/packages/mermaid/src/diagrams/c4/c4Renderer.js
index a9072346a..a2d7813c6 100644
--- a/packages/mermaid/src/diagrams/c4/c4Renderer.js
+++ b/packages/mermaid/src/diagrams/c4/c4Renderer.js
@@ -8,7 +8,7 @@ import * as configApi from '../../config';
 import assignWithDepth from '../../assignWithDepth';
 import { wrapLabel, calculateTextWidth, calculateTextHeight } from '../../utils';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let globalBoundaryMaxX = 0,
   globalBoundaryMaxY = 0;
@@ -676,7 +676,7 @@ export const draw = function (_text, id, _version, diagObj) {
       (height + extraVertForTitle)
   );
 
-  addSVGAccessibilityFields(parser.yy, diagram, id);
+  addSVGa11yTitleDescription(parser.yy, diagram, id);
   log.debug(`models:`, box);
 };
 
diff --git a/packages/mermaid/src/diagrams/class/classRenderer-v2.js b/packages/mermaid/src/diagrams/class/classRenderer-v2.js
index fbc2e4833..75e7cdafb 100644
--- a/packages/mermaid/src/diagrams/class/classRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/class/classRenderer-v2.js
@@ -7,7 +7,7 @@ import { curveLinear } from 'd3';
 import { interpolateToCurve, getStylesFromArray } from '../../utils';
 import { setupGraphViewbox } from '../../setupGraphViewbox';
 import common from '../common/common';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let idCache = {};
 
@@ -452,7 +452,7 @@ export const draw = function (text, id, _version, diagObj) {
     }
   }
 
-  addSVGAccessibilityFields(diagObj.db, svg, id);
+  addSVGa11yTitleDescription(diagObj.db, svg, id);
   // If node has a link, wrap it in an anchor SVG object.
   // const keys = Object.keys(classes);
   // keys.forEach(function(key) {
diff --git a/packages/mermaid/src/diagrams/class/classRenderer.js b/packages/mermaid/src/diagrams/class/classRenderer.js
index 23b586192..4e4b31a82 100644
--- a/packages/mermaid/src/diagrams/class/classRenderer.js
+++ b/packages/mermaid/src/diagrams/class/classRenderer.js
@@ -5,7 +5,7 @@ import { log } from '../../logger';
 import svgDraw from './svgDraw';
 import { configureSvgSize } from '../../setupGraphViewbox';
 import { getConfig } from '../../config';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let idCache = {};
 const padding = 20;
@@ -272,7 +272,7 @@ export const draw = function (text, id, _version, diagObj) {
   const vBox = `${svgBounds.x - padding} ${svgBounds.y - padding} ${width} ${height}`;
   log.debug(`viewBox ${vBox}`);
   diagram.attr('viewBox', vBox);
-  addSVGAccessibilityFields(diagObj.db, diagram, id);
+  addSVGa11yTitleDescription(diagObj.db, diagram, id);
 };
 
 export default {
diff --git a/packages/mermaid/src/diagrams/er/erRenderer.js b/packages/mermaid/src/diagrams/er/erRenderer.js
index 323bb4607..f29eb44d7 100644
--- a/packages/mermaid/src/diagrams/er/erRenderer.js
+++ b/packages/mermaid/src/diagrams/er/erRenderer.js
@@ -5,7 +5,7 @@ import { getConfig } from '../../config';
 import { log } from '../../logger';
 import erMarkers from './erMarkers';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 import { parseGenericTypes } from '../common/common';
 import { v4 as uuid4 } from 'uuid';
 
@@ -657,7 +657,7 @@ export const draw = function (text, id, _version, diagObj) {
 
   svg.attr('viewBox', `${svgBounds.x - padding} ${svgBounds.y - padding} ${width} ${height}`);
 
-  addSVGAccessibilityFields(diagObj.db, svg, id);
+  addSVGa11yTitleDescription(diagObj.db, svg, id);
 }; // draw
 
 /**
diff --git a/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js b/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
index 6b7c4c1bf..a5f991a86 100644
--- a/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
@@ -10,7 +10,7 @@ import { log } from '../../logger';
 import common, { evaluate } from '../common/common';
 import { interpolateToCurve, getStylesFromArray } from '../../utils';
 import { setupGraphViewbox } from '../../setupGraphViewbox';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 const conf = {};
 export const setConf = function (cnf) {
@@ -431,7 +431,7 @@ export const draw = function (text, id, _version, diagObj) {
   const svg = root.select(`[id="${id}"]`);
 
   // Adds title and description to the flow chart
-  addSVGAccessibilityFields(diagObj.db, svg, id);
+  addSVGa11yTitleDescription(diagObj.db, svg, id);
 
   // Run the renderer. This is what draws the final graph.
   const element = root.select('#' + id + ' g');
diff --git a/packages/mermaid/src/diagrams/flowchart/flowRenderer.js b/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
index c403b7fe3..e9069ff4d 100644
--- a/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
+++ b/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
@@ -8,7 +8,7 @@ import common, { evaluate } from '../common/common';
 import { interpolateToCurve, getStylesFromArray } from '../../utils';
 import { setupGraphViewbox } from '../../setupGraphViewbox';
 import flowChartShapes from './flowChartShapes';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 const conf = {};
 export const setConf = function (cnf) {
@@ -418,7 +418,7 @@ export const draw = function (text, id, _version, diagObj) {
   const svg = root.select(`[id="${id}"]`);
 
   // Adds title and description to the flow chart
-  addSVGAccessibilityFields(diagObj.db, svg, id);
+  addSVGa11yTitleDescription(diagObj.db, svg, id);
 
   // Run the renderer. This is what draws the final graph.
   const element = root.select('#' + id + ' g');
diff --git a/packages/mermaid/src/diagrams/gantt/ganttRenderer.js b/packages/mermaid/src/diagrams/gantt/ganttRenderer.js
index 9501dd024..dc92be1f0 100644
--- a/packages/mermaid/src/diagrams/gantt/ganttRenderer.js
+++ b/packages/mermaid/src/diagrams/gantt/ganttRenderer.js
@@ -19,7 +19,7 @@ import {
 import common from '../common/common';
 import { getConfig } from '../../config';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 export const setConf = function () {
   log.debug('Something is calling, setConf, remove the call');
@@ -116,7 +116,7 @@ export const draw = function (text, id, version, diagObj) {
     .attr('y', conf.titleTopMargin)
     .attr('class', 'titleText');
 
-  addSVGAccessibilityFields(diagObj.db, svg, id);
+  addSVGa11yTitleDescription(diagObj.db, svg, id);
 
   /**
    * @param tasks
diff --git a/packages/mermaid/src/diagrams/git/gitGraphRenderer.js b/packages/mermaid/src/diagrams/git/gitGraphRenderer.js
index 71698a500..c9e02a1e4 100644
--- a/packages/mermaid/src/diagrams/git/gitGraphRenderer.js
+++ b/packages/mermaid/src/diagrams/git/gitGraphRenderer.js
@@ -1,7 +1,7 @@
 import { select } from 'd3';
 import { getConfig, setupGraphViewbox } from '../../diagram-api/diagramAPI';
 import { log } from '../../logger';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let allCommitsDict = {};
 
@@ -513,7 +513,7 @@ export const draw = function (txt, id, ver, diagObj) {
   const diagram = select(`[id="${id}"]`);
 
   // Adds title and description to the flow chart
-  addSVGAccessibilityFields(diagObj.db, diagram, id);
+  addSVGa11yTitleDescription(diagObj.db, diagram, id);
 
   drawCommits(diagram, allCommitsDict, false);
   if (gitGraphConfig.showBranches) {
diff --git a/packages/mermaid/src/diagrams/pie/pieRenderer.js b/packages/mermaid/src/diagrams/pie/pieRenderer.js
index 6cbb99fa3..daddfda86 100644
--- a/packages/mermaid/src/diagrams/pie/pieRenderer.js
+++ b/packages/mermaid/src/diagrams/pie/pieRenderer.js
@@ -3,7 +3,7 @@ import { select, scaleOrdinal, pie as d3pie, arc } from 'd3';
 import { log } from '../../logger';
 import { configureSvgSize } from '../../setupGraphViewbox';
 import * as configApi from '../../config';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let conf = configApi.getConfig();
 
@@ -53,7 +53,7 @@ export const draw = (txt, id, _version, diagObj) => {
     const diagram = root.select('#' + id);
     configureSvgSize(diagram, height, width, conf.pie.useMaxWidth);
 
-    addSVGAccessibilityFields(diagObj.db, diagram, id);
+    addSVGa11yTitleDescription(diagObj.db, diagram, id);
     // Set viewBox
     elem.setAttribute('viewBox', '0 0 ' + width + ' ' + height);
 
diff --git a/packages/mermaid/src/diagrams/requirement/requirementRenderer.js b/packages/mermaid/src/diagrams/requirement/requirementRenderer.js
index 79d67e76e..60f456f0b 100644
--- a/packages/mermaid/src/diagrams/requirement/requirementRenderer.js
+++ b/packages/mermaid/src/diagrams/requirement/requirementRenderer.js
@@ -6,7 +6,7 @@ import { configureSvgSize } from '../../setupGraphViewbox';
 import common from '../common/common';
 import markers from './requirementMarkers';
 import { getConfig } from '../../config';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let conf = {};
 let relCnt = 0;
@@ -364,7 +364,7 @@ export const draw = (text, id, _version, diagObj) => {
 
   svg.attr('viewBox', `${svgBounds.x - padding} ${svgBounds.y - padding} ${width} ${height}`);
   // Adds title and description to the requirements diagram
-  addSVGAccessibilityFields(diagObj.db, svg, id);
+  addSVGa11yTitleDescription(diagObj.db, svg, id);
 };
 
 export default {
diff --git a/packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts b/packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts
index fa943d658..bf8a512c1 100644
--- a/packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts
+++ b/packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts
@@ -9,9 +9,11 @@ import * as configApi from '../../config';
 import assignWithDepth from '../../assignWithDepth';
 import utils from '../../utils';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 import Diagram from '../../Diagram';
 
+// FIXME insert a11y title and desc
+
 let conf = {};
 
 export const bounds = {
diff --git a/packages/mermaid/src/diagrams/state/stateRenderer-v2.js b/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
index 1011fb6b1..d6bc821c4 100644
--- a/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
@@ -5,7 +5,7 @@ import { render } from '../../dagre-wrapper/index.js';
 import { log } from '../../logger';
 import { configureSvgSize } from '../../setupGraphViewbox';
 import common from '../common/common';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 import {
   DEFAULT_DIAGRAM_DIRECTION,
   DEFAULT_NESTED_DOC_DIR,
@@ -481,7 +481,7 @@ export const draw = function (text, id, _version, diag) {
     label.insertBefore(rect, label.firstChild);
     // }
   }
-  addSVGAccessibilityFields(diag.db, svg, id);
+  addSVGa11yTitleDescription(diag.db, svg, id);
 };
 
 export default {
diff --git a/packages/mermaid/src/diagrams/state/stateRenderer.js b/packages/mermaid/src/diagrams/state/stateRenderer.js
index 73717a645..b69d1aaee 100644
--- a/packages/mermaid/src/diagrams/state/stateRenderer.js
+++ b/packages/mermaid/src/diagrams/state/stateRenderer.js
@@ -6,7 +6,7 @@ import common from '../common/common';
 import { drawState, addTitleAndBox, drawEdge } from './shapes';
 import { getConfig } from '../../config';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
 
 // TODO Move conf object to main conf in mermaidAPI
 let conf;
@@ -97,7 +97,7 @@ export const draw = function (text, id, _version, diagObj) {
     'viewBox',
     `${bounds.x - conf.padding}  ${bounds.y - conf.padding} ` + width + ' ' + height
   );
-  addSVGAccessibilityFields(diagObj.db, diagram, id);
+  addSVGa11yTitleDescription(diagObj.db, diagram, id);
 };
 const getLabelWidth = (text) => {
   return text ? text.length * conf.fontSizeFactor : 1;
diff --git a/packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts b/packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts
index 3880a243a..5a2c1283d 100644
--- a/packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts
+++ b/packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts
@@ -3,7 +3,8 @@ import { select } from 'd3';
 import svgDraw from './svgDraw';
 import { getConfig } from '../../config';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import addSVGAccessibilityFields from '../../accessibility';
+import { addSVGa11yTitleDescription } from '../../accessibility';
+// FIXME insert a11y title and desc
 
 export const setConf = function (cnf) {
   const keys = Object.keys(cnf);

From d99707641b33908d87bb18896a3945213f165c08 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Tue, 15 Nov 2022 13:49:05 -0800
Subject: [PATCH 017/129] add "roledescription" to cSpell list of words (as in
 'aria-roledescription')

---
 cSpell.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/cSpell.json b/cSpell.json
index 08fce1d1c..3398361f4 100644
--- a/cSpell.json
+++ b/cSpell.json
@@ -60,6 +60,7 @@
     "podlite",
     "ranksep",
     "redmine",
+    "roledescription",
     "sandboxed",
     "setupgraphviewbox",
     "shiki",

From 1ad63d5b0b7a410fd9a1809c14bd95c1b0d927d7 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 16 Nov 2022 09:49:41 +0530
Subject: [PATCH 018/129] chore: Add working directory

---
 .github/workflows/release-preview-publish.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/release-preview-publish.yml b/.github/workflows/release-preview-publish.yml
index da12cb5cc..f5b70eedd 100644
--- a/.github/workflows/release-preview-publish.yml
+++ b/.github/workflows/release-preview-publish.yml
@@ -29,8 +29,8 @@ jobs:
         run: npm i json --global
 
       - name: Publish
+        working-directory: ./packages/mermaid
         run: |
-          cd packages/mermaid
           PREVIEW_VERSION=8
           VERSION=$(echo ${{github.ref}} | tail -c +20)-preview.$PREVIEW_VERSION
           echo $VERSION

From 503114c0eb76f1b3776fd7b5ac6007eac0c64060 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 16 Nov 2022 10:22:37 +0530
Subject: [PATCH 019/129] fix: Add commit count to release preview

---
 .github/workflows/release-preview-publish.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/release-preview-publish.yml b/.github/workflows/release-preview-publish.yml
index f5b70eedd..8bcfbc357 100644
--- a/.github/workflows/release-preview-publish.yml
+++ b/.github/workflows/release-preview-publish.yml
@@ -31,7 +31,7 @@ jobs:
       - name: Publish
         working-directory: ./packages/mermaid
         run: |
-          PREVIEW_VERSION=8
+          PREVIEW_VERSION=$(git log --oneline "origin/$GITHUB_REF_NAME" ^"origin/master" | wc -l)
           VERSION=$(echo ${{github.ref}} | tail -c +20)-preview.$PREVIEW_VERSION
           echo $VERSION
           npm version --no-git-tag-version --allow-same-version $VERSION

From 1d828fe8be8ee818c35df0a2c3dfe153d8d83e5a Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 16 Nov 2022 10:27:42 +0530
Subject: [PATCH 020/129] fix: Add commit count to release preview

---
 .github/workflows/release-preview-publish.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/release-preview-publish.yml b/.github/workflows/release-preview-publish.yml
index 8bcfbc357..f910c67b7 100644
--- a/.github/workflows/release-preview-publish.yml
+++ b/.github/workflows/release-preview-publish.yml
@@ -10,6 +10,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
+      - run: |
+          git fetch --no-tags --prune --depth=1 origin +refs/heads/master:refs/remotes/origin/master
 
       - uses: pnpm/action-setup@v2
 

From 52ee234c0fec0dc2a00e78844c193963d0359d7c Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 16 Nov 2022 10:31:07 +0530
Subject: [PATCH 021/129] fix: Fetch depth

---
 .github/workflows/release-preview-publish.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/release-preview-publish.yml b/.github/workflows/release-preview-publish.yml
index f910c67b7..ff57b4f58 100644
--- a/.github/workflows/release-preview-publish.yml
+++ b/.github/workflows/release-preview-publish.yml
@@ -11,7 +11,7 @@ jobs:
     steps:
       - uses: actions/checkout@v3
       - run: |
-          git fetch --no-tags --prune --depth=1 origin +refs/heads/master:refs/remotes/origin/master
+          git fetch --no-tags --prune --depth=0 origin +refs/heads/master:refs/remotes/origin/master
 
       - uses: pnpm/action-setup@v2
 

From e05e0f8ae35e7e6c1739a68b76361637aea9b18e Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 16 Nov 2022 10:31:49 +0530
Subject: [PATCH 022/129] fix: Fetch depth

---
 .github/workflows/release-preview-publish.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/release-preview-publish.yml b/.github/workflows/release-preview-publish.yml
index ff57b4f58..e9c4e46a3 100644
--- a/.github/workflows/release-preview-publish.yml
+++ b/.github/workflows/release-preview-publish.yml
@@ -11,7 +11,7 @@ jobs:
     steps:
       - uses: actions/checkout@v3
       - run: |
-          git fetch --no-tags --prune --depth=0 origin +refs/heads/master:refs/remotes/origin/master
+          git fetch --no-tags --prune origin +refs/heads/master:refs/remotes/origin/master
 
       - uses: pnpm/action-setup@v2
 

From 2092330eec603abfd673cf782762f217bd8b5e5c Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 16 Nov 2022 11:30:58 +0530
Subject: [PATCH 023/129] fix: Fetch depth

---
 .github/workflows/release-preview-publish.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/release-preview-publish.yml b/.github/workflows/release-preview-publish.yml
index e9c4e46a3..5f4936ab6 100644
--- a/.github/workflows/release-preview-publish.yml
+++ b/.github/workflows/release-preview-publish.yml
@@ -10,8 +10,8 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - run: |
-          git fetch --no-tags --prune origin +refs/heads/master:refs/remotes/origin/master
+        with:
+          fetch-depth: 0
 
       - uses: pnpm/action-setup@v2
 

From 03a11e103ec119660bf2e6b3a3294464591d0935 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 12:19:31 -0800
Subject: [PATCH 024/129] (minor) fix typo

---
 cypress/integration/rendering/stateDiagram-v2.spec.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cypress/integration/rendering/stateDiagram-v2.spec.js b/cypress/integration/rendering/stateDiagram-v2.spec.js
index 5b43c890c..adba68ed2 100644
--- a/cypress/integration/rendering/stateDiagram-v2.spec.js
+++ b/cypress/integration/rendering/stateDiagram-v2.spec.js
@@ -328,7 +328,7 @@ describe('State diagram', () => {
       }
     );
   });
-  it('v2 it should be possibel to use a choice', () => {
+  it('v2 it should be possible to use a choice', () => {
     imgSnapshotTest(
       `
   stateDiagram-v2

From 4d7496b8dd74a758186e54745e1d05dfc66a2000 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 12:21:45 -0800
Subject: [PATCH 025/129] add error checking (empty diagramType, title, desc)
 to a11y methods

---
 packages/mermaid/src/accessibility.spec.ts | 219 +++++++++++++++------
 packages/mermaid/src/accessibility.ts      |  59 +++---
 2 files changed, 194 insertions(+), 84 deletions(-)

diff --git a/packages/mermaid/src/accessibility.spec.ts b/packages/mermaid/src/accessibility.spec.ts
index 29a2f125d..7336284fe 100644
--- a/packages/mermaid/src/accessibility.spec.ts
+++ b/packages/mermaid/src/accessibility.spec.ts
@@ -1,73 +1,172 @@
-// Spec/tests for accessibility
-
+import { MockedD3 } from './tests/MockedD3';
 import { setA11yDiagramInfo, addSVGa11yTitleDescription } from './accessibility';
 
-import { MockedD3 } from './tests/MockedD3';
+describe('accessibility', () => {
+  const fauxSvgNode = new MockedD3();
 
-const fauxSvgNode = new MockedD3();
-
-const MockedDiagramDb = {
-  getAccTitle: vi.fn().mockReturnValue('the title'),
-  getAccDescription: vi.fn().mockReturnValue('the description'),
-};
-
-describe('setA11yDiagramInfo', () => {
-  it('sets the aria-roledescription to the diagram type', () => {
-    // @ts-ignore  Required to easily handle the d3 select types
-    const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
-    setA11yDiagramInfo(fauxSvgNode, 'flowchart');
-    expect(svg_attr_spy).toHaveBeenCalledWith('aria-roledescription', 'flowchart');
-  });
-});
-
-describe('addSVGa11yTitleDescription', () => {
-  const testDiagramDb = MockedDiagramDb;
-  const givenId = 'theBaseId';
-
-  describe('with the given svg d3 object:', () => {
-    it('does nothing if there is no insert defined', () => {
-      const noInsertSvg = {
-        attr: vi.fn(),
-      };
-      const noInsert_attr_spy = vi.spyOn(noInsertSvg, 'attr').mockReturnValue(noInsertSvg);
-      addSVGa11yTitleDescription(testDiagramDb, noInsertSvg, givenId);
-      expect(noInsert_attr_spy).not.toHaveBeenCalled();
-    });
-
-    it('sets aria-labelledby to the title id and the description id inserted as children', () => {
-      // @ts-ignore Required to easily handle the d3 select types
+  describe('setA11yDiagramInfo', () => {
+    it('sets the aria-roledescription to the diagram type', () => {
+      // @ts-ignore  Required to easily handle the d3 select types
       const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
-      addSVGa11yTitleDescription(testDiagramDb, fauxSvgNode, givenId);
-      expect(svg_attr_spy).toHaveBeenCalledWith(
-        'aria-labelledby',
-        `chart-title-${givenId} chart-desc-${givenId}`
-      );
+      setA11yDiagramInfo(fauxSvgNode, 'flowchart');
+      expect(svg_attr_spy).toHaveBeenCalledWith('aria-roledescription', 'flowchart');
     });
 
-    it('inserts a title tag as the first child with the text set to the accTitle returned by the diagram db', () => {
-      const faux_title = new MockedD3();
-      const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+    it('does nothing if the diagram type is empty', () => {
       // @ts-ignore  Required to easily handle the d3 select types
-      const title_attr_spy = vi.spyOn(faux_title, 'attr').mockReturnValue(faux_title);
-      const title_text_spy = vi.spyOn(faux_title, 'text');
-
-      addSVGa11yTitleDescription(testDiagramDb, fauxSvgNode, givenId);
-      expect(svg_insert_spy).toHaveBeenCalledWith('title', ':first-child');
-      expect(title_attr_spy).toHaveBeenCalledWith('id', `chart-title-` + givenId);
-      expect(title_text_spy).toHaveBeenNthCalledWith(2, 'the title');
+      const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+      setA11yDiagramInfo(fauxSvgNode, '');
+      expect(svg_attr_spy).not.toHaveBeenCalled();
     });
+  });
 
-    it('inserts a desc tag as the 2nd child with the text set to accDescription returned by the diagram db', () => {
-      const faux_desc = new MockedD3();
-      const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_desc);
-      // @ts-ignore  Required to easily handle the d3 select types
-      const desc_attr_spy = vi.spyOn(faux_desc, 'attr').mockReturnValue(faux_desc);
-      const desc_text_spy = vi.spyOn(faux_desc, 'text');
+  describe('addSVGa11yTitleDescription', () => {
+    const givenId = 'theBaseId';
 
-      addSVGa11yTitleDescription(testDiagramDb, fauxSvgNode, givenId);
-      expect(svg_insert_spy).toHaveBeenCalledWith('desc', ':first-child');
-      expect(desc_attr_spy).toHaveBeenCalledWith('id', `chart-desc-` + givenId);
-      expect(desc_text_spy).toHaveBeenNthCalledWith(1, 'the description');
+    describe('with the given svg d3 object:', () => {
+      it('does nothing if there is no insert defined', () => {
+        const noInsertSvg = {
+          attr: vi.fn(),
+        };
+        const noInsert_attr_spy = vi.spyOn(noInsertSvg, 'attr').mockReturnValue(noInsertSvg);
+        addSVGa11yTitleDescription(noInsertSvg, 'some title', 'some desc', givenId);
+        expect(noInsert_attr_spy).not.toHaveBeenCalled();
+      });
+
+      describe('given an a11y title', () => {
+        const a11yTitle = 'a11y title';
+
+        describe('given an a11y description', () => {
+          const a11yDesc = 'a11y description';
+
+          it('sets aria-labelledby to the title id and the description id inserted as children', () => {
+            // @ts-ignore Required to easily handle the d3 select types
+            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_attr_spy).toHaveBeenCalledWith(
+              'aria-labelledby',
+              `chart-title-${givenId} chart-desc-${givenId}`
+            );
+          });
+
+          it('inserts a title tag as the first child with the text set to the accTitle given', () => {
+            const faux_title = new MockedD3();
+            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+            // @ts-ignore  Required to easily handle the d3 select types
+            const title_attr_spy = vi.spyOn(faux_title, 'attr').mockReturnValue(faux_title);
+            const title_text_spy = vi.spyOn(faux_title, 'text');
+
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_insert_spy).toHaveBeenCalledWith('desc', ':first-child');
+            expect(title_attr_spy).toHaveBeenCalledWith('id', `chart-desc-` + givenId);
+            expect(title_text_spy).toHaveBeenNthCalledWith(1, 'a11y description');
+          });
+
+          it('inserts a desc tag as the 2nd child with the text set to accDescription given', () => {
+            const faux_desc = new MockedD3();
+            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_desc);
+            // @ts-ignore  Required to easily handle the d3 select types
+            const desc_attr_spy = vi.spyOn(faux_desc, 'attr').mockReturnValue(faux_desc);
+            const desc_text_spy = vi.spyOn(faux_desc, 'text');
+
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_insert_spy).toHaveBeenCalledWith('desc', ':first-child');
+            expect(desc_attr_spy).toHaveBeenCalledWith('id', `chart-desc-` + givenId);
+            expect(desc_text_spy).toHaveBeenNthCalledWith(1, 'a11y description');
+          });
+        });
+
+        describe(`no a11y description`, () => {
+          const a11yDesc = undefined;
+
+          it('sets aria-labelledby to the title id inserted as a child', () => {
+            // @ts-ignore Required to easily handle the d3 select types
+            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_attr_spy).toHaveBeenCalledWith('aria-labelledby', `chart-title-${givenId}`);
+          });
+
+          it('inserts a title tag as the first child with the text set to the accTitle given', () => {
+            const faux_title = new MockedD3();
+            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+            // @ts-ignore  Required to easily handle the d3 select types
+            const title_attr_spy = vi.spyOn(faux_title, 'attr').mockReturnValue(faux_title);
+            const title_text_spy = vi.spyOn(faux_title, 'text');
+
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_insert_spy).toHaveBeenCalledWith('title', ':first-child');
+            expect(title_attr_spy).toHaveBeenCalledWith('id', `chart-title-` + givenId);
+            expect(title_text_spy).toHaveBeenNthCalledWith(1, 'a11y title');
+          });
+
+          it('no description tag is inserted', () => {
+            const faux_title = new MockedD3();
+            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_insert_spy).not.toHaveBeenCalledWith('desc', ':first-child');
+          });
+        });
+      });
+
+      describe('no a11y title', () => {
+        const a11yTitle = undefined;
+
+        describe('given an a11y description', () => {
+          const a11yDesc = 'a11y description';
+
+          it('no title tag inserted', () => {
+            const faux_title = new MockedD3();
+            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_insert_spy).not.toHaveBeenCalledWith('title', ':first-child');
+          });
+
+          it('sets aria-labelledby to the description id inserted as a child', () => {
+            // @ts-ignore Required to easily handle the d3 select types
+            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_attr_spy).toHaveBeenCalledWith('aria-labelledby', `chart-desc-${givenId}`);
+          });
+
+          it('inserts a desc tag as a child with the text set to accDescription given', () => {
+            const faux_desc = new MockedD3();
+            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_desc);
+            // @ts-ignore  Required to easily handle the d3 select types
+            const desc_attr_spy = vi.spyOn(faux_desc, 'attr').mockReturnValue(faux_desc);
+            const desc_text_spy = vi.spyOn(faux_desc, 'text');
+
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_insert_spy).toHaveBeenCalledWith('desc', ':first-child');
+            expect(desc_attr_spy).toHaveBeenCalledWith('id', `chart-desc-` + givenId);
+            expect(desc_text_spy).toHaveBeenNthCalledWith(1, 'a11y description');
+          });
+        });
+
+        describe('no a11y description', () => {
+          const a11yDesc = undefined;
+
+          it('no title tag inserted', () => {
+            const faux_title = new MockedD3();
+            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_insert_spy).not.toHaveBeenCalledWith('title', ':first-child');
+          });
+
+          it('no description tag inserted', () => {
+            const faux_desc = new MockedD3();
+            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_desc);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_insert_spy).not.toHaveBeenCalledWith('desc', ':first-child');
+          });
+
+          it('no aria-labelledby is set', () => {
+            // @ts-ignore Required to easily handle the d3 select types
+            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_attr_spy).not.toHaveBeenCalled();
+          });
+        });
+      });
     });
   });
 });
diff --git a/packages/mermaid/src/accessibility.ts b/packages/mermaid/src/accessibility.ts
index 246a88f66..eff9a4edc 100644
--- a/packages/mermaid/src/accessibility.ts
+++ b/packages/mermaid/src/accessibility.ts
@@ -3,43 +3,54 @@
  *
  */
 
-// This is just a convenience alias to make it clear the type is a d3 object. (It's easier to make it 'any' instead of the comple typing set in d3)
+import { isEmpty, compact } from 'lodash';
+
+// This is just a convenience alias to make it clear the type is a d3 object. (It's easier to make it 'any' instead of the complete typing set in d3)
 type D3object = any;
 
 /**
- * Set the accessibility (a11y) information for the svg d3 object using the given diagram type
- * Note that the svg element role _should_ be mapped to a 'graphics-document' by default. Thus we don't set it here, but can set it in the future if needed.
+ * Add aria-roledescription to the svg element to the diagramType
+ *
  * @param svg - d3 object that contains the SVG HTML element
  * @param diagramType - diagram name for to the aria-roledescription
  */
-export function setA11yDiagramInfo(svg: D3object, diagramType: string) {
-  svg.attr('aria-roledescription', diagramType);
+export function setA11yDiagramInfo(svg: D3object, diagramType: string | null | undefined) {
+  if (!isEmpty(diagramType)) {
+    svg.attr('aria-roledescription', diagramType);
+  }
 }
-
 /**
- * This method will add a basic title and description element to a chart. The yy parser will need to
- * respond to getAccTitle and getAccDescription,
- * where the accessible title is the title element on the chart.
+ * Add an accessible title and/or description element to a chart.
+ * The title is usually not displayed and the description is never displayed.
  *
- * Note that the accessible title is generally _not_ displayed
- * and the accessible description is never displayed.
+ * The following charts display their title as a visual and accessibility element: gantt
  *
- *
- * The following charts display their title as a visual and accessibility element: gantt.  TODO fix this
- *
- * @param diagramDb - the 'db' object/module for a diagram. Must respond to getAccTitle() and getAccDescription()
- * @param svg - the d3 object that represents the svg element
- * @param baseId - the id to use as the base for the title and description
+ * @param svg - d3 node to insert the a11y title and desc info
+ * @param a11yTitle - a11y title. null and undefined are meaningful: means to skip it
+ * @param a11yDesc - a11y description.  null and undefined are meaningful: means to skip it
+ * @param baseId - id used to construct the a11y title and description id
  */
-export function addSVGa11yTitleDescription(diagramDb: any, svg: D3object, baseId: string) {
+export function addSVGa11yTitleDescription(
+  svg: D3object,
+  a11yTitle: string | null | undefined,
+  a11yDesc: string | null | undefined,
+  baseId: string
+) {
   if (typeof svg.insert === 'undefined') {
     return;
   }
 
-  const titleId = 'chart-title-' + baseId;
-  const descId = 'chart-desc-' + baseId;
-
-  svg.attr('aria-labelledby', titleId + ' ' + descId);
-  svg.insert('desc', ':first-child').attr('id', descId).text(diagramDb.getAccDescription());
-  svg.insert('title', ':first-child').attr('id', titleId).text(diagramDb.getAccTitle());
+  const titleId = a11yTitle ? 'chart-title-' + baseId : null;
+  const descId = a11yDesc ? 'chart-desc-' + baseId : null;
+  if (a11yTitle || a11yDesc) {
+    svg.attr('aria-labelledby', compact([titleId, descId]).join(' '));
+    if (a11yDesc) {
+      svg.insert('desc', ':first-child').attr('id', descId).text(a11yDesc);
+    }
+    if (a11yTitle) {
+      svg.insert('title', ':first-child').attr('id', titleId).text(a11yTitle);
+    }
+  } else {
+    return;
+  }
 }

From 8a3c4f64b2d05a8173a879474c3e139d0be3fb0b Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 12:23:01 -0800
Subject: [PATCH 026/129] MockedD3: node() return Element; add selectAll()

---
 packages/mermaid/src/tests/MockedD3.ts | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/packages/mermaid/src/tests/MockedD3.ts b/packages/mermaid/src/tests/MockedD3.ts
index d7c16b3a8..24cb9043f 100644
--- a/packages/mermaid/src/tests/MockedD3.ts
+++ b/packages/mermaid/src/tests/MockedD3.ts
@@ -1,12 +1,18 @@
 /**
  * This is a mocked/stubbed version of the d3 Selection type. Each of the main functions are all
  * mocked (via vi.fn()) so you can track if they have been called, etc.
+ *
+ * Note that node() returns a HTML Element with tag 'svg'. It is an empty element (no innerHTML, no children, etc).
+ * This potentially allows testing of mermaidAPI render().
  */
+
 export class MockedD3 {
   public attribs = new Map<string, string | null>();
   public id: string | undefined = '';
   _children: MockedD3[] = [];
 
+  _containingHTMLdoc = new Document();
+
   constructor(givenId = 'mock-id') {
     this.id = givenId;
   }
@@ -29,6 +35,11 @@ export class MockedD3 {
     return new MockedD3(cleanId);
   });
 
+  // This has the same implementation as select(). (It calls it.)
+  selectAll = vi.fn().mockImplementation(({ select_str = '' }): MockedD3 => {
+    return this.select(select_str);
+  });
+
   append = vi
     .fn()
     .mockImplementation(function (this: MockedD3, type: string, id = '' + '-appended'): MockedD3 {
@@ -87,9 +98,18 @@ export class MockedD3 {
     this.attribs.set('text', attrValue);
     return this;
   }
-  // NOTE: Arbitrarily returns an empty object. The return value could be something different with a mockReturnValue() or mockImplementation()
-  public node = vi.fn().mockReturnValue({});
 
+  // NOTE: Returns a HTML ELement with tag 'svg' that has _another_ 'svg' element child.
+  // This allows different tests to succeed -- some need a top level 'svg' and some need a 'svg' element to be the firstChild
+  // Real implementation returns an HTML Element
+  public node = vi.fn().mockImplementation(() => {
+    const topElem = this._containingHTMLdoc.createElement('svg');
+    const elem_svgChild = this._containingHTMLdoc.createElement('svg'); // another svg element
+    topElem.appendChild(elem_svgChild);
+    return topElem;
+  });
+
+  // TODO Is this correct? shouldn't it return a list of HTML Elements?
   nodes = vi.fn().mockImplementation(function (this: MockedD3): MockedD3[] {
     return this._children;
   });

From 1fc02940ae9fbb8c3f6ad892bd7202eed20638e8 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 12:24:16 -0800
Subject: [PATCH 027/129] move mocks specific to only seq spec files out of
 global d3 mock

---
 .../diagrams/sequence/sequenceDiagram.spec.js | 54 +++++++++++++++++++
 .../src/diagrams/sequence/svgDraw.spec.js     | 28 +++++++++-
 2 files changed, 81 insertions(+), 1 deletion(-)

diff --git a/packages/mermaid/src/diagrams/sequence/sequenceDiagram.spec.js b/packages/mermaid/src/diagrams/sequence/sequenceDiagram.spec.js
index 9422a5f37..6395940b0 100644
--- a/packages/mermaid/src/diagrams/sequence/sequenceDiagram.spec.js
+++ b/packages/mermaid/src/diagrams/sequence/sequenceDiagram.spec.js
@@ -1,8 +1,62 @@
+import { vi } from 'vitest';
+
 import * as configApi from '../../config';
 import mermaidAPI from '../../mermaidAPI';
 import Diagram from '../../Diagram';
 import { addDiagrams } from '../../diagram-api/diagram-orchestration';
+
+/**
+ * Sequence diagrams require their own very special version of a mocked d3 module
+ * diagrams/sequence/svgDraw uses statements like this with d3 nodes: (note the [0][0])
+ *
+ *   // in drawText(...)
+ *   textHeight += (textElem._groups || textElem)[0][0].getBBox().height;
+ */
+vi.mock('d3', () => {
+  const NewD3 = function () {
+    function returnThis() {
+      return this;
+    }
+    return {
+      append: function () {
+        return NewD3();
+      },
+      lower: returnThis,
+      attr: returnThis,
+      style: returnThis,
+      text: returnThis,
+      // [0][0] (below) is required by drawText() in packages/mermaid/src/diagrams/sequence/svgDraw.js
+      0: {
+        0: {
+          getBBox: function () {
+            return {
+              height: 10,
+              width: 20,
+            };
+          },
+        },
+      },
+    };
+  };
+
+  return {
+    select: function () {
+      return new NewD3();
+    },
+
+    selectAll: function () {
+      return new NewD3();
+    },
+
+    curveBasis: 'basis',
+    curveLinear: 'linear',
+    curveCardinal: 'cardinal',
+  };
+});
+// -------------------------------
+
 addDiagrams();
+
 /**
  * @param conf
  * @param key
diff --git a/packages/mermaid/src/diagrams/sequence/svgDraw.spec.js b/packages/mermaid/src/diagrams/sequence/svgDraw.spec.js
index 580dafe89..8e5f5f32b 100644
--- a/packages/mermaid/src/diagrams/sequence/svgDraw.spec.js
+++ b/packages/mermaid/src/diagrams/sequence/svgDraw.spec.js
@@ -1,5 +1,31 @@
+import { vi } from 'vitest';
 import svgDraw from './svgDraw';
-import { MockD3 } from 'd3';
+
+// This is the only place that uses this mock
+export const MockD3 = (name, parent) => {
+  const children = [];
+  const elem = {
+    get __children() {
+      return children;
+    },
+    get __name() {
+      return name;
+    },
+    get __parent() {
+      return parent;
+    },
+  };
+  elem.append = (name) => {
+    const mockElem = MockD3(name, elem);
+    children.push(mockElem);
+    return mockElem;
+  };
+  elem.lower = vi.fn(() => elem);
+  elem.attr = vi.fn(() => elem);
+  elem.text = vi.fn(() => elem);
+  elem.style = vi.fn(() => elem);
+  return elem;
+};
 
 describe('svgDraw', function () {
   describe('drawRect', function () {

From 1ad537bc4d44025a361546aa45a8291a248b4049 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 12:24:58 -0800
Subject: [PATCH 028/129] d3 mock: use MockedD3; remove sequence specific mock
 code

---
 __mocks__/d3.ts | 59 +++----------------------------------------------
 1 file changed, 3 insertions(+), 56 deletions(-)

diff --git a/__mocks__/d3.ts b/__mocks__/d3.ts
index 67f09b6f4..af35020c5 100644
--- a/__mocks__/d3.ts
+++ b/__mocks__/d3.ts
@@ -1,67 +1,14 @@
 // @ts-nocheck TODO: Fix TS
-import { vi } from 'vitest';
-
-const NewD3 = function () {
-  /**
-   *
-   */
-  function returnThis() {
-    return this;
-  }
-  return {
-    append: function () {
-      return NewD3();
-    },
-    lower: returnThis,
-    attr: returnThis,
-    style: returnThis,
-    text: returnThis,
-    0: {
-      0: {
-        getBBox: function () {
-          return {
-            height: 10,
-            width: 20,
-          };
-        },
-      },
-    },
-  };
-};
+import { MockedD3 } from '../packages/mermaid/src/tests/MockedD3';
 
 export const select = function () {
-  return new NewD3();
+  return new MockedD3();
 };
 
 export const selectAll = function () {
-  return new NewD3();
+  return new MockedD3();
 };
 
 export const curveBasis = 'basis';
 export const curveLinear = 'linear';
 export const curveCardinal = 'cardinal';
-
-export const MockD3 = (name, parent) => {
-  const children = [];
-  const elem = {
-    get __children() {
-      return children;
-    },
-    get __name() {
-      return name;
-    },
-    get __parent() {
-      return parent;
-    },
-  };
-  elem.append = (name) => {
-    const mockElem = MockD3(name, elem);
-    children.push(mockElem);
-    return mockElem;
-  };
-  elem.lower = vi.fn(() => elem);
-  elem.attr = vi.fn(() => elem);
-  elem.text = vi.fn(() => elem);
-  elem.style = vi.fn(() => elem);
-  return elem;
-};

From f62c5d9698d8738b7058ec8834c5d62e677d9178 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 12:25:14 -0800
Subject: [PATCH 029/129] add diagram renderer mocks

---
 __mocks__/c4Renderer.js          | 21 +++++++++++++++++++++
 __mocks__/classRenderer-v2.js    | 16 ++++++++++++++++
 __mocks__/classRenderer.js       | 13 +++++++++++++
 __mocks__/erRenderer.js          | 16 ++++++++++++++++
 __mocks__/flowRenderer-v2.js     | 24 ++++++++++++++++++++++++
 __mocks__/ganttRenderer.js       | 16 ++++++++++++++++
 __mocks__/gitGraphRenderer.js    | 13 +++++++++++++
 __mocks__/journeyRenderer.js     | 15 +++++++++++++++
 __mocks__/pieRenderer.js         | 13 +++++++++++++
 __mocks__/requirementRenderer.js | 13 +++++++++++++
 __mocks__/sequenceRenderer.js    | 23 +++++++++++++++++++++++
 __mocks__/stateRenderer-v2.js    | 22 ++++++++++++++++++++++
 12 files changed, 205 insertions(+)
 create mode 100644 __mocks__/c4Renderer.js
 create mode 100644 __mocks__/classRenderer-v2.js
 create mode 100644 __mocks__/classRenderer.js
 create mode 100644 __mocks__/erRenderer.js
 create mode 100644 __mocks__/flowRenderer-v2.js
 create mode 100644 __mocks__/ganttRenderer.js
 create mode 100644 __mocks__/gitGraphRenderer.js
 create mode 100644 __mocks__/journeyRenderer.js
 create mode 100644 __mocks__/pieRenderer.js
 create mode 100644 __mocks__/requirementRenderer.js
 create mode 100644 __mocks__/sequenceRenderer.js
 create mode 100644 __mocks__/stateRenderer-v2.js

diff --git a/__mocks__/c4Renderer.js b/__mocks__/c4Renderer.js
new file mode 100644
index 000000000..576d5d863
--- /dev/null
+++ b/__mocks__/c4Renderer.js
@@ -0,0 +1,21 @@
+/**
+ * Mocked C4Context diagram renderer
+ */
+
+import { vi } from 'vitest';
+
+export const drawPersonOrSystemArray = vi.fn();
+export const drawBoundary = vi.fn();
+
+export const setConf = vi.fn();
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  drawPersonOrSystemArray,
+  drawBoundary,
+  setConf,
+  draw,
+};
diff --git a/__mocks__/classRenderer-v2.js b/__mocks__/classRenderer-v2.js
new file mode 100644
index 000000000..1ad95806f
--- /dev/null
+++ b/__mocks__/classRenderer-v2.js
@@ -0,0 +1,16 @@
+/**
+ * Mocked class diagram v2 renderer
+ */
+
+import { vi } from 'vitest';
+
+export const setConf = vi.fn();
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  setConf,
+  draw,
+};
diff --git a/__mocks__/classRenderer.js b/__mocks__/classRenderer.js
new file mode 100644
index 000000000..1c20de4b1
--- /dev/null
+++ b/__mocks__/classRenderer.js
@@ -0,0 +1,13 @@
+/**
+ * Mocked class diagram renderer
+ */
+
+import { vi } from 'vitest';
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  draw,
+};
diff --git a/__mocks__/erRenderer.js b/__mocks__/erRenderer.js
new file mode 100644
index 000000000..845d641f7
--- /dev/null
+++ b/__mocks__/erRenderer.js
@@ -0,0 +1,16 @@
+/**
+ * Mocked er diagram renderer
+ */
+
+import { vi } from 'vitest';
+
+export const setConf = vi.fn();
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  setConf,
+  draw,
+};
diff --git a/__mocks__/flowRenderer-v2.js b/__mocks__/flowRenderer-v2.js
new file mode 100644
index 000000000..89cc86031
--- /dev/null
+++ b/__mocks__/flowRenderer-v2.js
@@ -0,0 +1,24 @@
+/**
+ * Mocked flow (flowchart) diagram v2 renderer
+ */
+
+import { vi } from 'vitest';
+
+export const setConf = vi.fn();
+export const addVertices = vi.fn();
+export const addEdges = vi.fn();
+export const getClasses = vi.fn().mockImplementation(() => {
+  return {};
+});
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  setConf,
+  addVertices,
+  addEdges,
+  getClasses,
+  draw,
+};
diff --git a/__mocks__/ganttRenderer.js b/__mocks__/ganttRenderer.js
new file mode 100644
index 000000000..957249832
--- /dev/null
+++ b/__mocks__/ganttRenderer.js
@@ -0,0 +1,16 @@
+/**
+ * Mocked gantt diagram renderer
+ */
+
+import { vi } from 'vitest';
+
+export const setConf = vi.fn();
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  setConf,
+  draw,
+};
diff --git a/__mocks__/gitGraphRenderer.js b/__mocks__/gitGraphRenderer.js
new file mode 100644
index 000000000..1daa82ca4
--- /dev/null
+++ b/__mocks__/gitGraphRenderer.js
@@ -0,0 +1,13 @@
+/**
+ * Mocked git (graph) diagram renderer
+ */
+
+import { vi } from 'vitest';
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  draw,
+};
diff --git a/__mocks__/journeyRenderer.js b/__mocks__/journeyRenderer.js
new file mode 100644
index 000000000..2bc77c0b1
--- /dev/null
+++ b/__mocks__/journeyRenderer.js
@@ -0,0 +1,15 @@
+/**
+ * Mocked pie (picChart) diagram renderer
+ */
+
+import { vi } from 'vitest';
+export const setConf = vi.fn();
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  setConf,
+  draw,
+};
diff --git a/__mocks__/pieRenderer.js b/__mocks__/pieRenderer.js
new file mode 100644
index 000000000..317c69901
--- /dev/null
+++ b/__mocks__/pieRenderer.js
@@ -0,0 +1,13 @@
+/**
+ * Mocked pie (picChart) diagram renderer
+ */
+
+import { vi } from 'vitest';
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  draw,
+};
diff --git a/__mocks__/requirementRenderer.js b/__mocks__/requirementRenderer.js
new file mode 100644
index 000000000..48d8997ac
--- /dev/null
+++ b/__mocks__/requirementRenderer.js
@@ -0,0 +1,13 @@
+/**
+ * Mocked requirement diagram renderer
+ */
+
+import { vi } from 'vitest';
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  draw,
+};
diff --git a/__mocks__/sequenceRenderer.js b/__mocks__/sequenceRenderer.js
new file mode 100644
index 000000000..11080c6bb
--- /dev/null
+++ b/__mocks__/sequenceRenderer.js
@@ -0,0 +1,23 @@
+/**
+ * Mocked sequence diagram renderer
+ */
+
+import { vi } from 'vitest';
+
+export const bounds = vi.fn();
+export const drawActors = vi.fn();
+export const drawActorsPopup = vi.fn();
+
+export const setConf = vi.fn();
+
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  bounds,
+  drawActors,
+  drawActorsPopup,
+  setConf,
+  draw,
+};
diff --git a/__mocks__/stateRenderer-v2.js b/__mocks__/stateRenderer-v2.js
new file mode 100644
index 000000000..a2d103b50
--- /dev/null
+++ b/__mocks__/stateRenderer-v2.js
@@ -0,0 +1,22 @@
+/**
+ * Mocked state diagram v2 renderer
+ */
+
+import { vi } from 'vitest';
+
+export const setConf = vi.fn();
+export const getClasses = vi.fn().mockImplementation(() => {
+  return {};
+});
+export const stateDomId = vi.fn().mockImplementation(() => {
+  return 'mocked-stateDiagram-stateDomId';
+});
+export const draw = vi.fn().mockImplementation(() => {
+  return '';
+});
+
+export default {
+  setConf,
+  getClasses,
+  draw,
+};

From 29efc116f340bc85fa670035b8d411ca957de3fe Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 12:27:17 -0800
Subject: [PATCH 030/129] put a11y into mermaidAPI render; add render spec
 (mock diagram renderers etc)

---
 docs/community/newDiagram.md            |  4 +-
 docs/config/setup/modules/mermaidAPI.md | 20 +++---
 packages/mermaid/src/mermaidAPI.spec.ts | 96 +++++++++++++++++++++++--
 packages/mermaid/src/mermaidAPI.ts      | 15 +++-
 4 files changed, 118 insertions(+), 17 deletions(-)

diff --git a/docs/community/newDiagram.md b/docs/community/newDiagram.md
index da86f9838..e49dd3749 100644
--- a/docs/community/newDiagram.md
+++ b/docs/community/newDiagram.md
@@ -214,7 +214,9 @@ The functions for setting title and description are provided by a common module.
       clear as commonClear,
     } from '../../commonDb';
 
-For rendering the accessibility tags you have again an existing function you can use.
+Starting with Mermaid version, the accessibility tags are inserted into the SVG element in the `render` function in mermaidAPI.
+
+In version \_\_\_ and before, you need to insert the accessibility tags in your renderer:
 
 **In the renderer:**
 
diff --git a/docs/config/setup/modules/mermaidAPI.md b/docs/config/setup/modules/mermaidAPI.md
index 0acfe4f97..baa4a939c 100644
--- a/docs/config/setup/modules/mermaidAPI.md
+++ b/docs/config/setup/modules/mermaidAPI.md
@@ -80,7 +80,7 @@ mermaid.initialize(config);
 
 #### Defined in
 
-[mermaidAPI.ts:949](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L949)
+[mermaidAPI.ts:960](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L960)
 
 ## Functions
 
@@ -111,7 +111,7 @@ Return the last node appended
 
 #### Defined in
 
-[mermaidAPI.ts:292](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L292)
+[mermaidAPI.ts:294](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L294)
 
 ---
 
@@ -137,7 +137,7 @@ the cleaned up svgCode
 
 #### Defined in
 
-[mermaidAPI.ts:243](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L243)
+[mermaidAPI.ts:245](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L245)
 
 ---
 
@@ -163,7 +163,7 @@ the string with all the user styles
 
 #### Defined in
 
-[mermaidAPI.ts:170](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L170)
+[mermaidAPI.ts:172](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L172)
 
 ---
 
@@ -186,7 +186,7 @@ the string with all the user styles
 
 #### Defined in
 
-[mermaidAPI.ts:220](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L220)
+[mermaidAPI.ts:222](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L222)
 
 ---
 
@@ -213,7 +213,7 @@ with an enclosing block that has each of the cssClasses followed by !important;
 
 #### Defined in
 
-[mermaidAPI.ts:154](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L154)
+[mermaidAPI.ts:156](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L156)
 
 ---
 
@@ -233,7 +233,7 @@ with an enclosing block that has each of the cssClasses followed by !important;
 
 #### Defined in
 
-[mermaidAPI.ts:128](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L128)
+[mermaidAPI.ts:130](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L130)
 
 ---
 
@@ -253,7 +253,7 @@ with an enclosing block that has each of the cssClasses followed by !important;
 
 #### Defined in
 
-[mermaidAPI.ts:99](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L99)
+[mermaidAPI.ts:101](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L101)
 
 ---
 
@@ -279,7 +279,7 @@ Put the svgCode into an iFrame. Return the iFrame code
 
 #### Defined in
 
-[mermaidAPI.ts:271](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L271)
+[mermaidAPI.ts:273](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L273)
 
 ---
 
@@ -305,4 +305,4 @@ Remove any existing elements from the given document
 
 #### Defined in
 
-[mermaidAPI.ts:343](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L343)
+[mermaidAPI.ts:345](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L345)
diff --git a/packages/mermaid/src/mermaidAPI.spec.ts b/packages/mermaid/src/mermaidAPI.spec.ts
index 786b163c4..fcc547546 100644
--- a/packages/mermaid/src/mermaidAPI.spec.ts
+++ b/packages/mermaid/src/mermaidAPI.spec.ts
@@ -1,6 +1,38 @@
 'use strict';
 import { vi } from 'vitest';
 
+// -------------------------------------
+//  Mocks and mocking
+
+import { MockedD3 } from './tests/MockedD3';
+
+// Note: If running this directly from within an IDE, the mocks directory must be at packages/mermaid/mocks
+vi.mock('d3');
+vi.mock('dagre-d3');
+
+// mermaidAPI.spec.ts:
+import * as accessibility from './accessibility'; // Import it this way so we can use spyOn(accessibility,...)
+vi.mock('./accessibility', () => ({
+  setA11yDiagramInfo: vi.fn(),
+  addSVGa11yTitleDescription: vi.fn(),
+}));
+
+// Mock the renderers specifically so we can test render(). Need to mock draw() for each renderer
+vi.mock('./diagrams/c4/c4Renderer');
+vi.mock('./diagrams/class/classRenderer');
+vi.mock('./diagrams/class/classRenderer-v2');
+vi.mock('./diagrams/er/erRenderer');
+vi.mock('./diagrams/flowchart/flowRenderer-v2');
+vi.mock('./diagrams/git/gitGraphRenderer');
+vi.mock('./diagrams/gantt/ganttRenderer');
+vi.mock('./diagrams/user-journey/journeyRenderer');
+vi.mock('./diagrams/pie/pieRenderer');
+vi.mock('./diagrams/requirement/requirementRenderer');
+vi.mock('./diagrams/sequence/sequenceRenderer');
+vi.mock('./diagrams/state/stateRenderer-v2');
+
+// -------------------------------------
+
 import mermaid from './mermaid';
 import { MermaidConfig } from './config.type';
 
@@ -37,7 +69,10 @@ vi.mock('stylis', () => {
 });
 import { compile, serialize } from 'stylis';
 
-import { MockedD3 } from './tests/MockedD3';
+/**
+ * @see https://vitest.dev/guide/mocking.html Mock part of a module
+ * To investigate how to mock just some methods from a module - call the actual implementation and then mock others, e.g. so they can be spied on
+ */
 
 // -------------------------------------------------------------------------------------
 
@@ -335,7 +370,8 @@ describe('mermaidAPI', function () {
             const htmlElements = ['> *', 'span'];
 
             it('creates CSS styles for every style and textStyle in every classDef', () => {
-              // @todo TODO Can't figure out how to spy on the cssImportantStyles method. That would be a much better approach than manually checking the result
+              // @todo TODO Can't figure out how to spy on the cssImportantStyles method.
+              //   That would be a much better approach than manually checking the result
 
               const styles = createCssStyles(mocked_config, graphType, classDefs);
               htmlElements.forEach((htmlElement) => {
@@ -373,7 +409,7 @@ describe('mermaidAPI', function () {
             const htmlElements = ['rect', 'polygon', 'ellipse', 'circle'];
 
             it('creates CSS styles for every style and textStyle in every classDef', () => {
-              // @todo TODO Can't figure out how to spy on the cssImportantStyles method. That would be a much better approach than manually checking the result
+              // TODO Can't figure out how to spy on the cssImportantStyles method. That would be a much better approach than manually checking the result.
 
               const styles = createCssStyles(mocked_config_no_htmlLabels, graphType, classDefs);
               htmlElements.forEach((htmlElement) => {
@@ -510,7 +546,7 @@ describe('mermaidAPI', function () {
       expect(config.testLiteral).toBe(true);
     });
 
-    it('copies a an object into the configuration', function () {
+    it('copies an object into the configuration', function () {
       const orgConfig: any = mermaidAPI.getConfig();
       expect(orgConfig.testObject).toBe(undefined);
 
@@ -616,6 +652,7 @@ describe('mermaidAPI', function () {
       expect(mermaidAPI.defaultConfig['logLevel']).toBe(5);
     });
   });
+
   describe('dompurify config', function () {
     it('allows dompurify config to be set', function () {
       mermaidAPI.initialize({ dompurifyConfig: { ADD_ATTR: ['onclick'] } });
@@ -623,6 +660,7 @@ describe('mermaidAPI', function () {
       expect(mermaidAPI!.getConfig()!.dompurifyConfig!.ADD_ATTR).toEqual(['onclick']);
     });
   });
+
   describe('parse', function () {
     mermaid.parseError = undefined; // ensure it parseError undefined
     it('throws for an invalid definition (with no mermaid.parseError() defined)', function () {
@@ -646,4 +684,54 @@ describe('mermaidAPI', function () {
       expect(mermaidAPI.parse('graph TD;A--x|text including URL space|B;')).toEqual(true);
     });
   });
+
+  describe('render', () => {
+    // These are more like integration tests right now because nothing is mocked.
+    // But it is faster that a cypress test and there's no real reason to actually evaluate an image pixel by pixel.
+
+    // render(id, text, cb?, svgContainingElement?)
+
+    // Test all diagram types.  Note that old flowchart 'graph' type will invoke the flowRenderer-v2. (See the flowchart v2 detector.)
+    // We have to have both the specific textDiagramType and the expected type name because the expected type may be slightly different than was is put in the diagram text (ex: in -v2 diagrams)
+    const diagramTypesAndExpectations = [
+      { textDiagramType: 'C4Context', expectedType: 'c4' },
+      { textDiagramType: 'classDiagram', expectedType: 'classDiagram' },
+      { textDiagramType: 'classDiagram-v2', expectedType: 'classDiagram' },
+      { textDiagramType: 'erDiagram', expectedType: 'er' },
+      { textDiagramType: 'graph', expectedType: 'flowchart-v2' },
+      { textDiagramType: 'flowchart', expectedType: 'flowchart-v2' },
+      { textDiagramType: 'gitGraph', expectedType: 'gitGraph' },
+      { textDiagramType: 'gantt', expectedType: 'gantt' },
+      { textDiagramType: 'journey', expectedType: 'journey' },
+      { textDiagramType: 'pie', expectedType: 'pie' },
+      { textDiagramType: 'requirementDiagram', expectedType: 'requirement' },
+      { textDiagramType: 'sequenceDiagram', expectedType: 'sequence' },
+      { textDiagramType: 'stateDiagram-v2', expectedType: 'stateDiagram' },
+    ];
+
+    describe('accessibility', () => {
+      const id = 'mermaid-fauxId';
+      const a11yTitle = 'a11y title';
+      const a11yDescr = 'a11y description';
+
+      diagramTypesAndExpectations.forEach((testedDiagram) => {
+        describe(`${testedDiagram.textDiagramType}`, () => {
+          const diagramType = testedDiagram.textDiagramType;
+          const diagramText = `${diagramType}\n accTitle: ${a11yTitle}\n accDescr: ${a11yDescr}\n`;
+          const expectedDiagramType = testedDiagram.expectedType;
+
+          it('aria-roledscription is set to the diagram type, addSVGa11yTitleDescription is called', () => {
+            const a11yDiagramInfo_spy = vi.spyOn(accessibility, 'setA11yDiagramInfo');
+            const a11yTitleDesc_spy = vi.spyOn(accessibility, 'addSVGa11yTitleDescription');
+            mermaidAPI.render(id, diagramText);
+            expect(a11yDiagramInfo_spy).toHaveBeenCalledWith(
+              expect.anything(),
+              expectedDiagramType
+            );
+            expect(a11yTitleDesc_spy).toHaveBeenCalled();
+          });
+        });
+      });
+    });
+  });
 });
diff --git a/packages/mermaid/src/mermaidAPI.ts b/packages/mermaid/src/mermaidAPI.ts
index 0df1da305..18076b488 100644
--- a/packages/mermaid/src/mermaidAPI.ts
+++ b/packages/mermaid/src/mermaidAPI.ts
@@ -29,6 +29,8 @@ import utils, { directiveSanitizer } from './utils';
 import DOMPurify from 'dompurify';
 import { MermaidConfig } from './config.type';
 import { evaluate } from './diagrams/common/common';
+import { setA11yDiagramInfo, addSVGa11yTitleDescription } from './accessibility';
+
 import { isEmpty } from 'lodash';
 
 // diagram names that support classDef statements
@@ -487,12 +489,13 @@ const render = function (
     parseEncounteredException = error;
   }
 
-  // Get the temporary div element containing the svg
+  // Get the temporary div element containing the svg (the parent HTML Element)
   const element = root.select(enclosingDivID_selector).node();
   const graphType = diag.type;
 
   // -------------------------------------------------------------------------------
   // Create and insert the styles (user styles, theme styles, config styles)
+  //  These are dealing with HTML Elements, not d3 nodes.
 
   // Insert an element into svg. This is where we put the styles
   const svg = element.firstChild;
@@ -509,6 +512,7 @@ const render = function (
     idSelector
   );
 
+  // svg is a HTML element (not a d3 node)
   const style1 = document.createElement('style');
   style1.innerHTML = `${idSelector} ` + rules;
   svg.insertBefore(style1, firstChild);
@@ -522,6 +526,13 @@ const render = function (
     throw e;
   }
 
+  // This is the d3 node for the svg element
+  const svgNode = root.select(`${enclosingDivID_selector} svg`);
+  setA11yDiagramInfo(svgNode, graphType);
+  const a11yTitle = diag.db.getAccTitle !== undefined ? diag.db.getAccTitle() : null;
+  const a11yDescr = diag.db.getAccDescription !== undefined ? diag.db.getAccDescription() : null;
+  addSVGa11yTitleDescription(svgNode, a11yTitle, a11yDescr, svgNode.attr('id'));
+
   // -------------------------------------------------------------------------------
   // Clean up SVG code
   root.select(`[id="${id}"]`).selectAll('foreignobject > *').attr('xmlns', XMLNS_XHTML_STD);
@@ -763,7 +774,7 @@ const renderAsync = async function (
   attachFunctions();
 
   // -------------------------------------------------------------------------------
-  // Remove the temporary element if appropriate
+  // Remove the temporary HTML element if appropriate
   const tmpElementSelector = isSandboxed ? iFrameID_selector : enclosingDivID_selector;
   const node = select(tmpElementSelector).node();
   if (node && 'remove' in node) {

From 0adc6a6112bca1d6461eb85ae7603b7fa7b3287f Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 12:28:11 -0800
Subject: [PATCH 031/129] remove a11y from individual diagrams; now happens in
 mermaidAPI render

---
 cypress/integration/rendering/gantt.spec.js   | 32 ---------
 .../integration/rendering/requirement.spec.js | 65 -------------------
 .../mermaid/src/diagrams/c4/c4Renderer.js     |  2 -
 .../src/diagrams/class/classRenderer-v2.js    |  2 -
 .../src/diagrams/class/classRenderer.js       |  2 -
 .../mermaid/src/diagrams/er/erRenderer.js     |  3 -
 .../src/diagrams/er/parser/erDiagram.spec.js  | 16 -----
 .../src/diagrams/flowchart/flowRenderer-v2.js |  4 --
 .../src/diagrams/flowchart/flowRenderer.js    |  4 --
 .../src/diagrams/gantt/ganttRenderer.js       |  3 -
 .../src/diagrams/git/gitGraphRenderer.js      |  4 --
 .../mermaid/src/diagrams/pie/pieRenderer.js   |  2 -
 .../requirement/requirementRenderer.js        |  3 -
 .../src/diagrams/sequence/sequenceRenderer.ts |  4 --
 .../src/diagrams/state/stateRenderer-v2.js    |  2 -
 .../src/diagrams/state/stateRenderer.js       |  2 -
 .../diagrams/user-journey/journeyRenderer.ts  |  4 --
 17 files changed, 154 deletions(-)

diff --git a/cypress/integration/rendering/gantt.spec.js b/cypress/integration/rendering/gantt.spec.js
index b75e682c6..c0156eee3 100644
--- a/cypress/integration/rendering/gantt.spec.js
+++ b/cypress/integration/rendering/gantt.spec.js
@@ -310,38 +310,6 @@ describe('Gantt diagram', () => {
     );
   });
 
-  it('should render accessibility tags', function () {
-    const expectedTitle = 'Gantt Diagram';
-    const expectedAccDescription = 'Tasks for Q4';
-    renderGraph(
-      `
-      gantt
-      accTitle: ${expectedTitle}
-      accDescr: ${expectedAccDescription}
-      dateFormat  YYYY-MM-DD
-      section Section
-      A task :a1, 2014-01-01, 30d
-      `,
-      {}
-    );
-    cy.get('svg').should((svg) => {
-      const el = svg.get(0);
-      const children = Array.from(el.children);
-
-      const titleEl = children.find(function (node) {
-        return node.tagName === 'title';
-      });
-      const descriptionEl = children.find(function (node) {
-        return node.tagName === 'desc';
-      });
-
-      expect(titleEl).to.exist;
-      expect(titleEl.textContent).to.equal(expectedTitle);
-      expect(descriptionEl).to.exist;
-      expect(descriptionEl.textContent).to.equal(expectedAccDescription);
-    });
-  });
-
   it('should render a gantt diagram with tick is 15 minutes', () => {
     imgSnapshotTest(
       `
diff --git a/cypress/integration/rendering/requirement.spec.js b/cypress/integration/rendering/requirement.spec.js
index be27f39fa..0bf9014bf 100644
--- a/cypress/integration/rendering/requirement.spec.js
+++ b/cypress/integration/rendering/requirement.spec.js
@@ -46,69 +46,4 @@ describe('Requirement diagram', () => {
     );
     cy.get('svg');
   });
-
-  it('should render accessibility tags', function () {
-    const expectedTitle = 'Gantt Diagram';
-    const expectedAccDescription = 'Tasks for Q4';
-    renderGraph(
-      `
-    requirementDiagram
-    accTitle: ${expectedTitle}
-    accDescr: ${expectedAccDescription}
-
-    requirement test_req {
-    id: 1
-    text: the test text.
-    risk: high
-    verifymethod: test
-    }
-
-    functionalRequirement test_req2 {
-    id: 1.1
-    text: the second test text.
-    risk: low
-    verifymethod: inspection
-    }
-
-    performanceRequirement test_req3 {
-    id: 1.2
-    text: the third test text.
-    risk: medium
-    verifymethod: demonstration
-    }
-
-    element test_entity {
-    type: simulation
-    }
-
-    element test_entity2 {
-    type: word doc
-    docRef: reqs/test_entity
-    }
-
-
-    test_entity - satisfies -> test_req2
-    test_req - traces -> test_req2
-    test_req - contains -> test_req3
-    test_req <- copies - test_entity2
-      `,
-      {}
-    );
-    cy.get('svg').should((svg) => {
-      const el = svg.get(0);
-      const children = Array.from(el.children);
-
-      const titleEl = children.find(function (node) {
-        return node.tagName === 'title';
-      });
-      const descriptionEl = children.find(function (node) {
-        return node.tagName === 'desc';
-      });
-
-      expect(titleEl).to.exist;
-      expect(titleEl.textContent).to.equal(expectedTitle);
-      expect(descriptionEl).to.exist;
-      expect(descriptionEl.textContent).to.equal(expectedAccDescription);
-    });
-  });
 });
diff --git a/packages/mermaid/src/diagrams/c4/c4Renderer.js b/packages/mermaid/src/diagrams/c4/c4Renderer.js
index a2d7813c6..580abbccc 100644
--- a/packages/mermaid/src/diagrams/c4/c4Renderer.js
+++ b/packages/mermaid/src/diagrams/c4/c4Renderer.js
@@ -8,7 +8,6 @@ import * as configApi from '../../config';
 import assignWithDepth from '../../assignWithDepth';
 import { wrapLabel, calculateTextWidth, calculateTextHeight } from '../../utils';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let globalBoundaryMaxX = 0,
   globalBoundaryMaxY = 0;
@@ -676,7 +675,6 @@ export const draw = function (_text, id, _version, diagObj) {
       (height + extraVertForTitle)
   );
 
-  addSVGa11yTitleDescription(parser.yy, diagram, id);
   log.debug(`models:`, box);
 };
 
diff --git a/packages/mermaid/src/diagrams/class/classRenderer-v2.js b/packages/mermaid/src/diagrams/class/classRenderer-v2.js
index 75e7cdafb..9c7002aa4 100644
--- a/packages/mermaid/src/diagrams/class/classRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/class/classRenderer-v2.js
@@ -7,7 +7,6 @@ import { curveLinear } from 'd3';
 import { interpolateToCurve, getStylesFromArray } from '../../utils';
 import { setupGraphViewbox } from '../../setupGraphViewbox';
 import common from '../common/common';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let idCache = {};
 
@@ -452,7 +451,6 @@ export const draw = function (text, id, _version, diagObj) {
     }
   }
 
-  addSVGa11yTitleDescription(diagObj.db, svg, id);
   // If node has a link, wrap it in an anchor SVG object.
   // const keys = Object.keys(classes);
   // keys.forEach(function(key) {
diff --git a/packages/mermaid/src/diagrams/class/classRenderer.js b/packages/mermaid/src/diagrams/class/classRenderer.js
index 4e4b31a82..b66222ccc 100644
--- a/packages/mermaid/src/diagrams/class/classRenderer.js
+++ b/packages/mermaid/src/diagrams/class/classRenderer.js
@@ -5,7 +5,6 @@ import { log } from '../../logger';
 import svgDraw from './svgDraw';
 import { configureSvgSize } from '../../setupGraphViewbox';
 import { getConfig } from '../../config';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let idCache = {};
 const padding = 20;
@@ -272,7 +271,6 @@ export const draw = function (text, id, _version, diagObj) {
   const vBox = `${svgBounds.x - padding} ${svgBounds.y - padding} ${width} ${height}`;
   log.debug(`viewBox ${vBox}`);
   diagram.attr('viewBox', vBox);
-  addSVGa11yTitleDescription(diagObj.db, diagram, id);
 };
 
 export default {
diff --git a/packages/mermaid/src/diagrams/er/erRenderer.js b/packages/mermaid/src/diagrams/er/erRenderer.js
index f29eb44d7..ac32a0287 100644
--- a/packages/mermaid/src/diagrams/er/erRenderer.js
+++ b/packages/mermaid/src/diagrams/er/erRenderer.js
@@ -5,7 +5,6 @@ import { getConfig } from '../../config';
 import { log } from '../../logger';
 import erMarkers from './erMarkers';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 import { parseGenericTypes } from '../common/common';
 import { v4 as uuid4 } from 'uuid';
 
@@ -656,8 +655,6 @@ export const draw = function (text, id, _version, diagObj) {
   configureSvgSize(svg, height, width, conf.useMaxWidth);
 
   svg.attr('viewBox', `${svgBounds.x - padding} ${svgBounds.y - padding} ${width} ${height}`);
-
-  addSVGa11yTitleDescription(diagObj.db, svg, id);
 }; // draw
 
 /**
diff --git a/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js b/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
index eb738fe4b..6131f7697 100644
--- a/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
+++ b/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
@@ -337,22 +337,6 @@ describe('when parsing ER diagram it...', function () {
     expect(erDb.getAccDescription()).toBe('this graph is about stuff');
   });
 
-  it('should allow for a accessibility title and multi line description (accDescr)', function () {
-    const teacherRole = 'is teacher of';
-    const line1 = `TEACHER }o--o{ STUDENT : "${teacherRole}"`;
-
-    erDiagram.parser.parse(
-      `erDiagram
-      accTitle: graph title
-      accDescr {
-        this graph is about stuff
-      }\n
-      ${line1}`
-    );
-    expect(erDb.getAccTitle()).toBe('graph title');
-    expect(erDb.getAccDescription()).toBe('this graph is about stuff');
-  });
-
   it('should allow more than one relationship between the same two entities', function () {
     const line1 = 'CAR ||--o{ PERSON : "insured for"';
     const line2 = 'CAR }o--|| PERSON : "owned by"';
diff --git a/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js b/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
index a5f991a86..437c5a120 100644
--- a/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
@@ -10,7 +10,6 @@ import { log } from '../../logger';
 import common, { evaluate } from '../common/common';
 import { interpolateToCurve, getStylesFromArray } from '../../utils';
 import { setupGraphViewbox } from '../../setupGraphViewbox';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 const conf = {};
 export const setConf = function (cnf) {
@@ -430,9 +429,6 @@ export const draw = function (text, id, _version, diagObj) {
   // Set up an SVG group so that we can translate the final graph.
   const svg = root.select(`[id="${id}"]`);
 
-  // Adds title and description to the flow chart
-  addSVGa11yTitleDescription(diagObj.db, svg, id);
-
   // Run the renderer. This is what draws the final graph.
   const element = root.select('#' + id + ' g');
   render(element, g, ['point', 'circle', 'cross'], 'flowchart', id);
diff --git a/packages/mermaid/src/diagrams/flowchart/flowRenderer.js b/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
index e9069ff4d..69eb8a9f3 100644
--- a/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
+++ b/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
@@ -8,7 +8,6 @@ import common, { evaluate } from '../common/common';
 import { interpolateToCurve, getStylesFromArray } from '../../utils';
 import { setupGraphViewbox } from '../../setupGraphViewbox';
 import flowChartShapes from './flowChartShapes';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 const conf = {};
 export const setConf = function (cnf) {
@@ -417,9 +416,6 @@ export const draw = function (text, id, _version, diagObj) {
   // Set up an SVG group so that we can translate the final graph.
   const svg = root.select(`[id="${id}"]`);
 
-  // Adds title and description to the flow chart
-  addSVGa11yTitleDescription(diagObj.db, svg, id);
-
   // Run the renderer. This is what draws the final graph.
   const element = root.select('#' + id + ' g');
   render(element, g);
diff --git a/packages/mermaid/src/diagrams/gantt/ganttRenderer.js b/packages/mermaid/src/diagrams/gantt/ganttRenderer.js
index dc92be1f0..9840cede4 100644
--- a/packages/mermaid/src/diagrams/gantt/ganttRenderer.js
+++ b/packages/mermaid/src/diagrams/gantt/ganttRenderer.js
@@ -19,7 +19,6 @@ import {
 import common from '../common/common';
 import { getConfig } from '../../config';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 export const setConf = function () {
   log.debug('Something is calling, setConf, remove the call');
@@ -116,8 +115,6 @@ export const draw = function (text, id, version, diagObj) {
     .attr('y', conf.titleTopMargin)
     .attr('class', 'titleText');
 
-  addSVGa11yTitleDescription(diagObj.db, svg, id);
-
   /**
    * @param tasks
    * @param pageWidth
diff --git a/packages/mermaid/src/diagrams/git/gitGraphRenderer.js b/packages/mermaid/src/diagrams/git/gitGraphRenderer.js
index c9e02a1e4..fdd07059c 100644
--- a/packages/mermaid/src/diagrams/git/gitGraphRenderer.js
+++ b/packages/mermaid/src/diagrams/git/gitGraphRenderer.js
@@ -1,7 +1,6 @@
 import { select } from 'd3';
 import { getConfig, setupGraphViewbox } from '../../diagram-api/diagramAPI';
 import { log } from '../../logger';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let allCommitsDict = {};
 
@@ -512,9 +511,6 @@ export const draw = function (txt, id, ver, diagObj) {
 
   const diagram = select(`[id="${id}"]`);
 
-  // Adds title and description to the flow chart
-  addSVGa11yTitleDescription(diagObj.db, diagram, id);
-
   drawCommits(diagram, allCommitsDict, false);
   if (gitGraphConfig.showBranches) {
     drawBranches(diagram, branches);
diff --git a/packages/mermaid/src/diagrams/pie/pieRenderer.js b/packages/mermaid/src/diagrams/pie/pieRenderer.js
index daddfda86..d02f97f3f 100644
--- a/packages/mermaid/src/diagrams/pie/pieRenderer.js
+++ b/packages/mermaid/src/diagrams/pie/pieRenderer.js
@@ -3,7 +3,6 @@ import { select, scaleOrdinal, pie as d3pie, arc } from 'd3';
 import { log } from '../../logger';
 import { configureSvgSize } from '../../setupGraphViewbox';
 import * as configApi from '../../config';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let conf = configApi.getConfig();
 
@@ -53,7 +52,6 @@ export const draw = (txt, id, _version, diagObj) => {
     const diagram = root.select('#' + id);
     configureSvgSize(diagram, height, width, conf.pie.useMaxWidth);
 
-    addSVGa11yTitleDescription(diagObj.db, diagram, id);
     // Set viewBox
     elem.setAttribute('viewBox', '0 0 ' + width + ' ' + height);
 
diff --git a/packages/mermaid/src/diagrams/requirement/requirementRenderer.js b/packages/mermaid/src/diagrams/requirement/requirementRenderer.js
index 60f456f0b..9b5675adf 100644
--- a/packages/mermaid/src/diagrams/requirement/requirementRenderer.js
+++ b/packages/mermaid/src/diagrams/requirement/requirementRenderer.js
@@ -6,7 +6,6 @@ import { configureSvgSize } from '../../setupGraphViewbox';
 import common from '../common/common';
 import markers from './requirementMarkers';
 import { getConfig } from '../../config';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 let conf = {};
 let relCnt = 0;
@@ -363,8 +362,6 @@ export const draw = (text, id, _version, diagObj) => {
   configureSvgSize(svg, height, width, conf.useMaxWidth);
 
   svg.attr('viewBox', `${svgBounds.x - padding} ${svgBounds.y - padding} ${width} ${height}`);
-  // Adds title and description to the requirements diagram
-  addSVGa11yTitleDescription(diagObj.db, svg, id);
 };
 
 export default {
diff --git a/packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts b/packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts
index bf8a512c1..356b1d4c4 100644
--- a/packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts
+++ b/packages/mermaid/src/diagrams/sequence/sequenceRenderer.ts
@@ -9,11 +9,8 @@ import * as configApi from '../../config';
 import assignWithDepth from '../../assignWithDepth';
 import utils from '../../utils';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 import Diagram from '../../Diagram';
 
-// FIXME insert a11y title and desc
-
 let conf = {};
 
 export const bounds = {
@@ -906,7 +903,6 @@ export const draw = function (_text: string, id: string, _version: string, diagO
       (height + extraVertForTitle)
   );
 
-  addSVGAccessibilityFields(diagObj.db, diagram, id);
   log.debug(`models:`, bounds.models);
 };
 
diff --git a/packages/mermaid/src/diagrams/state/stateRenderer-v2.js b/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
index e3255bc65..ca0cf039c 100644
--- a/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
@@ -5,7 +5,6 @@ import { render } from '../../dagre-wrapper/index.js';
 import { log } from '../../logger';
 import { configureSvgSize } from '../../setupGraphViewbox';
 import common from '../common/common';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 import {
   DEFAULT_DIAGRAM_DIRECTION,
   DEFAULT_NESTED_DOC_DIR,
@@ -472,7 +471,6 @@ export const draw = function (text, id, _version, diag) {
     label.insertBefore(rect, label.firstChild);
     // }
   }
-  addSVGa11yTitleDescription(diag.db, svg, id);
 };
 
 export default {
diff --git a/packages/mermaid/src/diagrams/state/stateRenderer.js b/packages/mermaid/src/diagrams/state/stateRenderer.js
index b69d1aaee..e4e882106 100644
--- a/packages/mermaid/src/diagrams/state/stateRenderer.js
+++ b/packages/mermaid/src/diagrams/state/stateRenderer.js
@@ -6,7 +6,6 @@ import common from '../common/common';
 import { drawState, addTitleAndBox, drawEdge } from './shapes';
 import { getConfig } from '../../config';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import { addSVGa11yTitleDescription } from '../../accessibility';
 
 // TODO Move conf object to main conf in mermaidAPI
 let conf;
@@ -97,7 +96,6 @@ export const draw = function (text, id, _version, diagObj) {
     'viewBox',
     `${bounds.x - conf.padding}  ${bounds.y - conf.padding} ` + width + ' ' + height
   );
-  addSVGa11yTitleDescription(diagObj.db, diagram, id);
 };
 const getLabelWidth = (text) => {
   return text ? text.length * conf.fontSizeFactor : 1;
diff --git a/packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts b/packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts
index 5a2c1283d..f3b6acb25 100644
--- a/packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts
+++ b/packages/mermaid/src/diagrams/user-journey/journeyRenderer.ts
@@ -3,8 +3,6 @@ import { select } from 'd3';
 import svgDraw from './svgDraw';
 import { getConfig } from '../../config';
 import { configureSvgSize } from '../../setupGraphViewbox';
-import { addSVGa11yTitleDescription } from '../../accessibility';
-// FIXME insert a11y title and desc
 
 export const setConf = function (cnf) {
   const keys = Object.keys(cnf);
@@ -122,8 +120,6 @@ export const draw = function (text, id, version, diagObj) {
   diagram.attr('viewBox', `${box.startx} -25 ${width} ${height + extraVertForTitle}`);
   diagram.attr('preserveAspectRatio', 'xMinYMin meet');
   diagram.attr('height', height + extraVertForTitle + 25);
-
-  addSVGAccessibilityFields(diagObj.db, diagram, id);
 };
 
 export const bounds = {

From 4fb4aa417cb5633e81ce49c1b87d7a695f49a56e Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 15:45:28 -0800
Subject: [PATCH 032/129] doc: revise A11y: fix multi-line ex, +describedby,
 alpha sort examples

---
 docs/community/newDiagram.md                  |  46 +-
 docs/config/accessibility.md                  | 409 +++++++++++-------
 .../mermaid/src/docs/config/accessibility.md  | 257 ++++++-----
 3 files changed, 417 insertions(+), 295 deletions(-)

diff --git a/docs/community/newDiagram.md b/docs/community/newDiagram.md
index e49dd3749..288af42cd 100644
--- a/docs/community/newDiagram.md
+++ b/docs/community/newDiagram.md
@@ -14,8 +14,8 @@ This would be to define a jison grammar for the new diagram type. That should st
 
 For instance:
 
-- the flowchart starts with the keyword graph.
-- the sequence diagram starts with the keyword sequenceDiagram
+- the flowchart starts with the keyword _graph_
+- the sequence diagram starts with the keyword _sequenceDiagram_
 
 #### Store data found during parsing
 
@@ -61,6 +61,11 @@ Place the renderer in the diagram folder.
 ### Step 3: Detection of the new diagram type
 
 The second thing to do is to add the capability to detect the new new diagram to type to the detectType in utils.js. The detection should return a key for the new diagram type.
+[This key will be used to as the aria roledescription](#aria-roledescription), so it should be a word that clearly describes the diagram type.
+For example, if your new diagram use a UML deployment diagram, a good key would be "UMLDeploymentDiagram" because assistive technologies such as a screen reader
+would voice that as "U-M-L Deployment diagram." Another good key would be "deploymentDiagram" because that would be voiced as "Deployment Diagram." A bad key would be "deployment" because that would not sufficiently describe the diagram.
+
+Note that the diagram type key does not have to be the same as the diagram keyword chosen for the [grammar](#grammar), but it is helpful if they are the same.
 
 ### Step 4: The final piece - triggering the rendering
 
@@ -168,17 +173,23 @@ It is probably a good idea to keep the handling similar to this in your new diag
 
 ## Accessibility
 
-The syntax for adding title and description looks like this:
+Mermaid automatically adds the following accessibility information for the diagram SVG HTML element:
 
-    accTitle: The title
-    accDescr: The description
+- aria-roledescription
+- accessible title
+- accessible description
 
-    accDescr {
-    	Syntax for a description text
-    	written on multiple lines.
-    }
+### aria-roledescription
 
-In a similar way to the directives the jison syntax are quite similar between the diagrams.
+The aria-roledescription is automatically set to [the diagram type](#step-3--detection-of-the-new-diagram-type) and inserted into the SVG element.
+
+See [the definition of aria-roledescription](https://www.w3.org/TR/wai-aria-1.1/#aria-roledescription) in [the Accessible Rich Internet Applications W3 standard.](https://www.w3.org/WAI/standards-guidelines/aria/)
+
+### accessible title and description
+
+The syntax for accessible titles and descriptions is described in [the Accessibility documenation section.](../config/accessibility.md)
+
+In a similar way to the directives, the jison syntax are quite similar between the diagrams.
 
 ```jison
 
@@ -214,20 +225,7 @@ The functions for setting title and description are provided by a common module.
       clear as commonClear,
     } from '../../commonDb';
 
-Starting with Mermaid version, the accessibility tags are inserted into the SVG element in the `render` function in mermaidAPI.
-
-In version \_\_\_ and before, you need to insert the accessibility tags in your renderer:
-
-**In the renderer:**
-
-```js
-import addSVGAccessibilityFields from '../../accessibility';
-
-/* ... */
-
-// Adds title and description to the flow chart
-addSVGAccessibilityFields(parser.yy, svg, id);
-```
+The accessibility title and description are inserted into the SVG element in the `render` function in mermaidAPI.
 
 ## Theming
 
diff --git a/docs/config/accessibility.md b/docs/config/accessibility.md
index 8fa4aa3ac..e5b96670e 100644
--- a/docs/config/accessibility.md
+++ b/docs/config/accessibility.md
@@ -10,118 +10,169 @@
 
 Now with Mermaid library in much wider use, we have started to work towards more accessible features, based on the feedback from the community.
 
-To begin with, we have added a new feature to Mermaid library, which is to support accessibility options, **Accessibility Title** and **Accessibility Description**.
+Adding accessibility means that the rich information communicated by visual diagrams can be made available to those using assistive technologies (and of course to search engines).
+[Read more about Accessible Rich Internet Applications and the W3 standards.](https://www.w3.org/WAI/standards-guidelines/aria/)
 
-This support for accessibility options is available for all the diagrams/chart types. Also, we have tired to keep the same format for the accessibility options, so that it is easy to understand and maintain.
+Mermaid will automatically insert the [aria-roledescription](#aria-roledescription) and, if provided in the diagram text by the diagram author, the [accessible title and description.](#accessible-title-and-description)
 
-## Defining Accessibility Options
+### aria-roledescription
 
-### Single line accessibility values
+The [aria-roledescription](https://www.w3.org/TR/wai-aria-1.1/#aria-roledescription) for the SVG HTML element is set to the diagram type key. (Note this may be slightly different than the keyword used for the diagram in the diagram text.)
 
-The diagram authors can now add the accessibility options in the diagram definition, using the `accTitle` and `accDescr` keywords, where each keyword is followed by `:` and the string value for title and description like:
+For example: The diagram type key for a state diagram is "stateDiagram". Here (a part of) the HTML of the SVG tag that shows the automatically inserted aria-roledscription set to "stateDiagram". _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
 
-- `accTitle: "Your Accessibility Title"` or
-- `accDescr: "Your Accessibility Description"`
+```html
+<svg
+  aria-roledescription="stateDiagram"
+  class="statediagram"
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%"
+  id="mermaid-1668720491568"
+></svg>
+```
 
-**When these two options are defined, they will add a corresponding `<title>` and `<desc>` tag in the SVG.**
+### Accessible Title and Description
 
-Let us take a look at the following example with a flowchart diagram:
+Support for accessible titles and descriptions is available for all diagrams/chart types. We have tried to keep the same keywords and format for all diagrams so that it is easy to understand and maintain.
+
+The accessible title and description will add `<title>` and `<desc>` elements within the SVG element and the [aria-labelledby](https://www.w3.org/TR/wai-aria/#aria-labelledby) and [aria-describedby](https://www.w3.org/TR/wai-aria/#aria-describedby) attributes in the SVG tag.
+
+Here is HTML that is generated, showing that the SVG element is labelled by the accessible title (id = `chart-title-mermaid-1668725057758`)
+and described by the accessible description (id = `chart-desc-mermaid-1668725057758` );
+and the accessible title element (text = "This is the accessible title")
+and the accessible description element (text = "This is an accessible description").
+
+_(Note that some of the SVG attributes and the SVG contents are omitted for clarity.)_
+
+```html
+<svg
+  aria-labelledby="chart-title-mermaid-1668725057758"
+  aria-describedby="chart-desc-mermaid-1668725057758"
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%"
+  id="mermaid-1668725057758"
+>
+  <title id="chart-title-mermaid-1668725057758">This is the accessible title</title>
+  <desc id="chart-desc-mermaid-1668725057758">This is an accessible description</desc>
+</svg>
+```
+
+Details for the syntax follow.
+
+#### accessible title
+
+The **accessible title** is specified with the **accTitle** _keyword_, followed by a colon (`:`), and the string value for the title.
+The string value ends at the end of the line. (It can only be a single line.)
+
+Ex: `accTitle: This is a single line title`
+
+See [the accTitle and accDescr usage examples](#acctitle-and-accdescr-usage-examples) for how this can be used in a diagram and the resulting HTML generated.
+
+#### accessible description
+
+An accessible description can be 1 line long (a single line) or many lines long.
+
+The **single line accessible description** is specified with the **accDescr** _keyword_, followed by a colon (`:`), followed by the string value for the description.
+
+Ex: `accDescr: This is a single line description.`
+
+A **multiple line accessible description** _does not have a colon (`:`) after the accDescr keyword_ and is surrounded by curly brackets (`{}`).
+
+Ex:
+
+    accDescr { The official Bob's Burgers corporate processes that are used
+            for making very, very big decisions.
+            This is actually a very simple flow: see the big decision and then make the big decision.}
+
+See [the accTitle and accDescr usage examples](#acctitle-and-accdescr-usage-examples) for how this can be used in a diagram and the resulting HTML generated.
+
+#### accTitle and accDescr Usage Examples
+
+- Flowchart with the accessible title "Big Decisions" and the single-line accessible description "Bob's Burgers process for making big decisions"
 
 ```mermaid-example
-   graph LR
-      accTitle: Big decisions
-      accDescr: Flow chart of the decision making process
-      A[Hard] -->|Text| B(Round)
-      B --> C{Decision}
-      C -->|One| D[Result 1]
-
+  graph LR
+      accTitle: Big Decisions
+      accDescr: Bob's Burgers process for making big decisions
+      A[Identify Big Descision] --> B{Make Big Decision}
+      B --> D[Be done]
 ```
 
 ```mermaid
-   graph LR
-      accTitle: Big decisions
-      accDescr: Flow chart of the decision making process
-      A[Hard] -->|Text| B(Round)
-      B --> C{Decision}
-      C -->|One| D[Result 1]
-
+  graph LR
+      accTitle: Big Decisions
+      accDescr: Bob's Burgers process for making big decisions
+      A[Identify Big Descision] --> B{Make Big Decision}
+      B --> D[Be done]
 ```
 
-See in the code snippet above, the `accTitle` and `accDescr` are defined in the diagram definition. They result in the following tags in SVG code:
+Here is the HTML generated for the SVG element: _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
 
-![Accessibility options rendered inside SVG](img/accessibility-div-example.png)
+```html
+<svg
+  aria-labelledby="chart-title-mermaid_382ee221"
+  aria-describedby="chart-desc-mermaid_382ee221"
+  aria-roledescription="flowchart-v2"
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%"
+  id="mermaid_382ee221"
+>
+  <title id="chart-title-mermaid_382ee221">Big decisions</title>
+  <desc id="chart-desc-mermaid_382ee221">Bob's Burgers process for making big decisions</desc>
+</svg>
+```
 
-### Multi-line Accessibility title/description
-
-You can also define the accessibility options in a multi-line format, where the keyword is followed by opening curly bracket `{` and then multiple lines, followed by a closing `}`.
-
-`accTitle: My single line title value` (**_single line format_**)
-
-vs
-
-`accDescr: { My multi-line description of the diagram }` (**_multi-line format_**)
-
-Let us look at it in the following example, with same flowchart:
+- Flowchart with the accessible title "Bob's Burger's Making Big Decisions" and the multiple line accessible description "The official Bob's Burgers corporate processes that are used
+  for making very, very big decisions.
+  This is actually a very simple flow: identify the big decision and then make the big decision."
 
 ```mermaid-example
-   graph LR
-      accTitle: Big decisions
-
+  graph LR
+      accTitle: Bob's Burger's Making Big Decisions
       accDescr {
-        My multi-line description
-        of the diagram
-      }
-
-      A[Hard] -->|Text| B(Round)
-      B --> C{Decision}
-      C -->|One| D[Result 1]
-
+        The official Bob's Burgers corporate processes that are used
+        for making very, very big decisions.
+        This is actually a very simple flow: identify the big decision and then make the big decision.
+         }
+      A[Identify Big Descision] --> B{Make Big Decision}
+      B --> D[Be done]
 ```
 
 ```mermaid
-   graph LR
-      accTitle: Big decisions
-
+  graph LR
+      accTitle: Bob's Burger's Making Big Decisions
       accDescr {
-        My multi-line description
-        of the diagram
-      }
-
-      A[Hard] -->|Text| B(Round)
-      B --> C{Decision}
-      C -->|One| D[Result 1]
-
+        The official Bob's Burgers corporate processes that are used
+        for making very, very big decisions.
+        This is actually a very simple flow: identify the big decision and then make the big decision.
+         }
+      A[Identify Big Descision] --> B{Make Big Decision}
+      B --> D[Be done]
 ```
 
-See in the code snippet above, the `accTitle` and `accDescr` are defined in the diagram definition. They result in the following tags in SVG code:
+Here is the HTML generated for the SVG element: _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
 
-![Accessibility options rendered inside SVG](img/accessibility-div-example-2.png)
-
-### Sample Code Snippet for other diagram types
-
-#### Sequence Diagram
-
-```mermaid-example
-   sequenceDiagram
-      accTitle: My Sequence Diagram
-      accDescr: My Sequence Diagram Description
-
-      Alice->>John: Hello John, how are you?
-      John-->>Alice: Great!
-      Alice-)John: See you later!
+```html
+<svg
+  aria-labelledby="chart-title-mermaid_382ee221"
+  aria-describedby="chart-desc-mermaid_382ee221"
+  aria-roledescription="flowchart-v2"
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%"
+  id="mermaid_382ee221"
+>
+  <title id="chart-title-mermaid_382ee221">Big decisions</title>
+  <desc id="chart-desc-mermaid_382ee221">
+    The official Bob's Burgers corporate processes that are used for making very, very big
+    decisions. This is actually a very simple flow: identify the big decision and then make the big
+    decision.
+  </desc>
+</svg>
 ```
 
-```mermaid
-   sequenceDiagram
-      accTitle: My Sequence Diagram
-      accDescr: My Sequence Diagram Description
+#### Sample Code Snippets for other diagram types
 
-      Alice->>John: Hello John, how are you?
-      John-->>Alice: Great!
-      Alice-)John: See you later!
-```
-
-#### Class Diagram
+##### Class Diagram
 
 ```mermaid-example
    classDiagram
@@ -139,27 +190,7 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
       Vehicle <|-- Car
 ```
 
-#### State Diagram
-
-```mermaid-example
-   stateDiagram
-      accTitle: My State Diagram
-      accDescr: My State Diagram Description
-
-       s1 --> s2
-
-```
-
-```mermaid
-   stateDiagram
-      accTitle: My State Diagram
-      accDescr: My State Diagram Description
-
-       s1 --> s2
-
-```
-
-#### Entity Relationship Diagram
+##### Entity Relationship Diagram
 
 ```mermaid-example
    erDiagram
@@ -183,41 +214,7 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
 
 ```
 
-#### User Journey Diagram
-
-```mermaid-example
-  journey
-      accTitle: My User Journey Diagram
-      accDescr: My User Journey Diagram Description
-
-      title My working day
-      section Go to work
-        Make tea: 5: Me
-        Go upstairs: 3: Me
-        Do work: 1: Me, Cat
-      section Go home
-        Go downstairs: 5: Me
-        Sit down: 5: Me
-
-```
-
-```mermaid
-  journey
-      accTitle: My User Journey Diagram
-      accDescr: My User Journey Diagram Description
-
-      title My working day
-      section Go to work
-        Make tea: 5: Me
-        Go upstairs: 3: Me
-        Do work: 1: Me, Cat
-      section Go home
-        Go downstairs: 5: Me
-        Sit down: 5: Me
-
-```
-
-#### Gantt Chart
+##### Gantt Chart
 
 ```mermaid-example
    gantt
@@ -251,7 +248,45 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
 
 ```
 
-#### Pie Chart
+##### Gitgraph
+
+```mermaid-example
+  gitGraph
+      accTitle: My Gitgraph Accessibility Title
+      accDescr: My Gitgraph Accessibility Description
+
+     commit
+     commit
+     branch develop
+     checkout develop
+     commit
+     commit
+     checkout main
+     merge develop
+     commit
+     commit
+
+```
+
+```mermaid
+  gitGraph
+      accTitle: My Gitgraph Accessibility Title
+      accDescr: My Gitgraph Accessibility Description
+
+     commit
+     commit
+     branch develop
+     checkout develop
+     commit
+     commit
+     checkout main
+     merge develop
+     commit
+     commit
+
+```
+
+##### Pie Chart
 
 ```mermaid-example
    pie
@@ -279,7 +314,7 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
 
 ```
 
-#### Requirement Diagram
+##### Requirement Diagram
 
 ```mermaid-example
   requirementDiagram
@@ -321,40 +356,78 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
 
 ```
 
-#### Gitgraph
+##### Sequence Diagram
 
 ```mermaid-example
-  gitGraph
-      accTitle: My Gitgraph Accessibility Title
-      accDescr: My Gitgraph Accessibility Description
+   sequenceDiagram
+      accTitle: My Sequence Diagram
+      accDescr: My Sequence Diagram Description
 
-     commit
-     commit
-     branch develop
-     checkout develop
-     commit
-     commit
-     checkout main
-     merge develop
-     commit
-     commit
+      Alice->>John: Hello John, how are you?
+      John-->>Alice: Great!
+      Alice-)John: See you later!
+```
+
+```mermaid
+   sequenceDiagram
+      accTitle: My Sequence Diagram
+      accDescr: My Sequence Diagram Description
+
+      Alice->>John: Hello John, how are you?
+      John-->>Alice: Great!
+      Alice-)John: See you later!
+```
+
+##### State Diagram
+
+```mermaid-example
+   stateDiagram
+      accTitle: My State Diagram
+      accDescr: My State Diagram Description
+
+       s1 --> s2
 
 ```
 
 ```mermaid
-  gitGraph
-      accTitle: My Gitgraph Accessibility Title
-      accDescr: My Gitgraph Accessibility Description
+   stateDiagram
+      accTitle: My State Diagram
+      accDescr: My State Diagram Description
 
-     commit
-     commit
-     branch develop
-     checkout develop
-     commit
-     commit
-     checkout main
-     merge develop
-     commit
-     commit
+       s1 --> s2
+
+```
+
+##### User Journey Diagram
+
+```mermaid-example
+  journey
+      accTitle: My User Journey Diagram
+      accDescr: My User Journey Diagram Description
+
+      title My working day
+      section Go to work
+        Make tea: 5: Me
+        Go upstairs: 3: Me
+        Do work: 1: Me, Cat
+      section Go home
+        Go downstairs: 5: Me
+        Sit down: 5: Me
+
+```
+
+```mermaid
+  journey
+      accTitle: My User Journey Diagram
+      accDescr: My User Journey Diagram Description
+
+      title My working day
+      section Go to work
+        Make tea: 5: Me
+        Go upstairs: 3: Me
+        Do work: 1: Me, Cat
+      section Go home
+        Go downstairs: 5: Me
+        Sit down: 5: Me
 
 ```
diff --git a/packages/mermaid/src/docs/config/accessibility.md b/packages/mermaid/src/docs/config/accessibility.md
index ade20a839..5545ce1bc 100644
--- a/packages/mermaid/src/docs/config/accessibility.md
+++ b/packages/mermaid/src/docs/config/accessibility.md
@@ -4,83 +4,121 @@
 
 Now with Mermaid library in much wider use, we have started to work towards more accessible features, based on the feedback from the community.
 
-To begin with, we have added a new feature to Mermaid library, which is to support accessibility options, **Accessibility Title** and **Accessibility Description**.
+Adding accessibility means that the rich information communicated by visual diagrams can be made available to those using assistive technologies (and of course to search engines).
+[Read more about Accessible Rich Internet Applications and the W3 standards.](https://www.w3.org/WAI/standards-guidelines/aria/)
 
-This support for accessibility options is available for all the diagrams/chart types. Also, we have tired to keep the same format for the accessibility options, so that it is easy to understand and maintain.
+Mermaid will automatically insert the [aria-roledescription](#aria-roledescription) and, if provided in the diagram text by the diagram author, the [accessible title and description.](#accessible-title-and-description) 
 
-## Defining Accessibility Options
+### aria-roledescription
 
-### Single line accessibility values
+The [aria-roledescription](https://www.w3.org/TR/wai-aria-1.1/#aria-roledescription) for the SVG HTML element is set to the diagram type key.  (Note this may be slightly different than the keyword used for the diagram in the diagram text.)
 
-The diagram authors can now add the accessibility options in the diagram definition, using the `accTitle` and `accDescr` keywords, where each keyword is followed by `:` and the string value for title and description like:
+For example: The diagram type key for a state diagram is "stateDiagram". Here (a part of) the HTML of the SVG tag that shows the automatically inserted aria-roledscription set to "stateDiagram". _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
+```html
+<svg aria-roledescription="stateDiagram"  class="statediagram" xmlns="http://www.w3.org/2000/svg" width="100%" id="mermaid-1668720491568">
+```
 
-- `accTitle: "Your Accessibility Title"` or
-- `accDescr: "Your Accessibility Description"`
+### Accessible Title and Description
 
-**When these two options are defined, they will add a corresponding `<title>` and `<desc>` tag in the SVG.**
+Support for accessible titles and descriptions is available for all diagrams/chart types. We have tried to keep the same keywords and format for all diagrams so that it is easy to understand and maintain.
 
-Let us take a look at the following example with a flowchart diagram:
+The accessible title and description will add `<title>` and `<desc>` elements within the SVG element and the [aria-labelledby](https://www.w3.org/TR/wai-aria/#aria-labelledby) and [aria-describedby](https://www.w3.org/TR/wai-aria/#aria-describedby) attributes in the SVG tag.
+
+Here is HTML that is generated, showing that the SVG element is labelled by the accessible title (id = `chart-title-mermaid-1668725057758`)
+and described by the accessible description (id = `chart-desc-mermaid-1668725057758` );
+and the accessible title element (text = "This is the accessible title")
+and the accessible description element (text = "This is an accessible description").
+
+_(Note that some of the SVG attributes and the SVG contents are omitted for clarity.)_
+
+```html
+<svg aria-labelledby="chart-title-mermaid-1668725057758" aria-describedby="chart-desc-mermaid-1668725057758"  xmlns="http://www.w3.org/2000/svg" width="100%" id="mermaid-1668725057758">
+  <title id="chart-title-mermaid-1668725057758">This is the accessible title</title>
+  <desc id="chart-desc-mermaid-1668725057758">This is an accessible description</desc>
+```
+
+Details for the syntax follow.
+
+
+#### accessible title
+The **accessible title** is specified with the **accTitle** _keyword_, followed by a colon (`:`), and the string value for the title.
+The string value ends at the end of the line. (It can only be a single line.)
+ 
+Ex: `accTitle: This is a single line title` 
+
+See [the accTitle and accDescr usage examples](#acctitle-and-accdescr-usage-examples) for how this can be used in a diagram and the resulting HTML generated.
+
+
+#### accessible description
+
+An accessible description can be 1 line long (a single line) or many lines long.
+
+The **single line accessible description** is specified with the **accDescr** _keyword_, followed by a colon (`:`), followed by the string value for the description.
+
+Ex: `accDescr: This is a single line description.`
+
+A **multiple line accessible description** _does not have a colon (`:`) after the accDescr keyword_ and is surrounded by curly brackets (`{}`).
+
+Ex:
+```
+accDescr { The official Bob's Burgers corporate processes that are used
+        for making very, very big decisions.
+        This is actually a very simple flow: see the big decision and then make the big decision.}
+```
+
+See [the accTitle and accDescr usage examples](#acctitle-and-accdescr-usage-examples) for how this can be used in a diagram and the resulting HTML generated.
+
+
+#### accTitle and accDescr Usage Examples
+
+- Flowchart with the accessible title "Big Decisions" and the single-line accessible description "Bob's Burgers process for making big decisions"
 
 ```mermaid-example
-   graph LR
-      accTitle: Big decisions
-      accDescr: Flow chart of the decision making process
-      A[Hard] -->|Text| B(Round)
-      B --> C{Decision}
-      C -->|One| D[Result 1]
+  graph LR
+      accTitle: Big Decisions
+      accDescr: Bob's Burgers process for making big decisions
+      A[Identify Big Descision] --> B{Make Big Decision}
+      B --> D[Be done]
+```
+
+Here is the HTML generated for the SVG element: _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
+```html
+<svg aria-labelledby="chart-title-mermaid_382ee221" aria-describedby="chart-desc-mermaid_382ee221" aria-roledescription="flowchart-v2"  xmlns="http://www.w3.org/2000/svg" width="100%" id="mermaid_382ee221">
+  <title id="chart-title-mermaid_382ee221">Big decisions</title>
+  <desc id="chart-desc-mermaid_382ee221">Bob's Burgers process for making big decisions</desc>
 
 ```
 
-See in the code snippet above, the `accTitle` and `accDescr` are defined in the diagram definition. They result in the following tags in SVG code:
-
-![Accessibility options rendered inside SVG](img/accessibility-div-example.png)
-
-### Multi-line Accessibility title/description
-
-You can also define the accessibility options in a multi-line format, where the keyword is followed by opening curly bracket `{` and then multiple lines, followed by a closing `}`.
-
-`accTitle: My single line title value` (**_single line format_**)
-
-vs
-
-`accDescr: { My multi-line description of the diagram }` (**_multi-line format_**)
-
-Let us look at it in the following example, with same flowchart:
+* Flowchart with the accessible title "Bob's Burger's Making Big Decisions" and the multiple line accessible description "The official Bob's Burgers corporate processes that are used
+  for making very, very big decisions.
+  This is actually a very simple flow: identify the big decision and then make the big decision."
 
 ```mermaid-example
-   graph LR
-      accTitle: Big decisions
-
+  graph LR
+      accTitle: Bob's Burger's Making Big Decisions
       accDescr {
-        My multi-line description
-        of the diagram
-      }
+        The official Bob's Burgers corporate processes that are used
+        for making very, very big decisions.
+        This is actually a very simple flow: identify the big decision and then make the big decision.
+         }
+      A[Identify Big Descision] --> B{Make Big Decision}
+      B --> D[Be done]
+```
 
-      A[Hard] -->|Text| B(Round)
-      B --> C{Decision}
-      C -->|One| D[Result 1]
+Here is the HTML generated for the SVG element: _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
+```html
+<svg aria-labelledby="chart-title-mermaid_382ee221" aria-describedby="chart-desc-mermaid_382ee221" aria-roledescription="flowchart-v2"  xmlns="http://www.w3.org/2000/svg" width="100%" id="mermaid_382ee221">
+  <title id="chart-title-mermaid_382ee221">Big decisions</title>
+  <desc id="chart-desc-mermaid_382ee221">The official Bob's Burgers corporate processes that are used
+    for making very, very big decisions.
+    This is actually a very simple flow: identify the big decision and then make the big decision.</desc>
 
 ```
 
-See in the code snippet above, the `accTitle` and `accDescr` are defined in the diagram definition. They result in the following tags in SVG code:
 
-![Accessibility options rendered inside SVG](img/accessibility-div-example-2.png)
+#### Sample Code Snippets for other diagram types
 
-### Sample Code Snippet for other diagram types
-
-#### Sequence Diagram
-
-```mermaid-example
-   sequenceDiagram
-      accTitle: My Sequence Diagram
-      accDescr: My Sequence Diagram Description
-
-      Alice->>John: Hello John, how are you?
-      John-->>Alice: Great!
-      Alice-)John: See you later!
-```
-
-#### Class Diagram
+##### Class Diagram
 
 ```mermaid-example
    classDiagram
@@ -90,18 +128,7 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
       Vehicle <|-- Car
 ```
 
-#### State Diagram
-
-```mermaid-example
-   stateDiagram
-      accTitle: My State Diagram
-      accDescr: My State Diagram Description
-
-       s1 --> s2
-
-```
-
-#### Entity Relationship Diagram
+##### Entity Relationship Diagram
 
 ```mermaid-example
    erDiagram
@@ -114,25 +141,7 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
 
 ```
 
-#### User Journey Diagram
-
-```mermaid-example
-  journey
-      accTitle: My User Journey Diagram
-      accDescr: My User Journey Diagram Description
-
-      title My working day
-      section Go to work
-        Make tea: 5: Me
-        Go upstairs: 3: Me
-        Do work: 1: Me, Cat
-      section Go home
-        Go downstairs: 5: Me
-        Sit down: 5: Me
-
-```
-
-#### Gantt Chart
+##### Gantt Chart
 
 ```mermaid-example
    gantt
@@ -150,7 +159,27 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
 
 ```
 
-#### Pie Chart
+##### Gitgraph
+
+```mermaid-example
+  gitGraph
+      accTitle: My Gitgraph Accessibility Title
+      accDescr: My Gitgraph Accessibility Description
+
+     commit
+     commit
+     branch develop
+     checkout develop
+     commit
+     commit
+     checkout main
+     merge develop
+     commit
+     commit
+
+```
+
+##### Pie Chart
 
 ```mermaid-example
    pie
@@ -165,7 +194,7 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
 
 ```
 
-#### Requirement Diagram
+##### Requirement Diagram
 
 ```mermaid-example
   requirementDiagram
@@ -187,22 +216,44 @@ See in the code snippet above, the `accTitle` and `accDescr` are defined in the
 
 ```
 
-#### Gitgraph
+##### Sequence Diagram
 
 ```mermaid-example
-  gitGraph
-      accTitle: My Gitgraph Accessibility Title
-      accDescr: My Gitgraph Accessibility Description
+   sequenceDiagram
+      accTitle: My Sequence Diagram
+      accDescr: My Sequence Diagram Description
 
-     commit
-     commit
-     branch develop
-     checkout develop
-     commit
-     commit
-     checkout main
-     merge develop
-     commit
-     commit
+      Alice->>John: Hello John, how are you?
+      John-->>Alice: Great!
+      Alice-)John: See you later!
+```
+
+##### State Diagram
+
+```mermaid-example
+   stateDiagram
+      accTitle: My State Diagram
+      accDescr: My State Diagram Description
+
+       s1 --> s2
+
+```
+
+
+##### User Journey Diagram
+
+```mermaid-example
+  journey
+      accTitle: My User Journey Diagram
+      accDescr: My User Journey Diagram Description
+
+      title My working day
+      section Go to work
+        Make tea: 5: Me
+        Go upstairs: 3: Me
+        Do work: 1: Me, Cat
+      section Go home
+        Go downstairs: 5: Me
+        Sit down: 5: Me
 
 ```

From 9cc862b951082dbe143e7bc5fb3fc2b5875862af Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 15:48:17 -0800
Subject: [PATCH 033/129] doc: adding diagrams: revise a11y section

---
 .../mermaid/src/docs/community/newDiagram.md  | 45 +++++++++----------
 1 file changed, 22 insertions(+), 23 deletions(-)

diff --git a/packages/mermaid/src/docs/community/newDiagram.md b/packages/mermaid/src/docs/community/newDiagram.md
index 74026b3ff..ed8c1e8aa 100644
--- a/packages/mermaid/src/docs/community/newDiagram.md
+++ b/packages/mermaid/src/docs/community/newDiagram.md
@@ -8,8 +8,8 @@ This would be to define a jison grammar for the new diagram type. That should st
 
 For instance:
 
-- the flowchart starts with the keyword graph.
-- the sequence diagram starts with the keyword sequenceDiagram
+- the flowchart starts with the keyword _graph_
+- the sequence diagram starts with the keyword _sequenceDiagram_
 
 #### Store data found during parsing
 
@@ -56,6 +56,11 @@ Place the renderer in the diagram folder.
 ### Step 3: Detection of the new diagram type
 
 The second thing to do is to add the capability to detect the new new diagram to type to the detectType in utils.js. The detection should return a key for the new diagram type.
+[This key will be used to as the aria roledescription](#aria-roledescription), so it should be a word that clearly describes the diagram type. 
+For example, if your new diagram use a UML deployment diagram, a good key would be "UMLDeploymentDiagram" because assistive technologies such as a screen reader
+would voice that as "U-M-L Deployment diagram."  Another good key would be "deploymentDiagram" because that would be voiced as "Deployment Diagram." A bad key would be "deployment" because that would not sufficiently describe the diagram.
+
+Note that the diagram type key does not have to be the same as the diagram keyword chosen for the [grammar](#grammar), but it is helpful if they are the same.
 
 ### Step 4: The final piece - triggering the rendering
 
@@ -163,19 +168,23 @@ It is probably a good idea to keep the handling similar to this in your new diag
 
 ## Accessibility
 
-The syntax for adding title and description looks like this:
+Mermaid automatically adds the following accessibility information for the diagram SVG HTML element:
+- aria-roledescription 
+- accessible title
+- accessible description
 
-```
-accTitle: The title
-accDescr: The description
 
-accDescr {
-	Syntax for a description text
-	written on multiple lines.
-}
-```
+### aria-roledescription
 
-In a similar way to the directives the jison syntax are quite similar between the diagrams.
+The aria-roledescription is automatically set to [the diagram type](#step-3--detection-of-the-new-diagram-type) and inserted into the SVG element.
+
+See [the definition of aria-roledescription](https://www.w3.org/TR/wai-aria-1.1/#aria-roledescription) in [the Accessible Rich Internet Applications W3 standard.](https://www.w3.org/WAI/standards-guidelines/aria/)
+
+### accessible title and description
+
+The syntax for accessible titles and descriptions is described in [the Accessibility documenation section.](../config/accessibility.md)
+
+In a similar way to the directives, the jison syntax are quite similar between the diagrams.
 
 ```jison
 
@@ -213,18 +222,8 @@ import {
 } from '../../commonDb';
 ```
 
-For rendering the accessibility tags you have again an existing function you can use.
+The accessibility title and description are inserted into the SVG element in the `render` function in mermaidAPI.
 
-**In the renderer:**
-
-```js
-import addSVGAccessibilityFields from '../../accessibility';
-
-/* ... */
-
-// Adds title and description to the flow chart
-addSVGAccessibilityFields(parser.yy, svg, id);
-```
 
 ## Theming
 

From 68b1805c40dc4505cc755d7cae475cbd2444cd83 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 15:49:37 -0800
Subject: [PATCH 034/129] (minor) fix typo, whitespace formatting

---
 demos/state.html                   | 4 ++--
 packages/mermaid/src/mermaidAPI.ts | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/demos/state.html b/demos/state.html
index dbe2286a3..6f6dfba00 100644
--- a/demos/state.html
+++ b/demos/state.html
@@ -68,8 +68,8 @@
     <pre class="mermaid">
     stateDiagram-v2
       accTitle: very very simple state
-    accDescr: This is a state diagram showing one state
-    State1
+      accDescr: This is a state diagram showing one state
+      State1
     </pre>
     <hr />
 
diff --git a/packages/mermaid/src/mermaidAPI.ts b/packages/mermaid/src/mermaidAPI.ts
index 18076b488..072ff595a 100644
--- a/packages/mermaid/src/mermaidAPI.ts
+++ b/packages/mermaid/src/mermaidAPI.ts
@@ -381,7 +381,7 @@ export const removeExistingElements = (
  * @param id - The id for the SVG element (the element to be rendered)
  * @param text - The text for the graph definition
  * @param cb - Callback which is called after rendering is finished with the svg code as in param.
- * @param container - HTML element where the svg will be inserted. (Is usually element with the .mermaid class)
+ * @param svgContainingElement - HTML element where the svg will be inserted. (Is usually element with the .mermaid class)
  *   If no svgContainingElement is provided then the SVG element will be appended to the body.
  *    Selector to element in which a div with the graph temporarily will be
  *   inserted. If one is provided a hidden div will be inserted in the body of the page instead. The

From b51759d36eebfdf7445909b048f0e8a0dfd540fd Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 15:50:52 -0800
Subject: [PATCH 035/129] set describeby to accessible description element id

---
 packages/mermaid/src/accessibility.spec.ts | 170 +++++++++++++--------
 packages/mermaid/src/accessibility.ts      |   7 +-
 2 files changed, 112 insertions(+), 65 deletions(-)

diff --git a/packages/mermaid/src/accessibility.spec.ts b/packages/mermaid/src/accessibility.spec.ts
index 7336284fe..87d9a1cd0 100644
--- a/packages/mermaid/src/accessibility.spec.ts
+++ b/packages/mermaid/src/accessibility.spec.ts
@@ -33,46 +33,95 @@ describe('accessibility', () => {
         expect(noInsert_attr_spy).not.toHaveBeenCalled();
       });
 
+      // ----------------
+      // Convenience functions to DRY up the spec
+
+      function expectAriaLabelledByIsTitleId(
+        svgD3Node: any,
+        title: string | null | undefined,
+        desc: string | null | undefined,
+        givenId: string
+      ) {
+        // @ts-ignore Required to easily handle the d3 select types
+        const svg_attr_spy = vi.spyOn(svgD3Node, 'attr').mockReturnValue(svgD3Node);
+        addSVGa11yTitleDescription(svgD3Node, title, desc, givenId);
+        expect(svg_attr_spy).toHaveBeenCalledWith('aria-labelledby', `chart-title-${givenId}`);
+      }
+
+      function expectAriaDescribedByIsDescId(
+        svgD3Node: any,
+        title: string | null | undefined,
+        desc: string | null | undefined,
+        givenId: string
+      ) {
+        // @ts-ignore Required to easily handle the d3 select types
+        const svg_attr_spy = vi.spyOn(svgD3Node, 'attr').mockReturnValue(svgD3Node);
+        addSVGa11yTitleDescription(svgD3Node, title, desc, givenId);
+        expect(svg_attr_spy).toHaveBeenCalledWith('aria-describedby', `chart-desc-${givenId}`);
+      }
+
+      function a11yTitleTagInserted(
+        svgD3Node: any,
+        title: string | null | undefined,
+        desc: string | null | undefined,
+        givenId: string,
+        callNumber: number
+      ) {
+        a11yTagInserted(svgD3Node, title, desc, givenId, callNumber, 'title', title);
+      }
+
+      function a11yDescTagInserted(
+        svgD3Node: any,
+        title: string | null | undefined,
+        desc: string | null | undefined,
+        givenId: string,
+        callNumber: number
+      ) {
+        a11yTagInserted(svgD3Node, title, desc, givenId, callNumber, 'desc', desc);
+      }
+
+      function a11yTagInserted(
+        svgD3Node: any,
+        title: string | null | undefined,
+        desc: string | null | undefined,
+        givenId: string,
+        callNumber: number,
+        expectedPrefix: string,
+        expectedText: string | null | undefined
+      ) {
+        const faux_insertedD3 = new MockedD3();
+        const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_insertedD3);
+        // @ts-ignore  Required to easily handle the d3 select types
+        const title_attr_spy = vi.spyOn(faux_insertedD3, 'attr').mockReturnValue(faux_insertedD3);
+        const title_text_spy = vi.spyOn(faux_insertedD3, 'text');
+
+        addSVGa11yTitleDescription(fauxSvgNode, title, desc, givenId);
+        expect(svg_insert_spy).toHaveBeenCalledWith(expectedPrefix, ':first-child');
+        expect(title_attr_spy).toHaveBeenCalledWith('id', `chart-${expectedPrefix}-${givenId}`);
+        expect(title_text_spy).toHaveBeenNthCalledWith(callNumber, expectedText);
+      }
+      // ----------------
+
       describe('given an a11y title', () => {
         const a11yTitle = 'a11y title';
 
         describe('given an a11y description', () => {
           const a11yDesc = 'a11y description';
 
-          it('sets aria-labelledby to the title id and the description id inserted as children', () => {
-            // @ts-ignore Required to easily handle the d3 select types
-            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
-            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_attr_spy).toHaveBeenCalledWith(
-              'aria-labelledby',
-              `chart-title-${givenId} chart-desc-${givenId}`
-            );
+          it('sets aria-labelledby to the title id inserted as a child', () => {
+            expectAriaLabelledByIsTitleId(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+          });
+
+          it('sets aria-describedby to the description id inserted as a child', () => {
+            expectAriaDescribedByIsDescId(fauxSvgNode, a11yTitle, a11yDesc, givenId);
           });
 
           it('inserts a title tag as the first child with the text set to the accTitle given', () => {
-            const faux_title = new MockedD3();
-            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
-            // @ts-ignore  Required to easily handle the d3 select types
-            const title_attr_spy = vi.spyOn(faux_title, 'attr').mockReturnValue(faux_title);
-            const title_text_spy = vi.spyOn(faux_title, 'text');
-
-            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_insert_spy).toHaveBeenCalledWith('desc', ':first-child');
-            expect(title_attr_spy).toHaveBeenCalledWith('id', `chart-desc-` + givenId);
-            expect(title_text_spy).toHaveBeenNthCalledWith(1, 'a11y description');
+            a11yTitleTagInserted(fauxSvgNode, a11yTitle, a11yDesc, givenId, 2);
           });
 
           it('inserts a desc tag as the 2nd child with the text set to accDescription given', () => {
-            const faux_desc = new MockedD3();
-            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_desc);
-            // @ts-ignore  Required to easily handle the d3 select types
-            const desc_attr_spy = vi.spyOn(faux_desc, 'attr').mockReturnValue(faux_desc);
-            const desc_text_spy = vi.spyOn(faux_desc, 'text');
-
-            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_insert_spy).toHaveBeenCalledWith('desc', ':first-child');
-            expect(desc_attr_spy).toHaveBeenCalledWith('id', `chart-desc-` + givenId);
-            expect(desc_text_spy).toHaveBeenNthCalledWith(1, 'a11y description');
+            a11yDescTagInserted(fauxSvgNode, a11yTitle, a11yDesc, givenId, 1);
           });
         });
 
@@ -80,23 +129,18 @@ describe('accessibility', () => {
           const a11yDesc = undefined;
 
           it('sets aria-labelledby to the title id inserted as a child', () => {
+            expectAriaLabelledByIsTitleId(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+          });
+
+          it('no aria-describedby is set', () => {
             // @ts-ignore Required to easily handle the d3 select types
             const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_attr_spy).toHaveBeenCalledWith('aria-labelledby', `chart-title-${givenId}`);
+            expect(svg_attr_spy).not.toHaveBeenCalledWith('aria-describedby', expect.anything());
           });
 
           it('inserts a title tag as the first child with the text set to the accTitle given', () => {
-            const faux_title = new MockedD3();
-            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
-            // @ts-ignore  Required to easily handle the d3 select types
-            const title_attr_spy = vi.spyOn(faux_title, 'attr').mockReturnValue(faux_title);
-            const title_text_spy = vi.spyOn(faux_title, 'text');
-
-            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_insert_spy).toHaveBeenCalledWith('title', ':first-child');
-            expect(title_attr_spy).toHaveBeenCalledWith('id', `chart-title-` + givenId);
-            expect(title_text_spy).toHaveBeenNthCalledWith(1, 'a11y title');
+            a11yTitleTagInserted(fauxSvgNode, a11yTitle, a11yDesc, givenId, 1);
           });
 
           it('no description tag is inserted', () => {
@@ -114,6 +158,13 @@ describe('accessibility', () => {
         describe('given an a11y description', () => {
           const a11yDesc = 'a11y description';
 
+          it('no aria-labelledby is set', () => {
+            // @ts-ignore Required to easily handle the d3 select types
+            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_attr_spy).not.toHaveBeenCalledWith('aria-labelledby', expect.anything());
+          });
+
           it('no title tag inserted', () => {
             const faux_title = new MockedD3();
             const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
@@ -121,30 +172,32 @@ describe('accessibility', () => {
             expect(svg_insert_spy).not.toHaveBeenCalledWith('title', ':first-child');
           });
 
-          it('sets aria-labelledby to the description id inserted as a child', () => {
-            // @ts-ignore Required to easily handle the d3 select types
-            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
-            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_attr_spy).toHaveBeenCalledWith('aria-labelledby', `chart-desc-${givenId}`);
+          it('sets aria-describedby to the description id inserted as a child', () => {
+            expectAriaDescribedByIsDescId(fauxSvgNode, a11yTitle, a11yDesc, givenId);
           });
 
-          it('inserts a desc tag as a child with the text set to accDescription given', () => {
-            const faux_desc = new MockedD3();
-            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_desc);
-            // @ts-ignore  Required to easily handle the d3 select types
-            const desc_attr_spy = vi.spyOn(faux_desc, 'attr').mockReturnValue(faux_desc);
-            const desc_text_spy = vi.spyOn(faux_desc, 'text');
-
-            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_insert_spy).toHaveBeenCalledWith('desc', ':first-child');
-            expect(desc_attr_spy).toHaveBeenCalledWith('id', `chart-desc-` + givenId);
-            expect(desc_text_spy).toHaveBeenNthCalledWith(1, 'a11y description');
+          it('inserts a desc tag as the 2nd child with the text set to accDescription given', () => {
+            a11yDescTagInserted(fauxSvgNode, a11yTitle, a11yDesc, givenId, 1);
           });
         });
 
         describe('no a11y description', () => {
           const a11yDesc = undefined;
 
+          it('no aria-labelledby is set', () => {
+            // @ts-ignore Required to easily handle the d3 select types
+            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_attr_spy).not.toHaveBeenCalledWith('aria-labelledby', expect.anything());
+          });
+
+          it('no aria-describedby is set', () => {
+            // @ts-ignore Required to easily handle the d3 select types
+            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
+            expect(svg_attr_spy).not.toHaveBeenCalledWith('aria-describedby', expect.anything());
+          });
+
           it('no title tag inserted', () => {
             const faux_title = new MockedD3();
             const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
@@ -158,13 +211,6 @@ describe('accessibility', () => {
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
             expect(svg_insert_spy).not.toHaveBeenCalledWith('desc', ':first-child');
           });
-
-          it('no aria-labelledby is set', () => {
-            // @ts-ignore Required to easily handle the d3 select types
-            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
-            addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_attr_spy).not.toHaveBeenCalled();
-          });
         });
       });
     });
diff --git a/packages/mermaid/src/accessibility.ts b/packages/mermaid/src/accessibility.ts
index eff9a4edc..2940de959 100644
--- a/packages/mermaid/src/accessibility.ts
+++ b/packages/mermaid/src/accessibility.ts
@@ -40,14 +40,15 @@ export function addSVGa11yTitleDescription(
     return;
   }
 
-  const titleId = a11yTitle ? 'chart-title-' + baseId : null;
-  const descId = a11yDesc ? 'chart-desc-' + baseId : null;
   if (a11yTitle || a11yDesc) {
-    svg.attr('aria-labelledby', compact([titleId, descId]).join(' '));
     if (a11yDesc) {
+      const descId = 'chart-desc-' + baseId;
+      svg.attr('aria-describedby', descId);
       svg.insert('desc', ':first-child').attr('id', descId).text(a11yDesc);
     }
     if (a11yTitle) {
+      const titleId = 'chart-title-' + baseId;
+      svg.attr('aria-labelledby', titleId);
       svg.insert('title', ':first-child').attr('id', titleId).text(a11yTitle);
     }
   } else {

From 69526402e2d952352e3195080fa7b2553ee2c767 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 16:51:23 -0800
Subject: [PATCH 036/129] format .md files

---
 docs/community/development.md                 | 246 +++++++++++++++---
 .../mermaid/src/docs/community/newDiagram.md  |   9 +-
 .../mermaid/src/docs/config/accessibility.md  |  67 +++--
 3 files changed, 259 insertions(+), 63 deletions(-)

diff --git a/docs/community/development.md b/docs/community/development.md
index 58ca4670b..8503fb141 100644
--- a/docs/community/development.md
+++ b/docs/community/development.md
@@ -4,7 +4,17 @@
 >
 > ## Please edit the corresponding file in [/packages/mermaid/src/docs/community/development.md](../../packages/mermaid/src/docs/community/development.md).
 
-# Development and Contribution 🙌
+# Contributing to Mermaid
+
+## Contents
+
+- [Technical Requirements and Setup](#technical-requirements-and-setup)
+- [Contributing Code](#contributing-code)
+- [Contributing Documentation](#contributing-documentation)
+- [Questions or Suggestions?](#questions-or-suggestions)
+- [Last Words](#last-words)
+
+---
 
 So you want to help? That's great!
 
@@ -12,72 +22,141 @@ So you want to help? That's great!
 
 Here are a few things to get you started on the right path.
 
-**The Docs Structure is dictated by [.vitepress/config.ts](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/docs/.vitepress/config.ts)**.
+## Technical Requirements and Setup
 
-**Note: Commits and Pull Requests should be directed to the develop branch.**
+### Technical Requirements
 
-## Branching
+These are the tools we use for working with the code and documentation.
 
-Mermaid uses a [Git Flow](https://guides.github.com/introduction/flow/)–inspired approach to branching. So development is done in the `develop` branch.
+- [volta](https://volta.sh/) to manage node versions.
+- [Node.js](https://nodejs.org/en/). `volta install node`
+- [pnpm](https://pnpm.io/) package manager. `volta install pnpm`
+- [npx](https://docs.npmjs.com/cli/v8/commands/npx) the packaged executor in npm. This is needed [to install pnpm.](#2-install-pnpm)
 
-Once development is done we branch a `release` branch from `develop` for testing.
+Follow [the setup steps below](#setup) to install them and verify they are working
 
-Once the release happens we merge the `release` branch with `master` and kill the `release` branch.
+### Setup
 
-This means that **you should branch off your pull request from develop** and direct all Pull Requests to it.
+Follow these steps to set up the environment you need to work on code and/or documentation.
+
+#### 1. Fork and clone the repository
+
+In GitHub, you first _fork_ a repository when you are going to make changes and submit pull requests.
+
+Then you _clone_ a copy to your local development machine (e.g. where you code) to make a copy with all the files to work with.
+
+[Here is a GitHub document that gives an overview of the process.](https://docs.github.com/en/get-started/quickstart/fork-a-repo)
+
+#### 2. Install pnpm
+
+Once you have cloned the repository onto your development machine, change into the `mermaid` project folder so that you can install `pnpm`. You will need `npx` to install pnpm because volta doesn't support it yet.
+
+Ex:
+
+```bash
+# Change into the mermaid directory (the top level director of the mermaid project repository)
+cd mermaid
+# npx is required for first install because volta does not support pnpm yet
+npx pnpm install
+```
+
+#### 3. Verify Everything Is Working
+
+Once you have installed pnpm, you can run the `test` script to verify that pnpm is working _and_ that the repository has been cloned correctly:
+
+```bash
+pnpm test
+```
+
+The `test` script and others are in the top-level `package.json` file.
+
+All tests should run sucessfully without any errors or failures. (You might see _lint_ or _formatting_ warnings; those are ok during this step.)
 
 ## Contributing Code
 
-We make all changes via Pull Requests. As we have many Pull Requests from developers new to mermaid, we have put in place a process, wherein _knsv, Knut Sveidqvist_ is the primary reviewer of changes and merging pull requests. The process is as follows:
+The basic steps for contributing code are:
 
-- Large changes reviewed by knsv or other developer asked to review by knsv
-- Smaller, low-risk changes like dependencies, documentation, etc. can be merged by active collaborators
-- Documentation (we encourage updates to the `/packages/mermaid/src/docs` folder; you can submit them via direct commits)
+```mermaid-example
+graph LR
+    git[1. Checkout a  git branch] --> codeTest[2. write tests and code] --> doc[3. update documentation] --> submit[4.submit a PR]
+```
 
-When you commit code, create a branch with the following naming convention:
+```mermaid
+graph LR
+    git[1. Checkout a  git branch] --> codeTest[2. write tests and code] --> doc[3. update documentation] --> submit[4.submit a PR]
+```
 
-Start with the type, such as **feature** or **bug**, followed by the issue number for reference, and a text that describes the issue.
+1.  **Create** and checkout a git branch and work on your code in the branch
+2.  Write and update **tests** (unit and perhaps even integration (e2e) tests) (If you do TDD/BDD, the order might be different.)
+3.  **Let users know** that things have changed or been added in the documents! This is often overlooked, but _critical_
+4.  **Submit** your code as a _pull request._
 
-**One example:**
+### 1. Checkout a git branch
 
-`feature/945_state_diagrams`
+Mermaid uses a [Git Flow](https://guides.github.com/introduction/flow/)–inspired approach to branching.
 
-**Another example:**
+Development is done in the `develop` branch.
 
-`bug/123_nasty_bug_branch`
+Once development is done we branch a `release` branch from `develop` for testing.
 
-## Contributing to Documentation
+Once the release happens we merge the `release` branch with `master` and delete the `release` branch. The live product and on-line documentation are what is in the `master` branch.
 
-If it is not in the documentation, it's like it never happened. Wouldn't that be sad? With all the effort that was put into the feature?
+**All new work should be based on the `develop` branch.**
 
-The docs are located in the `src/docs` folder and are written in Markdown. Just pick the right section and start typing. If you want to propose changes to the structure of the documentation, such as adding a new section or a new file you do that via **[.vitepress/config.ts](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/docs/.vitepress/config.ts)**.
+**When you are ready to do work, always, ALWAYS:**
 
-> **All the documents displayed in the GitHub.io page are listed in [.vitepress/config.ts](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/docs/.vitepress/config.ts)**.
+1.  Make sure you have the most up to date version of the `develop` branch. (fetch or pull to update it)
+2.  Check out the `develop` branch
+3.  Create a new branch for your work. Please name the branch following our naming convention below.
 
-The contents of <https://mermaid-js.github.io/mermaid/> are based on the docs from the `master` branch. Updates committed to the `master` branch are reflected in the [Mermaid Docs](https://mermaid-js.github.io/mermaid/) once released.
+We use the follow naming convention for branches:
 
-## How to Contribute to Documentation
+```text
+   [feature | bug | chore | docs]/[issue number]_[short description using dashes ('-') or underscores ('_') instead of spaces]
+```
 
-We are a little less strict here, it is OK to commit directly in the `develop` branch if you are a collaborator.
+- The first part is the **type** of change: a feature, bug, chore, or documentation change ('docs')
+- followed by a _slash_ (which helps to group like types together in many git tools)
+- followed by the **issue number**
+- followed by an _underscore_ ('\_')
+- followed by a short text description (but use dashes ('-') or underscores ('\_') instead of spaces)
 
-The documentation is located in the `src/docs` directory and organized according to relevant subfolder.
+If your work is specific to a single diagram type, it is a good idea to put the diagram type at the start of the dscription. This will help use keep release notes organized: it will help us keep changes for a diagram type together.
 
-The `docs` folder will be automatically generated when committing to `src/docs` and should not be edited manually.
+**Ex: A new feature described in issue 2945 that adds a new arrow type called 'florbs' to state diagrams**
 
-We encourage contributions to the documentation at [mermaid-js/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/packages/mermaid/src/docs). We publish documentation using GitHub Pages with [Docsify](https://www.youtube.com/watch?v=TV88lp7egMw&t=3s)
+`feature/2945_state-diagram-new-arrow-florbs`
 
-### Add Unit Tests for Parsing
+**Ex: A bug described in issue 1123 that causes random ugly red text in multiple diagram types**
+`bug/1123_fix_random_ugly_red_text`
 
-This is important so that, if someone that does not know about this great feature suggests a change to the grammar, they get notified early on when that change breaks the parser. Another important aspect is that, without proper parsing, tests refactoring is pretty much impossible.
+### 2. Write Tests
 
-### Add E2E Tests
+Tests ensure that each function, module, or part of code does what it says it will do. This is critically
+important when other changes are made to ensure that existing code is not broken (no regression).
 
-This tests the rendering and visual appearance of the diagrams. This ensures that the rendering of that feature in the e2e will be reviewed in the release process going forward. Less chance that it breaks!
+Just as important, the tests act as _specifications:_ they specify what the code does (or should do).
+Whenever someone is new to a section of code, they should be able to read the tests to get a thorough understanding of what it does and why.
+
+If you are fixing a bug, you should add tests to ensure that your code has actually fixed the bug, to specify/describe what the code is doing, and to ensure the bug doesn't happen again.
+(If there had been a test for the situation, the bug never would have happened in the first place.)
+You may need to change existing tests if they were inaccurate.
+
+If you are adding a feature, you will definitely need to add tests. Depending on the size of your feature, you may need to add integration tests.
+
+#### Unit Tests for Parsing
+
+If you are adding or changing the text that describes a diagram (the _grammar_), you will need to add (or change) tests for the _parser._
+
+#### Integration/End-to-End (e2e) tests
+
+These test the rendering and visual appearance of the diagrams.
+This ensures that the rendering of that feature in the e2e will be reviewed in the release process going forward. Less chance that it breaks!
 
 To start working with the e2e tests:
 
-1.  Run `pnpm run dev` to start the dev server
-2.  Start **Cypress** by running `pnpm exec cypress open` in the **mermaid** folder.
+1.  Run `pnpm run dev` to start the dev server (or use the `pnpm dev` script)
+2.  Start **Cypress** by running `pnpm exec cypress open` in the **mermaid** folder (or use the `pnpm cypress:open` script).
 
 The rendering tests are very straightforward to create. There is a function `imgSnapshotTest`, which takes a diagram in text form and the mermaid options, and it renders that diagram in Cypress.
 
@@ -107,17 +186,87 @@ it('should render forks and joins', () => {
 });
 ```
 
-### Any Questions or Suggestions?
+\[TODO - running the tests against what is expected in development. ]
 
-After logging in at [GitHub.com](https://www.github.com), open or append to an issue [using the GitHub issue tracker of the mermaid-js repository](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Area%3A+Documentation%22).
+\[TODO - how to generate new screenshots]
+....
 
-### How to Contribute a Suggestion
+### 3. Update Documentation
+
+If the users have no way to know that things have changed, then you haven't really _fixed_ anything for the users; you've just added to making Mermaid feel broken.
+Likewise, if users don't know that there is a new feature that you've implemented, it will forever remain unknown and unused.
+
+The documentation has to be updated to users know that things have changed and added!
+
+We know it can sometimes be hard to code _and_ write user documentation.
+
+\[TODO - how to submit documentation changes -- see [Contributing Documentation](#contributing-documentation)
+
+Create another issue specifically for the documentation.\
+You will need to help with the PR, but definitely ask for help if you feel stuck.
+When it feels hard to write stuff out, explaining it to someone and having that person ask you clarifying questions can often be 80% of the work!]
+
+When in doubt, write up and submit what you can. It can be clarified and refined later. (With documentation, something is better than nothing!)
+
+### 4. Submit your pull request
+
+\[TODO - PR titles should start with (fix | feat | ....)]
+
+We make all changes via Pull Requests (PRs). As we have many Pull Requests from developers new to Mermaid, \
+we have put in place a process wherein _knsv, Knut Sveidqvist_ is the primary reviewer of changes and merging pull requests. The process is as follows:
+
+- Large changes are reviewed by knsv or other developer asked to review by knsv
+- Smaller, low-risk changes like dependencies, documentation, etc. can be reviewed and merged by active collaborators
+
+**Reminder: Pull Requests should be submitted to the develop branch.**
+
+## Contributing Documentation
+
+\[TODO: This section is still a WIP. It still needs revision.]
+
+If it is not in the documentation, it's like it never happened. Wouldn't that be sad? With all the effort that was put into the feature?
+
+The docs are located in the `src/docs` folder and are written in Markdown. Just pick the right section and start typing.
+If you want to propose changes to the structure of the documentation, such as adding a new section or a new file you do that via the **[sidebar](https://github.com/mermaid-js/mermaid/edit/develop/src/docs/_sidebar.md)**.
+
+> **All the documents displayed in the GitHub.io page are listed in [sidebar.md](https://github.com/mermaid-js/mermaid/edit/develop/src/docs/_sidebar.md)**.
+
+The contents of <https://mermaid-js.github.io/mermaid/> are based on the docs from the `master` branch.
+Updates committed to the `master` branch are reflected in the [Mermaid Docs](https://mermaid-js.github.io/mermaid/) once released.
+
+### How to Contribute to Documentation
+
+We are a little less strict here, it is OK to commit directly in the `develop` branch if you are a collaborator.
+
+The documentation is located in the `src/docs` directory and organized according to relevant subfolder.
+
+The contents of <https://mermaid-js.github.io/mermaid/> are based on the docs from the `master` branch. Updates committed to the `master` branch are reflected in the [Mermaid Docs](https://mermaid-js.github.io/mermaid/) once released.
+
+**The Docs Structure is dictated by [sidebar.md](https://github.com/mermaid-js/mermaid/edit/develop/src/docs/_sidebar.md)**
+
+The `docs` folder will be automatically generated when committing to `src/docs` and should not be edited manually.
+
+We encourage contributions to the documentation at [mermaid-js/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/src/docs). We publish documentation using GitHub Pages with [Docsify](https://www.youtube.com/watch?v=TV88lp7egMw&t=3s)
+
+- Documentation (we encourage updates to the `src/docs` folder; you can submit them via direct commits)
+
+The source files for documentation are in `/packages/mermaid/docs` and are written in markdown.
+
+**_DO NOT CHANGE FILES IN `/docs`_**
+
+### The official documentation site
+
+**[The mermaid documentation site](https://mermaid-js.github.io/mermaid/) is powered by [Docsify](https://docsify.js.org), a simple documentation site generator.**
+
+\[TODO - how to preview the documents on a local machine? how to run VitePress?]
+
+If you want to preview the whole documentation site on your machine, you need to install `docsify-cli`:
 
 Markdown is used to format the text, for more information about Markdown [see the GitHub Markdown help page](https://help.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax).
 
 To edit Docs on your computer:
 
-1.  Find the Markdown file (.md) to edit in the [packages/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/packages/mermaid/src/docs) directory in the `develop` branch.
+1.  Find the Markdown file (.md) to edit in the [mermaid-js/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/src/docs) directory in the `develop` branch.
 2.  Create a fork of the develop branch.
 3.  Make changes or add new documentation.
 4.  Commit changes to your fork and push it to GitHub.
@@ -126,12 +275,31 @@ To edit Docs on your computer:
 To edit Docs on GitHub:
 
 1.  Login to [GitHub.com](https://www.github.com).
-2.  Navigate to [packages/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/packages/mermaid/src/docs).
+2.  Navigate to [mermaid-js/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/src/docs).
 3.  To edit a file, click the pencil icon at the top-right of the file contents panel.
 4.  Describe what you changed in the **Propose file change** section, located at the bottom of the page.
 5.  Submit your changes by clicking the button **Propose file change** at the bottom (by automatic creation of a fork and a new branch).
 6.  Create a Pull Request of your newly forked branch by clicking the green **Create Pull Request** button.
 
+## Questions or Suggestions?
+
+#### First search to see if someone has already asked (and hopefully been answered) or suggested the same thing.
+
+- search in the Discussions
+- search in the open Issues
+
+If you find an open issue or discussion thread that is similar to your question but isn't answered,
+you can let us know that you are also interested in it. \[TODO: describe +1, upvote]
+This helps the team know the relative interest in something and helps them set priorities and assignments.
+
+Feel free to add to the discussion on the issue or topic.
+
+If you can't find anything that already addresses your question or suggestion, _open a new issue:_
+
+Log in to [GitHub.com](https://www.github.com), open or append to an issue [using the GitHub issue tracker of the mermaid-js repository](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Area%3A+Documentation%22).
+
+### How to Contribute a Suggestion
+
 ## Last Words
 
 Don't get daunted if it is hard in the beginning. We have a great community with only encouraging words. So, if you get stuck, ask for help and hints in the Slack forum. If you want to show off something good, show it off there.
diff --git a/packages/mermaid/src/docs/community/newDiagram.md b/packages/mermaid/src/docs/community/newDiagram.md
index ed8c1e8aa..57a454671 100644
--- a/packages/mermaid/src/docs/community/newDiagram.md
+++ b/packages/mermaid/src/docs/community/newDiagram.md
@@ -56,9 +56,9 @@ Place the renderer in the diagram folder.
 ### Step 3: Detection of the new diagram type
 
 The second thing to do is to add the capability to detect the new new diagram to type to the detectType in utils.js. The detection should return a key for the new diagram type.
-[This key will be used to as the aria roledescription](#aria-roledescription), so it should be a word that clearly describes the diagram type. 
+[This key will be used to as the aria roledescription](#aria-roledescription), so it should be a word that clearly describes the diagram type.
 For example, if your new diagram use a UML deployment diagram, a good key would be "UMLDeploymentDiagram" because assistive technologies such as a screen reader
-would voice that as "U-M-L Deployment diagram."  Another good key would be "deploymentDiagram" because that would be voiced as "Deployment Diagram." A bad key would be "deployment" because that would not sufficiently describe the diagram.
+would voice that as "U-M-L Deployment diagram." Another good key would be "deploymentDiagram" because that would be voiced as "Deployment Diagram." A bad key would be "deployment" because that would not sufficiently describe the diagram.
 
 Note that the diagram type key does not have to be the same as the diagram keyword chosen for the [grammar](#grammar), but it is helpful if they are the same.
 
@@ -169,11 +169,11 @@ It is probably a good idea to keep the handling similar to this in your new diag
 ## Accessibility
 
 Mermaid automatically adds the following accessibility information for the diagram SVG HTML element:
-- aria-roledescription 
+
+- aria-roledescription
 - accessible title
 - accessible description
 
-
 ### aria-roledescription
 
 The aria-roledescription is automatically set to [the diagram type](#step-3--detection-of-the-new-diagram-type) and inserted into the SVG element.
@@ -224,7 +224,6 @@ import {
 
 The accessibility title and description are inserted into the SVG element in the `render` function in mermaidAPI.
 
-
 ## Theming
 
 Mermaid supports themes and has an integrated theming engine. You can read more about how the themes can be used [in the docs](../config/theming.md).
diff --git a/packages/mermaid/src/docs/config/accessibility.md b/packages/mermaid/src/docs/config/accessibility.md
index 5545ce1bc..e7947adec 100644
--- a/packages/mermaid/src/docs/config/accessibility.md
+++ b/packages/mermaid/src/docs/config/accessibility.md
@@ -7,15 +7,22 @@ Now with Mermaid library in much wider use, we have started to work towards more
 Adding accessibility means that the rich information communicated by visual diagrams can be made available to those using assistive technologies (and of course to search engines).
 [Read more about Accessible Rich Internet Applications and the W3 standards.](https://www.w3.org/WAI/standards-guidelines/aria/)
 
-Mermaid will automatically insert the [aria-roledescription](#aria-roledescription) and, if provided in the diagram text by the diagram author, the [accessible title and description.](#accessible-title-and-description) 
+Mermaid will automatically insert the [aria-roledescription](#aria-roledescription) and, if provided in the diagram text by the diagram author, the [accessible title and description.](#accessible-title-and-description)
 
 ### aria-roledescription
 
-The [aria-roledescription](https://www.w3.org/TR/wai-aria-1.1/#aria-roledescription) for the SVG HTML element is set to the diagram type key.  (Note this may be slightly different than the keyword used for the diagram in the diagram text.)
+The [aria-roledescription](https://www.w3.org/TR/wai-aria-1.1/#aria-roledescription) for the SVG HTML element is set to the diagram type key. (Note this may be slightly different than the keyword used for the diagram in the diagram text.)
 
 For example: The diagram type key for a state diagram is "stateDiagram". Here (a part of) the HTML of the SVG tag that shows the automatically inserted aria-roledscription set to "stateDiagram". _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
+
 ```html
-<svg aria-roledescription="stateDiagram"  class="statediagram" xmlns="http://www.w3.org/2000/svg" width="100%" id="mermaid-1668720491568">
+<svg
+  aria-roledescription="stateDiagram"
+  class="statediagram"
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%"
+  id="mermaid-1668720491568"
+></svg>
 ```
 
 ### Accessible Title and Description
@@ -32,23 +39,29 @@ and the accessible description element (text = "This is an accessible descriptio
 _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.)_
 
 ```html
-<svg aria-labelledby="chart-title-mermaid-1668725057758" aria-describedby="chart-desc-mermaid-1668725057758"  xmlns="http://www.w3.org/2000/svg" width="100%" id="mermaid-1668725057758">
+<svg
+  aria-labelledby="chart-title-mermaid-1668725057758"
+  aria-describedby="chart-desc-mermaid-1668725057758"
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%"
+  id="mermaid-1668725057758"
+>
   <title id="chart-title-mermaid-1668725057758">This is the accessible title</title>
   <desc id="chart-desc-mermaid-1668725057758">This is an accessible description</desc>
+</svg>
 ```
 
 Details for the syntax follow.
 
-
 #### accessible title
+
 The **accessible title** is specified with the **accTitle** _keyword_, followed by a colon (`:`), and the string value for the title.
 The string value ends at the end of the line. (It can only be a single line.)
- 
-Ex: `accTitle: This is a single line title` 
+
+Ex: `accTitle: This is a single line title`
 
 See [the accTitle and accDescr usage examples](#acctitle-and-accdescr-usage-examples) for how this can be used in a diagram and the resulting HTML generated.
 
-
 #### accessible description
 
 An accessible description can be 1 line long (a single line) or many lines long.
@@ -60,6 +73,7 @@ Ex: `accDescr: This is a single line description.`
 A **multiple line accessible description** _does not have a colon (`:`) after the accDescr keyword_ and is surrounded by curly brackets (`{}`).
 
 Ex:
+
 ```
 accDescr { The official Bob's Burgers corporate processes that are used
         for making very, very big decisions.
@@ -68,7 +82,6 @@ accDescr { The official Bob's Burgers corporate processes that are used
 
 See [the accTitle and accDescr usage examples](#acctitle-and-accdescr-usage-examples) for how this can be used in a diagram and the resulting HTML generated.
 
-
 #### accTitle and accDescr Usage Examples
 
 - Flowchart with the accessible title "Big Decisions" and the single-line accessible description "Bob's Burgers process for making big decisions"
@@ -82,14 +95,22 @@ See [the accTitle and accDescr usage examples](#acctitle-and-accdescr-usage-exam
 ```
 
 Here is the HTML generated for the SVG element: _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
+
 ```html
-<svg aria-labelledby="chart-title-mermaid_382ee221" aria-describedby="chart-desc-mermaid_382ee221" aria-roledescription="flowchart-v2"  xmlns="http://www.w3.org/2000/svg" width="100%" id="mermaid_382ee221">
+<svg
+  aria-labelledby="chart-title-mermaid_382ee221"
+  aria-describedby="chart-desc-mermaid_382ee221"
+  aria-roledescription="flowchart-v2"
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%"
+  id="mermaid_382ee221"
+>
   <title id="chart-title-mermaid_382ee221">Big decisions</title>
   <desc id="chart-desc-mermaid_382ee221">Bob's Burgers process for making big decisions</desc>
-
+</svg>
 ```
 
-* Flowchart with the accessible title "Bob's Burger's Making Big Decisions" and the multiple line accessible description "The official Bob's Burgers corporate processes that are used
+- Flowchart with the accessible title "Bob's Burger's Making Big Decisions" and the multiple line accessible description "The official Bob's Burgers corporate processes that are used
   for making very, very big decisions.
   This is actually a very simple flow: identify the big decision and then make the big decision."
 
@@ -106,16 +127,25 @@ Here is the HTML generated for the SVG element: _(Note that some of the SVG attr
 ```
 
 Here is the HTML generated for the SVG element: _(Note that some of the SVG attributes and the SVG contents are omitted for clarity.):_
+
 ```html
-<svg aria-labelledby="chart-title-mermaid_382ee221" aria-describedby="chart-desc-mermaid_382ee221" aria-roledescription="flowchart-v2"  xmlns="http://www.w3.org/2000/svg" width="100%" id="mermaid_382ee221">
+<svg
+  aria-labelledby="chart-title-mermaid_382ee221"
+  aria-describedby="chart-desc-mermaid_382ee221"
+  aria-roledescription="flowchart-v2"
+  xmlns="http://www.w3.org/2000/svg"
+  width="100%"
+  id="mermaid_382ee221"
+>
   <title id="chart-title-mermaid_382ee221">Big decisions</title>
-  <desc id="chart-desc-mermaid_382ee221">The official Bob's Burgers corporate processes that are used
-    for making very, very big decisions.
-    This is actually a very simple flow: identify the big decision and then make the big decision.</desc>
-
+  <desc id="chart-desc-mermaid_382ee221">
+    The official Bob's Burgers corporate processes that are used for making very, very big
+    decisions. This is actually a very simple flow: identify the big decision and then make the big
+    decision.
+  </desc>
+</svg>
 ```
 
-
 #### Sample Code Snippets for other diagram types
 
 ##### Class Diagram
@@ -239,7 +269,6 @@ Here is the HTML generated for the SVG element: _(Note that some of the SVG attr
 
 ```
 
-
 ##### User Journey Diagram
 
 ```mermaid-example

From 67a015c71d42e8cd6870337807244ff9e528d164 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 17 Nov 2022 16:58:18 -0800
Subject: [PATCH 037/129] re-re-fixed the contributing doc

---
 docs/community/development.md | 256 ++++++----------------------------
 1 file changed, 44 insertions(+), 212 deletions(-)

diff --git a/docs/community/development.md b/docs/community/development.md
index 8503fb141..58ca4670b 100644
--- a/docs/community/development.md
+++ b/docs/community/development.md
@@ -4,17 +4,7 @@
 >
 > ## Please edit the corresponding file in [/packages/mermaid/src/docs/community/development.md](../../packages/mermaid/src/docs/community/development.md).
 
-# Contributing to Mermaid
-
-## Contents
-
-- [Technical Requirements and Setup](#technical-requirements-and-setup)
-- [Contributing Code](#contributing-code)
-- [Contributing Documentation](#contributing-documentation)
-- [Questions or Suggestions?](#questions-or-suggestions)
-- [Last Words](#last-words)
-
----
+# Development and Contribution 🙌
 
 So you want to help? That's great!
 
@@ -22,141 +12,72 @@ So you want to help? That's great!
 
 Here are a few things to get you started on the right path.
 
-## Technical Requirements and Setup
+**The Docs Structure is dictated by [.vitepress/config.ts](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/docs/.vitepress/config.ts)**.
 
-### Technical Requirements
+**Note: Commits and Pull Requests should be directed to the develop branch.**
 
-These are the tools we use for working with the code and documentation.
+## Branching
 
-- [volta](https://volta.sh/) to manage node versions.
-- [Node.js](https://nodejs.org/en/). `volta install node`
-- [pnpm](https://pnpm.io/) package manager. `volta install pnpm`
-- [npx](https://docs.npmjs.com/cli/v8/commands/npx) the packaged executor in npm. This is needed [to install pnpm.](#2-install-pnpm)
-
-Follow [the setup steps below](#setup) to install them and verify they are working
-
-### Setup
-
-Follow these steps to set up the environment you need to work on code and/or documentation.
-
-#### 1. Fork and clone the repository
-
-In GitHub, you first _fork_ a repository when you are going to make changes and submit pull requests.
-
-Then you _clone_ a copy to your local development machine (e.g. where you code) to make a copy with all the files to work with.
-
-[Here is a GitHub document that gives an overview of the process.](https://docs.github.com/en/get-started/quickstart/fork-a-repo)
-
-#### 2. Install pnpm
-
-Once you have cloned the repository onto your development machine, change into the `mermaid` project folder so that you can install `pnpm`. You will need `npx` to install pnpm because volta doesn't support it yet.
-
-Ex:
-
-```bash
-# Change into the mermaid directory (the top level director of the mermaid project repository)
-cd mermaid
-# npx is required for first install because volta does not support pnpm yet
-npx pnpm install
-```
-
-#### 3. Verify Everything Is Working
-
-Once you have installed pnpm, you can run the `test` script to verify that pnpm is working _and_ that the repository has been cloned correctly:
-
-```bash
-pnpm test
-```
-
-The `test` script and others are in the top-level `package.json` file.
-
-All tests should run sucessfully without any errors or failures. (You might see _lint_ or _formatting_ warnings; those are ok during this step.)
-
-## Contributing Code
-
-The basic steps for contributing code are:
-
-```mermaid-example
-graph LR
-    git[1. Checkout a  git branch] --> codeTest[2. write tests and code] --> doc[3. update documentation] --> submit[4.submit a PR]
-```
-
-```mermaid
-graph LR
-    git[1. Checkout a  git branch] --> codeTest[2. write tests and code] --> doc[3. update documentation] --> submit[4.submit a PR]
-```
-
-1.  **Create** and checkout a git branch and work on your code in the branch
-2.  Write and update **tests** (unit and perhaps even integration (e2e) tests) (If you do TDD/BDD, the order might be different.)
-3.  **Let users know** that things have changed or been added in the documents! This is often overlooked, but _critical_
-4.  **Submit** your code as a _pull request._
-
-### 1. Checkout a git branch
-
-Mermaid uses a [Git Flow](https://guides.github.com/introduction/flow/)–inspired approach to branching.
-
-Development is done in the `develop` branch.
+Mermaid uses a [Git Flow](https://guides.github.com/introduction/flow/)–inspired approach to branching. So development is done in the `develop` branch.
 
 Once development is done we branch a `release` branch from `develop` for testing.
 
-Once the release happens we merge the `release` branch with `master` and delete the `release` branch. The live product and on-line documentation are what is in the `master` branch.
+Once the release happens we merge the `release` branch with `master` and kill the `release` branch.
 
-**All new work should be based on the `develop` branch.**
+This means that **you should branch off your pull request from develop** and direct all Pull Requests to it.
 
-**When you are ready to do work, always, ALWAYS:**
+## Contributing Code
 
-1.  Make sure you have the most up to date version of the `develop` branch. (fetch or pull to update it)
-2.  Check out the `develop` branch
-3.  Create a new branch for your work. Please name the branch following our naming convention below.
+We make all changes via Pull Requests. As we have many Pull Requests from developers new to mermaid, we have put in place a process, wherein _knsv, Knut Sveidqvist_ is the primary reviewer of changes and merging pull requests. The process is as follows:
 
-We use the follow naming convention for branches:
+- Large changes reviewed by knsv or other developer asked to review by knsv
+- Smaller, low-risk changes like dependencies, documentation, etc. can be merged by active collaborators
+- Documentation (we encourage updates to the `/packages/mermaid/src/docs` folder; you can submit them via direct commits)
 
-```text
-   [feature | bug | chore | docs]/[issue number]_[short description using dashes ('-') or underscores ('_') instead of spaces]
-```
+When you commit code, create a branch with the following naming convention:
 
-- The first part is the **type** of change: a feature, bug, chore, or documentation change ('docs')
-- followed by a _slash_ (which helps to group like types together in many git tools)
-- followed by the **issue number**
-- followed by an _underscore_ ('\_')
-- followed by a short text description (but use dashes ('-') or underscores ('\_') instead of spaces)
+Start with the type, such as **feature** or **bug**, followed by the issue number for reference, and a text that describes the issue.
 
-If your work is specific to a single diagram type, it is a good idea to put the diagram type at the start of the dscription. This will help use keep release notes organized: it will help us keep changes for a diagram type together.
+**One example:**
 
-**Ex: A new feature described in issue 2945 that adds a new arrow type called 'florbs' to state diagrams**
+`feature/945_state_diagrams`
 
-`feature/2945_state-diagram-new-arrow-florbs`
+**Another example:**
 
-**Ex: A bug described in issue 1123 that causes random ugly red text in multiple diagram types**
-`bug/1123_fix_random_ugly_red_text`
+`bug/123_nasty_bug_branch`
 
-### 2. Write Tests
+## Contributing to Documentation
 
-Tests ensure that each function, module, or part of code does what it says it will do. This is critically
-important when other changes are made to ensure that existing code is not broken (no regression).
+If it is not in the documentation, it's like it never happened. Wouldn't that be sad? With all the effort that was put into the feature?
 
-Just as important, the tests act as _specifications:_ they specify what the code does (or should do).
-Whenever someone is new to a section of code, they should be able to read the tests to get a thorough understanding of what it does and why.
+The docs are located in the `src/docs` folder and are written in Markdown. Just pick the right section and start typing. If you want to propose changes to the structure of the documentation, such as adding a new section or a new file you do that via **[.vitepress/config.ts](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/docs/.vitepress/config.ts)**.
 
-If you are fixing a bug, you should add tests to ensure that your code has actually fixed the bug, to specify/describe what the code is doing, and to ensure the bug doesn't happen again.
-(If there had been a test for the situation, the bug never would have happened in the first place.)
-You may need to change existing tests if they were inaccurate.
+> **All the documents displayed in the GitHub.io page are listed in [.vitepress/config.ts](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/docs/.vitepress/config.ts)**.
 
-If you are adding a feature, you will definitely need to add tests. Depending on the size of your feature, you may need to add integration tests.
+The contents of <https://mermaid-js.github.io/mermaid/> are based on the docs from the `master` branch. Updates committed to the `master` branch are reflected in the [Mermaid Docs](https://mermaid-js.github.io/mermaid/) once released.
 
-#### Unit Tests for Parsing
+## How to Contribute to Documentation
 
-If you are adding or changing the text that describes a diagram (the _grammar_), you will need to add (or change) tests for the _parser._
+We are a little less strict here, it is OK to commit directly in the `develop` branch if you are a collaborator.
 
-#### Integration/End-to-End (e2e) tests
+The documentation is located in the `src/docs` directory and organized according to relevant subfolder.
 
-These test the rendering and visual appearance of the diagrams.
-This ensures that the rendering of that feature in the e2e will be reviewed in the release process going forward. Less chance that it breaks!
+The `docs` folder will be automatically generated when committing to `src/docs` and should not be edited manually.
+
+We encourage contributions to the documentation at [mermaid-js/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/packages/mermaid/src/docs). We publish documentation using GitHub Pages with [Docsify](https://www.youtube.com/watch?v=TV88lp7egMw&t=3s)
+
+### Add Unit Tests for Parsing
+
+This is important so that, if someone that does not know about this great feature suggests a change to the grammar, they get notified early on when that change breaks the parser. Another important aspect is that, without proper parsing, tests refactoring is pretty much impossible.
+
+### Add E2E Tests
+
+This tests the rendering and visual appearance of the diagrams. This ensures that the rendering of that feature in the e2e will be reviewed in the release process going forward. Less chance that it breaks!
 
 To start working with the e2e tests:
 
-1.  Run `pnpm run dev` to start the dev server (or use the `pnpm dev` script)
-2.  Start **Cypress** by running `pnpm exec cypress open` in the **mermaid** folder (or use the `pnpm cypress:open` script).
+1.  Run `pnpm run dev` to start the dev server
+2.  Start **Cypress** by running `pnpm exec cypress open` in the **mermaid** folder.
 
 The rendering tests are very straightforward to create. There is a function `imgSnapshotTest`, which takes a diagram in text form and the mermaid options, and it renders that diagram in Cypress.
 
@@ -186,87 +107,17 @@ it('should render forks and joins', () => {
 });
 ```
 
-\[TODO - running the tests against what is expected in development. ]
+### Any Questions or Suggestions?
 
-\[TODO - how to generate new screenshots]
-....
+After logging in at [GitHub.com](https://www.github.com), open or append to an issue [using the GitHub issue tracker of the mermaid-js repository](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Area%3A+Documentation%22).
 
-### 3. Update Documentation
-
-If the users have no way to know that things have changed, then you haven't really _fixed_ anything for the users; you've just added to making Mermaid feel broken.
-Likewise, if users don't know that there is a new feature that you've implemented, it will forever remain unknown and unused.
-
-The documentation has to be updated to users know that things have changed and added!
-
-We know it can sometimes be hard to code _and_ write user documentation.
-
-\[TODO - how to submit documentation changes -- see [Contributing Documentation](#contributing-documentation)
-
-Create another issue specifically for the documentation.\
-You will need to help with the PR, but definitely ask for help if you feel stuck.
-When it feels hard to write stuff out, explaining it to someone and having that person ask you clarifying questions can often be 80% of the work!]
-
-When in doubt, write up and submit what you can. It can be clarified and refined later. (With documentation, something is better than nothing!)
-
-### 4. Submit your pull request
-
-\[TODO - PR titles should start with (fix | feat | ....)]
-
-We make all changes via Pull Requests (PRs). As we have many Pull Requests from developers new to Mermaid, \
-we have put in place a process wherein _knsv, Knut Sveidqvist_ is the primary reviewer of changes and merging pull requests. The process is as follows:
-
-- Large changes are reviewed by knsv or other developer asked to review by knsv
-- Smaller, low-risk changes like dependencies, documentation, etc. can be reviewed and merged by active collaborators
-
-**Reminder: Pull Requests should be submitted to the develop branch.**
-
-## Contributing Documentation
-
-\[TODO: This section is still a WIP. It still needs revision.]
-
-If it is not in the documentation, it's like it never happened. Wouldn't that be sad? With all the effort that was put into the feature?
-
-The docs are located in the `src/docs` folder and are written in Markdown. Just pick the right section and start typing.
-If you want to propose changes to the structure of the documentation, such as adding a new section or a new file you do that via the **[sidebar](https://github.com/mermaid-js/mermaid/edit/develop/src/docs/_sidebar.md)**.
-
-> **All the documents displayed in the GitHub.io page are listed in [sidebar.md](https://github.com/mermaid-js/mermaid/edit/develop/src/docs/_sidebar.md)**.
-
-The contents of <https://mermaid-js.github.io/mermaid/> are based on the docs from the `master` branch.
-Updates committed to the `master` branch are reflected in the [Mermaid Docs](https://mermaid-js.github.io/mermaid/) once released.
-
-### How to Contribute to Documentation
-
-We are a little less strict here, it is OK to commit directly in the `develop` branch if you are a collaborator.
-
-The documentation is located in the `src/docs` directory and organized according to relevant subfolder.
-
-The contents of <https://mermaid-js.github.io/mermaid/> are based on the docs from the `master` branch. Updates committed to the `master` branch are reflected in the [Mermaid Docs](https://mermaid-js.github.io/mermaid/) once released.
-
-**The Docs Structure is dictated by [sidebar.md](https://github.com/mermaid-js/mermaid/edit/develop/src/docs/_sidebar.md)**
-
-The `docs` folder will be automatically generated when committing to `src/docs` and should not be edited manually.
-
-We encourage contributions to the documentation at [mermaid-js/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/src/docs). We publish documentation using GitHub Pages with [Docsify](https://www.youtube.com/watch?v=TV88lp7egMw&t=3s)
-
-- Documentation (we encourage updates to the `src/docs` folder; you can submit them via direct commits)
-
-The source files for documentation are in `/packages/mermaid/docs` and are written in markdown.
-
-**_DO NOT CHANGE FILES IN `/docs`_**
-
-### The official documentation site
-
-**[The mermaid documentation site](https://mermaid-js.github.io/mermaid/) is powered by [Docsify](https://docsify.js.org), a simple documentation site generator.**
-
-\[TODO - how to preview the documents on a local machine? how to run VitePress?]
-
-If you want to preview the whole documentation site on your machine, you need to install `docsify-cli`:
+### How to Contribute a Suggestion
 
 Markdown is used to format the text, for more information about Markdown [see the GitHub Markdown help page](https://help.github.com/en/github/writing-on-github/basic-writing-and-formatting-syntax).
 
 To edit Docs on your computer:
 
-1.  Find the Markdown file (.md) to edit in the [mermaid-js/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/src/docs) directory in the `develop` branch.
+1.  Find the Markdown file (.md) to edit in the [packages/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/packages/mermaid/src/docs) directory in the `develop` branch.
 2.  Create a fork of the develop branch.
 3.  Make changes or add new documentation.
 4.  Commit changes to your fork and push it to GitHub.
@@ -275,31 +126,12 @@ To edit Docs on your computer:
 To edit Docs on GitHub:
 
 1.  Login to [GitHub.com](https://www.github.com).
-2.  Navigate to [mermaid-js/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/src/docs).
+2.  Navigate to [packages/mermaid/src/docs](https://github.com/mermaid-js/mermaid/tree/develop/packages/mermaid/src/docs).
 3.  To edit a file, click the pencil icon at the top-right of the file contents panel.
 4.  Describe what you changed in the **Propose file change** section, located at the bottom of the page.
 5.  Submit your changes by clicking the button **Propose file change** at the bottom (by automatic creation of a fork and a new branch).
 6.  Create a Pull Request of your newly forked branch by clicking the green **Create Pull Request** button.
 
-## Questions or Suggestions?
-
-#### First search to see if someone has already asked (and hopefully been answered) or suggested the same thing.
-
-- search in the Discussions
-- search in the open Issues
-
-If you find an open issue or discussion thread that is similar to your question but isn't answered,
-you can let us know that you are also interested in it. \[TODO: describe +1, upvote]
-This helps the team know the relative interest in something and helps them set priorities and assignments.
-
-Feel free to add to the discussion on the issue or topic.
-
-If you can't find anything that already addresses your question or suggestion, _open a new issue:_
-
-Log in to [GitHub.com](https://www.github.com), open or append to an issue [using the GitHub issue tracker of the mermaid-js repository](https://github.com/mermaid-js/mermaid/issues?q=is%3Aissue+is%3Aopen+label%3A%22Area%3A+Documentation%22).
-
-### How to Contribute a Suggestion
-
 ## Last Words
 
 Don't get daunted if it is hard in the beginning. We have a great community with only encouraging words. So, if you get stuck, ask for help and hints in the Slack forum. If you want to show off something good, show it off there.

From e9f8ba6915376b2bd30e0b63075fb243806c2d4c Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Fri, 18 Nov 2022 11:28:29 +0530
Subject: [PATCH 038/129] doc: Add mindmap integration docs

---
 docs/mindmap.md                                  | 14 ++++++++++++++
 docs/n00b-gettingStarted.md                      |  4 ++++
 packages/mermaid/src/docs/mindmap.md             | 14 ++++++++++++++
 packages/mermaid/src/docs/n00b-gettingStarted.md |  4 ++++
 4 files changed, 36 insertions(+)

diff --git a/docs/mindmap.md b/docs/mindmap.md
index 32f1e099d..935572ddc 100644
--- a/docs/mindmap.md
+++ b/docs/mindmap.md
@@ -235,3 +235,17 @@ Root
         B
       C
 ```
+
+## Integrating with your library/website.
+
+Mindmap uses the experimental lazy loading & async rendering features which could change in the future.
+
+```html
+<script type="module">
+  import mermaid from 'https://unpkg.com/mermaid@9/dist/mermaid.esm.min.mjs';
+  import mindmap from 'https://unpkg.com/@mermaid-js/mermaid-mindmap@9/dist/mermaid-mindmap.esm.min.mjs';
+  await mermaid.registerExternalDiagrams([mindmap]);
+</script>
+```
+
+You can also refer the implementation in the live editor [here](https://github.com/mermaid-js/mermaid-live-editor/blob/fcf53c98c25604c90a218104268c339be53035a6/src/lib/util/mermaid.ts) to see how the async loading is done.
diff --git a/docs/n00b-gettingStarted.md b/docs/n00b-gettingStarted.md
index feac48919..e4e98d082 100644
--- a/docs/n00b-gettingStarted.md
+++ b/docs/n00b-gettingStarted.md
@@ -119,6 +119,10 @@ Rendering in Mermaid is initialized by `mermaid.initialize()` call. You can plac
 | ----------- | --------------------------------- | ------- | ----------- |
 | startOnLoad | Toggle for Rendering upon loading | Boolean | true, false |
 
+### Adding external diagrams to mermaid
+
+Please refer to the [Mindmap](./mindmap.md?id=integrating-with-your-librarywebsite) section for more information.
+
 ### Working Examples
 
 **Here is a full working example of the mermaidAPI being called through the CDN:**
diff --git a/packages/mermaid/src/docs/mindmap.md b/packages/mermaid/src/docs/mindmap.md
index 5aa6f4953..2b47e3e19 100644
--- a/packages/mermaid/src/docs/mindmap.md
+++ b/packages/mermaid/src/docs/mindmap.md
@@ -153,3 +153,17 @@ Root
         B
       C
 ```
+
+## Integrating with your library/website.
+
+Mindmap uses the experimental lazy loading & async rendering features which could change in the future.
+
+```html
+<script type="module">
+  import mermaid from '<CDN_URL>/mermaid@<MERMAID_VERSION>/dist/mermaid.esm.min.mjs';
+  import mindmap from '<CDN_URL>/@mermaid-js/mermaid-mindmap@<MERMAID_VERSION>/dist/mermaid-mindmap.esm.min.mjs';
+  await mermaid.registerExternalDiagrams([mindmap]);
+</script>
+```
+
+You can also refer the implementation in the live editor [here](https://github.com/mermaid-js/mermaid-live-editor/blob/fcf53c98c25604c90a218104268c339be53035a6/src/lib/util/mermaid.ts) to see how the async loading is done.
diff --git a/packages/mermaid/src/docs/n00b-gettingStarted.md b/packages/mermaid/src/docs/n00b-gettingStarted.md
index 095cece24..398541eb1 100644
--- a/packages/mermaid/src/docs/n00b-gettingStarted.md
+++ b/packages/mermaid/src/docs/n00b-gettingStarted.md
@@ -117,6 +117,10 @@ Rendering in Mermaid is initialized by `mermaid.initialize()` call. You can plac
 | ----------- | --------------------------------- | ------- | ----------- |
 | startOnLoad | Toggle for Rendering upon loading | Boolean | true, false |
 
+### Adding external diagrams to mermaid
+
+Please refer to the [Mindmap](./mindmap.md?id=integrating-with-your-librarywebsite) section for more information.
+
 ### Working Examples
 
 **Here is a full working example of the mermaidAPI being called through the CDN:**

From 2a98791ec9005d0ec0c8f2e0a71f1452ea7c993e Mon Sep 17 00:00:00 2001
From: Ashley Engelund <weedySeaDragon@users.noreply.github.com>
Date: Sun, 20 Nov 2022 12:17:21 -0800
Subject: [PATCH 039/129] use optional chaining check for get acc title and get
 acc description

Co-authored-by: Alois Klink <alois@aloisklink.com>
---
 packages/mermaid/src/mermaidAPI.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/mermaid/src/mermaidAPI.ts b/packages/mermaid/src/mermaidAPI.ts
index 072ff595a..c1b2f2556 100644
--- a/packages/mermaid/src/mermaidAPI.ts
+++ b/packages/mermaid/src/mermaidAPI.ts
@@ -529,8 +529,8 @@ const render = function (
   // This is the d3 node for the svg element
   const svgNode = root.select(`${enclosingDivID_selector} svg`);
   setA11yDiagramInfo(svgNode, graphType);
-  const a11yTitle = diag.db.getAccTitle !== undefined ? diag.db.getAccTitle() : null;
-  const a11yDescr = diag.db.getAccDescription !== undefined ? diag.db.getAccDescription() : null;
+  const a11yTitle = diag.db.getAccTitle?.();
+  const a11yDescr = diag.db.getAccDescription?.();
   addSVGa11yTitleDescription(svgNode, a11yTitle, a11yDescr, svgNode.attr('id'));
 
   // -------------------------------------------------------------------------------

From a9c337302a5204dd3413659aa9ebacf34ecf779c Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Sun, 20 Nov 2022 12:27:29 -0800
Subject: [PATCH 040/129] export D3Element from mermaidAPI; use in
 accessibility

---
 docs/config/setup/modules/mermaidAPI.md    | 10 ++++++++++
 packages/mermaid/src/accessibility.spec.ts | 11 ++++++-----
 packages/mermaid/src/accessibility.ts      | 10 ++++------
 packages/mermaid/src/mermaidAPI.ts         |  2 +-
 4 files changed, 21 insertions(+), 12 deletions(-)

diff --git a/docs/config/setup/modules/mermaidAPI.md b/docs/config/setup/modules/mermaidAPI.md
index baa4a939c..ef8a08b91 100644
--- a/docs/config/setup/modules/mermaidAPI.md
+++ b/docs/config/setup/modules/mermaidAPI.md
@@ -12,6 +12,16 @@
 
 Renames and re-exports [mermaidAPI](mermaidAPI.md#mermaidapi)
 
+## Type Aliases
+
+### D3Element
+
+Ƭ **D3Element**: `any`
+
+#### Defined in
+
+[mermaidAPI.ts:73](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L73)
+
 ## Variables
 
 ### mermaidAPI
diff --git a/packages/mermaid/src/accessibility.spec.ts b/packages/mermaid/src/accessibility.spec.ts
index 87d9a1cd0..57d5e8933 100644
--- a/packages/mermaid/src/accessibility.spec.ts
+++ b/packages/mermaid/src/accessibility.spec.ts
@@ -1,5 +1,6 @@
 import { MockedD3 } from './tests/MockedD3';
 import { setA11yDiagramInfo, addSVGa11yTitleDescription } from './accessibility';
+import { D3Element } from './mermaidAPI';
 
 describe('accessibility', () => {
   const fauxSvgNode = new MockedD3();
@@ -37,7 +38,7 @@ describe('accessibility', () => {
       // Convenience functions to DRY up the spec
 
       function expectAriaLabelledByIsTitleId(
-        svgD3Node: any,
+        svgD3Node: D3Element,
         title: string | null | undefined,
         desc: string | null | undefined,
         givenId: string
@@ -49,7 +50,7 @@ describe('accessibility', () => {
       }
 
       function expectAriaDescribedByIsDescId(
-        svgD3Node: any,
+        svgD3Node: D3Element,
         title: string | null | undefined,
         desc: string | null | undefined,
         givenId: string
@@ -61,7 +62,7 @@ describe('accessibility', () => {
       }
 
       function a11yTitleTagInserted(
-        svgD3Node: any,
+        svgD3Node: D3Element,
         title: string | null | undefined,
         desc: string | null | undefined,
         givenId: string,
@@ -71,7 +72,7 @@ describe('accessibility', () => {
       }
 
       function a11yDescTagInserted(
-        svgD3Node: any,
+        svgD3Node: D3Element,
         title: string | null | undefined,
         desc: string | null | undefined,
         givenId: string,
@@ -81,7 +82,7 @@ describe('accessibility', () => {
       }
 
       function a11yTagInserted(
-        svgD3Node: any,
+        svgD3Node: D3Element,
         title: string | null | undefined,
         desc: string | null | undefined,
         givenId: string,
diff --git a/packages/mermaid/src/accessibility.ts b/packages/mermaid/src/accessibility.ts
index 2940de959..a84edec0c 100644
--- a/packages/mermaid/src/accessibility.ts
+++ b/packages/mermaid/src/accessibility.ts
@@ -2,11 +2,9 @@
  * Accessibility (a11y) functions, types, helpers
  *
  */
+import { D3Element } from './mermaidAPI';
 
-import { isEmpty, compact } from 'lodash';
-
-// This is just a convenience alias to make it clear the type is a d3 object. (It's easier to make it 'any' instead of the complete typing set in d3)
-type D3object = any;
+import { isEmpty } from 'lodash';
 
 /**
  * Add aria-roledescription to the svg element to the diagramType
@@ -14,7 +12,7 @@ type D3object = any;
  * @param svg - d3 object that contains the SVG HTML element
  * @param diagramType - diagram name for to the aria-roledescription
  */
-export function setA11yDiagramInfo(svg: D3object, diagramType: string | null | undefined) {
+export function setA11yDiagramInfo(svg: D3Element, diagramType: string | null | undefined) {
   if (!isEmpty(diagramType)) {
     svg.attr('aria-roledescription', diagramType);
   }
@@ -31,7 +29,7 @@ export function setA11yDiagramInfo(svg: D3object, diagramType: string | null | u
  * @param baseId - id used to construct the a11y title and description id
  */
 export function addSVGa11yTitleDescription(
-  svg: D3object,
+  svg: D3Element,
   a11yTitle: string | null | undefined,
   a11yDesc: string | null | undefined,
   baseId: string
diff --git a/packages/mermaid/src/mermaidAPI.ts b/packages/mermaid/src/mermaidAPI.ts
index c1b2f2556..808dec809 100644
--- a/packages/mermaid/src/mermaidAPI.ts
+++ b/packages/mermaid/src/mermaidAPI.ts
@@ -70,7 +70,7 @@ interface DiagramStyleClassDef {
 
 // This makes it clear that we're working with a d3 selected element of some kind, even though it's hard to specify the exact type.
 // @ts-ignore Could replicate the type definition in d3. This also makes it possible to use the untyped info from the js diagram files.
-type D3Element = any;
+export type D3Element = any;
 
 // ----------------------------------------------------------------------------
 

From 7508cd796d8e6b50e64503d429031e0601c9659e Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Sun, 27 Nov 2022 10:13:32 -0800
Subject: [PATCH 041/129] (minor) fix comment, comment typo

---
 packages/mermaid/src/tests/MockedD3.ts | 2 +-
 packages/mermaid/src/utils.ts          | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/mermaid/src/tests/MockedD3.ts b/packages/mermaid/src/tests/MockedD3.ts
index 24cb9043f..56787448a 100644
--- a/packages/mermaid/src/tests/MockedD3.ts
+++ b/packages/mermaid/src/tests/MockedD3.ts
@@ -99,7 +99,7 @@ export class MockedD3 {
     return this;
   }
 
-  // NOTE: Returns a HTML ELement with tag 'svg' that has _another_ 'svg' element child.
+  // NOTE: Returns a HTML Element with tag 'svg' that has _another_ 'svg' element child.
   // This allows different tests to succeed -- some need a top level 'svg' and some need a 'svg' element to be the firstChild
   // Real implementation returns an HTML Element
   public node = vi.fn().mockImplementation(() => {
diff --git a/packages/mermaid/src/utils.ts b/packages/mermaid/src/utils.ts
index 3689a01a1..19ed228f9 100644
--- a/packages/mermaid/src/utils.ts
+++ b/packages/mermaid/src/utils.ts
@@ -915,7 +915,7 @@ export function getErrorMessage(error: unknown): string {
 }
 
 /**
- * Appends <text> element with the given title, centered.
+ * Appends <text> element with the given title and css class.
  *
  * @param parent - d3 svg object to append title to
  * @param cssClass - CSS class for the <text> element containing the title

From f1bc2deafd1f8ec30ccea37d853fb944480fbed6 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Sun, 27 Nov 2022 10:14:11 -0800
Subject: [PATCH 042/129] use MockedD3, spies in util insertTitle spec (remove
 MockD3)

---
 packages/mermaid/src/utils.spec.js | 60 +++++++++++++++++++++++-------
 1 file changed, 46 insertions(+), 14 deletions(-)

diff --git a/packages/mermaid/src/utils.spec.js b/packages/mermaid/src/utils.spec.js
index 54262f10e..769a0d0cc 100644
--- a/packages/mermaid/src/utils.spec.js
+++ b/packages/mermaid/src/utils.spec.js
@@ -4,7 +4,8 @@ import assignWithDepth from './assignWithDepth';
 import { detectType } from './diagram-api/detectType';
 import { addDiagrams } from './diagram-api/diagram-orchestration';
 import memoize from 'lodash-es/memoize';
-import { MockD3 } from 'd3';
+import { MockedD3 } from './tests/MockedD3';
+
 addDiagrams();
 
 describe('when assignWithDepth: should merge objects within objects', function () {
@@ -352,21 +353,52 @@ describe('when initializing the id generator', function () {
 });
 
 describe('when inserting titles', function () {
-  it('should do nothing when title is empty', function () {
-    const svg = MockD3('svg');
-    utils.insertTitle(svg, 'testClass', 0, '');
-    expect(svg.__children.length).toBe(0);
+  const svg = new MockedD3('svg');
+  const mockedElement = {
+    getBBox: vi.fn().mockReturnValue({ x: 10, y: 11, width: 100, height: 200 }),
+  };
+  const fauxTitle = new MockedD3('title');
+
+  beforeEach(() => {
+    svg.node = vi.fn().mockReturnValue(mockedElement);
   });
 
-  it('should insert title centered', function () {
-    const svg = MockD3('svg');
+  it('does nothing if the title is empty', function () {
+    const svg_append_spy = vi.spyOn(svg, 'append');
+    utils.insertTitle(svg, 'testClass', 0, '');
+    expect(svg_append_spy).not.toHaveBeenCalled();
+  });
+
+  it('appends the title as a text item with the given title text', function () {
+    const svg_append_spy = vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
+    const title_text_spy = vi.spyOn(fauxTitle, 'text');
+
     utils.insertTitle(svg, 'testClass', 5, 'test title');
-    expect(svg.__children.length).toBe(1);
-    const text = svg.__children[0];
-    expect(text.__name).toBe('text');
-    expect(text.text).toHaveBeenCalledWith('test title');
-    expect(text.attr).toHaveBeenCalledWith('x', 15);
-    expect(text.attr).toHaveBeenCalledWith('y', -5);
-    expect(text.attr).toHaveBeenCalledWith('class', 'testClass');
+    expect(svg_append_spy).toHaveBeenCalled();
+    expect(title_text_spy).toHaveBeenCalledWith('test title');
+  });
+
+  it('x value is the bounds x position + half of the bounds width', () => {
+    vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
+    const title_attr_spy = vi.spyOn(fauxTitle, 'attr');
+
+    utils.insertTitle(svg, 'testClass', 5, 'test title');
+    expect(title_attr_spy).toHaveBeenCalledWith('x', 10 + 100 / 2);
+  });
+
+  it('y value is - given title top margin', () => {
+    vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
+    const title_attr_spy = vi.spyOn(fauxTitle, 'attr');
+
+    utils.insertTitle(svg, 'testClass', 5, 'test title');
+    expect(title_attr_spy).toHaveBeenCalledWith('y', -5);
+  });
+
+  it('class is the given css class', () => {
+    vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
+    const title_attr_spy = vi.spyOn(fauxTitle, 'attr');
+
+    utils.insertTitle(svg, 'testClass', 5, 'test title');
+    expect(title_attr_spy).toHaveBeenCalledWith('class', 'testClass');
   });
 });

From 6e486d3c49fe3aa8a8480cf486f07a53838673ed Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Sun, 27 Nov 2022 10:32:25 -0800
Subject: [PATCH 043/129] add test for multi-line accDescr

---
 .../src/diagrams/er/parser/erDiagram.spec.js  | 28 +++++++++++++++----
 1 file changed, 22 insertions(+), 6 deletions(-)

diff --git a/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js b/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
index 6131f7697..43bc13e6d 100644
--- a/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
+++ b/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
@@ -323,18 +323,34 @@ describe('when parsing ER diagram it...', function () {
     expect(Object.keys(erDb.getEntities()).length).toBe(1);
   });
 
-  it('should allow for a accessibility title and description (accDescr)', function () {
+  describe('accessible title and description', () => {
     const teacherRole = 'is teacher of';
     const line1 = `TEACHER }o--o{ STUDENT : "${teacherRole}"`;
 
-    erDiagram.parser.parse(
-      `erDiagram
+    it('should allow for a accessibility title and description (accDescr)', function () {
+      erDiagram.parser.parse(
+        `erDiagram
       accTitle: graph title
       accDescr: this graph is about stuff
       ${line1}`
-    );
-    expect(erDb.getAccTitle()).toBe('graph title');
-    expect(erDb.getAccDescription()).toBe('this graph is about stuff');
+      );
+      expect(erDb.getAccTitle()).toBe('graph title');
+      expect(erDb.getAccDescription()).toBe('this graph is about stuff');
+    });
+
+    it('parses a multi line description (accDescr)', function () {
+      erDiagram.parser.parse(
+        `erDiagram
+      accTitle: graph title
+      accDescr { this graph is
+        about
+        stuff
+        }\n
+      ${line1}`
+      );
+      expect(erDb.getAccTitle()).toEqual('graph title');
+      expect(erDb.getAccDescription()).toEqual('this graph is\nabout\nstuff');
+    });
   });
 
   it('should allow more than one relationship between the same two entities', function () {

From 2030885fd3307829cee44a1c3187311e2dd5cae1 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Sun, 27 Nov 2022 10:46:43 -0800
Subject: [PATCH 044/129] update /docs

---
 docs/config/setup/modules/mermaidAPI.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/docs/config/setup/modules/mermaidAPI.md b/docs/config/setup/modules/mermaidAPI.md
index ef8a08b91..e236538e0 100644
--- a/docs/config/setup/modules/mermaidAPI.md
+++ b/docs/config/setup/modules/mermaidAPI.md
@@ -20,7 +20,7 @@ Renames and re-exports [mermaidAPI](mermaidAPI.md#mermaidapi)
 
 #### Defined in
 
-[mermaidAPI.ts:73](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L73)
+[mermaidAPI.ts:72](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L72)
 
 ## Variables
 
@@ -90,7 +90,7 @@ mermaid.initialize(config);
 
 #### Defined in
 
-[mermaidAPI.ts:960](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L960)
+[mermaidAPI.ts:959](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L959)
 
 ## Functions
 
@@ -121,7 +121,7 @@ Return the last node appended
 
 #### Defined in
 
-[mermaidAPI.ts:294](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L294)
+[mermaidAPI.ts:293](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L293)
 
 ---
 
@@ -147,7 +147,7 @@ the cleaned up svgCode
 
 #### Defined in
 
-[mermaidAPI.ts:245](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L245)
+[mermaidAPI.ts:244](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L244)
 
 ---
 
@@ -173,7 +173,7 @@ the string with all the user styles
 
 #### Defined in
 
-[mermaidAPI.ts:172](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L172)
+[mermaidAPI.ts:171](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L171)
 
 ---
 
@@ -196,7 +196,7 @@ the string with all the user styles
 
 #### Defined in
 
-[mermaidAPI.ts:222](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L222)
+[mermaidAPI.ts:221](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L221)
 
 ---
 
@@ -223,7 +223,7 @@ with an enclosing block that has each of the cssClasses followed by !important;
 
 #### Defined in
 
-[mermaidAPI.ts:156](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L156)
+[mermaidAPI.ts:155](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L155)
 
 ---
 
@@ -243,7 +243,7 @@ with an enclosing block that has each of the cssClasses followed by !important;
 
 #### Defined in
 
-[mermaidAPI.ts:130](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L130)
+[mermaidAPI.ts:129](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L129)
 
 ---
 
@@ -263,7 +263,7 @@ with an enclosing block that has each of the cssClasses followed by !important;
 
 #### Defined in
 
-[mermaidAPI.ts:101](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L101)
+[mermaidAPI.ts:100](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L100)
 
 ---
 
@@ -289,7 +289,7 @@ Put the svgCode into an iFrame. Return the iFrame code
 
 #### Defined in
 
-[mermaidAPI.ts:273](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L273)
+[mermaidAPI.ts:272](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L272)
 
 ---
 
@@ -315,4 +315,4 @@ Remove any existing elements from the given document
 
 #### Defined in
 
-[mermaidAPI.ts:345](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L345)
+[mermaidAPI.ts:344](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L344)

From 6044e9e9e820e1412515241b81e267091d43289c Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Sun, 27 Nov 2022 19:17:17 -0800
Subject: [PATCH 045/129] make test title clearer

---
 packages/mermaid/src/utils.spec.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/src/utils.spec.js b/packages/mermaid/src/utils.spec.js
index 769a0d0cc..1c40cd6cc 100644
--- a/packages/mermaid/src/utils.spec.js
+++ b/packages/mermaid/src/utils.spec.js
@@ -386,7 +386,7 @@ describe('when inserting titles', function () {
     expect(title_attr_spy).toHaveBeenCalledWith('x', 10 + 100 / 2);
   });
 
-  it('y value is - given title top margin', () => {
+  it('y value is the negative of given title top margin', () => {
     vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
     const title_attr_spy = vi.spyOn(fauxTitle, 'attr');
 

From 2bf753a769ed816dab2a2ea81860ff1d02934134 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Sun, 27 Nov 2022 19:17:37 -0800
Subject: [PATCH 046/129] use camelCase

---
 packages/mermaid/src/accessibility.spec.ts | 74 +++++++++++-----------
 packages/mermaid/src/utils.spec.js         | 24 +++----
 2 files changed, 49 insertions(+), 49 deletions(-)

diff --git a/packages/mermaid/src/accessibility.spec.ts b/packages/mermaid/src/accessibility.spec.ts
index 57d5e8933..c633d0e15 100644
--- a/packages/mermaid/src/accessibility.spec.ts
+++ b/packages/mermaid/src/accessibility.spec.ts
@@ -8,16 +8,16 @@ describe('accessibility', () => {
   describe('setA11yDiagramInfo', () => {
     it('sets the aria-roledescription to the diagram type', () => {
       // @ts-ignore  Required to easily handle the d3 select types
-      const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+      const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
       setA11yDiagramInfo(fauxSvgNode, 'flowchart');
-      expect(svg_attr_spy).toHaveBeenCalledWith('aria-roledescription', 'flowchart');
+      expect(svgAttrSpy).toHaveBeenCalledWith('aria-roledescription', 'flowchart');
     });
 
     it('does nothing if the diagram type is empty', () => {
       // @ts-ignore  Required to easily handle the d3 select types
-      const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+      const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
       setA11yDiagramInfo(fauxSvgNode, '');
-      expect(svg_attr_spy).not.toHaveBeenCalled();
+      expect(svgAttrSpy).not.toHaveBeenCalled();
     });
   });
 
@@ -29,9 +29,9 @@ describe('accessibility', () => {
         const noInsertSvg = {
           attr: vi.fn(),
         };
-        const noInsert_attr_spy = vi.spyOn(noInsertSvg, 'attr').mockReturnValue(noInsertSvg);
+        const noInsertAttrSpy = vi.spyOn(noInsertSvg, 'attr').mockReturnValue(noInsertSvg);
         addSVGa11yTitleDescription(noInsertSvg, 'some title', 'some desc', givenId);
-        expect(noInsert_attr_spy).not.toHaveBeenCalled();
+        expect(noInsertAttrSpy).not.toHaveBeenCalled();
       });
 
       // ----------------
@@ -44,9 +44,9 @@ describe('accessibility', () => {
         givenId: string
       ) {
         // @ts-ignore Required to easily handle the d3 select types
-        const svg_attr_spy = vi.spyOn(svgD3Node, 'attr').mockReturnValue(svgD3Node);
+        const svgAttrSpy = vi.spyOn(svgD3Node, 'attr').mockReturnValue(svgD3Node);
         addSVGa11yTitleDescription(svgD3Node, title, desc, givenId);
-        expect(svg_attr_spy).toHaveBeenCalledWith('aria-labelledby', `chart-title-${givenId}`);
+        expect(svgAttrSpy).toHaveBeenCalledWith('aria-labelledby', `chart-title-${givenId}`);
       }
 
       function expectAriaDescribedByIsDescId(
@@ -56,9 +56,9 @@ describe('accessibility', () => {
         givenId: string
       ) {
         // @ts-ignore Required to easily handle the d3 select types
-        const svg_attr_spy = vi.spyOn(svgD3Node, 'attr').mockReturnValue(svgD3Node);
+        const svgAttrSpy = vi.spyOn(svgD3Node, 'attr').mockReturnValue(svgD3Node);
         addSVGa11yTitleDescription(svgD3Node, title, desc, givenId);
-        expect(svg_attr_spy).toHaveBeenCalledWith('aria-describedby', `chart-desc-${givenId}`);
+        expect(svgAttrSpy).toHaveBeenCalledWith('aria-describedby', `chart-desc-${givenId}`);
       }
 
       function a11yTitleTagInserted(
@@ -90,16 +90,16 @@ describe('accessibility', () => {
         expectedPrefix: string,
         expectedText: string | null | undefined
       ) {
-        const faux_insertedD3 = new MockedD3();
-        const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_insertedD3);
+        const fauxInsertedD3 = new MockedD3();
+        const svgInsertSpy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(fauxInsertedD3);
         // @ts-ignore  Required to easily handle the d3 select types
-        const title_attr_spy = vi.spyOn(faux_insertedD3, 'attr').mockReturnValue(faux_insertedD3);
-        const title_text_spy = vi.spyOn(faux_insertedD3, 'text');
+        const titleAttrSpy = vi.spyOn(fauxInsertedD3, 'attr').mockReturnValue(fauxInsertedD3);
+        const titleTextSpy = vi.spyOn(fauxInsertedD3, 'text');
 
         addSVGa11yTitleDescription(fauxSvgNode, title, desc, givenId);
-        expect(svg_insert_spy).toHaveBeenCalledWith(expectedPrefix, ':first-child');
-        expect(title_attr_spy).toHaveBeenCalledWith('id', `chart-${expectedPrefix}-${givenId}`);
-        expect(title_text_spy).toHaveBeenNthCalledWith(callNumber, expectedText);
+        expect(svgInsertSpy).toHaveBeenCalledWith(expectedPrefix, ':first-child');
+        expect(titleAttrSpy).toHaveBeenCalledWith('id', `chart-${expectedPrefix}-${givenId}`);
+        expect(titleTextSpy).toHaveBeenNthCalledWith(callNumber, expectedText);
       }
       // ----------------
 
@@ -135,9 +135,9 @@ describe('accessibility', () => {
 
           it('no aria-describedby is set', () => {
             // @ts-ignore Required to easily handle the d3 select types
-            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_attr_spy).not.toHaveBeenCalledWith('aria-describedby', expect.anything());
+            expect(svgAttrSpy).not.toHaveBeenCalledWith('aria-describedby', expect.anything());
           });
 
           it('inserts a title tag as the first child with the text set to the accTitle given', () => {
@@ -145,10 +145,10 @@ describe('accessibility', () => {
           });
 
           it('no description tag is inserted', () => {
-            const faux_title = new MockedD3();
-            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+            const fauxTitle = new MockedD3();
+            const svgInsertSpy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(fauxTitle);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_insert_spy).not.toHaveBeenCalledWith('desc', ':first-child');
+            expect(svgInsertSpy).not.toHaveBeenCalledWith('desc', ':first-child');
           });
         });
       });
@@ -161,16 +161,16 @@ describe('accessibility', () => {
 
           it('no aria-labelledby is set', () => {
             // @ts-ignore Required to easily handle the d3 select types
-            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_attr_spy).not.toHaveBeenCalledWith('aria-labelledby', expect.anything());
+            expect(svgAttrSpy).not.toHaveBeenCalledWith('aria-labelledby', expect.anything());
           });
 
           it('no title tag inserted', () => {
-            const faux_title = new MockedD3();
-            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+            const fauxTitle = new MockedD3();
+            const svgInsertSpy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(fauxTitle);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_insert_spy).not.toHaveBeenCalledWith('title', ':first-child');
+            expect(svgInsertSpy).not.toHaveBeenCalledWith('title', ':first-child');
           });
 
           it('sets aria-describedby to the description id inserted as a child', () => {
@@ -187,30 +187,30 @@ describe('accessibility', () => {
 
           it('no aria-labelledby is set', () => {
             // @ts-ignore Required to easily handle the d3 select types
-            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_attr_spy).not.toHaveBeenCalledWith('aria-labelledby', expect.anything());
+            expect(svgAttrSpy).not.toHaveBeenCalledWith('aria-labelledby', expect.anything());
           });
 
           it('no aria-describedby is set', () => {
             // @ts-ignore Required to easily handle the d3 select types
-            const svg_attr_spy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+            const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_attr_spy).not.toHaveBeenCalledWith('aria-describedby', expect.anything());
+            expect(svgAttrSpy).not.toHaveBeenCalledWith('aria-describedby', expect.anything());
           });
 
           it('no title tag inserted', () => {
-            const faux_title = new MockedD3();
-            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_title);
+            const fauxTitle = new MockedD3();
+            const svgInsertSpy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(fauxTitle);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_insert_spy).not.toHaveBeenCalledWith('title', ':first-child');
+            expect(svgInsertSpy).not.toHaveBeenCalledWith('title', ':first-child');
           });
 
           it('no description tag inserted', () => {
-            const faux_desc = new MockedD3();
-            const svg_insert_spy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(faux_desc);
+            const fauxDesc = new MockedD3();
+            const svgInsertSpy = vi.spyOn(fauxSvgNode, 'insert').mockReturnValue(fauxDesc);
             addSVGa11yTitleDescription(fauxSvgNode, a11yTitle, a11yDesc, givenId);
-            expect(svg_insert_spy).not.toHaveBeenCalledWith('desc', ':first-child');
+            expect(svgInsertSpy).not.toHaveBeenCalledWith('desc', ':first-child');
           });
         });
       });
diff --git a/packages/mermaid/src/utils.spec.js b/packages/mermaid/src/utils.spec.js
index 1c40cd6cc..e983d21c8 100644
--- a/packages/mermaid/src/utils.spec.js
+++ b/packages/mermaid/src/utils.spec.js
@@ -364,41 +364,41 @@ describe('when inserting titles', function () {
   });
 
   it('does nothing if the title is empty', function () {
-    const svg_append_spy = vi.spyOn(svg, 'append');
+    const svgAppendSpy = vi.spyOn(svg, 'append');
     utils.insertTitle(svg, 'testClass', 0, '');
-    expect(svg_append_spy).not.toHaveBeenCalled();
+    expect(svgAppendSpy).not.toHaveBeenCalled();
   });
 
   it('appends the title as a text item with the given title text', function () {
-    const svg_append_spy = vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
-    const title_text_spy = vi.spyOn(fauxTitle, 'text');
+    const svgAppendSpy = vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
+    const titleTextSpy = vi.spyOn(fauxTitle, 'text');
 
     utils.insertTitle(svg, 'testClass', 5, 'test title');
-    expect(svg_append_spy).toHaveBeenCalled();
-    expect(title_text_spy).toHaveBeenCalledWith('test title');
+    expect(svgAppendSpy).toHaveBeenCalled();
+    expect(titleTextSpy).toHaveBeenCalledWith('test title');
   });
 
   it('x value is the bounds x position + half of the bounds width', () => {
     vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
-    const title_attr_spy = vi.spyOn(fauxTitle, 'attr');
+    const titleAttrSpy = vi.spyOn(fauxTitle, 'attr');
 
     utils.insertTitle(svg, 'testClass', 5, 'test title');
-    expect(title_attr_spy).toHaveBeenCalledWith('x', 10 + 100 / 2);
+    expect(titleAttrSpy).toHaveBeenCalledWith('x', 10 + 100 / 2);
   });
 
   it('y value is the negative of given title top margin', () => {
     vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
-    const title_attr_spy = vi.spyOn(fauxTitle, 'attr');
+    const titleAttrSpy = vi.spyOn(fauxTitle, 'attr');
 
     utils.insertTitle(svg, 'testClass', 5, 'test title');
-    expect(title_attr_spy).toHaveBeenCalledWith('y', -5);
+    expect(titleAttrSpy).toHaveBeenCalledWith('y', -5);
   });
 
   it('class is the given css class', () => {
     vi.spyOn(svg, 'append').mockReturnValue(fauxTitle);
-    const title_attr_spy = vi.spyOn(fauxTitle, 'attr');
+    const titleAttrSpy = vi.spyOn(fauxTitle, 'attr');
 
     utils.insertTitle(svg, 'testClass', 5, 'test title');
-    expect(title_attr_spy).toHaveBeenCalledWith('class', 'testClass');
+    expect(titleAttrSpy).toHaveBeenCalledWith('class', 'testClass');
   });
 });

From 6f2b0c43cb91b97431667c209dfc2e267da8e23c Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Wed, 30 Nov 2022 12:43:27 -0800
Subject: [PATCH 047/129] delete functions not used in diagrams/c4 code (dead
 code)

---
 packages/mermaid/src/diagrams/c4/svgDraw.js | 200 +-------------------
 1 file changed, 1 insertion(+), 199 deletions(-)

diff --git a/packages/mermaid/src/diagrams/c4/svgDraw.js b/packages/mermaid/src/diagrams/c4/svgDraw.js
index d9727f074..d3d66a80d 100644
--- a/packages/mermaid/src/diagrams/c4/svgDraw.js
+++ b/packages/mermaid/src/diagrams/c4/svgDraw.js
@@ -35,183 +35,6 @@ export const drawImage = function (elem, width, height, x, y, link) {
   imageElem.attr('xlink:href', sanitizedLink);
 };
 
-export const drawEmbeddedImage = function (elem, x, y, link) {
-  const imageElem = elem.append('use');
-  imageElem.attr('x', x);
-  imageElem.attr('y', y);
-  var sanitizedLink = sanitizeUrl(link);
-  imageElem.attr('xlink:href', '#' + sanitizedLink);
-};
-
-export const drawText = function (elem, textData) {
-  let prevTextHeight = 0,
-    textHeight = 0;
-  const lines = textData.text.split(common.lineBreakRegex);
-
-  let textElems = [];
-  let dy = 0;
-  let yfunc = () => textData.y;
-  if (
-    textData.valign !== undefined &&
-    textData.textMargin !== undefined &&
-    textData.textMargin > 0
-  ) {
-    switch (textData.valign) {
-      case 'top':
-      case 'start':
-        yfunc = () => Math.round(textData.y + textData.textMargin);
-        break;
-      case 'middle':
-      case 'center':
-        yfunc = () =>
-          Math.round(textData.y + (prevTextHeight + textHeight + textData.textMargin) / 2);
-        break;
-      case 'bottom':
-      case 'end':
-        yfunc = () =>
-          Math.round(
-            textData.y +
-              (prevTextHeight + textHeight + 2 * textData.textMargin) -
-              textData.textMargin
-          );
-        break;
-    }
-  }
-  if (
-    textData.anchor !== undefined &&
-    textData.textMargin !== undefined &&
-    textData.width !== undefined
-  ) {
-    switch (textData.anchor) {
-      case 'left':
-      case 'start':
-        textData.x = Math.round(textData.x + textData.textMargin);
-        textData.anchor = 'start';
-        textData.dominantBaseline = 'text-after-edge';
-        textData.alignmentBaseline = 'middle';
-        break;
-      case 'middle':
-      case 'center':
-        textData.x = Math.round(textData.x + textData.width / 2);
-        textData.anchor = 'middle';
-        textData.dominantBaseline = 'middle';
-        textData.alignmentBaseline = 'middle';
-        break;
-      case 'right':
-      case 'end':
-        textData.x = Math.round(textData.x + textData.width - textData.textMargin);
-        textData.anchor = 'end';
-        textData.dominantBaseline = 'text-before-edge';
-        textData.alignmentBaseline = 'middle';
-        break;
-    }
-  }
-  for (let [i, line] of lines.entries()) {
-    if (
-      textData.textMargin !== undefined &&
-      textData.textMargin === 0 &&
-      textData.fontSize !== undefined
-    ) {
-      dy = i * textData.fontSize;
-    }
-
-    const textElem = elem.append('text');
-    textElem.attr('x', textData.x);
-    textElem.attr('y', yfunc());
-    if (textData.anchor !== undefined) {
-      textElem
-        .attr('text-anchor', textData.anchor)
-        .attr('dominant-baseline', textData.dominantBaseline)
-        .attr('alignment-baseline', textData.alignmentBaseline);
-    }
-    if (textData.fontFamily !== undefined) {
-      textElem.style('font-family', textData.fontFamily);
-    }
-    if (textData.fontSize !== undefined) {
-      textElem.style('font-size', textData.fontSize);
-    }
-    if (textData.fontWeight !== undefined) {
-      textElem.style('font-weight', textData.fontWeight);
-    }
-    if (textData.fill !== undefined) {
-      textElem.attr('fill', textData.fill);
-    }
-    if (textData.class !== undefined) {
-      textElem.attr('class', textData.class);
-    }
-    if (textData.dy !== undefined) {
-      textElem.attr('dy', textData.dy);
-    } else if (dy !== 0) {
-      textElem.attr('dy', dy);
-    }
-
-    if (textData.tspan) {
-      const span = textElem.append('tspan');
-      span.attr('x', textData.x);
-      if (textData.fill !== undefined) {
-        span.attr('fill', textData.fill);
-      }
-      span.text(line);
-    } else {
-      textElem.text(line);
-    }
-    if (
-      textData.valign !== undefined &&
-      textData.textMargin !== undefined &&
-      textData.textMargin > 0
-    ) {
-      textHeight += (textElem._groups || textElem)[0][0].getBBox().height;
-      prevTextHeight = textHeight;
-    }
-
-    textElems.push(textElem);
-  }
-
-  return textElems;
-};
-
-export const drawLabel = function (elem, txtObject) {
-  /**
-   * @param {any} x
-   * @param {any} y
-   * @param {any} width
-   * @param {any} height
-   * @param {any} cut
-   * @returns {any}
-   */
-  function genPoints(x, y, width, height, cut) {
-    return (
-      x +
-      ',' +
-      y +
-      ' ' +
-      (x + width) +
-      ',' +
-      y +
-      ' ' +
-      (x + width) +
-      ',' +
-      (y + height - cut) +
-      ' ' +
-      (x + width - cut * 1.2) +
-      ',' +
-      (y + height) +
-      ' ' +
-      x +
-      ',' +
-      (y + height)
-    );
-  }
-  const polygon = elem.append('polygon');
-  polygon.attr('points', genPoints(txtObject.x, txtObject.y, txtObject.width, txtObject.height, 7));
-  polygon.attr('class', 'labelBox');
-
-  txtObject.y = txtObject.y + txtObject.height / 2;
-
-  drawText(elem, txtObject);
-  return polygon;
-};
-
 export const drawRels = (elem, rels, conf) => {
   const relsElem = elem.append('g');
   let i = 0;
@@ -744,23 +567,6 @@ export const insertArrowCrossHead = function (elem) {
   // this is actual shape for arrowhead
 };
 
-export const getTextObj = function () {
-  return {
-    x: 0,
-    y: 0,
-    fill: undefined,
-    anchor: undefined,
-    style: '#666',
-    width: undefined,
-    height: undefined,
-    textMargin: 0,
-    rx: 0,
-    ry: 0,
-    tspan: true,
-    valign: undefined,
-  };
-};
-
 export const getNoteRect = function () {
   return {
     x: 0,
@@ -895,13 +701,10 @@ const _drawTextCandidateFunc = (function () {
 
 export default {
   drawRect,
-  drawText,
-  drawLabel,
   drawBoundary,
   drawC4Shape,
   drawRels,
   drawImage,
-  drawEmbeddedImage,
   insertArrowHead,
   insertArrowEnd,
   insertArrowFilledHead,
@@ -910,7 +713,6 @@ export default {
   insertDatabaseIcon,
   insertComputerIcon,
   insertClockIcon,
-  getTextObj,
   getNoteRect,
-  sanitizeUrl,
+  sanitizeUrl, // TODO why is this exported?
 };

From cd0eae28079658a5ff30e8a8bb6e99b8ae568334 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Thu, 1 Dec 2022 11:23:50 +0530
Subject: [PATCH 048/129] chore: Switch back from unpkg to jsdelivr

---
 docs/config/usage.md              | 4 ++--
 docs/intro/index.md               | 2 +-
 docs/intro/n00b-gettingStarted.md | 4 ++--
 docs/syntax/mindmap.md            | 4 ++--
 packages/mermaid/src/docs.mts     | 2 +-
 5 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/config/usage.md b/docs/config/usage.md
index 29273e9b5..476806d8f 100644
--- a/docs/config/usage.md
+++ b/docs/config/usage.md
@@ -62,7 +62,7 @@ Example:
 
 ```html
 <script type="module">
-  import mermaid from 'https://unpkg.com/mermaid@9/dist/mermaid.esm.min.mjs';
+  import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@9/dist/mermaid.esm.min.mjs';
   mermaid.initialize({ startOnLoad: true });
 </script>
 ```
@@ -85,7 +85,7 @@ Example:
       B-->D(fa:fa-spinner);
     </pre>
     <script type="module">
-      import mermaid from 'https://unpkg.com/mermaid@9/dist/mermaid.esm.min.mjs';
+      import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@9/dist/mermaid.esm.min.mjs';
       mermaid.initialize({ startOnLoad: true });
     </script>
   </body>
diff --git a/docs/intro/index.md b/docs/intro/index.md
index b8a27acff..5aa068e27 100644
--- a/docs/intro/index.md
+++ b/docs/intro/index.md
@@ -267,7 +267,7 @@ To Deploy Mermaid:
 
 ```html
 <script type="module">
-  import mermaid from 'https://unpkg.com/mermaid@9/dist/mermaid.esm.min.mjs';
+  import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@9/dist/mermaid.esm.min.mjs';
   mermaid.initialize({ startOnLoad: true });
 </script>
 ```
diff --git a/docs/intro/n00b-gettingStarted.md b/docs/intro/n00b-gettingStarted.md
index 2f422758e..7354f0181 100644
--- a/docs/intro/n00b-gettingStarted.md
+++ b/docs/intro/n00b-gettingStarted.md
@@ -128,7 +128,7 @@ b. The importing of mermaid library through the `mermaid.esm.js` or `mermaid.esm
 ```html
 <body>
   <script type="module">
-    import mermaid from 'https://unpkg.com/mermaid@9/dist/mermaid.esm.min.mjs';
+    import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@9/dist/mermaid.esm.min.mjs';
     mermaid.initialize({ startOnLoad: true });
   </script>
 </body>
@@ -172,7 +172,7 @@ Please refer to the [Mindmap](./mindmap.md?id=integrating-with-your-librarywebsi
     </pre>
 
     <script type="module">
-      import mermaid from 'https://unpkg.com/mermaid@9/dist/mermaid.esm.min.mjs';
+      import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@9/dist/mermaid.esm.min.mjs';
       mermaid.initialize({ startOnLoad: true });
     </script>
   </body>
diff --git a/docs/syntax/mindmap.md b/docs/syntax/mindmap.md
index e789646bc..0214a5512 100644
--- a/docs/syntax/mindmap.md
+++ b/docs/syntax/mindmap.md
@@ -260,8 +260,8 @@ Mindmap uses the experimental lazy loading & async rendering features which coul
 
 ```html
 <script type="module">
-  import mermaid from 'https://unpkg.com/mermaid@9/dist/mermaid.esm.min.mjs';
-  import mindmap from 'https://unpkg.com/@mermaid-js/mermaid-mindmap@9/dist/mermaid-mindmap.esm.min.mjs';
+  import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@9/dist/mermaid.esm.min.mjs';
+  import mindmap from 'https://cdn.jsdelivr.net/npm/@mermaid-js/mermaid-mindmap@9/dist/mermaid-mindmap.esm.min.mjs';
   await mermaid.registerExternalDiagrams([mindmap]);
 </script>
 ```
diff --git a/packages/mermaid/src/docs.mts b/packages/mermaid/src/docs.mts
index 846e92212..313d1f2de 100644
--- a/packages/mermaid/src/docs.mts
+++ b/packages/mermaid/src/docs.mts
@@ -46,7 +46,7 @@ import flatmap from 'unist-util-flatmap';
 const MERMAID_MAJOR_VERSION = (
   JSON.parse(readFileSync('../mermaid/package.json', 'utf8')).version as string
 ).split('.')[0];
-const CDN_URL = 'https://unpkg.com'; // https://cdn.jsdelivr.net/npm
+const CDN_URL = 'https://cdn.jsdelivr.net/npm'; // 'https://unpkg.com';
 
 const verifyOnly: boolean = process.argv.includes('--verify');
 const git: boolean = process.argv.includes('--git');

From 1e30e33ad321826f55f2ebdf19db52b7f747cf19 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Thu, 1 Dec 2022 13:51:50 +0530
Subject: [PATCH 049/129] chore: Fix mindmap link

---
 docs/intro/n00b-gettingStarted.md                      | 2 +-
 packages/mermaid/src/docs/intro/n00b-gettingStarted.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/intro/n00b-gettingStarted.md b/docs/intro/n00b-gettingStarted.md
index 7354f0181..2a05a1fdd 100644
--- a/docs/intro/n00b-gettingStarted.md
+++ b/docs/intro/n00b-gettingStarted.md
@@ -145,7 +145,7 @@ Rendering in Mermaid is initialized by `mermaid.initialize()` call. You can plac
 
 ### Adding external diagrams to mermaid
 
-Please refer to the [Mindmap](./mindmap.md?id=integrating-with-your-librarywebsite) section for more information.
+Please refer to the [Mindmap](../syntax/mindmap.md?id=integrating-with-your-librarywebsite) section for more information.
 
 ### Working Examples
 
diff --git a/packages/mermaid/src/docs/intro/n00b-gettingStarted.md b/packages/mermaid/src/docs/intro/n00b-gettingStarted.md
index e17bbffb9..a4dd7662f 100644
--- a/packages/mermaid/src/docs/intro/n00b-gettingStarted.md
+++ b/packages/mermaid/src/docs/intro/n00b-gettingStarted.md
@@ -128,7 +128,7 @@ Rendering in Mermaid is initialized by `mermaid.initialize()` call. You can plac
 
 ### Adding external diagrams to mermaid
 
-Please refer to the [Mindmap](./mindmap.md?id=integrating-with-your-librarywebsite) section for more information.
+Please refer to the [Mindmap](../syntax/mindmap.md?id=integrating-with-your-librarywebsite) section for more information.
 
 ### Working Examples
 

From bfe3f309d26f632eee2ed7f2a7543f7258c832d3 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 1 Dec 2022 10:09:43 -0800
Subject: [PATCH 050/129] remove typeof

---
 packages/mermaid/src/accessibility.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/src/accessibility.ts b/packages/mermaid/src/accessibility.ts
index d70ad00d3..b9e088e0b 100644
--- a/packages/mermaid/src/accessibility.ts
+++ b/packages/mermaid/src/accessibility.ts
@@ -34,7 +34,7 @@ export function addSVGa11yTitleDescription(
   a11yDesc: string | null | undefined,
   baseId: string
 ) {
-  if (typeof svg.insert === 'undefined') {
+  if (svg.insert === undefined) {
     return;
   }
 

From c7471f17558856c8f91dec7b8e4908f84c4df350 Mon Sep 17 00:00:00 2001
From: MrCoder <eagle.xiao@gmail.com>
Date: Sat, 3 Dec 2022 19:10:05 +1100
Subject: [PATCH 051/129] Fixed the issue that theme-switch does not work on
 docs.

---
 packages/mermaid/src/docs/.vitepress/theme/mermaid.ts | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts b/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
index b287346f9..fef090ea9 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
+++ b/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
@@ -8,7 +8,9 @@ try {
 }
 
 export const render = async (id: string, code: string, config: MermaidConfig): Promise<string> => {
-  mermaid.initialize(config);
+  // make a clone of config, so we don't mutate the original
+  const mermaidConfig = { ...config };
+  mermaid.initialize(mermaidConfig);
   const svg = await mermaid.renderAsync(id, code);
   return svg;
 };

From a1e4ffb3f08e38bb02945e33f02b7992c3f99a2c Mon Sep 17 00:00:00 2001
From: MrCoder <eagle.xiao@gmail.com>
Date: Sat, 3 Dec 2022 19:30:09 +1100
Subject: [PATCH 052/129] Fixed an issue that diagrams disappear from docs
 pages when switching themes or reloading pages

---
 packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue b/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
index 9ae9c9f3b..c99141601 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
+++ b/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
@@ -61,6 +61,13 @@ const renderChart = async () => {
   mermaidConfig.theme = hasDarkClass ? 'dark' : 'default';
 
   console.log({ mermaidConfig });
-  svg.value = await render(props.id, decodeURIComponent(props.graph), mermaidConfig);
+  let svgCode = await render(props.id, decodeURIComponent(props.graph), mermaidConfig);
+  // This is a hack to force v-html to re-render, otherwise the diagram disappears
+  // when **switching themes** or **reloading the page**.
+  // The cause is that the diagram is deleted during rendering (out of Vue's knowledge).
+  // Because svgCode does NOT change, v-html does not re-render.
+  // This is not required for all diagrams, but it is required for c4c, mindmap and zenuml.
+  const salt = Math.random().toString(36).substring(7);
+  svg.value = `${svgCode} <span style="display: none">${salt}</span>`;
 };
 </script>

From b68fee7e65274f6f8a52cc26cb9e3094c3bb88a1 Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knsv@sveido.com>
Date: Sat, 3 Dec 2022 11:41:29 +0100
Subject: [PATCH 053/129] Small fix for issue #3881

---
 cypress/platform/knsv2.html                   | 39 +++++++------------
 .../mermaid/src/dagre-wrapper/clusters.js     |  8 ++--
 2 files changed, 18 insertions(+), 29 deletions(-)

diff --git a/cypress/platform/knsv2.html b/cypress/platform/knsv2.html
index ba7f41601..fb2fe7f9b 100644
--- a/cypress/platform/knsv2.html
+++ b/cypress/platform/knsv2.html
@@ -56,29 +56,24 @@
   <body>
     <div>Security check</div>
     <pre id="diagram" class="mermaid">
-graph LR
+flowchart LR
     subgraph external
-        inside
+      subgraph internal
+          inside
+      end
     end
-    outside --> external
+    outside --> inside
     </pre>
     <pre id="diagram" class="mermaid">
-mindmap
-  root
-    child1((Circle))
-        grandchild 1
-        grandchild 2
-    child2(Round rectangle)
-        grandchild 3
-        grandchild 4
-    child3[Square]
-        grandchild 5
-        ::icon(mdi mdi-fire)
-        gc6((grand<br/>child 6))
-        ::icon(mdi mdi-fire)
-          gc7((grand<br/>grand<br/>child 8))
-        </pre>
-    <pre id="diagram" class="mermaid">
+flowchart LR
+    subgraph parent
+      subgraph childB
+        grandchild
+      end
+    end
+    foo --> childA        </pre
+    >
+    <pre id="diagram" class="mermaid2">
       gantt
         title Style today marker (vertical line should be 5px wide and half-transparent blue)
         dateFormat YYYY-MM-DD
@@ -103,7 +98,7 @@ mindmap
         // console.error('Mermaid error: ', err);
       };
       mermaid.initialize({
-        theme: 'base',
+        theme: 'default',
         startOnLoad: true,
         logLevel: 0,
         flowchart: {
@@ -114,10 +109,6 @@ mindmap
           useMaxWidth: false,
         },
         useMaxWidth: false,
-        lazyLoadedDiagrams: [
-          './mermaid-mindmap-detector.esm.mjs',
-          './mermaid-example-diagram-detector.esm.mjs',
-        ],
       });
       function callback() {
         alert('It worked');
diff --git a/packages/mermaid/src/dagre-wrapper/clusters.js b/packages/mermaid/src/dagre-wrapper/clusters.js
index 40729dead..57c3ff513 100644
--- a/packages/mermaid/src/dagre-wrapper/clusters.js
+++ b/packages/mermaid/src/dagre-wrapper/clusters.js
@@ -59,11 +59,9 @@ const rect = (parent, node) => {
   // Center the label
   label.attr(
     'transform',
-    'translate(' +
-      (node.x - bbox.width / 2) +
-      ', ' +
-      (node.y - node.height / 2 + node.padding / 3) +
-      ')'
+    // This puts the labal on top of the box instead of inside it
+    // 'translate(' + (node.x - bbox.width / 2) + ', ' + (node.y - node.height / 2 - bbox.height) + ')'
+    'translate(' + (node.x - bbox.width / 2) + ', ' + (node.y - node.height / 2) + ')'
   );
 
   const rectBox = rect.node().getBBox();

From 4124d186d0b3b270c281db26d6c6d233626c6333 Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knsv@sveido.com>
Date: Sat, 3 Dec 2022 13:21:10 +0100
Subject: [PATCH 054/129] Fix for issue #3882 moving the label when the path
 has been modified

---
 cypress/platform/knsv2.html                 | 32 ++++++++++++---------
 packages/mermaid/src/dagre-wrapper/edges.js | 20 ++++++++++---
 2 files changed, 35 insertions(+), 17 deletions(-)

diff --git a/cypress/platform/knsv2.html b/cypress/platform/knsv2.html
index fb2fe7f9b..83472039d 100644
--- a/cypress/platform/knsv2.html
+++ b/cypress/platform/knsv2.html
@@ -57,22 +57,28 @@
     <div>Security check</div>
     <pre id="diagram" class="mermaid">
 flowchart LR
-    subgraph external
-      subgraph internal
-          inside
-      end
+    %% Actors
+    A
+    subgraph Sub
+        B --> C
     end
-    outside --> inside
+
+    %% Accusations
+    A --L --> Sub
+
+    %% Offense
+    B --> A
+
     </pre>
     <pre id="diagram" class="mermaid">
-flowchart LR
-    subgraph parent
-      subgraph childB
-        grandchild
-      end
-    end
-    foo --> childA        </pre
-    >
+      stateDiagram-v2
+
+      [*] --> S1
+      S1 --> S2: long line using<br/>should work
+      S1 --> S3: long line using <br>should work
+      S1 --> S4: long line using \\nshould work
+
+    </pre>
     <pre id="diagram" class="mermaid2">
       gantt
         title Style today marker (vertical line should be 5px wide and half-transparent blue)
diff --git a/packages/mermaid/src/dagre-wrapper/edges.js b/packages/mermaid/src/dagre-wrapper/edges.js
index 5213d0684..bb22cee83 100644
--- a/packages/mermaid/src/dagre-wrapper/edges.js
+++ b/packages/mermaid/src/dagre-wrapper/edges.js
@@ -130,9 +130,21 @@ export const positionEdgeLabel = (edge, paths) => {
     if (path) {
       //   // debugger;
       const pos = utils.calcLabelPosition(path);
-      log.info('Moving label from (', x, ',', y, ') to (', pos.x, ',', pos.y, ') abc78');
-      // x = pos.x;
-      // y = pos.y;
+      log.info(
+        'Moving label ' + edge.label + ' from (',
+        x,
+        ',',
+        y,
+        ') to (',
+        pos.x,
+        ',',
+        pos.y,
+        ') abc78'
+      );
+      if (paths.updatedPath) {
+        x = pos.x;
+        y = pos.y;
+      }
     }
     el.attr('transform', 'translate(' + x + ', ' + y + ')');
   }
@@ -463,7 +475,7 @@ export const insertEdge = function (elem, e, edge, clusterDb, diagramType, graph
     .attr('style', edge.style);
 
   // DEBUG code, adds a red circle at each edge coordinate
-  // edge.points.forEach(point => {
+  // edge.points.forEach((point) => {
   //   elem
   //     .append('circle')
   //     .style('stroke', 'red')

From d451a0c508b4ffd7ffd5cd82de8a3088fea308f0 Mon Sep 17 00:00:00 2001
From: steph <steph@huynhicode.dev>
Date: Sun, 4 Dec 2022 21:20:09 -0800
Subject: [PATCH 055/129] refactor theming doc

---
 docs/config/theming.md                      | 814 ++++----------------
 packages/mermaid/src/docs/config/theming.md | 551 ++++---------
 2 files changed, 276 insertions(+), 1089 deletions(-)

diff --git a/docs/config/theming.md b/docs/config/theming.md
index cfd86caa0..6c12ee75f 100644
--- a/docs/config/theming.md
+++ b/docs/config/theming.md
@@ -6,31 +6,27 @@
 
 # Theme Configuration
 
-With Version 8.7.0 Mermaid comes out with a system for dynamic and integrated configuration of themes. The intent is to increase the customizability and ease of styling for mermaid diagrams.
+Dynamic and integrated theme configuration was introduced in Mermaid version 8.7.0.
 
-The theme can be altered by changing the root level variable `theme` variable in the configuration. To change it for the whole site you must use the `initialize` call. To do it for just for a single diagram you can use the `%%init%%` directive
+Themes can now be customized at the site-wide level, or on individual Mermaid diagrams. For site-wide theme customization, the `initialize` call is used. For diagram specific customization, the `init` directive is used.
 
-Themes follow and build upon the Levels of Configuration, and employ `directives` to modify and create custom configurations, as they were introduced in Version [8.6.0](./8.6.0_docs.md).
+## Available Themes
 
-## Deployable Themes
+1.  **default** - This is the default theme for all diagrams.
 
-The following are a list of **Deployable themes**, sample `%%init%%` directives and `initialize` calls.
+2.  **neutral** - This theme is great for black and white documents that will be printed.
 
-1.  **base**- Designed to be modified, as the name implies it is supposed to be used as the base for making custom themes.
+3.  **dark** - This theme goes well with dark-colored elements or dark-mode.
 
-2.  **forest**- A theme full of light greens that is easy on the eyes.
+4.  **forest** - This theme contains shades of green.
 
-3.  **dark**- A theme that would go well with other dark-colored elements.
+5.  **base** - This is the only theme that can be modified. Use this theme as the base for customizations.
 
-4.  **default**- The default theme for all diagrams.
+## Site-wide Theme
 
-5.  **neutral**- The theme to be used for black and white printing.
+To customize themes site-wide, call the `initialize` method on the `mermaidAPI`.
 
-## Site-wide Themes
-
-Site-wide themes are declared via `initialize` by site owners.
-
-Example of `Initialize` call setting `theme` to `base`:
+Example of `initialize` call setting `theme` to `base`:
 
 ```javascript
 mermaidAPI.initialize({
@@ -39,28 +35,52 @@ mermaidAPI.initialize({
 });
 ```
 
-**Notes**: Only site owners can use the `mermaidAPI.initialize` call, to set values. Site-Users will have to use `%%init%%` to modify or create the theme for their diagrams.
+## Diagram-specific Themes
 
-## Themes at the Local or Current Level
+To customize the theme of an individual diagram, use the `init` directive.
 
-When Generating a diagram using on a webpage that supports mermaid. It is also possible to override site-wide theme settings locally, for a specific diagram, using directives, as long as it is not prohibited by the `secure` array.
+Example of `init` directive setting the `theme` to `forest`:
 
 ```mermaid-example
-%%{init: {'theme':'base'}}%%
+%%{init: {'theme':'forest'}}%%
   graph TD
     a --> b
 ```
 
 ```mermaid
-%%{init: {'theme':'base'}}%%
+%%{init: {'theme':'forest'}}%%
   graph TD
     a --> b
 ```
 
-Here is an example of how `%%init%%` can set the theme to 'base', this assumes that `themeVariables` are set to default:
+> **Reminder**: the only theme that can be customed is the `base` theme. The following section covers how to use `themeVariables` for customizations.
+
+## Customizing Themes with `themeVariables`
+
+To make a custom theme, modify `themeVariables` via `init`.
+
+You will need to use the [base](#available-themes) theme as it is the only modifiable theme.
+
+| Parameter      | Description                          | Type   | Properties                                                                                          |
+| -------------- | ------------------------------------ | ------ | --------------------------------------------------------------------------------------------------- |
+| themeVariables | Modifiable with the `init` directive | Object | `primaryColor`, `primaryTextColor`, `lineColor` ([see full list](#theme-variables-reference-table)) |
+
+Example of modifying `themeVariables` using the `init` directive:
 
 ```mermaid-example
-%%{init: {'theme':'base'}}%%
+%%{
+  init: {
+    'theme': 'base',
+    'themeVariables': {
+      'primaryColor': '#BB2528',
+      'primaryTextColor': '#fff',
+      'primaryBorderColor': '#7C0000',
+      'lineColor': '#F8B229',
+      'secondaryColor': '#006100',
+      'tertiaryColor': '#fff'
+    }
+  }
+}%%
         graph TD
           A[Christmas] -->|Get money| B(Go shopping)
           B --> C{Let me think}
@@ -78,7 +98,19 @@ Here is an example of how `%%init%%` can set the theme to 'base', this assumes t
 ```
 
 ```mermaid
-%%{init: {'theme':'base'}}%%
+%%{
+  init: {
+    'theme': 'base',
+    'themeVariables': {
+      'primaryColor': '#BB2528',
+      'primaryTextColor': '#fff',
+      'primaryBorderColor': '#7C0000',
+      'lineColor': '#F8B229',
+      'secondaryColor': '#006100',
+      'tertiaryColor': '#fff'
+    }
+  }
+}%%
         graph TD
           A[Christmas] -->|Get money| B(Go shopping)
           B --> C{Let me think}
@@ -95,649 +127,93 @@ Here is an example of how `%%init%%` can set the theme to 'base', this assumes t
           end
 ```
 
-# List of Themes
-
-# Customizing Themes with `themeVariables`
-
-The easiest way to make a custom theme is to start with the base theme, and just modify theme variables through `themeVariables`, via `%%init%%`.
-
-| Parameter      | Description                                                        | Type  | Required | Objects contained                  |
-| -------------- | ------------------------------------------------------------------ | ----- | -------- | ---------------------------------- |
-| themeVariables | Array containing objects, modifiable with the `%%init%%` directive | Array | Required | primaryColor, lineColor, textColor |
-
-**Here is an example of overriding `primaryColor` through `themeVariables` and giving everything a different look, using `%%init%%`.**
-
-```mermaid-example
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ff0000'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-```mermaid
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ff0000'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-**Notes:**
-Leaving it empty will set all variable values to default.
-
-## Color and Color Calculation:
-
-Color definitions have certain interactions in mermaid, this is in order to ensure visibility for diagrams. Mermaid will adjust some variables automatically, when colors are changed in order to compensate and maintain readability.
-
-**The Default Value Column** to the right of the Variable column will denote the Variable paired/associated with the Variable on the left and the nature of this pairing or association. If it for instance says primaryColor it means that it gets primaryColor as default value. If it says "based on primaryColor" it means that it is calculated/ derived from primaryColor. This calculation can be primary color inversion, a change of hue, darkening or lightening by 10%, etc.
-
-You can create your own themes, by changing any of the given variables below. If you are using a dark background, set dark mode to true to adjust the colors. It is possible to override the calculations using the variable names below, with `%%init%%` if you wish to style it differently.
-
-## Theme Variables Reference Table
-
-> **Note**
-> Variables that are unique to some diagrams can be affected by changes in Theme Variables
-
-| Variable             | Default/Base/Factor value      | Calc | Description                                                                                                                      |
-| -------------------- | ------------------------------ | ---- | -------------------------------------------------------------------------------------------------------------------------------- |
-| darkMode             | false                          |      | Boolean Value that dictates how to calculate colors. "true" will activate darkmode.                                              |
-| background           | #f4f4f4                        |      | Used to calculate color for items that should either be background colored or contrasting to the background.                     |
-| fontFamily           | "trebuchet ms", verdana, arial |      |                                                                                                                                  |
-| fontSize             | 16px                           |      | Font Size, in pixels                                                                                                             |
-| primaryColor         | #fff4dd                        |      | Color to be used as background in nodes, other colors will be derived from this                                                  |
-| primaryBorderColor   | based on primaryColor          | \*   | Color to be used as border in nodes using primaryColor                                                                           |
-| primaryTextColor     | based on darkMode #ddd/#333    | \*   | Color to be used as text color in nodes using primaryColor                                                                       |
-| secondaryColor       | based on primaryColor          | \*   |                                                                                                                                  |
-| secondaryBorderColor | based on secondaryColor        | \*   | Color to be used as border in nodes using secondaryColor                                                                         |
-| secondaryTextColor   | based on secondaryColor        | \*   | Color to be used as text color in nodes using secondaryColor                                                                     |
-| tertiaryColor        | based on primaryColor          | \*   |                                                                                                                                  |
-| tertiaryBorderColor  | based on tertiaryColor         | \*   | Color to be used as border in nodes using tertiaryColor                                                                          |
-| tertiaryTextColor    | based on tertiaryColor         | \*   | Color to be used as text color in nodes using tertiaryColor                                                                      |
-| noteBkgColor         | #fff5ad                        |      | Color used as background in notes                                                                                                |
-| noteTextColor        | #333                           |      | Text color in note rectangles.                                                                                                   |
-| noteBorderColor      | based on noteBkgColor          | \*   | Border color in note rectangles.                                                                                                 |
-| lineColor            | based on background            | \*   |                                                                                                                                  |
-| textColor            | based on primaryTextColor      | \*   | Text in diagram over the background for instance text on labels and on signals in sequence diagram or the title in gantt diagram |
-| mainBkg              | based on primaryColor          | \*   | Background in flowchart objects like rects/circles, class diagram classes, sequence diagram etc                                  |
-| errorBkgColor        | tertiaryColor                  | \*   | Color for syntax error message                                                                                                   |
-| errorTextColor       | tertiaryTextColor              | \*   | Color for syntax error message                                                                                                   |
-
-# What follows are Variables, specific to different diagrams and charts.
-
-## Some Theme Variables serve as, or affect the Default Values for Specific Diagram Variables, unless changed using `%%init%%` .
-
-## Flowchart
-
-| Variable            | Default/ Associated Value | Calc | Description                  |
-| ------------------- | ------------------------- | ---- | ---------------------------- |
-| nodeBorder          | primaryBorderColor        | \*   | Node Border Color            |
-| clusterBkg          | tertiaryColor             | \*   | Background in subgraphs      |
-| clusterBorder       | tertiaryBorderColor       | \*   | Cluster Border Color         |
-| defaultLinkColor    | lineColor                 | \*   | Link Color                   |
-| titleColor          | tertiaryTextColor         | \*   | Title Color                  |
-| edgeLabelBackground | based on secondaryColor   | \*   |                              |
-| nodeTextColor       | primaryTextColor          | \*   | Color for text inside Nodes. |
-
-# sequence diagram
-
-| name                  | Default value           | Calc | Description                 |
-| --------------------- | ----------------------- | ---- | --------------------------- |
-| actorBorder           | primaryBorderColor      | \*   | Actor Border Color          |
-| actorBkg              | mainBkg                 | \*   | Actor Background Color      |
-| actorTextColor        | primaryTextColor        | \*   | Actor Text Color            |
-| actorLineColor        | grey                    | \*   | Actor Line Color            |
-| signalColor           | textColor               | \*   | Signal Color                |
-| signalTextColor       | textColor               | \*   | Signal Text Color           |
-| labelBoxBkgColor      | actorBkg                | \*   | Label Box Background Color  |
-| labelBoxBorderColor   | actorBorder             | \*   | Label Box Border Color      |
-| labelTextColor        | actorTextColor          | \*   | Label Text Color            |
-| loopTextColor         | actorTextColor          | \*   | Loop ext Color              |
-| activationBorderColor | based on secondaryColor | \*   | Activation Border Color     |
-| activationBkgColor    | secondaryColor          | \*   | Activation Background Color |
-| sequenceNumberColor   | based on lineColor      | \*   | Sequence Number Color       |
-
-# state colors
-
-| name          | Default value    | Calc | Description                                  |
-| ------------- | ---------------- | ---- | -------------------------------------------- |
-| labelColor    | primaryTextColor | \*   |                                              |
-| altBackground | tertiaryColor    | \*   | Used for background in deep composite states |
-
-# class colors
-
-| name      | Default value | Calc | Description                     |
-| --------- | ------------- | ---- | ------------------------------- |
-| classText | textColor     | \*   | Color of Text in class diagrams |
-
-# User journey colors
-
-| name      | Default value           | Calc | Description                             |
-| --------- | ----------------------- | ---- | --------------------------------------- |
-| fillType0 | primaryColor            | \*   | Fill for 1st section in journey diagram |
-| fillType1 | secondaryColor          | \*   | Fill for 2nd section in journey diagram |
-| fillType2 | based on primaryColor   | \*   | Fill for 3rd section in journey diagram |
-| fillType3 | based on secondaryColor | \*   | Fill for 4th section in journey diagram |
-| fillType4 | based on primaryColor   | \*   | Fill for 5th section in journey diagram |
-| fillType5 | based on secondaryColor | \*   | Fill for 6th section in journey diagram |
-| fillType6 | based on primaryColor   | \*   | Fill for 7th section in journey diagram |
-| fillType7 | based on secondaryColor | \*   | Fill for 8th section in journey diagram |
-
-\*\*Notes: Values are meant to create an alternating look.
-
-# Here is an example of overriding `primaryColor` and giving everything a different look, using `%%init%%`.
-
-```mermaid-example
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ff0000'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-```mermaid
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ff0000'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-\*\*This got a bit too dark and bit too colorful. With some easy steps this can be fixed:
-
-- Make the primary color a little lighter
-- set the tertiary color to a reddish shade as well
-- make the edge label background differ from the subgraph by setting the edgeLabelBackground
-
-```mermaid-example
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ffcccc', 'edgeLabelBackground':'#ffffee', 'tertiaryColor': '#fff0f0'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-```mermaid
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ffcccc', 'edgeLabelBackground':'#ffffee', 'tertiaryColor': '#fff0f0'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-The Theming Engine does not admit color codes and will only accept proper color values. Color Names is not supported so for instance, the color value 'red' will not work, but '#ff0000' will work.
-
-# Common theming activities
-
-## How to change the color of the arrows
-
-# Examples:
-
-When adjusting a theme it might be helpful to look at how your preferred theme goes with the diagrams, to evaluate whether everything is visible and looks good.
-In the following examples, the directive `init` is used, with the `theme` being declared as `base`. For more information on using directives, read the documentation for [Version 8.6.0](/8.6.0_docs.md)
-
-### Flowchart
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-```mermaid
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-### Flowchart (beta)
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        flowchart TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[Another]
-          C ==>|One| D[Laptop]
-          C x--x|Two| E[iPhone]
-          C o--o|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-```mermaid
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        flowchart TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[Another]
-          C ==>|One| D[Laptop]
-          C x--x|Two| E[iPhone]
-          C o--o|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-### Sequence diagram
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        sequenceDiagram
-          autonumber
-          par Action 1
-            Alice->>John: Hello John, how are you?
-          and Action 2
-            Alice->>Bob: Hello Bob, how are you?
-          end
-          Alice->>+John: Hello John, how are you?
-          Alice->>+John: John, can you hear me?
-          John-->>-Alice: Hi Alice, I can hear you!
-          Note right of John: John is perceptive
-          John-->>-Alice: I feel great!
-              loop Every minute
-                John-->Alice: Great!
-            end
-```
-
-```mermaid
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        sequenceDiagram
-          autonumber
-          par Action 1
-            Alice->>John: Hello John, how are you?
-          and Action 2
-            Alice->>Bob: Hello Bob, how are you?
-          end
-          Alice->>+John: Hello John, how are you?
-          Alice->>+John: John, can you hear me?
-          John-->>-Alice: Hi Alice, I can hear you!
-          Note right of John: John is perceptive
-          John-->>-Alice: I feel great!
-              loop Every minute
-                John-->Alice: Great!
-            end
-```
-
-### Class diagram
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-
-classDiagram
-	Animal "1" <|-- Duck
-	Animal <|-- Fish
-	Animal <--o Zebra
-	Animal : +int age
-	Animal : +String gender
-	Animal: +isMammal()
-	Animal: +mate()
-	class Duck{
-		+String beakColor
-		+swim()
-		+quack()
-	}
-	class Fish{
-		-int sizeInFeet
-		-canEat()
-	}
-	class Zebra{
-		+bool is_wild
-		+run()
-	}
-```
-
-```mermaid
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-
-classDiagram
-	Animal "1" <|-- Duck
-	Animal <|-- Fish
-	Animal <--o Zebra
-	Animal : +int age
-	Animal : +String gender
-	Animal: +isMammal()
-	Animal: +mate()
-	class Duck{
-		+String beakColor
-		+swim()
-		+quack()
-	}
-	class Fish{
-		-int sizeInFeet
-		-canEat()
-	}
-	class Zebra{
-		+bool is_wild
-		+run()
-	}
-```
-
-### Gantt
-
-```mermaid-example
-gantt
-       dateFormat                YYYY-MM-DD
-       title                     Adding GANTT diagram functionality to mermaid
-       excludes                  :excludes the named dates/days from being included in a charted task..
-       section A section
-       Completed task            :done,    des1, 2014-01-06,2014-01-08
-       Active task               :active,  des2, 2014-01-09, 3d
-       Future task               :         des3, after des2, 5d
-       Future task2              :         des4, after des3, 5d
-
-       section Critical tasks
-       Completed task in the critical line :crit, done, 2014-01-06,24h
-       Implement parser and jison          :crit, done, after des1, 2d
-       Create tests for parser             :crit, active, 3d
-       Future task in critical line        :crit, 5d
-       Create tests for renderer           :2d
-       Add to mermaid                      :1d
-
-       section Documentation
-       Describe gantt syntax               :active, a1, after des1, 3d
-       Add gantt diagram to demo page      :after a1  , 20h
-       Add another diagram to demo page    :doc1, after a1  , 48h
-
-       section Last section
-       Describe gantt syntax               :after doc1, 3d
-       Add gantt diagram to demo page      :20h
-       Add another diagram to demo page    :48h
-```
-
-```mermaid
-gantt
-       dateFormat                YYYY-MM-DD
-       title                     Adding GANTT diagram functionality to mermaid
-       excludes                  :excludes the named dates/days from being included in a charted task..
-       section A section
-       Completed task            :done,    des1, 2014-01-06,2014-01-08
-       Active task               :active,  des2, 2014-01-09, 3d
-       Future task               :         des3, after des2, 5d
-       Future task2              :         des4, after des3, 5d
-
-       section Critical tasks
-       Completed task in the critical line :crit, done, 2014-01-06,24h
-       Implement parser and jison          :crit, done, after des1, 2d
-       Create tests for parser             :crit, active, 3d
-       Future task in critical line        :crit, 5d
-       Create tests for renderer           :2d
-       Add to mermaid                      :1d
-
-       section Documentation
-       Describe gantt syntax               :active, a1, after des1, 3d
-       Add gantt diagram to demo page      :after a1  , 20h
-       Add another diagram to demo page    :doc1, after a1  , 48h
-
-       section Last section
-       Describe gantt syntax               :after doc1, 3d
-       Add gantt diagram to demo page      :20h
-       Add another diagram to demo page    :48h
-```
-
-### State diagram
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-      stateDiagram
-        [*] --> Active
-
-        state Active {
-            [*] --> NumLockOff
-            NumLockOff --> NumLockOn : EvNumLockPressed
-            NumLockOn --> NumLockOff : EvNumLockPressed
-            --
-            [*] --> CapsLockOff
-            CapsLockOff --> CapsLockOn : EvCapsLockPressed
-            CapsLockOn --> CapsLockOff : EvCapsLockPressed
-            --
-            [*] --> ScrollLockOff
-            ScrollLockOff --> ScrollLockOn : EvCapsLockPressed
-            ScrollLockOn --> ScrollLockOff : EvCapsLockPressed
-        }
-        state SomethingElse {
-          A --> B
-          B --> A
-        }
-
-        Active --> SomethingElse
-        note right of SomethingElse : This is the note to the right.
-
-        SomethingElse --> [*]
-
-```
-
-```mermaid
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-      stateDiagram
-        [*] --> Active
-
-        state Active {
-            [*] --> NumLockOff
-            NumLockOff --> NumLockOn : EvNumLockPressed
-            NumLockOn --> NumLockOff : EvNumLockPressed
-            --
-            [*] --> CapsLockOff
-            CapsLockOff --> CapsLockOn : EvCapsLockPressed
-            CapsLockOn --> CapsLockOff : EvCapsLockPressed
-            --
-            [*] --> ScrollLockOff
-            ScrollLockOff --> ScrollLockOn : EvCapsLockPressed
-            ScrollLockOn --> ScrollLockOff : EvCapsLockPressed
-        }
-        state SomethingElse {
-          A --> B
-          B --> A
-        }
-
-        Active --> SomethingElse
-        note right of SomethingElse : This is the note to the right.
-
-        SomethingElse --> [*]
-
-```
-
-### State diagram (beta)
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-stateDiagram-v2
-        [*] --> Active
-
-        state Active {
-            [*] --> NumLockOff
-            NumLockOff --> NumLockOn : EvNumLockPressed
-            NumLockOn --> NumLockOff : EvNumLockPressed
-            --
-            [*] --> CapsLockOff
-            CapsLockOff --> CapsLockOn : EvCapsLockPressed
-            CapsLockOn --> CapsLockOff : EvCapsLockPressed
-            --
-            [*] --> ScrollLockOff
-            ScrollLockOff --> ScrollLockOn : EvCapsLockPressed
-            ScrollLockOn --> ScrollLockOff : EvCapsLockPressed
-        }
-        state SomethingElse {
-          A --> B
-          B --> A
-        }
-
-        Active --> SomethingElse2
-        note right of SomethingElse2 : This is the note to the right.
-
-        SomethingElse2 --> [*]
-```
-
-```mermaid
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-stateDiagram-v2
-        [*] --> Active
-
-        state Active {
-            [*] --> NumLockOff
-            NumLockOff --> NumLockOn : EvNumLockPressed
-            NumLockOn --> NumLockOff : EvNumLockPressed
-            --
-            [*] --> CapsLockOff
-            CapsLockOff --> CapsLockOn : EvCapsLockPressed
-            CapsLockOn --> CapsLockOff : EvCapsLockPressed
-            --
-            [*] --> ScrollLockOff
-            ScrollLockOff --> ScrollLockOn : EvCapsLockPressed
-            ScrollLockOn --> ScrollLockOff : EvCapsLockPressed
-        }
-        state SomethingElse {
-          A --> B
-          B --> A
-        }
-
-        Active --> SomethingElse2
-        note right of SomethingElse2 : This is the note to the right.
-
-        SomethingElse2 --> [*]
-```
-
-### Entity Relations diagram
-
-```mermaid-example
-      erDiagram
-        CUSTOMER }|..|{ DELIVERY-ADDRESS : has
-        CUSTOMER ||--o{ ORDER : places
-        CUSTOMER ||--o{ INVOICE : "liable for"
-        DELIVERY-ADDRESS ||--o{ ORDER : receives
-        INVOICE ||--|{ ORDER : covers
-        ORDER ||--|{ ORDER-ITEM : includes
-        PRODUCT-CATEGORY ||--|{ PRODUCT : contains
-        PRODUCT ||--o{ ORDER-ITEM : "ordered in"
-```
-
-```mermaid
-      erDiagram
-        CUSTOMER }|..|{ DELIVERY-ADDRESS : has
-        CUSTOMER ||--o{ ORDER : places
-        CUSTOMER ||--o{ INVOICE : "liable for"
-        DELIVERY-ADDRESS ||--o{ ORDER : receives
-        INVOICE ||--|{ ORDER : covers
-        ORDER ||--|{ ORDER-ITEM : includes
-        PRODUCT-CATEGORY ||--|{ PRODUCT : contains
-        PRODUCT ||--o{ ORDER-ITEM : "ordered in"
-```
-
-### User journey diagram
-
-```mermaid-example
-journey
-            title My working day
-            section Go to work
-              Make tea: 5: Me
-              Go upstairs: 3: Me
-              Do work: 1: Me, Cat
-            section Go home
-              Go downstairs: 5: Me
-              Sit down: 5: Me
-```
-
-```mermaid
-journey
-            title My working day
-            section Go to work
-              Make tea: 5: Me
-              Go upstairs: 3: Me
-              Do work: 1: Me, Cat
-            section Go home
-              Go downstairs: 5: Me
-              Sit down: 5: Me
-```
+## Color and Color Calculation
+
+To ensure diagram readability, the default value of certain variables is calculated or derived from other variables. For example, `primaryBorderColor` is derived from the `primaryColor` variable. So if the `primaryColor` variable is customized, Mermaid will adjust `primaryBorderColor` automatically. Adjustments can mean a color inversion, a hue change, a darkening/lightening by 10%, etc.
+
+The theming engine will only recognize hex colors and not color names. So, the value `#ff0000` will work, but `red` will not.
+
+## Theme Variables
+
+| Variable             | Default value                      | Description                                                                                                                      |
+| -------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| darkMode             | false                              | Affects how derived colors are calculated. Set value to `true` for darkmode.                                                     |
+| background           | #f4f4f4                            | Used to calculate color for items that should either be background colored or contrasting to the background                      |
+| fontFamily           | trebuchet ms, verdana, arial       |                                                                                                                                  |
+| fontSize             | 16px                               | Font size in pixels                                                                                                              |
+| primaryColor         | #fff4dd                            | Color to be used as background in nodes, other colors will be derived from this                                                  |
+| primaryBorderColor   | calculated from primaryColor       | Color to be used as border in nodes using `primaryColor`                                                                         |
+| primaryBorderColor   | calculated from primaryColor       | Color to be used as border in nodes using `primaryColor`                                                                         |
+| primaryTextColor     | calculated from darkMode #ddd/#333 | Color to be used as text color in nodes using `primaryColor`                                                                     |
+| secondaryColor       | calculated from primaryColor       |                                                                                                                                  |
+| primaryBorderColor   | calculated from primaryColor       | Color to be used as border in nodes using `primaryColor`                                                                         |
+| secondaryBorderColor | calculated from secondaryColor     | Color to be used as border in nodes using `secondaryColor`                                                                       |
+| primaryBorderColor   | calculated from primaryColor       | Color to be used as border in nodes using `primaryColor`                                                                         |
+| secondaryTextColor   | calculated from secondaryColor     | Color to be used as text color in nodes using `secondaryColor`                                                                   |
+| tertiaryColor        | calculated from primaryColor       |                                                                                                                                  |
+| tertiaryBorderColor  | calculated from tertiaryColor      | Color to be used as border in nodes using `tertiaryColor`                                                                        |
+| tertiaryTextColor    | calculated from tertiaryColor      | Color to be used as text color in nodes using `tertiaryColor`                                                                    |
+| noteBkgColor         | #fff5ad                            | Color used as background in notes                                                                                                |
+| noteTextColor        | #333                               | Text color in note rectangles                                                                                                    |
+| noteBorderColor      | calculated from noteBkgColor       | Border color in note rectangles                                                                                                  |
+| lineColor            | calculated from background         |                                                                                                                                  |
+| textColor            | calculated from primaryTextColor   | Text in diagram over the background for instance text on labels and on signals in sequence diagram or the title in Gantt diagram |
+| mainBkg              | calculated from primaryColor       | Background in flowchart objects like rects/circles, class diagram classes, sequence diagram etc                                  |
+| errorBkgColor        | tertiaryColor                      | Color for syntax error message                                                                                                   |
+| errorTextColor       | tertiaryTextColor                  | Color for syntax error message                                                                                                   |
+
+## Flowchart Variables
+
+| Variable            | Default value                  | Description                 |
+| ------------------- | ------------------------------ | --------------------------- |
+| nodeBorder          | primaryBorderColor             | Node Border Color           |
+| clusterBkg          | tertiaryColor                  | Background in subgraphs     |
+| clusterBorder       | tertiaryBorderColor            | Cluster Border Color        |
+| defaultLinkColor    | lineColor                      | Link Color                  |
+| titleColor          | tertiaryTextColor              | Title Color                 |
+| edgeLabelBackground | calculated from secondaryColor |                             |
+| nodeTextColor       | primaryTextColor               | Color for text inside Nodes |
+
+## Sequence Diagram Variables
+
+| Variable              | Default value                  | Description                 |
+| --------------------- | ------------------------------ | --------------------------- |
+| actorBkg              | mainBkg                        | Actor Background Color      |
+| actorBorder           | primaryBorderColor             | Actor Border Color          |
+| actorTextColor        | primaryTextColor               | Actor Text Color            |
+| actorLineColor        | grey                           | Actor Line Color            |
+| signalColor           | textColor                      | Signal Color                |
+| signalTextColor       | textColor                      | Signal Text Color           |
+| labelBoxBkgColor      | actorBkg                       | Label Box Background Color  |
+| labelBoxBorderColor   | actorBorder                    | Label Box Border Color      |
+| labelTextColor        | actorTextColor                 | Label Text Color            |
+| loopTextColor         | actorTextColor                 | Loop Text Color             |
+| activationBorderColor | calculated from secondaryColor | Activation Border Color     |
+| activationBkgColor    | secondaryColor                 | Activation Background Color |
+| sequenceNumberColor   | calculated from lineColor      | Sequence Number Color       |
+
+## State Colors
+
+| Variable      | Default value    | Description                                  |
+| ------------- | ---------------- | -------------------------------------------- |
+| labelColor    | primaryTextColor |                                              |
+| altBackground | tertiaryColor    | Used for background in deep composite states |
+
+## Class Colors
+
+| Variable  | Default value | Description                     |
+| --------- | ------------- | ------------------------------- |
+| classText | textColor     | Color of Text in class diagrams |
+
+## User Journey Colors
+
+| Variable  | Default value                  | Description                             |
+| --------- | ------------------------------ | --------------------------------------- |
+| fillType0 | primaryColor                   | Fill for 1st section in journey diagram |
+| fillType1 | secondaryColor                 | Fill for 2nd section in journey diagram |
+| fillType2 | calculated from primaryColor   | Fill for 3rd section in journey diagram |
+| fillType3 | calculated from secondaryColor | Fill for 4th section in journey diagram |
+| fillType4 | calculated from primaryColor   | Fill for 5th section in journey diagram |
+| fillType5 | calculated from secondaryColor | Fill for 6th section in journey diagram |
+| fillType6 | calculated from primaryColor   | Fill for 7th section in journey diagram |
+| fillType7 | calculated from secondaryColor | Fill for 8th section in journey diagram |
diff --git a/packages/mermaid/src/docs/config/theming.md b/packages/mermaid/src/docs/config/theming.md
index 78f3546cc..2dcc9a561 100644
--- a/packages/mermaid/src/docs/config/theming.md
+++ b/packages/mermaid/src/docs/config/theming.md
@@ -1,30 +1,26 @@
 # Theme Configuration
 
-With Version 8.7.0 Mermaid comes out with a system for dynamic and integrated configuration of themes. The intent is to increase the customizability and ease of styling for mermaid diagrams.
+Dynamic and integrated theme configuration was introduced in Mermaid version 8.7.0.
 
-The theme can be altered by changing the root level variable `theme` variable in the configuration. To change it for the whole site you must use the `initialize` call. To do it for just for a single diagram you can use the `%%init%%` directive
+Themes can now be customized at the site-wide level, or on individual Mermaid diagrams. For site-wide theme customization, the `initialize` call is used. For diagram specific customization, the `init` directive is used.
 
-Themes follow and build upon the Levels of Configuration, and employ `directives` to modify and create custom configurations, as they were introduced in Version [8.6.0](./8.6.0_docs.md).
+## Available Themes
 
-## Deployable Themes
+1. **default** - This is the default theme for all diagrams.
 
-The following are a list of **Deployable themes**, sample `%%init%%` directives and `initialize` calls.
+1. **neutral** - This theme is great for black and white documents that will be printed.
 
-1. **base**- Designed to be modified, as the name implies it is supposed to be used as the base for making custom themes.
+1. **dark** - This theme goes well with dark-colored elements or dark-mode.
 
-2. **forest**- A theme full of light greens that is easy on the eyes.
+1. **forest** - This theme contains shades of green.
 
-3. **dark**- A theme that would go well with other dark-colored elements.
+1. **base** - This is the only theme that can be modified. Use this theme as the base for customizations.
 
-4. **default**- The default theme for all diagrams.
+## Site-wide Theme
 
-5. **neutral**- The theme to be used for black and white printing.
+To customize themes site-wide, call the `initialize` method on the `mermaidAPI`.
 
-## Site-wide Themes
-
-Site-wide themes are declared via `initialize` by site owners.
-
-Example of `Initialize` call setting `theme` to `base`:
+Example of `initialize` call setting `theme` to `base`:
 
 ```javascript
 mermaidAPI.initialize({
@@ -33,22 +29,46 @@ mermaidAPI.initialize({
 });
 ```
 
-**Notes**: Only site owners can use the `mermaidAPI.initialize` call, to set values. Site-Users will have to use `%%init%%` to modify or create the theme for their diagrams.
+## Diagram-specific Themes
 
-## Themes at the Local or Current Level
+To customize the theme of an individual diagram, use the `init` directive.
 
-When Generating a diagram using on a webpage that supports mermaid. It is also possible to override site-wide theme settings locally, for a specific diagram, using directives, as long as it is not prohibited by the `secure` array.
+Example of `init` directive setting the `theme` to `forest`:
 
 ```mmd
-%%{init: {'theme':'base'}}%%
+%%{init: {'theme':'forest'}}%%
   graph TD
     a --> b
 ```
 
-Here is an example of how `%%init%%` can set the theme to 'base', this assumes that `themeVariables` are set to default:
+> **Reminder**: the only theme that can be customed is the `base` theme. The following section covers how to use `themeVariables` for customizations.
+
+## Customizing Themes with `themeVariables`
+
+To make a custom theme, modify `themeVariables` via `init`.
+
+You will need to use the [base](#available-themes) theme as it is the only modifiable theme.
+
+| Parameter      | Description                                                        | Type   | Properties                         |
+| -------------- | ------------------------------------------------------------------ | ------ | ---------------------------------- |
+| themeVariables | Modifiable with the `init` directive | Object | `primaryColor`, `primaryTextColor`, `lineColor` ([see full list](#theme-variables-reference-table)) |
+
+Example of modifying `themeVariables` using the `init` directive:
 
 ```mermaid-example
-%%{init: {'theme':'base'}}%%
+%%{
+  init: {
+    'theme': 'base',
+    'themeVariables': {
+      'primaryColor': '#BB2528',
+      'primaryTextColor': '#fff',
+      'primaryBorderColor': '#7C0000',
+      'lineColor': '#F8B229',
+      'secondaryColor': '#006100',
+      'tertiaryColor': '#fff'
+    }
+  }
+}%%
         graph TD
           A[Christmas] -->|Get money| B(Go shopping)
           B --> C{Let me think}
@@ -65,402 +85,93 @@ Here is an example of how `%%init%%` can set the theme to 'base', this assumes t
           end
 ```
 
-# List of Themes
-
-# Customizing Themes with `themeVariables`
-
-The easiest way to make a custom theme is to start with the base theme, and just modify theme variables through `themeVariables`, via `%%init%%`.
-
-| Parameter      | Description                                                        | Type  | Required | Objects contained                  |
-| -------------- | ------------------------------------------------------------------ | ----- | -------- | ---------------------------------- |
-| themeVariables | Array containing objects, modifiable with the `%%init%%` directive | Array | Required | primaryColor, lineColor, textColor |
-
-**Here is an example of overriding `primaryColor` through `themeVariables` and giving everything a different look, using `%%init%%`.**
-
-```mermaid-example
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ff0000'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-**Notes:**
-Leaving it empty will set all variable values to default.
-
-## Color and Color Calculation:
-
-Color definitions have certain interactions in mermaid, this is in order to ensure visibility for diagrams. Mermaid will adjust some variables automatically, when colors are changed in order to compensate and maintain readability.
-
-**The Default Value Column** to the right of the Variable column will denote the Variable paired/associated with the Variable on the left and the nature of this pairing or association. If it for instance says primaryColor it means that it gets primaryColor as default value. If it says "based on primaryColor" it means that it is calculated/ derived from primaryColor. This calculation can be primary color inversion, a change of hue, darkening or lightening by 10%, etc.
-
-You can create your own themes, by changing any of the given variables below. If you are using a dark background, set dark mode to true to adjust the colors. It is possible to override the calculations using the variable names below, with `%%init%%` if you wish to style it differently.
-
-## Theme Variables Reference Table
-
-```note
-Variables that are unique to some diagrams can be affected by changes in Theme Variables
-```
-
-| Variable             | Default/Base/Factor value      | Calc | Description                                                                                                                      |
-| -------------------- | ------------------------------ | ---- | -------------------------------------------------------------------------------------------------------------------------------- |
-| darkMode             | false                          |      | Boolean Value that dictates how to calculate colors. "true" will activate darkmode.                                              |
-| background           | #f4f4f4                        |      | Used to calculate color for items that should either be background colored or contrasting to the background.                     |
-| fontFamily           | "trebuchet ms", verdana, arial |      |                                                                                                                                  |
-| fontSize             | 16px                           |      | Font Size, in pixels                                                                                                             |
-| primaryColor         | #fff4dd                        |      | Color to be used as background in nodes, other colors will be derived from this                                                  |
-| primaryBorderColor   | based on primaryColor          | \*   | Color to be used as border in nodes using primaryColor                                                                           |
-| primaryTextColor     | based on darkMode #ddd/#333    | \*   | Color to be used as text color in nodes using primaryColor                                                                       |
-| secondaryColor       | based on primaryColor          | \*   |                                                                                                                                  |
-| secondaryBorderColor | based on secondaryColor        | \*   | Color to be used as border in nodes using secondaryColor                                                                         |
-| secondaryTextColor   | based on secondaryColor        | \*   | Color to be used as text color in nodes using secondaryColor                                                                     |
-| tertiaryColor        | based on primaryColor          | \*   |                                                                                                                                  |
-| tertiaryBorderColor  | based on tertiaryColor         | \*   | Color to be used as border in nodes using tertiaryColor                                                                          |
-| tertiaryTextColor    | based on tertiaryColor         | \*   | Color to be used as text color in nodes using tertiaryColor                                                                      |
-| noteBkgColor         | #fff5ad                        |      | Color used as background in notes                                                                                                |
-| noteTextColor        | #333                           |      | Text color in note rectangles.                                                                                                   |
-| noteBorderColor      | based on noteBkgColor          | \*   | Border color in note rectangles.                                                                                                 |
-| lineColor            | based on background            | \*   |                                                                                                                                  |
-| textColor            | based on primaryTextColor      | \*   | Text in diagram over the background for instance text on labels and on signals in sequence diagram or the title in gantt diagram |
-| mainBkg              | based on primaryColor          | \*   | Background in flowchart objects like rects/circles, class diagram classes, sequence diagram etc                                  |
-| errorBkgColor        | tertiaryColor                  | \*   | Color for syntax error message                                                                                                   |
-| errorTextColor       | tertiaryTextColor              | \*   | Color for syntax error message                                                                                                   |
-
-# What follows are Variables, specific to different diagrams and charts.
-
-## Some Theme Variables serve as, or affect the Default Values for Specific Diagram Variables, unless changed using `%%init%%` .
-
-## Flowchart
-
-| Variable            | Default/ Associated Value | Calc | Description                  |
-| ------------------- | ------------------------- | ---- | ---------------------------- |
-| nodeBorder          | primaryBorderColor        | \*   | Node Border Color            |
-| clusterBkg          | tertiaryColor             | \*   | Background in subgraphs      |
-| clusterBorder       | tertiaryBorderColor       | \*   | Cluster Border Color         |
-| defaultLinkColor    | lineColor                 | \*   | Link Color                   |
-| titleColor          | tertiaryTextColor         | \*   | Title Color                  |
-| edgeLabelBackground | based on secondaryColor   | \*   |                              |
-| nodeTextColor       | primaryTextColor          | \*   | Color for text inside Nodes. |
-
-# sequence diagram
-
-| name                  | Default value           | Calc | Description                 |
-| --------------------- | ----------------------- | ---- | --------------------------- |
-| actorBorder           | primaryBorderColor      | \*   | Actor Border Color          |
-| actorBkg              | mainBkg                 | \*   | Actor Background Color      |
-| actorTextColor        | primaryTextColor        | \*   | Actor Text Color            |
-| actorLineColor        | grey                    | \*   | Actor Line Color            |
-| signalColor           | textColor               | \*   | Signal Color                |
-| signalTextColor       | textColor               | \*   | Signal Text Color           |
-| labelBoxBkgColor      | actorBkg                | \*   | Label Box Background Color  |
-| labelBoxBorderColor   | actorBorder             | \*   | Label Box Border Color      |
-| labelTextColor        | actorTextColor          | \*   | Label Text Color            |
-| loopTextColor         | actorTextColor          | \*   | Loop ext Color              |
-| activationBorderColor | based on secondaryColor | \*   | Activation Border Color     |
-| activationBkgColor    | secondaryColor          | \*   | Activation Background Color |
-| sequenceNumberColor   | based on lineColor      | \*   | Sequence Number Color       |
-
-# state colors
-
-| name          | Default value    | Calc | Description                                  |
-| ------------- | ---------------- | ---- | -------------------------------------------- |
-| labelColor    | primaryTextColor | \*   |                                              |
-| altBackground | tertiaryColor    | \*   | Used for background in deep composite states |
-
-# class colors
-
-| name      | Default value | Calc | Description                     |
-| --------- | ------------- | ---- | ------------------------------- |
-| classText | textColor     | \*   | Color of Text in class diagrams |
-
-# User journey colors
-
-| name      | Default value           | Calc | Description                             |
-| --------- | ----------------------- | ---- | --------------------------------------- |
-| fillType0 | primaryColor            | \*   | Fill for 1st section in journey diagram |
-| fillType1 | secondaryColor          | \*   | Fill for 2nd section in journey diagram |
-| fillType2 | based on primaryColor   | \*   | Fill for 3rd section in journey diagram |
-| fillType3 | based on secondaryColor | \*   | Fill for 4th section in journey diagram |
-| fillType4 | based on primaryColor   | \*   | Fill for 5th section in journey diagram |
-| fillType5 | based on secondaryColor | \*   | Fill for 6th section in journey diagram |
-| fillType6 | based on primaryColor   | \*   | Fill for 7th section in journey diagram |
-| fillType7 | based on secondaryColor | \*   | Fill for 8th section in journey diagram |
-
-\*\*Notes: Values are meant to create an alternating look.
-
-# Here is an example of overriding `primaryColor` and giving everything a different look, using `%%init%%`.
-
-```mermaid-example
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ff0000'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-\*\*This got a bit too dark and bit too colorful. With some easy steps this can be fixed:
-
-- Make the primary color a little lighter
-- set the tertiary color to a reddish shade as well
-- make the edge label background differ from the subgraph by setting the edgeLabelBackground
-
-```mermaid-example
-%%{init: {'theme': 'base', 'themeVariables': { 'primaryColor': '#ffcccc', 'edgeLabelBackground':'#ffffee', 'tertiaryColor': '#fff0f0'}}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-The Theming Engine does not admit color codes and will only accept proper color values. Color Names is not supported so for instance, the color value 'red' will not work, but '#ff0000' will work.
-
-# Common theming activities
-
-## How to change the color of the arrows
-
-# Examples:
-
-When adjusting a theme it might be helpful to look at how your preferred theme goes with the diagrams, to evaluate whether everything is visible and looks good.
-In the following examples, the directive `init` is used, with the `theme` being declared as `base`. For more information on using directives, read the documentation for [Version 8.6.0](/8.6.0_docs.md)
-
-### Flowchart
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        graph TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[/Another/]
-          C ==>|One| D[Laptop]
-          C -->|Two| E[iPhone]
-          C -->|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-### Flowchart (beta)
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        flowchart TD
-          A[Christmas] -->|Get money| B(Go shopping)
-          B --> C{Let me think}
-          B --> G[Another]
-          C ==>|One| D[Laptop]
-          C x--x|Two| E[iPhone]
-          C o--o|Three| F[fa:fa-car Car]
-          subgraph section
-            C
-            D
-            E
-            F
-            G
-          end
-```
-
-### Sequence diagram
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-        sequenceDiagram
-          autonumber
-          par Action 1
-            Alice->>John: Hello John, how are you?
-          and Action 2
-            Alice->>Bob: Hello Bob, how are you?
-          end
-          Alice->>+John: Hello John, how are you?
-          Alice->>+John: John, can you hear me?
-          John-->>-Alice: Hi Alice, I can hear you!
-          Note right of John: John is perceptive
-          John-->>-Alice: I feel great!
-              loop Every minute
-                John-->Alice: Great!
-            end
-```
-
-### Class diagram
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-
-classDiagram
-	Animal "1" <|-- Duck
-	Animal <|-- Fish
-	Animal <--o Zebra
-	Animal : +int age
-	Animal : +String gender
-	Animal: +isMammal()
-	Animal: +mate()
-	class Duck{
-		+String beakColor
-		+swim()
-		+quack()
-	}
-	class Fish{
-		-int sizeInFeet
-		-canEat()
-	}
-	class Zebra{
-		+bool is_wild
-		+run()
-	}
-```
-
-### Gantt
-
-```mermaid-example
-gantt
-       dateFormat                YYYY-MM-DD
-       title                     Adding GANTT diagram functionality to mermaid
-       excludes                  :excludes the named dates/days from being included in a charted task..
-       section A section
-       Completed task            :done,    des1, 2014-01-06,2014-01-08
-       Active task               :active,  des2, 2014-01-09, 3d
-       Future task               :         des3, after des2, 5d
-       Future task2              :         des4, after des3, 5d
-
-       section Critical tasks
-       Completed task in the critical line :crit, done, 2014-01-06,24h
-       Implement parser and jison          :crit, done, after des1, 2d
-       Create tests for parser             :crit, active, 3d
-       Future task in critical line        :crit, 5d
-       Create tests for renderer           :2d
-       Add to mermaid                      :1d
-
-       section Documentation
-       Describe gantt syntax               :active, a1, after des1, 3d
-       Add gantt diagram to demo page      :after a1  , 20h
-       Add another diagram to demo page    :doc1, after a1  , 48h
-
-       section Last section
-       Describe gantt syntax               :after doc1, 3d
-       Add gantt diagram to demo page      :20h
-       Add another diagram to demo page    :48h
-```
-
-### State diagram
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-      stateDiagram
-        [*] --> Active
-
-        state Active {
-            [*] --> NumLockOff
-            NumLockOff --> NumLockOn : EvNumLockPressed
-            NumLockOn --> NumLockOff : EvNumLockPressed
-            --
-            [*] --> CapsLockOff
-            CapsLockOff --> CapsLockOn : EvCapsLockPressed
-            CapsLockOn --> CapsLockOff : EvCapsLockPressed
-            --
-            [*] --> ScrollLockOff
-            ScrollLockOff --> ScrollLockOn : EvCapsLockPressed
-            ScrollLockOn --> ScrollLockOff : EvCapsLockPressed
-        }
-        state SomethingElse {
-          A --> B
-          B --> A
-        }
-
-        Active --> SomethingElse
-        note right of SomethingElse : This is the note to the right.
-
-        SomethingElse --> [*]
-
-```
-
-### State diagram (beta)
-
-```mermaid-example
-%%{init: {'securityLevel': 'loose', 'theme':'base'}}%%
-stateDiagram-v2
-        [*] --> Active
-
-        state Active {
-            [*] --> NumLockOff
-            NumLockOff --> NumLockOn : EvNumLockPressed
-            NumLockOn --> NumLockOff : EvNumLockPressed
-            --
-            [*] --> CapsLockOff
-            CapsLockOff --> CapsLockOn : EvCapsLockPressed
-            CapsLockOn --> CapsLockOff : EvCapsLockPressed
-            --
-            [*] --> ScrollLockOff
-            ScrollLockOff --> ScrollLockOn : EvCapsLockPressed
-            ScrollLockOn --> ScrollLockOff : EvCapsLockPressed
-        }
-        state SomethingElse {
-          A --> B
-          B --> A
-        }
-
-        Active --> SomethingElse2
-        note right of SomethingElse2 : This is the note to the right.
-
-        SomethingElse2 --> [*]
-```
-
-### Entity Relations diagram
-
-```mermaid-example
-      erDiagram
-        CUSTOMER }|..|{ DELIVERY-ADDRESS : has
-        CUSTOMER ||--o{ ORDER : places
-        CUSTOMER ||--o{ INVOICE : "liable for"
-        DELIVERY-ADDRESS ||--o{ ORDER : receives
-        INVOICE ||--|{ ORDER : covers
-        ORDER ||--|{ ORDER-ITEM : includes
-        PRODUCT-CATEGORY ||--|{ PRODUCT : contains
-        PRODUCT ||--o{ ORDER-ITEM : "ordered in"
-```
-
-### User journey diagram
-
-```mermaid-example
-journey
-            title My working day
-            section Go to work
-              Make tea: 5: Me
-              Go upstairs: 3: Me
-              Do work: 1: Me, Cat
-            section Go home
-              Go downstairs: 5: Me
-              Sit down: 5: Me
-```
+## Color and Color Calculation
+
+To ensure diagram readability, the default value of certain variables is calculated or derived from other variables. For example, `primaryBorderColor` is derived from the `primaryColor` variable. So if the `primaryColor` variable is customized, Mermaid will adjust `primaryBorderColor` automatically. Adjustments can mean a color inversion, a hue change, a darkening/lightening by 10%, etc.
+
+The theming engine will only recognize hex colors and not color names. So, the value `#ff0000` will work, but `red` will not.
+
+## Theme Variables
+
+| Variable             | Default value                          | Description                                                                                                                      |
+| -------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| darkMode             | false                                  | Affects how derived colors are calculated. Set value to `true` for darkmode.                                                     |
+| background           | #f4f4f4                                | Used to calculate color for items that should either be background colored or contrasting to the background                      |
+| fontFamily           | trebuchet ms, verdana, arial           |                                                                                                                                  |
+| fontSize             | 16px                                   | Font size in pixels                                                                                                              |
+| primaryColor         | #fff4dd                                | Color to be used as background in nodes, other colors will be derived from this                                                  |
+| primaryBorderColor   | calculated from primaryColor           | Color to be used as border in nodes using `primaryColor`                                                                         |
+| primaryBorderColor   | calculated from primaryColor           | Color to be used as border in nodes using `primaryColor`                                                                         |
+| primaryTextColor     | calculated from darkMode #ddd/#333     | Color to be used as text color in nodes using `primaryColor`                                                                     |
+| secondaryColor       | calculated from primaryColor           |                                                                                                                                  |
+| primaryBorderColor   | calculated from primaryColor           | Color to be used as border in nodes using `primaryColor`                                                                         |
+| secondaryBorderColor | calculated from secondaryColor         | Color to be used as border in nodes using `secondaryColor`                                                                       |
+| primaryBorderColor   | calculated from primaryColor           | Color to be used as border in nodes using `primaryColor`                                                                         |
+| secondaryTextColor   | calculated from secondaryColor         | Color to be used as text color in nodes using `secondaryColor`                                                                   |
+| tertiaryColor        | calculated from primaryColor           |                                                                                                                                  |
+| tertiaryBorderColor  | calculated from tertiaryColor          | Color to be used as border in nodes using `tertiaryColor`                                                                        |
+| tertiaryTextColor    | calculated from tertiaryColor          | Color to be used as text color in nodes using `tertiaryColor`                                                                    |
+| noteBkgColor         | #fff5ad                                | Color used as background in notes                                                                                                |
+| noteTextColor        | #333                                   | Text color in note rectangles                                                                                                    |
+| noteBorderColor      | calculated from noteBkgColor           | Border color in note rectangles                                                                                                  |
+| lineColor            | calculated from background             |                                                                                                                                  |
+| textColor            | calculated from primaryTextColor       | Text in diagram over the background for instance text on labels and on signals in sequence diagram or the title in Gantt diagram |
+| mainBkg              | calculated from primaryColor           | Background in flowchart objects like rects/circles, class diagram classes, sequence diagram etc                                  |
+| errorBkgColor        | tertiaryColor                          | Color for syntax error message                                                                                                   |
+| errorTextColor       | tertiaryTextColor                      | Color for syntax error message                                                                                                   |
+
+## Flowchart Variables
+
+| Variable            | Default value                    | Description                  |
+| ------------------- | -------------------------------- | ---------------------------- |
+| nodeBorder          | primaryBorderColor               | Node Border Color            |
+| clusterBkg          | tertiaryColor                    | Background in subgraphs      |
+| clusterBorder       | tertiaryBorderColor              | Cluster Border Color         |
+| defaultLinkColor    | lineColor                        | Link Color                   |
+| titleColor          | tertiaryTextColor                | Title Color                  |
+| edgeLabelBackground | calculated from secondaryColor   |                              |
+| nodeTextColor       | primaryTextColor                 | Color for text inside Nodes  |
+
+## Sequence Diagram Variables
+
+| Variable              | Default value                  | Description                 |
+| --------------------- | ------------------------------ | --------------------------- |
+| actorBkg              | mainBkg                        | Actor Background Color      |
+| actorBorder           | primaryBorderColor             | Actor Border Color          |
+| actorTextColor        | primaryTextColor               | Actor Text Color            |
+| actorLineColor        | grey                           | Actor Line Color            |
+| signalColor           | textColor                      | Signal Color                |
+| signalTextColor       | textColor                      | Signal Text Color           |
+| labelBoxBkgColor      | actorBkg                       | Label Box Background Color  |
+| labelBoxBorderColor   | actorBorder                    | Label Box Border Color      |
+| labelTextColor        | actorTextColor                 | Label Text Color            |
+| loopTextColor         | actorTextColor                 | Loop Text Color              |
+| activationBorderColor | calculated from secondaryColor | Activation Border Color     |
+| activationBkgColor    | secondaryColor                 | Activation Background Color |
+| sequenceNumberColor   | calculated from lineColor      | Sequence Number Color       |
+
+## State Colors
+
+| Variable      | Default value    | Description                                  |
+| ------------- | ---------------- | -------------------------------------------- |
+| labelColor    | primaryTextColor |                                              |
+| altBackground | tertiaryColor    | Used for background in deep composite states |
+
+## Class Colors
+
+| Variable  | Default value | Description                     |
+| --------- | ------------- | ------------------------------- |
+| classText | textColor     | Color of Text in class diagrams |
+
+## User Journey Colors
+
+| Variable  | Default value                  | Description                             |
+| --------- | ------------------------------ | --------------------------------------- |
+| fillType0 | primaryColor                   | Fill for 1st section in journey diagram |
+| fillType1 | secondaryColor                 | Fill for 2nd section in journey diagram |
+| fillType2 | calculated from primaryColor   | Fill for 3rd section in journey diagram |
+| fillType3 | calculated from secondaryColor | Fill for 4th section in journey diagram |
+| fillType4 | calculated from primaryColor   | Fill for 5th section in journey diagram |
+| fillType5 | calculated from secondaryColor | Fill for 6th section in journey diagram |
+| fillType6 | calculated from primaryColor   | Fill for 7th section in journey diagram |
+| fillType7 | calculated from secondaryColor | Fill for 8th section in journey diagram |
\ No newline at end of file

From 24560b7d1329e9f7f239659a3dda4f67a15f91c0 Mon Sep 17 00:00:00 2001
From: steph <steph@huynhicode.dev>
Date: Sun, 4 Dec 2022 21:51:29 -0800
Subject: [PATCH 056/129] fix lint

---
 packages/mermaid/src/docs/config/theming.md | 78 ++++++++++-----------
 1 file changed, 39 insertions(+), 39 deletions(-)

diff --git a/packages/mermaid/src/docs/config/theming.md b/packages/mermaid/src/docs/config/theming.md
index 2dcc9a561..02b0c9a1c 100644
--- a/packages/mermaid/src/docs/config/theming.md
+++ b/packages/mermaid/src/docs/config/theming.md
@@ -49,8 +49,8 @@ To make a custom theme, modify `themeVariables` via `init`.
 
 You will need to use the [base](#available-themes) theme as it is the only modifiable theme.
 
-| Parameter      | Description                                                        | Type   | Properties                         |
-| -------------- | ------------------------------------------------------------------ | ------ | ---------------------------------- |
+| Parameter      | Description                          | Type   | Properties                                                                                          |
+| -------------- | ------------------------------------ | ------ | --------------------------------------------------------------------------------------------------- |
 | themeVariables | Modifiable with the `init` directive | Object | `primaryColor`, `primaryTextColor`, `lineColor` ([see full list](#theme-variables-reference-table)) |
 
 Example of modifying `themeVariables` using the `init` directive:
@@ -93,44 +93,44 @@ The theming engine will only recognize hex colors and not color names. So, the v
 
 ## Theme Variables
 
-| Variable             | Default value                          | Description                                                                                                                      |
-| -------------------- | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| darkMode             | false                                  | Affects how derived colors are calculated. Set value to `true` for darkmode.                                                     |
-| background           | #f4f4f4                                | Used to calculate color for items that should either be background colored or contrasting to the background                      |
-| fontFamily           | trebuchet ms, verdana, arial           |                                                                                                                                  |
-| fontSize             | 16px                                   | Font size in pixels                                                                                                              |
-| primaryColor         | #fff4dd                                | Color to be used as background in nodes, other colors will be derived from this                                                  |
-| primaryBorderColor   | calculated from primaryColor           | Color to be used as border in nodes using `primaryColor`                                                                         |
-| primaryBorderColor   | calculated from primaryColor           | Color to be used as border in nodes using `primaryColor`                                                                         |
-| primaryTextColor     | calculated from darkMode #ddd/#333     | Color to be used as text color in nodes using `primaryColor`                                                                     |
-| secondaryColor       | calculated from primaryColor           |                                                                                                                                  |
-| primaryBorderColor   | calculated from primaryColor           | Color to be used as border in nodes using `primaryColor`                                                                         |
-| secondaryBorderColor | calculated from secondaryColor         | Color to be used as border in nodes using `secondaryColor`                                                                       |
-| primaryBorderColor   | calculated from primaryColor           | Color to be used as border in nodes using `primaryColor`                                                                         |
-| secondaryTextColor   | calculated from secondaryColor         | Color to be used as text color in nodes using `secondaryColor`                                                                   |
-| tertiaryColor        | calculated from primaryColor           |                                                                                                                                  |
-| tertiaryBorderColor  | calculated from tertiaryColor          | Color to be used as border in nodes using `tertiaryColor`                                                                        |
-| tertiaryTextColor    | calculated from tertiaryColor          | Color to be used as text color in nodes using `tertiaryColor`                                                                    |
-| noteBkgColor         | #fff5ad                                | Color used as background in notes                                                                                                |
-| noteTextColor        | #333                                   | Text color in note rectangles                                                                                                    |
-| noteBorderColor      | calculated from noteBkgColor           | Border color in note rectangles                                                                                                  |
-| lineColor            | calculated from background             |                                                                                                                                  |
-| textColor            | calculated from primaryTextColor       | Text in diagram over the background for instance text on labels and on signals in sequence diagram or the title in Gantt diagram |
-| mainBkg              | calculated from primaryColor           | Background in flowchart objects like rects/circles, class diagram classes, sequence diagram etc                                  |
-| errorBkgColor        | tertiaryColor                          | Color for syntax error message                                                                                                   |
-| errorTextColor       | tertiaryTextColor                      | Color for syntax error message                                                                                                   |
+| Variable             | Default value                      | Description                                                                                                                      |
+| -------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
+| darkMode             | false                              | Affects how derived colors are calculated. Set value to `true` for darkmode.                                                     |
+| background           | #f4f4f4                            | Used to calculate color for items that should either be background colored or contrasting to the background                      |
+| fontFamily           | trebuchet ms, verdana, arial       |                                                                                                                                  |
+| fontSize             | 16px                               | Font size in pixels                                                                                                              |
+| primaryColor         | #fff4dd                            | Color to be used as background in nodes, other colors will be derived from this                                                  |
+| primaryBorderColor   | calculated from primaryColor       | Color to be used as border in nodes using `primaryColor`                                                                         |
+| primaryBorderColor   | calculated from primaryColor       | Color to be used as border in nodes using `primaryColor`                                                                         |
+| primaryTextColor     | calculated from darkMode #ddd/#333 | Color to be used as text color in nodes using `primaryColor`                                                                     |
+| secondaryColor       | calculated from primaryColor       |                                                                                                                                  |
+| primaryBorderColor   | calculated from primaryColor       | Color to be used as border in nodes using `primaryColor`                                                                         |
+| secondaryBorderColor | calculated from secondaryColor     | Color to be used as border in nodes using `secondaryColor`                                                                       |
+| primaryBorderColor   | calculated from primaryColor       | Color to be used as border in nodes using `primaryColor`                                                                         |
+| secondaryTextColor   | calculated from secondaryColor     | Color to be used as text color in nodes using `secondaryColor`                                                                   |
+| tertiaryColor        | calculated from primaryColor       |                                                                                                                                  |
+| tertiaryBorderColor  | calculated from tertiaryColor      | Color to be used as border in nodes using `tertiaryColor`                                                                        |
+| tertiaryTextColor    | calculated from tertiaryColor      | Color to be used as text color in nodes using `tertiaryColor`                                                                    |
+| noteBkgColor         | #fff5ad                            | Color used as background in notes                                                                                                |
+| noteTextColor        | #333                               | Text color in note rectangles                                                                                                    |
+| noteBorderColor      | calculated from noteBkgColor       | Border color in note rectangles                                                                                                  |
+| lineColor            | calculated from background         |                                                                                                                                  |
+| textColor            | calculated from primaryTextColor   | Text in diagram over the background for instance text on labels and on signals in sequence diagram or the title in Gantt diagram |
+| mainBkg              | calculated from primaryColor       | Background in flowchart objects like rects/circles, class diagram classes, sequence diagram etc                                  |
+| errorBkgColor        | tertiaryColor                      | Color for syntax error message                                                                                                   |
+| errorTextColor       | tertiaryTextColor                  | Color for syntax error message                                                                                                   |
 
 ## Flowchart Variables
 
-| Variable            | Default value                    | Description                  |
-| ------------------- | -------------------------------- | ---------------------------- |
-| nodeBorder          | primaryBorderColor               | Node Border Color            |
-| clusterBkg          | tertiaryColor                    | Background in subgraphs      |
-| clusterBorder       | tertiaryBorderColor              | Cluster Border Color         |
-| defaultLinkColor    | lineColor                        | Link Color                   |
-| titleColor          | tertiaryTextColor                | Title Color                  |
-| edgeLabelBackground | calculated from secondaryColor   |                              |
-| nodeTextColor       | primaryTextColor                 | Color for text inside Nodes  |
+| Variable            | Default value                  | Description                 |
+| ------------------- | ------------------------------ | --------------------------- |
+| nodeBorder          | primaryBorderColor             | Node Border Color           |
+| clusterBkg          | tertiaryColor                  | Background in subgraphs     |
+| clusterBorder       | tertiaryBorderColor            | Cluster Border Color        |
+| defaultLinkColor    | lineColor                      | Link Color                  |
+| titleColor          | tertiaryTextColor              | Title Color                 |
+| edgeLabelBackground | calculated from secondaryColor |                             |
+| nodeTextColor       | primaryTextColor               | Color for text inside Nodes |
 
 ## Sequence Diagram Variables
 
@@ -145,7 +145,7 @@ The theming engine will only recognize hex colors and not color names. So, the v
 | labelBoxBkgColor      | actorBkg                       | Label Box Background Color  |
 | labelBoxBorderColor   | actorBorder                    | Label Box Border Color      |
 | labelTextColor        | actorTextColor                 | Label Text Color            |
-| loopTextColor         | actorTextColor                 | Loop Text Color              |
+| loopTextColor         | actorTextColor                 | Loop Text Color             |
 | activationBorderColor | calculated from secondaryColor | Activation Border Color     |
 | activationBkgColor    | secondaryColor                 | Activation Background Color |
 | sequenceNumberColor   | calculated from lineColor      | Sequence Number Color       |
@@ -174,4 +174,4 @@ The theming engine will only recognize hex colors and not color names. So, the v
 | fillType4 | calculated from primaryColor   | Fill for 5th section in journey diagram |
 | fillType5 | calculated from secondaryColor | Fill for 6th section in journey diagram |
 | fillType6 | calculated from primaryColor   | Fill for 7th section in journey diagram |
-| fillType7 | calculated from secondaryColor | Fill for 8th section in journey diagram |
\ No newline at end of file
+| fillType7 | calculated from secondaryColor | Fill for 8th section in journey diagram |

From f0aea0e6af42347f82675ac09186248329fdfff0 Mon Sep 17 00:00:00 2001
From: steph <steph@huynhicode.dev>
Date: Sun, 4 Dec 2022 22:04:20 -0800
Subject: [PATCH 057/129] fix cspell

---
 cSpell.json                                 | 1 +
 docs/config/theming.md                      | 2 +-
 packages/mermaid/src/docs/config/theming.md | 2 +-
 3 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/cSpell.json b/cSpell.json
index 08fce1d1c..a4af6c785 100644
--- a/cSpell.json
+++ b/cSpell.json
@@ -59,6 +59,7 @@
     "playfair",
     "podlite",
     "ranksep",
+    "rect",
     "redmine",
     "sandboxed",
     "setupgraphviewbox",
diff --git a/docs/config/theming.md b/docs/config/theming.md
index 6c12ee75f..b34913af5 100644
--- a/docs/config/theming.md
+++ b/docs/config/theming.md
@@ -137,7 +137,7 @@ The theming engine will only recognize hex colors and not color names. So, the v
 
 | Variable             | Default value                      | Description                                                                                                                      |
 | -------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| darkMode             | false                              | Affects how derived colors are calculated. Set value to `true` for darkmode.                                                     |
+| darkMode             | false                              | Affects how derived colors are calculated. Set value to `true` for dark mode.                                                    |
 | background           | #f4f4f4                            | Used to calculate color for items that should either be background colored or contrasting to the background                      |
 | fontFamily           | trebuchet ms, verdana, arial       |                                                                                                                                  |
 | fontSize             | 16px                               | Font size in pixels                                                                                                              |
diff --git a/packages/mermaid/src/docs/config/theming.md b/packages/mermaid/src/docs/config/theming.md
index 02b0c9a1c..2d4da9530 100644
--- a/packages/mermaid/src/docs/config/theming.md
+++ b/packages/mermaid/src/docs/config/theming.md
@@ -95,7 +95,7 @@ The theming engine will only recognize hex colors and not color names. So, the v
 
 | Variable             | Default value                      | Description                                                                                                                      |
 | -------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| darkMode             | false                              | Affects how derived colors are calculated. Set value to `true` for darkmode.                                                     |
+| darkMode             | false                              | Affects how derived colors are calculated. Set value to `true` for dark mode.                                                    |
 | background           | #f4f4f4                            | Used to calculate color for items that should either be background colored or contrasting to the background                      |
 | fontFamily           | trebuchet ms, verdana, arial       |                                                                                                                                  |
 | fontSize             | 16px                               | Font size in pixels                                                                                                              |

From 2cce562bc43892afe5ec673b273d1c302e458b8d Mon Sep 17 00:00:00 2001
From: steph <steph@huynhicode.dev>
Date: Sun, 4 Dec 2022 22:10:33 -0800
Subject: [PATCH 058/129] fix cspell

---
 cSpell.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/cSpell.json b/cSpell.json
index a4af6c785..0849dc1d0 100644
--- a/cSpell.json
+++ b/cSpell.json
@@ -60,6 +60,7 @@
     "podlite",
     "ranksep",
     "rect",
+    "rects",
     "redmine",
     "sandboxed",
     "setupgraphviewbox",

From 49ca2e358897ab366ac008b89603025fcf188aa0 Mon Sep 17 00:00:00 2001
From: BD103 <59022059+BD103@users.noreply.github.com>
Date: Mon, 5 Dec 2022 17:41:30 -0500
Subject: [PATCH 059/129] feat: add links to theme listing

---
 packages/mermaid/src/docs/config/theming.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/mermaid/src/docs/config/theming.md b/packages/mermaid/src/docs/config/theming.md
index 78f3546cc..b9c5d0850 100644
--- a/packages/mermaid/src/docs/config/theming.md
+++ b/packages/mermaid/src/docs/config/theming.md
@@ -10,15 +10,15 @@ Themes follow and build upon the Levels of Configuration, and employ `directives
 
 The following are a list of **Deployable themes**, sample `%%init%%` directives and `initialize` calls.
 
-1. **base**- Designed to be modified, as the name implies it is supposed to be used as the base for making custom themes.
+1. [**base**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-base.js) - Designed to be modified, as the name implies it is supposed to be used as the base for making custom themes.
 
-2. **forest**- A theme full of light greens that is easy on the eyes.
+2. [**forest**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-forest.js) - A theme full of light greens that is easy on the eyes.
 
-3. **dark**- A theme that would go well with other dark-colored elements.
+3. [**dark**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-dark.js) - A theme that would go well with other dark-colored elements.
 
-4. **default**- The default theme for all diagrams.
+4. [**default**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-default.js) - The default theme for all diagrams.
 
-5. **neutral**- The theme to be used for black and white printing.
+5. [**neutral**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-neutral.js) - The theme to be used for black and white printing.
 
 ## Site-wide Themes
 

From 7a086890fd180545f774a82ad08e15a0f2939894 Mon Sep 17 00:00:00 2001
From: MrCoder <eagle.xiao@gmail.com>
Date: Tue, 6 Dec 2022 19:44:14 +1100
Subject: [PATCH 060/129] Made mermaidConfig a local variable so that it cannot
 be shared cross rendering.

---
 .../mermaid/src/docs/.vitepress/theme/Mermaid.vue     | 11 +++++------
 packages/mermaid/src/docs/.vitepress/theme/mermaid.ts |  4 +---
 2 files changed, 6 insertions(+), 9 deletions(-)

diff --git a/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue b/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
index c99141601..566543001 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
+++ b/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
@@ -20,11 +20,6 @@ const props = defineProps({
 const svg = ref(null);
 let mut = null;
 
-const mermaidConfig = {
-  securityLevel: 'loose',
-  startOnLoad: false,
-};
-
 onMounted(async () => {
   mut = new MutationObserver(() => renderChart());
   mut.observe(document.documentElement, { attributes: true });
@@ -58,7 +53,11 @@ onUnmounted(() => mut.disconnect());
 const renderChart = async () => {
   console.log('rendering chart' + props.id + props.graph);
   const hasDarkClass = document.documentElement.classList.contains('dark');
-  mermaidConfig.theme = hasDarkClass ? 'dark' : 'default';
+  const mermaidConfig = {
+        securityLevel: 'loose',
+        startOnLoad: false,
+        theme: hasDarkClass ? 'dark' : 'default',
+      };
 
   console.log({ mermaidConfig });
   let svgCode = await render(props.id, decodeURIComponent(props.graph), mermaidConfig);
diff --git a/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts b/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
index fef090ea9..b287346f9 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
+++ b/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
@@ -8,9 +8,7 @@ try {
 }
 
 export const render = async (id: string, code: string, config: MermaidConfig): Promise<string> => {
-  // make a clone of config, so we don't mutate the original
-  const mermaidConfig = { ...config };
-  mermaid.initialize(mermaidConfig);
+  mermaid.initialize(config);
   const svg = await mermaid.renderAsync(id, code);
   return svg;
 };

From fdf261bda3eed435fde103a268c1d74f70fce628 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Tue, 6 Dec 2022 15:53:36 +0530
Subject: [PATCH 061/129] chore: Format Mermaid.vue

---
 packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue b/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
index 566543001..85c13393c 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
+++ b/packages/mermaid/src/docs/.vitepress/theme/Mermaid.vue
@@ -54,10 +54,10 @@ const renderChart = async () => {
   console.log('rendering chart' + props.id + props.graph);
   const hasDarkClass = document.documentElement.classList.contains('dark');
   const mermaidConfig = {
-        securityLevel: 'loose',
-        startOnLoad: false,
-        theme: hasDarkClass ? 'dark' : 'default',
-      };
+    securityLevel: 'loose',
+    startOnLoad: false,
+    theme: hasDarkClass ? 'dark' : 'default',
+  };
 
   console.log({ mermaidConfig });
   let svgCode = await render(props.id, decodeURIComponent(props.graph), mermaidConfig);

From 4dadf8a72da15f2236c26989c1a9f55b917f8025 Mon Sep 17 00:00:00 2001
From: Maho Pacheco <mapach@microsoft.com>
Date: Tue, 6 Dec 2022 10:38:21 -0800
Subject: [PATCH 062/129] Adding support for parentheses

---
 cypress/integration/rendering/erDiagram.spec.js    | 14 ++++++++++++++
 docs/syntax/entityRelationshipDiagram.md           |  8 +++++---
 .../mermaid/src/diagrams/er/parser/erDiagram.jison |  2 +-
 .../src/docs/syntax/entityRelationshipDiagram.md   |  5 +++--
 4 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/cypress/integration/rendering/erDiagram.spec.js b/cypress/integration/rendering/erDiagram.spec.js
index 8e8946170..c72df49b6 100644
--- a/cypress/integration/rendering/erDiagram.spec.js
+++ b/cypress/integration/rendering/erDiagram.spec.js
@@ -182,6 +182,20 @@ describe('Entity Relationship Diagram', () => {
     cy.get('svg');
   });
 
+  it('should render entities with length in attributes type', () => {
+    renderGraph(
+      `
+    erDiagram
+        CLUSTER {
+          varchar(99) name
+          string(255) description 
+        }
+      `,
+      { logLevel: 1 }
+    );
+    cy.get('svg');
+  });
+
   it('should render entities and attributes with big and small entity names', () => {
     renderGraph(
       `
diff --git a/docs/syntax/entityRelationshipDiagram.md b/docs/syntax/entityRelationshipDiagram.md
index 9b938bc36..4f33b1edc 100644
--- a/docs/syntax/entityRelationshipDiagram.md
+++ b/docs/syntax/entityRelationshipDiagram.md
@@ -230,7 +230,7 @@ erDiagram
     }
 ```
 
-The `type` and `name` values must begin with an alphabetic character and may contain digits, hyphens or underscores. Other than that, there are no restrictions, and there is no implicit set of valid data types.
+The `type` and `name` values must begin with an alphabetic character and may contain digits, hyphens, underscores, parentheses and square brackets. Other than that, there are no restrictions, and there is no implicit set of valid data types.
 
 #### Attribute Keys and Comments
 
@@ -244,11 +244,12 @@ erDiagram
         string registrationNumber
         string make
         string model
+        string[] parts
     }
     PERSON ||--o{ NAMED-DRIVER : is
     PERSON {
         string driversLicense PK "The license #"
-        string firstName
+        string(99) firstName "Only 99 characters are allowed"
         string lastName
         int age
     }
@@ -263,11 +264,12 @@ erDiagram
         string registrationNumber
         string make
         string model
+        string[] parts
     }
     PERSON ||--o{ NAMED-DRIVER : is
     PERSON {
         string driversLicense PK "The license #"
-        string firstName
+        string(99) firstName "Only 99 characters are allowed"
         string lastName
         int age
     }
diff --git a/packages/mermaid/src/diagrams/er/parser/erDiagram.jison b/packages/mermaid/src/diagrams/er/parser/erDiagram.jison
index f0411fd72..bd8dc20f0 100644
--- a/packages/mermaid/src/diagrams/er/parser/erDiagram.jison
+++ b/packages/mermaid/src/diagrams/er/parser/erDiagram.jison
@@ -31,7 +31,7 @@ accDescr\s*"{"\s*                                { this.begin("acc_descr_multili
 <block>\s+                      /* skip whitespace in block */
 <block>\b((?:PK)|(?:FK))\b      return 'ATTRIBUTE_KEY'
 <block>(.*?)[~](.*?)*[~]        return 'ATTRIBUTE_WORD';
-<block>[A-Za-z][A-Za-z0-9\-_\[\]]*  return 'ATTRIBUTE_WORD'
+<block>[A-Za-z][A-Za-z0-9\-_\[\]\(\)]*  return 'ATTRIBUTE_WORD'
 <block>\"[^"]*\"                return 'COMMENT';
 <block>[\n]+                    /* nothing */
 <block>"}"                      { this.popState(); return 'BLOCK_STOP'; }
diff --git a/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md b/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md
index c666877c5..d83fd4b09 100644
--- a/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md
+++ b/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md
@@ -160,7 +160,7 @@ erDiagram
     }
 ```
 
-The `type` and `name` values must begin with an alphabetic character and may contain digits, hyphens or underscores. Other than that, there are no restrictions, and there is no implicit set of valid data types.
+The `type` and `name` values must begin with an alphabetic character and may contain digits, hyphens, underscores, parentheses and square brackets. Other than that, there are no restrictions, and there is no implicit set of valid data types.
 
 #### Attribute Keys and Comments
 
@@ -174,11 +174,12 @@ erDiagram
         string registrationNumber
         string make
         string model
+        string[] parts
     }
     PERSON ||--o{ NAMED-DRIVER : is
     PERSON {
         string driversLicense PK "The license #"
-        string firstName
+        string(99) firstName "Only 99 characters are allowed"
         string lastName
         int age
     }

From 792c1a8320fa12519b9d59acffa729917fc4ebe5 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 7 Dec 2022 11:19:44 +0530
Subject: [PATCH 063/129] chore: Rebuild docs if linting fails

---
 .github/workflows/lint-docs.yml | 74 ---------------------------------
 .github/workflows/lint.yml      | 16 ++++++-
 2 files changed, 15 insertions(+), 75 deletions(-)
 delete mode 100644 .github/workflows/lint-docs.yml

diff --git a/.github/workflows/lint-docs.yml b/.github/workflows/lint-docs.yml
deleted file mode 100644
index d9f0ddae0..000000000
--- a/.github/workflows/lint-docs.yml
+++ /dev/null
@@ -1,74 +0,0 @@
-name: Lint Docs
-
-on:
-  pull_request:
-    types:
-      - opened
-      - synchronize
-      - ready_for_review
-
-permissions:
-  contents: write
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [16.x]
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          repository: ${{ github.event.pull_request.head.repo.full_name }}
-          ref: ${{ github.event.pull_request.head.ref }}
-
-      - name: Get branch name
-        id: branch-name
-        uses: tj-actions/branch-names@v5
-
-      - uses: nrwl/last-successful-commit-action@v1
-        id: last_successful_commit_pull_request
-        with:
-          branch: ${{ steps.branch-name.outputs.base_ref_branch }}
-          workflow_id: 'lint-docs.yml'
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Check if source docs are changed
-        id: changed-docs
-        uses: tj-actions/changed-files@v29
-        with:
-          base_sha: ${{ steps.last_successful_commit_pull_request.outputs.commit_hash }}
-          files: |
-            packages/mermaid/src/docs/*
-            packages/mermaid/src/docs.mts
-
-      - uses: pnpm/action-setup@v2
-        if: steps.changed-docs.outputs.only_modified == 'true'
-
-      - name: Setup Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
-        if: steps.changed-docs.outputs.only_modified == 'true'
-        with:
-          cache: pnpm
-          node-version: ${{ matrix.node-version }}
-
-      - name: Install Packages
-        if: steps.changed-docs.outputs.only_modified == 'true'
-        run: |
-          pnpm install --frozen-lockfile
-        env:
-          CYPRESS_CACHE_FOLDER: .cache/Cypress
-
-      - name: Run step if any file(s) in the docs folder change
-        if: steps.changed-docs.outputs.only_modified == 'true'
-        run: |
-          echo "Only files in the src/docs folder has changed."
-          echo "List all the files that have changed: ${{ steps.changed-files-specific.outputs.all_changed_files }}"
-          yarn docs:build
-
-      - name: Commit changes
-        uses: EndBug/add-and-commit@v9
-        if: steps.changed-docs.outputs.only_modified == 'true'
-        with:
-          message: 'Update docs'
-          add: 'docs/*'
diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 8ba06989d..917a2731c 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -9,7 +9,7 @@ on:
       - ready_for_review
 
 permissions:
-  contents: read
+  contents: write
 
 jobs:
   lint:
@@ -39,5 +39,19 @@ jobs:
         run: pnpm run lint
 
       - name: Verify Docs
+        id: verifyDocs
         working-directory: ./packages/mermaid
+        continue-on-error: true
         run: pnpm run docs:verify
+
+      - name: Rebuild Docs
+        if: ${{ steps.verifyDocs.outcome == 'failure' && github.event_name == 'push' }}
+        run: |
+          yarn docs:build
+
+      - name: Commit changes
+        uses: EndBug/add-and-commit@v9
+        if: ${{ steps.verifyDocs.outcome == 'failure' && github.event_name == 'push' }}
+        with:
+          message: 'Update docs'
+          add: 'docs/*'

From 755382798589f28c936300c311589a4606a1f9a0 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 7 Dec 2022 11:40:17 +0530
Subject: [PATCH 064/129] fix: docs build command

---
 .github/workflows/lint.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index 917a2731c..f1ab5726b 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -46,8 +46,8 @@ jobs:
 
       - name: Rebuild Docs
         if: ${{ steps.verifyDocs.outcome == 'failure' && github.event_name == 'push' }}
-        run: |
-          yarn docs:build
+        working-directory: ./packages/mermaid
+        run: pnpm run docs:build
 
       - name: Commit changes
         uses: EndBug/add-and-commit@v9

From b2489523f24ed271e7c9dc281078e859e6026619 Mon Sep 17 00:00:00 2001
From: sidharthv96 <sidharthv96@users.noreply.github.com>
Date: Wed, 7 Dec 2022 06:13:07 +0000
Subject: [PATCH 065/129] Update docs

---
 docs/syntax/classDiagram.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/syntax/classDiagram.md b/docs/syntax/classDiagram.md
index 5870d0743..b6d48c9de 100644
--- a/docs/syntax/classDiagram.md
+++ b/docs/syntax/classDiagram.md
@@ -7,7 +7,8 @@
 # Class diagrams
 
 > "In software engineering, a class diagram in the Unified Modeling Language (UML) is a type of static structure diagram that describes the structure of a system by showing the system's classes, their attributes, operations (or methods), and the relationships among objects."
-> Wikipedia
+>
+> \-Wikipedia
 
 The class diagram is the main building block of object-oriented modeling. It is used for general conceptual modeling of the structure of the application, and for detailed modeling to translate the models into programming code. Class diagrams can also be used for data modeling. The classes in a class diagram represent both the main elements, interactions in the application, and the classes to be programmed.
 

From 1a767ee492f74aa3475cf50ecc0baf0f10545d3e Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 7 Dec 2022 11:48:51 +0530
Subject: [PATCH 066/129] chore: Update cspell

---
 cSpell.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/cSpell.json b/cSpell.json
index 64187e1ca..3ddf84102 100644
--- a/cSpell.json
+++ b/cSpell.json
@@ -64,6 +64,7 @@
     "phpbb",
     "plantuml",
     "playfair",
+    "pnpm",
     "podlite",
     "ranksep",
     "redmine",

From 59fdaa3b534e32437aeb7ac4ade9685511fb6a7e Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 7 Dec 2022 11:58:09 +0530
Subject: [PATCH 067/129] fix: Fail docs:verify on non push events

---
 .github/workflows/lint.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index f1ab5726b..d67144540 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -41,7 +41,7 @@ jobs:
       - name: Verify Docs
         id: verifyDocs
         working-directory: ./packages/mermaid
-        continue-on-error: true
+        continue-on-error: ${{ github.event_name == 'push' }}
         run: pnpm run docs:verify
 
       - name: Rebuild Docs

From 1c9a55936201db54aab405e86603a86840d4b69d Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Wed, 7 Dec 2022 10:19:30 -0800
Subject: [PATCH 068/129] common function for a11y; add to renderAsync; +
 renderAsync spec

---
 docs/config/setup/modules/mermaidAPI.md |  2 +-
 packages/mermaid/src/mermaidAPI.spec.ts | 52 +++++++++++++++++++++++++
 packages/mermaid/src/mermaidAPI.ts      | 23 ++++++++++-
 3 files changed, 74 insertions(+), 3 deletions(-)

diff --git a/docs/config/setup/modules/mermaidAPI.md b/docs/config/setup/modules/mermaidAPI.md
index 7902c1be9..1b840dcd3 100644
--- a/docs/config/setup/modules/mermaidAPI.md
+++ b/docs/config/setup/modules/mermaidAPI.md
@@ -90,7 +90,7 @@ mermaid.initialize(config);
 
 #### Defined in
 
-[mermaidAPI.ts:949](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L949)
+[mermaidAPI.ts:968](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L968)
 
 ## Functions
 
diff --git a/packages/mermaid/src/mermaidAPI.spec.ts b/packages/mermaid/src/mermaidAPI.spec.ts
index dd36b1d0c..f9bad66d7 100644
--- a/packages/mermaid/src/mermaidAPI.spec.ts
+++ b/packages/mermaid/src/mermaidAPI.spec.ts
@@ -734,4 +734,56 @@ describe('mermaidAPI', function () {
       });
     });
   });
+
+  describe('renderAsync', () => {
+    // Be sure to add async before each test (anonymous) method
+
+    // These are more like integration tests right now because nothing is mocked.
+    // But it is faster that a cypress test and there's no real reason to actually evaluate an image pixel by pixel.
+
+    // render(id, text, cb?, svgContainingElement?)
+
+    // Test all diagram types.  Note that old flowchart 'graph' type will invoke the flowRenderer-v2. (See the flowchart v2 detector.)
+    // We have to have both the specific textDiagramType and the expected type name because the expected type may be slightly different than was is put in the diagram text (ex: in -v2 diagrams)
+    const diagramTypesAndExpectations = [
+      { textDiagramType: 'C4Context', expectedType: 'c4' },
+      { textDiagramType: 'classDiagram', expectedType: 'classDiagram' },
+      { textDiagramType: 'classDiagram-v2', expectedType: 'classDiagram' },
+      { textDiagramType: 'erDiagram', expectedType: 'er' },
+      { textDiagramType: 'graph', expectedType: 'flowchart-v2' },
+      { textDiagramType: 'flowchart', expectedType: 'flowchart-v2' },
+      { textDiagramType: 'gitGraph', expectedType: 'gitGraph' },
+      { textDiagramType: 'gantt', expectedType: 'gantt' },
+      { textDiagramType: 'journey', expectedType: 'journey' },
+      { textDiagramType: 'pie', expectedType: 'pie' },
+      { textDiagramType: 'requirementDiagram', expectedType: 'requirement' },
+      { textDiagramType: 'sequenceDiagram', expectedType: 'sequence' },
+      { textDiagramType: 'stateDiagram-v2', expectedType: 'stateDiagram' },
+    ];
+
+    describe('accessibility', () => {
+      const id = 'mermaid-fauxId';
+      const a11yTitle = 'a11y title';
+      const a11yDescr = 'a11y description';
+
+      diagramTypesAndExpectations.forEach((testedDiagram) => {
+        describe(`${testedDiagram.textDiagramType}`, () => {
+          const diagramType = testedDiagram.textDiagramType;
+          const diagramText = `${diagramType}\n accTitle: ${a11yTitle}\n accDescr: ${a11yDescr}\n`;
+          const expectedDiagramType = testedDiagram.expectedType;
+
+          it('aria-roledscription is set to the diagram type, addSVGa11yTitleDescription is called', async () => {
+            const a11yDiagramInfo_spy = vi.spyOn(accessibility, 'setA11yDiagramInfo');
+            const a11yTitleDesc_spy = vi.spyOn(accessibility, 'addSVGa11yTitleDescription');
+            await mermaidAPI.renderAsync(id, diagramText);
+            expect(a11yDiagramInfo_spy).toHaveBeenCalledWith(
+              expect.anything(),
+              expectedDiagramType
+            );
+            expect(a11yTitleDesc_spy).toHaveBeenCalled();
+          });
+        });
+      });
+    });
+  });
 });
diff --git a/packages/mermaid/src/mermaidAPI.ts b/packages/mermaid/src/mermaidAPI.ts
index 1ac03c4f6..a77aed96d 100644
--- a/packages/mermaid/src/mermaidAPI.ts
+++ b/packages/mermaid/src/mermaidAPI.ts
@@ -519,10 +519,9 @@ const render = function (
 
   // This is the d3 node for the svg element
   const svgNode = root.select(`${enclosingDivID_selector} svg`);
-  setA11yDiagramInfo(svgNode, graphType);
   const a11yTitle = diag.db.getAccTitle?.();
   const a11yDescr = diag.db.getAccDescription?.();
-  addSVGa11yTitleDescription(svgNode, a11yTitle, a11yDescr, svgNode.attr('id'));
+  addA11yInfo(graphType, svgNode, a11yTitle, a11yDescr);
 
   // -------------------------------------------------------------------------------
   // Clean up SVG code
@@ -720,6 +719,12 @@ const renderAsync = async function (
     throw e;
   }
 
+  // This is the d3 node for the svg element
+  const svgNode = root.select(`${enclosingDivID_selector} svg`);
+  const a11yTitle = diag.db.getAccTitle?.();
+  const a11yDescr = diag.db.getAccDescription?.();
+  addA11yInfo(graphType, svgNode, a11yTitle, a11yDescr);
+
   // -------------------------------------------------------------------------------
   // Clean up SVG code
   root.select(`[id="${id}"]`).selectAll('foreignobject > *').attr('xmlns', XMLNS_XHTML_STD);
@@ -884,6 +889,20 @@ function initialize(options: MermaidConfig = {}) {
   addDiagrams();
 }
 
+/**
+ * Add accessibility (a11y) information to the diagram.
+ *
+ */
+function addA11yInfo(
+  graphType: string,
+  svgNode: D3Element,
+  a11yTitle: string | undefined,
+  a11yDescr: string | undefined
+) {
+  setA11yDiagramInfo(svgNode, graphType);
+  addSVGa11yTitleDescription(svgNode, a11yTitle, a11yDescr, svgNode.attr('id'));
+}
+
 /**
  * ## mermaidAPI configuration defaults
  *

From 9b27396344648d11c4f459edeae6fd4a3440642b Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knsv@sveido.com>
Date: Thu, 8 Dec 2022 13:21:56 +0100
Subject: [PATCH 069/129] Small fix

---
 cypress/integration/other/ghsa.spec.js        |   6 +
 cypress/platform/ghsa1.html                   |   2 +-
 cypress/platform/ghsa3.html                   | 100 +++++++
 cypress/platform/knsv3.html                   | 276 ++++--------------
 .../mermaid/src/diagrams/common/common.ts     |   4 +-
 packages/mermaid/src/mermaidAPI.ts            |   4 +-
 6 files changed, 173 insertions(+), 219 deletions(-)
 create mode 100644 cypress/platform/ghsa3.html

diff --git a/cypress/integration/other/ghsa.spec.js b/cypress/integration/other/ghsa.spec.js
index 5b168a8a8..4fadc7855 100644
--- a/cypress/integration/other/ghsa.spec.js
+++ b/cypress/integration/other/ghsa.spec.js
@@ -7,4 +7,10 @@ describe('CSS injections', () => {
       flowchart: { htmlLabels: false },
     });
   });
+  it('should not allow adding styletags affecting the page', () => {
+    urlSnapshotTest('http://localhost:9000/ghsa3.html', {
+      logLevel: 1,
+      flowchart: { htmlLabels: false },
+    });
+  });
 });
diff --git a/cypress/platform/ghsa1.html b/cypress/platform/ghsa1.html
index c54358862..890a8e0dd 100644
--- a/cypress/platform/ghsa1.html
+++ b/cypress/platform/ghsa1.html
@@ -4,7 +4,7 @@
   </script>
   <body>
     <div id="target">
-      <h1>This element does not belong to the SVG but we can style it</h1>
+      <h1>Background should be yellow!!!</h1>
     </div>
     <svg id="diagram"></svg>
 
diff --git a/cypress/platform/ghsa3.html b/cypress/platform/ghsa3.html
new file mode 100644
index 000000000..63dfa0d01
--- /dev/null
+++ b/cypress/platform/ghsa3.html
@@ -0,0 +1,100 @@
+<html>
+  <head>
+    <link href="https://fonts.googleapis.com/css?family=Montserrat&display=swap" rel="stylesheet" />
+    <link href="https://unpkg.com/tailwindcss@^1.0/dist/tailwind.min.css" rel="stylesheet" />
+    <link
+      rel="stylesheet"
+      href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css"
+    />
+    <link
+      href="https://fonts.googleapis.com/css?family=Noto+Sans+SC&display=swap"
+      rel="stylesheet"
+    />
+    <style>
+      body {
+        /* background: rgb(221, 208, 208); */
+        /* background:#333; */
+        font-family: 'Arial';
+        /* font-size: 18px !important; */
+      }
+      h1 {
+        color: grey;
+      }
+      .mermaid2 {
+        display: none;
+      }
+      .mermaid svg {
+        /* font-size: 18px !important; */
+      }
+      .malware {
+        position: fixed;
+        bottom: 0;
+        left: 0;
+        right: 0;
+        height: 150px;
+        background: red;
+        color: black;
+        display: flex;
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        font-family: monospace;
+        font-size: 72px;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>PAGE SHOULD NOT BE RED</h1>
+    <div class="flex">
+      <div id="diagram" class="mermaid"></div>
+      <div id="res" class=""></div>
+    </div>
+    <script src="./mermaid.js"></script>
+    <script>
+      mermaid.parseError = function (err, hash) {
+        // console.error('Mermaid error: ', err);
+      };
+      mermaid.initialize({
+        theme: 'forest',
+        arrowMarkerAbsolute: true,
+        // themeCSS: '.edgePath .path {stroke: red;} .arrowheadPath {fill: red;}',
+        logLevel: 0,
+        state: {
+          defaultRenderer: 'dagre-wrapper',
+        },
+        flowchart: {
+          // defaultRenderer: 'dagre-wrapper',
+          nodeSpacing: 10,
+          curve: 'cardinal',
+          htmlLabels: true,
+        },
+        htmlLabels: true,
+        // gantt: { axisFormat: '%m/%d/%Y' },
+        sequence: { actorFontFamily: 'courier', actorMargin: 50, showSequenceNumbers: false },
+        // sequenceDiagram: { actorMargin: 300 } // deprecated
+        // fontFamily: '"times", sans-serif',
+        // fontFamily: 'courier',
+        fontSize: 18,
+        curve: 'basis',
+        // securityLevel: 'strict',
+        startOnLoad: false,
+        secure: ['secure', 'securityLevel', 'startOnLoad', 'maxTextSize'],
+        // themeVariables: {relationLabelColor: 'red'}
+      });
+      function callback() {
+        alert('It worked');
+      }
+
+      let diagram = '%%{init: {"flowchart": {"htmlLabels": "true"}} }%%\n';
+      diagram += 'flowchart\n';
+      diagram += 'A["<p><sty';
+      diagram += 'le> * { background : red}</style>test</p>"]';
+
+      console.log(diagram);
+      // document.querySelector('#diagram').innerHTML = diagram;
+      mermaid.render('diagram', diagram, (res) => {
+        document.querySelector('#res').innerHTML = res;
+      });
+    </script>
+  </body>
+</html>
diff --git a/cypress/platform/knsv3.html b/cypress/platform/knsv3.html
index 0c1afadb7..e5ca66c87 100644
--- a/cypress/platform/knsv3.html
+++ b/cypress/platform/knsv3.html
@@ -6,6 +6,10 @@
       rel="stylesheet"
       href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css"
     />
+    <link
+      href="https://cdn.jsdelivr.net/npm/@mdi/font@6.9.96/css/materialdesignicons.min.css"
+      rel="stylesheet"
+    />
     <link
       href="https://fonts.googleapis.com/css?family=Noto+Sans+SC&display=swap"
       rel="stylesheet"
@@ -14,7 +18,7 @@
       body {
         /* background: rgb(221, 208, 208); */
         /* background:#333; */
-        font-family: 'Courier New', Courier, monospace;
+        font-family: 'Arial';
         /* font-size: 18px !important; */
       }
       h1 {
@@ -23,235 +27,77 @@
       .mermaid2 {
         display: none;
       }
-      .mermaid {
-        border: 1px solid red;
-        font-family: 'Courier New', Courier, monospace;
+      .mermaid svg {
         /* font-size: 18px !important; */
+        background-color: #eee;
+        background-image: radial-gradient(#fff 1%, transparent 11%),
+          radial-gradient(#fff 1%, transparent 11%);
+        background-size: 20px 20px;
+        background-position: 0 0, 10px 10px;
+        background-repeat: repeat;
+      }
+      .malware {
+        position: fixed;
+        bottom: 0;
+        left: 0;
+        right: 0;
+        height: 150px;
+        background: red;
+        color: black;
+        display: flex;
+        display: flex;
+        justify-content: center;
+        align-items: center;
+        font-family: monospace;
+        font-size: 72px;
       }
     </style>
   </head>
   <body>
-    <div>info below</div>
-    <div class="">
-      <pre class="mermaid2" style="width: 100%; height: 400px">
-flowchart TB;subgraph "number as labels";1;end;
-      </pre>
-      <pre class="mermaid2" style="width: 100%; height: 400px">
-flowchart TB;a[APA];
-      </pre>
-      <pre class="mermaid2" style="margin-left: 100px">
-graph TD
-      work --> sleep
-      sleep --> work
-      eat --> sleep
-      work --> eat
-      </pre>
-      <pre class="mermaid2" style="margin-left: 100px">
-flowchart TD
-      work --> sleep
-      sleep --> work
-      eat --> sleep
-      work --> eat
-      </pre>
-      <pre class="mermaid2" style="">
- graph TB
-      A
-      B
-      subgraph foo[Foo SubGraph]
-        C
-        D
-      end
-      subgraph bar[Bar SubGraph]
-        E
-        F
-      end
-      G
-
-      A-->B
-      B-->C
-      C-->D
-      B-->D
-      D-->E
-      E-->A
-      E-->F
-      F-->D
-      F-->G
-      B-->G
-      G-->D
-
-      style foo fill:#F99,stroke-width:2px,stroke:#F0F,color:darkred
-      style bar fill:#999,stroke-width:2px,stroke:#0F0,color:blue
-      </pre>
-      <pre class="mermaid2" style="">
-      graph TB
-%%{init: { "logLevel": 1, "flowchart": {"htmlLabels":true }} }%%
-      A
-      B
-      subgraph foo[Foo SubGraph]
-        C
-        D
-      end
-      subgraph bar[Bar SubGraph]
-        E
-        F
-      end
-      G
-
-      A-->B
-      B-->C
-      C-->D
-      B-->D
-      D-->E
-      E-->A
-      E-->F
-      F-->D
-      F-->G
-      B-->G
-      G-->D
-
-      style foo fill:#F99,stroke-width:2px,stroke:#F0F,color:darkred
-      style bar fill:#999,stroke-width:10px,stroke:#0F0,color:blue
-      </pre>
-      <pre class="mermaid2" style="">
+    <div>Security check</div>
+    <pre id="diagram" class="mermaid">
       graph TD
-        A[Christmas] ==> D
-        A[Christmas] -->|Get money| B(Go shopping)
-        A[Christmas] ==> C
-      </pre>
-      <pre class="mermaid2" style="">
-      graph TD
-%%{init: { "logLevel": 1, "flowchart": {"htmlLabels":true }} }%%
-        A[Christmas] ==> D
-        A[Christmas] -->|Get money| B(Go shopping)
-        A[Christmas] ==> C
-      </pre>
-      <pre class="mermaid2" style="">
-      flowchart TD
-        A[Christmas] ==> D
-        A[Christmas] -->|Get money| B(Go shopping)
-        A[Christmas] ==> C
-      </pre>
-      <pre class="mermaid2" style="">
-      flowchart TD
-%%{init: { "logLevel": 1, "flowchart": {"htmlLabels":true }} }%%
-        A[Christmas] ==> D
-        A[Christmas] -->|Get money| B(Go shopping)
-        A[Christmas] ==> C
-      </pre>
-      <pre class="mermaid2" style="">
-flowchart LR
-        a["<strong>Haiya</strong>"]---->b
-      </pre>
-      <pre class="mermaid" style="">
-flowchart LR
-%%{init: { "logLevel": 1, "flowchart": {"htmlLabels":true }} }%%
-        a["<strong>Haiya</strong>"]---->b
-      </pre>
-      <pre class="mermaid2" style="">
-      flowchart TD
-        A[Christmas] ==> D
-        A[Christmas] -->|Get money| B(Go shopping)
-        A[Christmas] ==> C
-      </pre>
-      <pre class="mermaid2" style="">
-      flowchart TD
-%%{init: { "logLevel": 1, "flowchart": {"htmlLabels":true }} }%%
-        A[Christmas] ==> D
-        A[Christmas] -->|Get money| B(Go shopping)
-        A[Christmas] ==> C
-      </pre>
-      <pre class="mermaid2" style="">
-      %%{init: { "logLevel": 1, "flowchart": {"htmlLabels":true }} }%%
-classDiagram-v2
-      Class01 <|-- AveryLongClass : Cool
-      &lt;&lt;interface&gt;&gt; Class01
-      Class03 *-- Class04
-      Class05 o-- Class06
-      Class07 .. Class08
-      Class09 --> C2 : Where am i?
-      Class09 --* C3
-      Class09 --|> Class07
-      Class12 <|.. Class08
-      Class11 ..>Class12
-      Class07 : equals()
-      Class07 : Object[] elementData
-      Class01 : size()
-      Class01 : int chimp
-      Class01 : int gorilla
-      Class01 : -int privateChimp
-      Class01 : +int publicGorilla
-      Class01 : #int protectedMarmoset
-      Class08 <--> C2: Cool label
-      class Class10 {
-        &lt;&lt;service&gt;&gt;
-        int id
-        test()
-      }
-      </pre>
-      <pre class="mermaid2" style="">
-classDiagram-v2
-      Class01 <|-- AveryLongClass : Cool
-      &lt;&lt;interface&gt;&gt; Class01
-      Class03 *-- Class04
-      Class05 o-- Class06
-      Class07 .. Class08
-      Class09 --> C2 : Where am i?
-      Class09 --* C3
-      Class09 --|> Class07
-      Class12 <|.. Class08
-      Class11 ..>Class12
-      Class07 : equals()
-      Class07 : Object[] elementData
-      Class01 : size()
-      Class01 : int chimp
-      Class01 : int gorilla
-      Class01 : -int privateChimp
-      Class01 : +int publicGorilla
-      Class01 : #int protectedMarmoset
-      Class08 <--> C2: Cool label
-      class Class10 {
-        &lt;&lt;service&gt;&gt;
-        int id
-        test()
-      }
-      </pre>
-      <pre class="mermaid" style="">
-flowchart BT
-   subgraph S1
-    sub1 -->sub2
-   end
-  subgraph S2
-    sub4
-   end
-   S1 --> S2
-   sub1 --> sub4
-      </pre>
-    </div>
-    <script src="./mermaid.js"></script>
-    <script>
+        A["test"] --"<p><style> * { display : none}</style>test</p>"--> B
+    </pre>
+
+    <!-- <div id="cy"></div> -->
+    <!-- <script src="http://localhost:9000/packages/mermaid-mindmap/dist/mermaid-mindmap-detector.js"></script> -->
+    <!-- <script src="./mermaid-example-diagram-detector.js"></script>    -->
+    <!-- <script src="//cdn.jsdelivr.net/npm/mermaid@9.1.7/dist/mermaid.min.js"></script> -->
+    <!-- <script src="./mermaid.js"></script> -->
+
+    <script type="module">
+      import mindmap from '../../packages/mermaid-mindmap/src/detector';
+      // import example from '../../packages/mermaid-example-diagram/src/detector';
+      import mermaid from '../../packages/mermaid/src/mermaid';
+      await mermaid.registerExternalDiagrams([mindmap]);
       mermaid.parseError = function (err, hash) {
         // console.error('Mermaid error: ', err);
       };
       mermaid.initialize({
-        // theme: 'neutral',
-        // arrowMarkerAbsolute: true,
-        // themeCSS: '.edgePath .path {stroke: red;} .arrowheadPath {fill: red;}',
+        theme: 'default',
+        startOnLoad: true,
         logLevel: 0,
-        flowchart: { curve: 'cardinal', htmlLabels: false },
-        // htmlLabels: true,
-        // gantt: { axisFormat: '%m/%d/%Y' },
-        // sequence: { actorFontFamily: 'courier', actorMargin: 50, showSequenceNumbers: false },
-        // sequenceDiagram: { actorMargin: 300 } // deprecated
-        // fontFamily: '"times", sans-serif',
-        fontFamily: 'courier',
-        // fontSize: 18,
-        // curve: 'cardinal',
-        securityLevel: 'loose',
-        // themeVariables: {relationLabelColor: 'red'}
+        flowchart: {
+          useMaxWidth: false,
+          htmlLabels: true,
+        },
+        gantt: {
+          useMaxWidth: false,
+        },
+        useMaxWidth: false,
       });
       function callback() {
         alert('It worked');
       }
+      mermaid.parseError = function (err, hash) {
+        console.error('In parse error:');
+        console.error(err);
+      };
+      // mermaid.test1('first_slow', 1200).then((r) => console.info(r));
+      // mermaid.test1('second_fast', 200).then((r) => console.info(r));
+      // mermaid.test1('third_fast', 200).then((r) => console.info(r));
+      // mermaid.test1('forth_slow', 1200).then((r) => console.info(r));
     </script>
   </body>
 </html>
diff --git a/packages/mermaid/src/diagrams/common/common.ts b/packages/mermaid/src/diagrams/common/common.ts
index 194a9a4c0..628908aab 100644
--- a/packages/mermaid/src/diagrams/common/common.ts
+++ b/packages/mermaid/src/diagrams/common/common.ts
@@ -47,7 +47,9 @@ export const sanitizeText = (text: string, config: MermaidConfig): string => {
   if (config.dompurifyConfig) {
     text = DOMPurify.sanitize(sanitizeMore(text, config), config.dompurifyConfig).toString();
   } else {
-    text = DOMPurify.sanitize(sanitizeMore(text, config));
+    text = DOMPurify.sanitize(sanitizeMore(text, config), {
+      FORBID_TAGS: ['style'],
+    }).toString();
   }
   return text;
 };
diff --git a/packages/mermaid/src/mermaidAPI.ts b/packages/mermaid/src/mermaidAPI.ts
index a77aed96d..193f5a9cc 100644
--- a/packages/mermaid/src/mermaidAPI.ts
+++ b/packages/mermaid/src/mermaidAPI.ts
@@ -536,7 +536,7 @@ const render = function (
   if (isSandboxed) {
     const svgEl = root.select(enclosingDivID_selector + ' svg').node();
     svgCode = putIntoIFrame(svgCode, svgEl);
-  } else if (isLooseSecurityLevel) {
+  } else if (!isLooseSecurityLevel) {
     // Sanitize the svgCode using DOMPurify
     svgCode = DOMPurify.sanitize(svgCode, {
       ADD_TAGS: DOMPURE_TAGS,
@@ -738,7 +738,7 @@ const renderAsync = async function (
   if (isSandboxed) {
     const svgEl = root.select(enclosingDivID_selector + ' svg').node();
     svgCode = putIntoIFrame(svgCode, svgEl);
-  } else if (isLooseSecurityLevel) {
+  } else if (!isLooseSecurityLevel) {
     // Sanitize the svgCode using DOMPurify
     svgCode = DOMPurify.sanitize(svgCode, {
       ADD_TAGS: DOMPURE_TAGS,

From c6fce2431b81b72a8915f224aa038300e72df1ac Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knsv@sveido.com>
Date: Thu, 8 Dec 2022 14:14:31 +0100
Subject: [PATCH 070/129] Fixes for tests

---
 cypress/integration/rendering/classDiagram-v2.spec.js | 3 +--
 cypress/integration/rendering/classDiagram.spec.js    | 1 -
 2 files changed, 1 insertion(+), 3 deletions(-)

diff --git a/cypress/integration/rendering/classDiagram-v2.spec.js b/cypress/integration/rendering/classDiagram-v2.spec.js
index f97458857..9536a074d 100644
--- a/cypress/integration/rendering/classDiagram-v2.spec.js
+++ b/cypress/integration/rendering/classDiagram-v2.spec.js
@@ -485,8 +485,7 @@ describe('Class diagram V2', () => {
       classDiagram-v2
         note "I love this diagram!\nDo you love it?"
         class Class10 {
-          <<service>>
-          int id
+            int id
           size()
         }
         note for Class10 "Cool class\nI said it's very cool class!"
diff --git a/cypress/integration/rendering/classDiagram.spec.js b/cypress/integration/rendering/classDiagram.spec.js
index 16601652d..e21be67ec 100644
--- a/cypress/integration/rendering/classDiagram.spec.js
+++ b/cypress/integration/rendering/classDiagram.spec.js
@@ -414,7 +414,6 @@ describe('Class diagram', () => {
     classDiagram
       note "I love this diagram!\nDo you love it?"
       class Class10 {
-        <<service>>
         int id
         size()
       }

From 98fc8664443f12e5bed5fe6209fa67e073619bc5 Mon Sep 17 00:00:00 2001
From: Per Brolin <per@mermaidchart.com>
Date: Thu, 8 Dec 2022 14:16:25 +0100
Subject: [PATCH 071/129] Minor change of test code

---
 cypress/integration/rendering/current.spec.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cypress/integration/rendering/current.spec.js b/cypress/integration/rendering/current.spec.js
index 56b5f774b..033752c66 100644
--- a/cypress/integration/rendering/current.spec.js
+++ b/cypress/integration/rendering/current.spec.js
@@ -1,6 +1,6 @@
 import { imgSnapshotTest } from '../../helpers/util';
 
-describe('State diagram', () => {
+describe('Current diagram', () => {
   it('should render a state with states in it', () => {
     imgSnapshotTest(
       `

From 7656916cef292828785b9f104df93ca1e2fe5211 Mon Sep 17 00:00:00 2001
From: Per Brolin <per@mermaidchart.com>
Date: Thu, 8 Dec 2022 15:03:51 +0100
Subject: [PATCH 072/129] Updated package number to 9.3.0-rc1

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 1faa1628d..c027fa71f 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "mermaid-monorepo",
   "private": true,
-  "version": "9.2.2",
+  "version": "9.3.0-rc1",
   "description": "Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "type": "module",
   "packageManager": "pnpm@7.17.1",

From 23a44952ace8d7e2779769d124c8e9d1a96945d0 Mon Sep 17 00:00:00 2001
From: Per Brolin <per@mermaidchart.com>
Date: Thu, 8 Dec 2022 15:09:49 +0100
Subject: [PATCH 073/129] Updated package number

---
 packages/mermaid/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 66fa4f224..81d1d9be9 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mermaid",
-  "version": "9.2.3-rc.1",
+  "version": "9.3.0-rc.1",
   "description": "Markdown-ish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",

From 4f169dd2b8bd6aa0e1e1023b8e2b6754620a1e64 Mon Sep 17 00:00:00 2001
From: Per Brolin <per@mermaidchart.com>
Date: Thu, 8 Dec 2022 15:16:13 +0100
Subject: [PATCH 074/129] Updated package number

---
 packages/mermaid-mindmap/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid-mindmap/package.json b/packages/mermaid-mindmap/package.json
index 852c0871b..2795cf73b 100644
--- a/packages/mermaid-mindmap/package.json
+++ b/packages/mermaid-mindmap/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@mermaid-js/mermaid-mindmap",
-  "version": "9.2.2",
+  "version": "9.3.0-rc1",
   "description": "Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "module": "dist/mermaid-mindmap.core.mjs",
   "types": "dist/detector.d.ts",

From e1a501c66b7b03d30aa66177bd88b747e1c7ec70 Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knsv@sveido.com>
Date: Thu, 8 Dec 2022 16:38:47 +0100
Subject: [PATCH 075/129] Update url snapshot test for external diagrams

---
 cypress/integration/other/external-diagrams.spec.js | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/cypress/integration/other/external-diagrams.spec.js b/cypress/integration/other/external-diagrams.spec.js
index 3a6c37e88..903f8b77b 100644
--- a/cypress/integration/other/external-diagrams.spec.js
+++ b/cypress/integration/other/external-diagrams.spec.js
@@ -1,13 +1,16 @@
+import { urlSnapshotTest } from '../../helpers/util';
+
 describe('mermaid', () => {
   describe('registerDiagram', () => {
     it('should work on @mermaid-js/mermaid-mindmap and mermaid-example-diagram', () => {
       const url = 'http://localhost:9000/external-diagrams-mindmap.html';
-      cy.visit(url);
+      urlSnapshotTest(url, {}, false, false);
+      // cy.visit(url);
 
-      cy.get('svg', {
-        // may be a bit slower than normal, since vite might need to re-compile mermaid/mermaid-mindmap/mermaid-example-diagram
-        timeout: 10000,
-      }).matchImageSnapshot();
+      // cy.get('svg', {
+      //   // may be a bit slower than normal, since vite might need to re-compile mermaid/mermaid-mindmap/mermaid-example-diagram
+      //   timeout: 10000,
+      // }).matchImageSnapshot();
     });
   });
 });

From 6c2647e8cf79c5c5a3d57ef3ebff036a38773e30 Mon Sep 17 00:00:00 2001
From: Knut Sveidqvist <knsv@sveido.com>
Date: Thu, 8 Dec 2022 16:39:21 +0100
Subject: [PATCH 076/129] Update url snapshot test for external diagrams

---
 cypress/integration/other/external-diagrams.spec.js | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/cypress/integration/other/external-diagrams.spec.js b/cypress/integration/other/external-diagrams.spec.js
index 903f8b77b..be69dfc98 100644
--- a/cypress/integration/other/external-diagrams.spec.js
+++ b/cypress/integration/other/external-diagrams.spec.js
@@ -5,12 +5,6 @@ describe('mermaid', () => {
     it('should work on @mermaid-js/mermaid-mindmap and mermaid-example-diagram', () => {
       const url = 'http://localhost:9000/external-diagrams-mindmap.html';
       urlSnapshotTest(url, {}, false, false);
-      // cy.visit(url);
-
-      // cy.get('svg', {
-      //   // may be a bit slower than normal, since vite might need to re-compile mermaid/mermaid-mindmap/mermaid-example-diagram
-      //   timeout: 10000,
-      // }).matchImageSnapshot();
     });
   });
 });

From e59b830d747750977d5ac4bf24ce86bb96e90292 Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Thu, 8 Dec 2022 11:25:04 -0800
Subject: [PATCH 077/129] set svg role to 'graphics-document document'

---
 packages/mermaid/src/accessibility.spec.ts | 12 ++++++++++--
 packages/mermaid/src/accessibility.ts      | 17 ++++++++++++++++-
 2 files changed, 26 insertions(+), 3 deletions(-)

diff --git a/packages/mermaid/src/accessibility.spec.ts b/packages/mermaid/src/accessibility.spec.ts
index c633d0e15..60415ea37 100644
--- a/packages/mermaid/src/accessibility.spec.ts
+++ b/packages/mermaid/src/accessibility.spec.ts
@@ -6,6 +6,13 @@ describe('accessibility', () => {
   const fauxSvgNode = new MockedD3();
 
   describe('setA11yDiagramInfo', () => {
+    it('sets the svg element role to "graphics-document document"', () => {
+      // @ts-ignore  Required to easily handle the d3 select types
+      const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
+      setA11yDiagramInfo(fauxSvgNode, 'flowchart');
+      expect(svgAttrSpy).toHaveBeenCalledWith('role', 'graphics-document document');
+    });
+
     it('sets the aria-roledescription to the diagram type', () => {
       // @ts-ignore  Required to easily handle the d3 select types
       const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
@@ -13,11 +20,12 @@ describe('accessibility', () => {
       expect(svgAttrSpy).toHaveBeenCalledWith('aria-roledescription', 'flowchart');
     });
 
-    it('does nothing if the diagram type is empty', () => {
+    it('does not set the aria-roledescription if the diagram type is empty', () => {
       // @ts-ignore  Required to easily handle the d3 select types
       const svgAttrSpy = vi.spyOn(fauxSvgNode, 'attr').mockReturnValue(fauxSvgNode);
       setA11yDiagramInfo(fauxSvgNode, '');
-      expect(svgAttrSpy).not.toHaveBeenCalled();
+      expect(svgAttrSpy).toHaveBeenCalledTimes(1);
+      expect(svgAttrSpy).toHaveBeenCalledWith('role', expect.anything()); // only called to set the role
     });
   });
 
diff --git a/packages/mermaid/src/accessibility.ts b/packages/mermaid/src/accessibility.ts
index b9e088e0b..13c2aa43a 100644
--- a/packages/mermaid/src/accessibility.ts
+++ b/packages/mermaid/src/accessibility.ts
@@ -1,5 +1,8 @@
 /**
  * Accessibility (a11y) functions, types, helpers
+ * @see https://www.w3.org/WAI/
+ * @see https://www.w3.org/TR/wai-aria-1.1/
+ * @see https://www.w3.org/TR/svg-aam-1.0/
  *
  */
 import { D3Element } from './mermaidAPI';
@@ -7,12 +10,24 @@ import { D3Element } from './mermaidAPI';
 import isEmpty from 'lodash-es/isEmpty';
 
 /**
- * Add aria-roledescription to the svg element to the diagramType
+ * SVG element role:
+ * The SVG element role _should_ be set to 'graphics-document' per SVG standard
+ * but in practice is not always done by browsers, etc. (As of 2022-12-08).
+ * A fallback role of 'document' should be set for those browsers, etc., that only support ARIA 1.0.
+ *
+ * @see https://www.w3.org/TR/svg-aam-1.0/#roleMappingGeneralRules
+ * @see https://www.w3.org/TR/graphics-aria-1.0/#graphics-document
+ */
+const SVG_ROLE = 'graphics-document document';
+
+/**
+ * Add role and aria-roledescription to the svg element
  *
  * @param svg - d3 object that contains the SVG HTML element
  * @param diagramType - diagram name for to the aria-roledescription
  */
 export function setA11yDiagramInfo(svg: D3Element, diagramType: string | null | undefined) {
+  svg.attr('role', SVG_ROLE);
   if (!isEmpty(diagramType)) {
     svg.attr('aria-roledescription', diagramType);
   }

From de795a915e0b1136faf347c7131db388d265ceef Mon Sep 17 00:00:00 2001
From: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Date: Fri, 9 Dec 2022 04:56:55 -0800
Subject: [PATCH 078/129] remove links from atom.io; add note Atom has been
 archived

---
 docs/misc/integrations.md                      | 8 ++++----
 packages/mermaid/src/docs/misc/integrations.md | 8 ++++----
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/misc/integrations.md b/docs/misc/integrations.md
index 007b9e778..23a95c0a1 100644
--- a/docs/misc/integrations.md
+++ b/docs/misc/integrations.md
@@ -109,10 +109,10 @@ They also serve as proof of concept, for the variety of things that can be built
   - [md-it-mermaid](https://github.com/iamcco/md-it-mermaid)
   - [markdown-it-mermaid-fence-new](https://github.com/Revomatico/markdown-it-mermaid-fence-new)
   - [markdown-it-mermaid-less](https://github.com/searKing/markdown-it-mermaid-less)
-- [Atom](https://atom.io)
-  - [Markdown Preview Enhanced](https://atom.io/packages/markdown-preview-enhanced)
-  - [Atom Mermaid](https://atom.io/packages/atom-mermaid)
-  - [Language Mermaid Syntax Highlighter](https://atom.io/packages/language-mermaid)
+- Atom _(Atom has been [archived.](https://github.blog/2022-06-08-sunsetting-atom/))_
+  - Markdown Preview Enhanced
+  - [Atom Mermaid](https://github.com/y-takey/atom-mermaid)
+  - Language Mermaid Syntax Highlighter
 - [Sublime Text 3](https://sublimetext.com)
   - [Mermaid Package](https://packagecontrol.io/packages/Mermaid)
 - [Astah](https://astah.net)
diff --git a/packages/mermaid/src/docs/misc/integrations.md b/packages/mermaid/src/docs/misc/integrations.md
index 06d09634f..78fc33df9 100644
--- a/packages/mermaid/src/docs/misc/integrations.md
+++ b/packages/mermaid/src/docs/misc/integrations.md
@@ -103,10 +103,10 @@ They also serve as proof of concept, for the variety of things that can be built
   - [md-it-mermaid](https://github.com/iamcco/md-it-mermaid)
   - [markdown-it-mermaid-fence-new](https://github.com/Revomatico/markdown-it-mermaid-fence-new)
   - [markdown-it-mermaid-less](https://github.com/searKing/markdown-it-mermaid-less)
-- [Atom](https://atom.io)
-  - [Markdown Preview Enhanced](https://atom.io/packages/markdown-preview-enhanced)
-  - [Atom Mermaid](https://atom.io/packages/atom-mermaid)
-  - [Language Mermaid Syntax Highlighter](https://atom.io/packages/language-mermaid)
+- Atom _(Atom has been [archived.](https://github.blog/2022-06-08-sunsetting-atom/))_
+  - Markdown Preview Enhanced
+  - [Atom Mermaid](https://github.com/y-takey/atom-mermaid)
+  - Language Mermaid Syntax Highlighter
 - [Sublime Text 3](https://sublimetext.com)
   - [Mermaid Package](https://packagecontrol.io/packages/Mermaid)
 - [Astah](https://astah.net)

From 76e9e0737011d19977e0fbaed2d3f7b9a5b196d0 Mon Sep 17 00:00:00 2001
From: Ashley Engelund <weedySeaDragon@users.noreply.github.com>
Date: Sat, 10 Dec 2022 13:46:24 -0800
Subject: [PATCH 079/129] Add links to github atom add-ons

Co-authored-by: Alois Klink <alois@aloisklink.com>
---
 packages/mermaid/src/docs/misc/integrations.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/mermaid/src/docs/misc/integrations.md b/packages/mermaid/src/docs/misc/integrations.md
index 78fc33df9..55d0e5b20 100644
--- a/packages/mermaid/src/docs/misc/integrations.md
+++ b/packages/mermaid/src/docs/misc/integrations.md
@@ -104,9 +104,9 @@ They also serve as proof of concept, for the variety of things that can be built
   - [markdown-it-mermaid-fence-new](https://github.com/Revomatico/markdown-it-mermaid-fence-new)
   - [markdown-it-mermaid-less](https://github.com/searKing/markdown-it-mermaid-less)
 - Atom _(Atom has been [archived.](https://github.blog/2022-06-08-sunsetting-atom/))_
-  - Markdown Preview Enhanced
+  - [Markdown Preview Enhanced](https://github.com/shd101wyy/markdown-preview-enhanced)
   - [Atom Mermaid](https://github.com/y-takey/atom-mermaid)
-  - Language Mermaid Syntax Highlighter
+  - [Language Mermaid Syntax Highlighter](https://github.com/ytisf/language-mermaid)
 - [Sublime Text 3](https://sublimetext.com)
   - [Mermaid Package](https://packagecontrol.io/packages/Mermaid)
 - [Astah](https://astah.net)

From e4c9aa198e0fdf6973acadc6fcba6cbca98f40da Mon Sep 17 00:00:00 2001
From: Ashley Engelund <weedySeaDragon@users.noreply.github.com>
Date: Sat, 10 Dec 2022 13:47:01 -0800
Subject: [PATCH 080/129] Update docs/misc/integrations.md

Co-authored-by: Alois Klink <alois@aloisklink.com>
---
 docs/misc/integrations.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/misc/integrations.md b/docs/misc/integrations.md
index 23a95c0a1..5f4d87792 100644
--- a/docs/misc/integrations.md
+++ b/docs/misc/integrations.md
@@ -110,9 +110,9 @@ They also serve as proof of concept, for the variety of things that can be built
   - [markdown-it-mermaid-fence-new](https://github.com/Revomatico/markdown-it-mermaid-fence-new)
   - [markdown-it-mermaid-less](https://github.com/searKing/markdown-it-mermaid-less)
 - Atom _(Atom has been [archived.](https://github.blog/2022-06-08-sunsetting-atom/))_
-  - Markdown Preview Enhanced
+  - [Markdown Preview Enhanced](https://github.com/shd101wyy/markdown-preview-enhanced)
   - [Atom Mermaid](https://github.com/y-takey/atom-mermaid)
-  - Language Mermaid Syntax Highlighter
+  - [Language Mermaid Syntax Highlighter](https://github.com/ytisf/language-mermaid)
 - [Sublime Text 3](https://sublimetext.com)
   - [Mermaid Package](https://packagecontrol.io/packages/Mermaid)
 - [Astah](https://astah.net)

From 72a3cff13e3cf630ebf009a661d2abdada3febc1 Mon Sep 17 00:00:00 2001
From: steph <steph@huynhicode.dev>
Date: Sun, 11 Dec 2022 14:04:41 -0800
Subject: [PATCH 081/129] fix dev server watch mode

---
 .vite/build.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.vite/build.ts b/.vite/build.ts
index 50b7fb1ad..9d2295322 100644
--- a/.vite/build.ts
+++ b/.vite/build.ts
@@ -127,7 +127,7 @@ const main = async () => {
 };
 
 if (watch) {
-  build(getBuildConfig({ minify: false, watch, core: true, entryName: 'mermaid' }));
+  build(getBuildConfig({ minify: false, watch, core: false, entryName: 'mermaid' }));
   if (!mermaidOnly) {
     build(getBuildConfig({ minify: false, watch, entryName: 'mermaid-mindmap' }));
     // build(getBuildConfig({ minify: false, watch, entryName: 'mermaid-example-diagram' }));

From 1b0ea981f9415ae1daa987243bfc90c79c9a2ec0 Mon Sep 17 00:00:00 2001
From: steph <steph@huynhicode.dev>
Date: Sun, 11 Dec 2022 18:59:01 -0800
Subject: [PATCH 082/129] update navbar

---
 .../mermaid/src/docs/.vitepress/config.ts     | 20 ++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/packages/mermaid/src/docs/.vitepress/config.ts b/packages/mermaid/src/docs/.vitepress/config.ts
index 7d3ec40dd..b7c033b11 100644
--- a/packages/mermaid/src/docs/.vitepress/config.ts
+++ b/packages/mermaid/src/docs/.vitepress/config.ts
@@ -32,19 +32,13 @@ export default defineConfig({
 
 function nav() {
   return [
-    { text: 'Intro', link: '/intro/', activeMatch: '/intro/' },
+    { text: 'Docs', link: '/intro/', activeMatch: '/intro/' },
     {
-      text: 'Configuration',
+      text: 'Tutorials',
       link: '/config/Tutorials',
       activeMatch: '/config/',
     },
-    { text: 'Syntax', link: '/syntax/classDiagram', activeMatch: '/syntax/' },
-    { text: 'Misc', link: '/misc/integrations', activeMatch: '/misc/' },
-    {
-      text: 'Community',
-      link: '/community/n00b-overview',
-      activeMatch: '/community/',
-    },
+    { text: 'Integrations', link: '/misc/integrations', activeMatch: '/misc/' },
     {
       text: version,
       items: [
@@ -62,6 +56,14 @@ function nav() {
       text: '💻 Live Editor',
       link: 'https://mermaid.live',
     },
+    {
+      text: 'Slack',
+      link: 'https://mermaid-talk.slack.com',
+    },
+    {
+      text: 'GitHub',
+      link: 'https://github.com/mermaid-js/mermaid',
+    },
   ];
 }
 

From 07d8684fc76c6ffdbe77e8652d3de026bfa7b24c Mon Sep 17 00:00:00 2001
From: Maho Pacheco <mapach@microsoft.com>
Date: Sun, 11 Dec 2022 19:34:25 -0800
Subject: [PATCH 083/129] Adding size to postal code

---
 demos/er.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/demos/er.html b/demos/er.html
index 06fbf020e..124311a03 100644
--- a/demos/er.html
+++ b/demos/er.html
@@ -40,7 +40,7 @@ erDiagram
       string city
       string region
       string state
-      string postal_code
+      string(5) postal_code
       string country
       }
 

From 6fb9b3b35367719e75ca61ade50991ab2fd9eb6a Mon Sep 17 00:00:00 2001
From: Maho Pacheco <mapach@microsoft.com>
Date: Sun, 11 Dec 2022 19:45:05 -0800
Subject: [PATCH 084/129] Adding UTs for attributes with variable length in er
 diagram

---
 .../src/diagrams/er/parser/erDiagram.spec.js        | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js b/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
index eb738fe4b..06e2d7993 100644
--- a/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
+++ b/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
@@ -214,6 +214,19 @@ describe('when parsing ER diagram it...', function () {
     expect(entities[entity].attributes.length).toBe(2);
   });
 
+  it('should allow an entity with attribute that is a limited length string', function () {
+    const entity = 'BOOK';
+    const attribute1 = 'character(10) isbn FK';
+    const attribute2 = 'varchar(5) postal_code "Five digits"';
+
+    erDiagram.parser.parse(`erDiagram\n${entity} {\n${attribute1}\n${attribute2}\n}`);
+    const entities = erDb.getEntities();
+    expect(Object.keys(entities).length).toBe(1);
+    expect(entities[entity].attributes.length).toBe(2);
+    expect(entities[entity].attributes[0].attributeType).toBe('character(10)');
+    expect(entities[entity].attributes[1].attributeType).toBe('varchar(5)');
+  });
+
   it('should allow an entity with multiple attributes to be defined', function () {
     const entity = 'BOOK';
     const attribute1 = 'string title';

From a975c8c9cdd92b49445aeb950cb7b6f13ea0dc61 Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 12 Dec 2022 01:45:57 +0000
Subject: [PATCH 085/129] chore(deps): update all non-major dependencies

---
 package.json   |   4 +-
 pnpm-lock.yaml | 244 ++++++++++++++++++++++++++++++++++++++++++++++---
 2 files changed, 233 insertions(+), 15 deletions(-)

diff --git a/package.json b/package.json
index 1faa1628d..11dcaa236 100644
--- a/package.json
+++ b/package.json
@@ -4,7 +4,7 @@
   "version": "9.2.2",
   "description": "Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "type": "module",
-  "packageManager": "pnpm@7.17.1",
+  "packageManager": "pnpm@7.18.1",
   "keywords": [
     "diagram",
     "markdown",
@@ -75,7 +75,7 @@
     "coveralls": "^3.1.1",
     "cypress": "^10.11.0",
     "cypress-image-snapshot": "^4.0.1",
-    "esbuild": "^0.15.13",
+    "esbuild": "^0.16.0",
     "eslint": "^8.27.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-cypress": "^2.12.1",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 55d775801..ad57e3bef 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -68,8 +68,8 @@ importers:
         specifier: ^4.0.1
         version: 4.0.1_bg25yee4qeg7mpleuvd346a3tq
       esbuild:
-        specifier: ^0.15.13
-        version: 0.15.13
+        specifier: ^0.16.0
+        version: 0.16.4
       eslint:
         specifier: ^8.27.0
         version: 8.27.0
@@ -1727,6 +1727,96 @@ packages:
     dev: true
     optional: true
 
+  /@esbuild/android-arm/0.16.4:
+    resolution: {integrity: sha512-rZzb7r22m20S1S7ufIc6DC6W659yxoOrl7sKP1nCYhuvUlnCFHVSbATG4keGUtV8rDz11sRRDbWkvQZpzPaHiw==}
+    engines: {node: '>=12'}
+    cpu: [arm]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/android-arm64/0.16.4:
+    resolution: {integrity: sha512-VPuTzXFm/m2fcGfN6CiwZTlLzxrKsWbPkG7ArRFpuxyaHUm/XFHQPD4xNwZT6uUmpIHhnSjcaCmcla8COzmZ5Q==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/android-x64/0.16.4:
+    resolution: {integrity: sha512-MW+B2O++BkcOfMWmuHXB15/l1i7wXhJFqbJhp82IBOais8RBEQv2vQz/jHrDEHaY2X0QY7Wfw86SBL2PbVOr0g==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/darwin-arm64/0.16.4:
+    resolution: {integrity: sha512-a28X1O//aOfxwJVZVs7ZfM8Tyih2Za4nKJrBwW5Wm4yKsnwBy9aiS/xwpxiiTRttw3EaTg4Srerhcm6z0bu9Wg==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/darwin-x64/0.16.4:
+    resolution: {integrity: sha512-e3doCr6Ecfwd7VzlaQqEPrnbvvPjE9uoTpxG5pyLzr2rI2NMjDHmvY1E5EO81O/e9TUOLLkXA5m6T8lfjK9yAA==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/freebsd-arm64/0.16.4:
+    resolution: {integrity: sha512-Oup3G/QxBgvvqnXWrBed7xxkFNwAwJVHZcklWyQt7YCAL5bfUkaa6FVWnR78rNQiM8MqqLiT6ZTZSdUFuVIg1w==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [freebsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/freebsd-x64/0.16.4:
+    resolution: {integrity: sha512-vAP+eYOxlN/Bpo/TZmzEQapNS8W1njECrqkTpNgvXskkkJC2AwOXwZWai/Kc2vEFZUXQttx6UJbj9grqjD/+9Q==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [freebsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-arm/0.16.4:
+    resolution: {integrity: sha512-A47ZmtpIPyERxkSvIv+zLd6kNIOtJH03XA0Hy7jaceRDdQaQVGSDt4mZqpWqJYgDk9rg96aglbF6kCRvPGDSUA==}
+    engines: {node: '>=12'}
+    cpu: [arm]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-arm64/0.16.4:
+    resolution: {integrity: sha512-2zXoBhv4r5pZiyjBKrOdFP4CXOChxXiYD50LRUU+65DkdS5niPFHbboKZd/c81l0ezpw7AQnHeoCy5hFrzzs4g==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-ia32/0.16.4:
+    resolution: {integrity: sha512-uxdSrpe9wFhz4yBwt2kl2TxS/NWEINYBUFIxQtaEVtglm1eECvsj1vEKI0KX2k2wCe17zDdQ3v+jVxfwVfvvjw==}
+    engines: {node: '>=12'}
+    cpu: [ia32]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
   /@esbuild/linux-loong64/0.15.13:
     resolution: {integrity: sha512-+BoyIm4I8uJmH/QDIH0fu7MG0AEx9OXEDXnqptXCwKOlOqZiS4iraH1Nr7/ObLMokW3sOCeBNyD68ATcV9b9Ag==}
     engines: {node: '>=12'}
@@ -1736,6 +1826,114 @@ packages:
     dev: true
     optional: true
 
+  /@esbuild/linux-loong64/0.16.4:
+    resolution: {integrity: sha512-peDrrUuxbZ9Jw+DwLCh/9xmZAk0p0K1iY5d2IcwmnN+B87xw7kujOkig6ZRcZqgrXgeRGurRHn0ENMAjjD5DEg==}
+    engines: {node: '>=12'}
+    cpu: [loong64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-mips64el/0.16.4:
+    resolution: {integrity: sha512-sD9EEUoGtVhFjjsauWjflZklTNr57KdQ6xfloO4yH1u7vNQlOfAlhEzbyBKfgbJlW7rwXYBdl5/NcZ+Mg2XhQA==}
+    engines: {node: '>=12'}
+    cpu: [mips64el]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-ppc64/0.16.4:
+    resolution: {integrity: sha512-X1HSqHUX9D+d0l6/nIh4ZZJ94eQky8d8z6yxAptpZE3FxCWYWvTDd9X9ST84MGZEJx04VYUD/AGgciddwO0b8g==}
+    engines: {node: '>=12'}
+    cpu: [ppc64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-riscv64/0.16.4:
+    resolution: {integrity: sha512-97ANpzyNp0GTXCt6SRdIx1ngwncpkV/z453ZuxbnBROCJ5p/55UjhbaG23UdHj88fGWLKPFtMoU4CBacz4j9FA==}
+    engines: {node: '>=12'}
+    cpu: [riscv64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-s390x/0.16.4:
+    resolution: {integrity: sha512-pUvPQLPmbEeJRPjP0DYTC1vjHyhrnCklQmCGYbipkep+oyfTn7GTBJXoPodR7ZS5upmEyc8lzAkn2o29wD786A==}
+    engines: {node: '>=12'}
+    cpu: [s390x]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-x64/0.16.4:
+    resolution: {integrity: sha512-N55Q0mJs3Sl8+utPRPBrL6NLYZKBCLLx0bme/+RbjvMforTGGzFvsRl4xLTZMUBFC1poDzBEPTEu5nxizQ9Nlw==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/netbsd-x64/0.16.4:
+    resolution: {integrity: sha512-LHSJLit8jCObEQNYkgsDYBh2JrJT53oJO2HVdkSYLa6+zuLJh0lAr06brXIkljrlI+N7NNW1IAXGn/6IZPi3YQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [netbsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/openbsd-x64/0.16.4:
+    resolution: {integrity: sha512-nLgdc6tWEhcCFg/WVFaUxHcPK3AP/bh+KEwKtl69Ay5IBqUwKDaq/6Xk0E+fh/FGjnLwqFSsarsbPHeKM8t8Sw==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [openbsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/sunos-x64/0.16.4:
+    resolution: {integrity: sha512-08SluG24GjPO3tXKk95/85n9kpyZtXCVwURR2i4myhrOfi3jspClV0xQQ0W0PYWHioJj+LejFMt41q+PG3mlAQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [sunos]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/win32-arm64/0.16.4:
+    resolution: {integrity: sha512-yYiRDQcqLYQSvNQcBKN7XogbrSvBE45FEQdH8fuXPl7cngzkCvpsG2H9Uey39IjQ6gqqc+Q4VXYHsQcKW0OMjQ==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/win32-ia32/0.16.4:
+    resolution: {integrity: sha512-5rabnGIqexekYkh9zXG5waotq8mrdlRoBqAktjx2W3kb0zsI83mdCwrcAeKYirnUaTGztR5TxXcXmQrEzny83w==}
+    engines: {node: '>=12'}
+    cpu: [ia32]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/win32-x64/0.16.4:
+    resolution: {integrity: sha512-sN/I8FMPtmtT2Yw+Dly8Ur5vQ5a/RmC8hW7jO9PtPSQUPkowxWpcUZnqOggU7VwyT3Xkj6vcXWd3V/qTXwultQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
   /@eslint/eslintrc/1.3.3:
     resolution: {integrity: sha512-uj3pT6Mg+3t39fvLrj8iuCIJ38zKO9FpGtJ4BBJebJhEwjoT+KLVNCcHT5QC9NGRIEi7fZ0ZR8YRb884auB4Lg==}
     engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
@@ -5505,6 +5703,36 @@ packages:
       esbuild-windows-arm64: 0.15.13
     dev: true
 
+  /esbuild/0.16.4:
+    resolution: {integrity: sha512-qQrPMQpPTWf8jHugLWHoGqZjApyx3OEm76dlTXobHwh/EBbavbRdjXdYi/GWr43GyN0sfpap14GPkb05NH3ROA==}
+    engines: {node: '>=12'}
+    hasBin: true
+    requiresBuild: true
+    optionalDependencies:
+      '@esbuild/android-arm': 0.16.4
+      '@esbuild/android-arm64': 0.16.4
+      '@esbuild/android-x64': 0.16.4
+      '@esbuild/darwin-arm64': 0.16.4
+      '@esbuild/darwin-x64': 0.16.4
+      '@esbuild/freebsd-arm64': 0.16.4
+      '@esbuild/freebsd-x64': 0.16.4
+      '@esbuild/linux-arm': 0.16.4
+      '@esbuild/linux-arm64': 0.16.4
+      '@esbuild/linux-ia32': 0.16.4
+      '@esbuild/linux-loong64': 0.16.4
+      '@esbuild/linux-mips64el': 0.16.4
+      '@esbuild/linux-ppc64': 0.16.4
+      '@esbuild/linux-riscv64': 0.16.4
+      '@esbuild/linux-s390x': 0.16.4
+      '@esbuild/linux-x64': 0.16.4
+      '@esbuild/netbsd-x64': 0.16.4
+      '@esbuild/openbsd-x64': 0.16.4
+      '@esbuild/sunos-x64': 0.16.4
+      '@esbuild/win32-arm64': 0.16.4
+      '@esbuild/win32-ia32': 0.16.4
+      '@esbuild/win32-x64': 0.16.4
+    dev: true
+
   /escalade/3.1.1:
     resolution: {integrity: sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw==}
     engines: {node: '>=6'}
@@ -6161,16 +6389,6 @@ packages:
     resolution: {integrity: sha512-XGozTsMPYkm+6b5QL3Z9wQcJjNYxp0CYn3U1gO7dwD6PAqU1SVWZxI9CCg3z+ml3YfqdPnrBehaBrnH2AGKbNA==}
     dev: true
 
-  /follow-redirects/1.15.2:
-    resolution: {integrity: sha512-VQLG33o04KaQ8uYi2tVNbdrWp1QWxNNea+nmIB4EVM28v0hmP17z7aG1+wAkNzVq4KeXTq3221ye5qTJP91JwA==}
-    engines: {node: '>=4.0'}
-    peerDependencies:
-      debug: '*'
-    peerDependenciesMeta:
-      debug:
-        optional: true
-    dev: true
-
   /follow-redirects/1.15.2_debug@4.3.2:
     resolution: {integrity: sha512-VQLG33o04KaQ8uYi2tVNbdrWp1QWxNNea+nmIB4EVM28v0hmP17z7aG1+wAkNzVq4KeXTq3221ye5qTJP91JwA==}
     engines: {node: '>=4.0'}
@@ -6715,7 +6933,7 @@ packages:
     engines: {node: '>=8.0.0'}
     dependencies:
       eventemitter3: 4.0.7
-      follow-redirects: 1.15.2
+      follow-redirects: 1.15.2_debug@4.3.2
       requires-port: 1.0.0
     transitivePeerDependencies:
       - debug

From 32fcea3bdd7433cc414e7e807a9b3bea1e6815f9 Mon Sep 17 00:00:00 2001
From: Jesper Hasselquist <jesper.hasselquist@pm.me>
Date: Mon, 12 Dec 2022 21:39:19 +0900
Subject: [PATCH 086/129] fix(docs): remove duplicate section

Remove duplicate `Return Type` section
---
 packages/mermaid/src/docs/syntax/classDiagram.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/packages/mermaid/src/docs/syntax/classDiagram.md b/packages/mermaid/src/docs/syntax/classDiagram.md
index a0f4e5611..8cd5796ff 100644
--- a/packages/mermaid/src/docs/syntax/classDiagram.md
+++ b/packages/mermaid/src/docs/syntax/classDiagram.md
@@ -141,10 +141,6 @@ Square : +setMessages(List~string~ messages)
 Square : +getMessages() List~string~
 ```
 
-#### Return Type
-
-Optionally you can end the method/function definition with the data type that will be returned.
-
 #### Visibility
 
 To describe the visibility (or encapsulation) of an attribute or method/function that is a part of a class (i.e. a class member), optional notation may be placed before that members' name:

From dfa1d2695225e1cd203908f26bd32bc49474a2bd Mon Sep 17 00:00:00 2001
From: Jesper Hasselquist <jesper.hasselquist@gmail.com>
Date: Mon, 12 Dec 2022 22:32:50 +0900
Subject: [PATCH 087/129] fix(docs): build the docs

---
 docs/syntax/classDiagram.md | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/docs/syntax/classDiagram.md b/docs/syntax/classDiagram.md
index b6d48c9de..c4fc07732 100644
--- a/docs/syntax/classDiagram.md
+++ b/docs/syntax/classDiagram.md
@@ -238,10 +238,6 @@ Square : +setMessages(List~string~ messages)
 Square : +getMessages() List~string~
 ```
 
-#### Return Type
-
-Optionally you can end the method/function definition with the data type that will be returned.
-
 #### Visibility
 
 To describe the visibility (or encapsulation) of an attribute or method/function that is a part of a class (i.e. a class member), optional notation may be placed before that members' name:

From d7610dda8fac9277413915a20849c59a969f9900 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 12 Dec 2022 23:51:46 +0530
Subject: [PATCH 088/129] fix: Throw correct errors when parsing diagrams with
 errors

---
 cSpell.json                          |  4 ++
 packages/mermaid/src/Diagram.ts      |  2 +-
 packages/mermaid/src/diagram.spec.ts | 67 ++++++++++++++++++++++++++++
 3 files changed, 72 insertions(+), 1 deletion(-)
 create mode 100644 packages/mermaid/src/diagram.spec.ts

diff --git a/cSpell.json b/cSpell.json
index 45e7fe99a..5711d29dc 100644
--- a/cSpell.json
+++ b/cSpell.json
@@ -14,6 +14,7 @@
     "bilkent",
     "bisheng",
     "braintree",
+    "brkt",
     "brolin",
     "brotli",
     "classdef",
@@ -60,12 +61,14 @@
     "mindmaps",
     "mitigations",
     "mkdocs",
+    "mult",
     "orlandoni",
     "phpbb",
     "plantuml",
     "playfair",
     "pnpm",
     "podlite",
+    "quence",
     "ranksep",
     "rect",
     "rects",
@@ -81,6 +84,7 @@
     "substate",
     "sveidqvist",
     "techn",
+    "teststr",
     "treemap",
     "ts-nocheck",
     "tuleap",
diff --git a/packages/mermaid/src/Diagram.ts b/packages/mermaid/src/Diagram.ts
index a2349c255..83412e4aa 100644
--- a/packages/mermaid/src/Diagram.ts
+++ b/packages/mermaid/src/Diagram.ts
@@ -102,7 +102,6 @@ export const getDiagramFromText = (
   try {
     // Trying to find the diagram
     getDiagram(type);
-    return new Diagram(txt, parseError);
   } catch (error) {
     const loader = getDiagramLoader(type);
     if (!loader) {
@@ -118,6 +117,7 @@ export const getDiagramFromText = (
       return new Diagram(txt, parseError);
     });
   }
+  return new Diagram(txt, parseError);
 };
 
 export default Diagram;
diff --git a/packages/mermaid/src/diagram.spec.ts b/packages/mermaid/src/diagram.spec.ts
new file mode 100644
index 000000000..ebe088a86
--- /dev/null
+++ b/packages/mermaid/src/diagram.spec.ts
@@ -0,0 +1,67 @@
+import { describe, test, expect } from 'vitest';
+import Diagram, { getDiagramFromText } from './Diagram';
+import { addDetector } from './diagram-api/detectType';
+import { addDiagrams } from './diagram-api/diagram-orchestration';
+
+addDiagrams();
+
+describe('diagram detection', () => {
+  test('should detect inbuilt diagrams', () => {
+    const graph = getDiagramFromText('graph TD; A-->B') as Diagram;
+    expect(graph).toBeInstanceOf(Diagram);
+    expect(graph.type).toBe('flowchart-v2');
+    const sequence = getDiagramFromText(
+      'sequenceDiagram; Alice->>+John: Hello John, how are you?'
+    ) as Diagram;
+    expect(sequence).toBeInstanceOf(Diagram);
+    expect(sequence.type).toBe('sequence');
+  });
+
+  test('should detect external diagrams', async () => {
+    addDetector(
+      'loki',
+      (str) => str.startsWith('loki'),
+      () =>
+        Promise.resolve({
+          id: 'loki',
+          diagram: {
+            db: {},
+            parser: {
+              parse: () => {
+                // no-op
+              },
+              parser: {
+                yy: {},
+              },
+            },
+            renderer: {},
+            styles: {},
+          },
+        })
+    );
+    const diagram = (await getDiagramFromText('loki TD; A-->B')) as Diagram;
+    expect(diagram).toBeInstanceOf(Diagram);
+    expect(diagram.type).toBe('loki');
+  });
+
+  test('should throw the right error for incorrect diagram', () => {
+    expect(() => getDiagramFromText('graph TD; A-->')).toThrowErrorMatchingInlineSnapshot(`
+"Parse error on line 3:
+graph TD; A-->
+--------------^
+Expecting 'AMP', 'ALPHA', 'COLON', 'PIPE', 'TESTSTR', 'DOWN', 'DEFAULT', 'NUM', 'COMMA', 'MINUS', 'BRKT', 'DOT', 'PUNCTUATION', 'UNICODE_TEXT', 'PLUS', 'EQUALS', 'MULT', 'UNDERSCORE', got 'EOF'"
+		`);
+    expect(() => getDiagramFromText('sequenceDiagram; A-->B')).toThrowErrorMatchingInlineSnapshot(`
+"Parse error on line 1:
+...quenceDiagram; A-->B
+-----------------------^
+Expecting 'TXT', got 'NEWLINE'"
+		`);
+  });
+
+  test('should throw the right error for unregistered diagrams', () => {
+    expect(() => getDiagramFromText('thor TD; A-->B')).toThrowError(
+      'No diagram type detected for text: thor TD; A-->B'
+    );
+  });
+});

From fac3a4d29bc7335f6a9df59f2c72bb3ea094d7a6 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 12 Dec 2022 23:52:48 +0530
Subject: [PATCH 089/129] Bump mermaid version

---
 packages/mermaid/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 81d1d9be9..306ab318e 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mermaid",
-  "version": "9.3.0-rc.1",
+  "version": "9.3.0-rc.2",
   "description": "Markdown-ish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",

From 89451ca6406f27f9eb50f558bc07d98005f8e5a8 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Tue, 13 Dec 2022 00:22:57 +0530
Subject: [PATCH 090/129] fix: add .js to external imports.

---
 cSpell.json                           |  1 +
 packages/mermaid/src/accessibility.ts |  2 +-
 packages/mermaid/src/mermaidAPI.ts    | 14 +++++++-------
 packages/mermaid/src/utils.ts         |  2 +-
 4 files changed, 10 insertions(+), 9 deletions(-)

diff --git a/cSpell.json b/cSpell.json
index 5711d29dc..4e9e4945a 100644
--- a/cSpell.json
+++ b/cSpell.json
@@ -85,6 +85,7 @@
     "sveidqvist",
     "techn",
     "teststr",
+    "textlength",
     "treemap",
     "ts-nocheck",
     "tuleap",
diff --git a/packages/mermaid/src/accessibility.ts b/packages/mermaid/src/accessibility.ts
index b9e088e0b..ed28ff689 100644
--- a/packages/mermaid/src/accessibility.ts
+++ b/packages/mermaid/src/accessibility.ts
@@ -4,7 +4,7 @@
  */
 import { D3Element } from './mermaidAPI';
 
-import isEmpty from 'lodash-es/isEmpty';
+import isEmpty from 'lodash-es/isEmpty.js';
 
 /**
  * Add aria-roledescription to the svg element to the diagramType
diff --git a/packages/mermaid/src/mermaidAPI.ts b/packages/mermaid/src/mermaidAPI.ts
index 193f5a9cc..a63071364 100644
--- a/packages/mermaid/src/mermaidAPI.ts
+++ b/packages/mermaid/src/mermaidAPI.ts
@@ -29,7 +29,7 @@ import utils, { directiveSanitizer } from './utils';
 import DOMPurify from 'dompurify';
 import { MermaidConfig } from './config.type';
 import { evaluate } from './diagrams/common/common';
-import isEmpty from 'lodash-es/isEmpty';
+import isEmpty from 'lodash-es/isEmpty.js';
 import { setA11yDiagramInfo, addSVGa11yTitleDescription } from './accessibility';
 
 // diagram names that support classDef statements
@@ -55,8 +55,8 @@ const IFRAME_SANDBOX_OPTS = 'allow-top-navigation-by-user-activation allow-popup
 const IFRAME_NOT_SUPPORTED_MSG = 'The "iframe" tag is not supported by your browser.';
 
 // DOMPurify settings for svgCode
-const DOMPURE_TAGS = ['foreignobject'];
-const DOMPURE_ATTR = ['dominant-baseline'];
+const DOMPURIFY_TAGS = ['foreignobject'];
+const DOMPURIFY_ATTR = ['dominant-baseline'];
 
 // This is what is returned from getClasses(...) methods.
 // It is slightly renamed to ..StyleClassDef instead of just ClassDef because "class" is a greatly ambiguous and overloaded word.
@@ -539,8 +539,8 @@ const render = function (
   } else if (!isLooseSecurityLevel) {
     // Sanitize the svgCode using DOMPurify
     svgCode = DOMPurify.sanitize(svgCode, {
-      ADD_TAGS: DOMPURE_TAGS,
-      ADD_ATTR: DOMPURE_ATTR,
+      ADD_TAGS: DOMPURIFY_TAGS,
+      ADD_ATTR: DOMPURIFY_ATTR,
     });
   }
 
@@ -741,8 +741,8 @@ const renderAsync = async function (
   } else if (!isLooseSecurityLevel) {
     // Sanitize the svgCode using DOMPurify
     svgCode = DOMPurify.sanitize(svgCode, {
-      ADD_TAGS: DOMPURE_TAGS,
-      ADD_ATTR: DOMPURE_ATTR,
+      ADD_TAGS: DOMPURIFY_TAGS,
+      ADD_ATTR: DOMPURIFY_ATTR,
     });
   }
 
diff --git a/packages/mermaid/src/utils.ts b/packages/mermaid/src/utils.ts
index 767fdaa7d..628bf37d3 100644
--- a/packages/mermaid/src/utils.ts
+++ b/packages/mermaid/src/utils.ts
@@ -21,7 +21,7 @@ import { log } from './logger';
 import { detectType } from './diagram-api/detectType';
 import assignWithDepth from './assignWithDepth';
 import { MermaidConfig } from './config.type';
-import memoize from 'lodash-es/memoize';
+import memoize from 'lodash-es/memoize.js';
 
 // Effectively an enum of the supported curve types, accessible by name
 const d3CurveTypes = {

From 1d529d80d12a239a621afbcb8ed060c9e9a3edfd Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Tue, 13 Dec 2022 00:23:41 +0530
Subject: [PATCH 091/129] Bump mermaid version

---
 packages/mermaid/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 306ab318e..19e2325c1 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mermaid",
-  "version": "9.3.0-rc.2",
+  "version": "9.3.0-rc.3",
   "description": "Markdown-ish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",

From 3c44379af9b3149bdcedb2757c6aa4d02989b0aa Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Tue, 13 Dec 2022 00:34:31 +0530
Subject: [PATCH 092/129] fix: add .js to external imports.

---
 packages/mermaid/package.json                                   | 2 +-
 packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js          | 2 +-
 packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js     | 2 +-
 packages/mermaid/src/diagrams/class/classRenderer-v2.js         | 2 +-
 packages/mermaid/src/diagrams/er/erRenderer.js                  | 2 +-
 packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js      | 2 +-
 packages/mermaid/src/diagrams/flowchart/flowRenderer.js         | 2 +-
 .../src/diagrams/flowchart/parser/flow-direction.spec.js        | 1 -
 packages/mermaid/src/diagrams/flowchart/parser/subgraph.spec.js | 1 -
 packages/mermaid/src/diagrams/state/stateRenderer-v2.js         | 2 +-
 packages/mermaid/src/utils.spec.js                              | 2 +-
 11 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 19e2325c1..e4ce9e93a 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mermaid",
-  "version": "9.3.0-rc.3",
+  "version": "9.3.0-rc.4",
   "description": "Markdown-ish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",
diff --git a/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js b/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js
index 5722f7cc0..cb80e658f 100644
--- a/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js
+++ b/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js
@@ -1,7 +1,7 @@
 /** Decorates with functions required by mermaids dagre-wrapper. */
 import { log } from '../logger';
 import * as graphlibJson from 'dagre-d3-es/src/graphlib/json';
-import * as graphlib from 'dagre-d3-es/src/graphlib';
+import * as graphlib from 'dagre-d3-es/src/graphlib.js';
 
 export let clusterDb = {};
 let descendants = {};
diff --git a/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js b/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js
index f594e3430..ffc3e7803 100644
--- a/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js
+++ b/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js
@@ -1,5 +1,5 @@
 import * as graphlibJson from 'dagre-d3-es/src/graphlib/json';
-import * as graphlib from 'dagre-d3-es/src/graphlib';
+import * as graphlib from 'dagre-d3-es/src/graphlib.js';
 import {
   validate,
   adjustClustersAndEdges,
diff --git a/packages/mermaid/src/diagrams/class/classRenderer-v2.js b/packages/mermaid/src/diagrams/class/classRenderer-v2.js
index 3fecfcb9f..72bc3f0b1 100644
--- a/packages/mermaid/src/diagrams/class/classRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/class/classRenderer-v2.js
@@ -1,5 +1,5 @@
 import { select } from 'd3';
-import * as graphlib from 'dagre-d3-es/src/graphlib';
+import * as graphlib from 'dagre-d3-es/src/graphlib.js';
 import { log } from '../../logger';
 import { getConfig } from '../../config';
 import { render } from '../../dagre-wrapper/index.js';
diff --git a/packages/mermaid/src/diagrams/er/erRenderer.js b/packages/mermaid/src/diagrams/er/erRenderer.js
index ebf338ae1..59097760f 100644
--- a/packages/mermaid/src/diagrams/er/erRenderer.js
+++ b/packages/mermaid/src/diagrams/er/erRenderer.js
@@ -1,4 +1,4 @@
-import * as graphlib from 'dagre-d3-es/src/graphlib';
+import * as graphlib from 'dagre-d3-es/src/graphlib.js';
 import { line, curveBasis, select } from 'd3';
 import { layout as dagreLayout } from 'dagre-d3-es/src/dagre/index.js';
 import { getConfig } from '../../config';
diff --git a/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js b/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
index 3e46aaaa5..b09a3227d 100644
--- a/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
@@ -1,4 +1,4 @@
-import * as graphlib from 'dagre-d3-es/src/graphlib';
+import * as graphlib from 'dagre-d3-es/src/graphlib.js';
 import { select, curveLinear, selectAll } from 'd3';
 
 import flowDb from './flowDb';
diff --git a/packages/mermaid/src/diagrams/flowchart/flowRenderer.js b/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
index 6cbc65532..32ab31159 100644
--- a/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
+++ b/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
@@ -1,4 +1,4 @@
-import * as graphlib from 'dagre-d3-es/src/graphlib';
+import * as graphlib from 'dagre-d3-es/src/graphlib.js';
 import { select, curveLinear, selectAll } from 'd3';
 import { getConfig } from '../../config';
 import { render as Render } from 'dagre-d3-es';
diff --git a/packages/mermaid/src/diagrams/flowchart/parser/flow-direction.spec.js b/packages/mermaid/src/diagrams/flowchart/parser/flow-direction.spec.js
index 5c2094737..7726ce0f7 100644
--- a/packages/mermaid/src/diagrams/flowchart/parser/flow-direction.spec.js
+++ b/packages/mermaid/src/diagrams/flowchart/parser/flow-direction.spec.js
@@ -1,6 +1,5 @@
 import flowDb from '../flowDb';
 import flow from './flow';
-import filter from 'lodash-es/filter';
 import { setConfig } from '../../../config';
 
 setConfig({
diff --git a/packages/mermaid/src/diagrams/flowchart/parser/subgraph.spec.js b/packages/mermaid/src/diagrams/flowchart/parser/subgraph.spec.js
index 5ba6a5361..ae6f178b8 100644
--- a/packages/mermaid/src/diagrams/flowchart/parser/subgraph.spec.js
+++ b/packages/mermaid/src/diagrams/flowchart/parser/subgraph.spec.js
@@ -1,6 +1,5 @@
 import flowDb from '../flowDb';
 import flow from './flow';
-import filter from 'lodash-es/filter';
 import { setConfig } from '../../../config';
 
 setConfig({
diff --git a/packages/mermaid/src/diagrams/state/stateRenderer-v2.js b/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
index fa2470d6b..625dddef4 100644
--- a/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
@@ -1,4 +1,4 @@
-import * as graphlib from 'dagre-d3-es/src/graphlib';
+import * as graphlib from 'dagre-d3-es/src/graphlib.js';
 import { select } from 'd3';
 import { getConfig } from '../../config';
 import { render } from '../../dagre-wrapper/index.js';
diff --git a/packages/mermaid/src/utils.spec.js b/packages/mermaid/src/utils.spec.js
index e983d21c8..e9a9fc7dc 100644
--- a/packages/mermaid/src/utils.spec.js
+++ b/packages/mermaid/src/utils.spec.js
@@ -3,7 +3,7 @@ import utils from './utils';
 import assignWithDepth from './assignWithDepth';
 import { detectType } from './diagram-api/detectType';
 import { addDiagrams } from './diagram-api/diagram-orchestration';
-import memoize from 'lodash-es/memoize';
+import memoize from 'lodash-es/memoize.js';
 import { MockedD3 } from './tests/MockedD3';
 
 addDiagrams();

From 3f0b13a1311459d52d42d31f03adb9f6a6d54097 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Tue, 13 Dec 2022 00:38:54 +0530
Subject: [PATCH 093/129] fix: add .js to external imports.

---
 packages/mermaid/src/dagre-wrapper/index.js                 | 2 +-
 packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js      | 4 ++--
 packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js | 4 ++--
 packages/mermaid/src/diagrams/class/classRenderer-v2.js     | 2 +-
 packages/mermaid/src/diagrams/er/erRenderer.js              | 2 +-
 packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js  | 2 +-
 packages/mermaid/src/diagrams/flowchart/flowRenderer.js     | 2 +-
 packages/mermaid/src/diagrams/state/stateRenderer-v2.js     | 2 +-
 8 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/packages/mermaid/src/dagre-wrapper/index.js b/packages/mermaid/src/dagre-wrapper/index.js
index e2d7d51f4..ce3ef6014 100644
--- a/packages/mermaid/src/dagre-wrapper/index.js
+++ b/packages/mermaid/src/dagre-wrapper/index.js
@@ -1,5 +1,5 @@
 import { layout as dagreLayout } from 'dagre-d3-es/src/dagre/index.js';
-import * as graphlibJson from 'dagre-d3-es/src/graphlib/json';
+import * as graphlibJson from 'dagre-d3-es/src/graphlib/json.js';
 import insertMarkers from './markers';
 import { updateNodeBounds } from './shapes/util';
 import {
diff --git a/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js b/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js
index cb80e658f..875ac4def 100644
--- a/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js
+++ b/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.js
@@ -1,7 +1,7 @@
 /** Decorates with functions required by mermaids dagre-wrapper. */
 import { log } from '../logger';
-import * as graphlibJson from 'dagre-d3-es/src/graphlib/json';
-import * as graphlib from 'dagre-d3-es/src/graphlib.js';
+import * as graphlibJson from 'dagre-d3-es/src/graphlib/json.js';
+import * as graphlib from 'dagre-d3-es/src/graphlib/index.js';
 
 export let clusterDb = {};
 let descendants = {};
diff --git a/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js b/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js
index ffc3e7803..25fb75d64 100644
--- a/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js
+++ b/packages/mermaid/src/dagre-wrapper/mermaid-graphlib.spec.js
@@ -1,5 +1,5 @@
-import * as graphlibJson from 'dagre-d3-es/src/graphlib/json';
-import * as graphlib from 'dagre-d3-es/src/graphlib.js';
+import * as graphlibJson from 'dagre-d3-es/src/graphlib/json.js';
+import * as graphlib from 'dagre-d3-es/src/graphlib/index.js';
 import {
   validate,
   adjustClustersAndEdges,
diff --git a/packages/mermaid/src/diagrams/class/classRenderer-v2.js b/packages/mermaid/src/diagrams/class/classRenderer-v2.js
index 72bc3f0b1..d95c29fd5 100644
--- a/packages/mermaid/src/diagrams/class/classRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/class/classRenderer-v2.js
@@ -1,5 +1,5 @@
 import { select } from 'd3';
-import * as graphlib from 'dagre-d3-es/src/graphlib.js';
+import * as graphlib from 'dagre-d3-es/src/graphlib/index.js';
 import { log } from '../../logger';
 import { getConfig } from '../../config';
 import { render } from '../../dagre-wrapper/index.js';
diff --git a/packages/mermaid/src/diagrams/er/erRenderer.js b/packages/mermaid/src/diagrams/er/erRenderer.js
index 59097760f..e8b80b646 100644
--- a/packages/mermaid/src/diagrams/er/erRenderer.js
+++ b/packages/mermaid/src/diagrams/er/erRenderer.js
@@ -1,4 +1,4 @@
-import * as graphlib from 'dagre-d3-es/src/graphlib.js';
+import * as graphlib from 'dagre-d3-es/src/graphlib/index.js';
 import { line, curveBasis, select } from 'd3';
 import { layout as dagreLayout } from 'dagre-d3-es/src/dagre/index.js';
 import { getConfig } from '../../config';
diff --git a/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js b/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
index b09a3227d..29c7ba07a 100644
--- a/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/flowchart/flowRenderer-v2.js
@@ -1,4 +1,4 @@
-import * as graphlib from 'dagre-d3-es/src/graphlib.js';
+import * as graphlib from 'dagre-d3-es/src/graphlib/index.js';
 import { select, curveLinear, selectAll } from 'd3';
 
 import flowDb from './flowDb';
diff --git a/packages/mermaid/src/diagrams/flowchart/flowRenderer.js b/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
index 32ab31159..63234b57c 100644
--- a/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
+++ b/packages/mermaid/src/diagrams/flowchart/flowRenderer.js
@@ -1,4 +1,4 @@
-import * as graphlib from 'dagre-d3-es/src/graphlib.js';
+import * as graphlib from 'dagre-d3-es/src/graphlib/index.js';
 import { select, curveLinear, selectAll } from 'd3';
 import { getConfig } from '../../config';
 import { render as Render } from 'dagre-d3-es';
diff --git a/packages/mermaid/src/diagrams/state/stateRenderer-v2.js b/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
index 625dddef4..ebe18535d 100644
--- a/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
+++ b/packages/mermaid/src/diagrams/state/stateRenderer-v2.js
@@ -1,4 +1,4 @@
-import * as graphlib from 'dagre-d3-es/src/graphlib.js';
+import * as graphlib from 'dagre-d3-es/src/graphlib/index.js';
 import { select } from 'd3';
 import { getConfig } from '../../config';
 import { render } from '../../dagre-wrapper/index.js';

From 9f9c95b0b3b6ac651df4f78721b9daf34c489a7a Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Tue, 13 Dec 2022 13:42:07 +0530
Subject: [PATCH 094/129] fix: Incorrect removal of existing elements

---
 docs/config/setup/modules/mermaidAPI.md | 19 +++----
 packages/mermaid/src/mermaidAPI.spec.ts | 73 ++++++++++---------------
 packages/mermaid/src/mermaidAPI.ts      | 23 +++-----
 3 files changed, 47 insertions(+), 68 deletions(-)

diff --git a/docs/config/setup/modules/mermaidAPI.md b/docs/config/setup/modules/mermaidAPI.md
index 1b840dcd3..40e4b567f 100644
--- a/docs/config/setup/modules/mermaidAPI.md
+++ b/docs/config/setup/modules/mermaidAPI.md
@@ -90,7 +90,7 @@ mermaid.initialize(config);
 
 #### Defined in
 
-[mermaidAPI.ts:968](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L968)
+[mermaidAPI.ts:961](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L961)
 
 ## Functions
 
@@ -295,19 +295,18 @@ Put the svgCode into an iFrame. Return the iFrame code
 
 ### removeExistingElements
 
-▸ **removeExistingElements**(`doc`, `isSandboxed`, `id`, `divSelector`, `iFrameSelector`): `void`
+▸ **removeExistingElements**(`doc`, `id`, `divId`, `iFrameId`): `void`
 
 Remove any existing elements from the given document
 
 #### Parameters
 
-| Name             | Type       | Description                                     |
-| :--------------- | :--------- | :---------------------------------------------- |
-| `doc`            | `Document` | the document to removed elements from           |
-| `isSandboxed`    | `boolean`  | whether or not we are in sandboxed mode         |
-| `id`             | `string`   | id for any existing SVG element                 |
-| `divSelector`    | `string`   | selector for any existing enclosing div element |
-| `iFrameSelector` | `string`   | selector for any existing iFrame element        |
+| Name       | Type       | Description                           |
+| :--------- | :--------- | :------------------------------------ |
+| `doc`      | `Document` | the document to removed elements from |
+| `id`       | `string`   | id for any existing SVG element       |
+| `divId`    | `string`   | -                                     |
+| `iFrameId` | `string`   | -                                     |
 
 #### Returns
 
@@ -315,4 +314,4 @@ Remove any existing elements from the given document
 
 #### Defined in
 
-[mermaidAPI.ts:336](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L336)
+[mermaidAPI.ts:335](https://github.com/mermaid-js/mermaid/blob/master/packages/mermaid/src/mermaidAPI.ts#L335)
diff --git a/packages/mermaid/src/mermaidAPI.spec.ts b/packages/mermaid/src/mermaidAPI.spec.ts
index f9bad66d7..d2fd49f34 100644
--- a/packages/mermaid/src/mermaidAPI.spec.ts
+++ b/packages/mermaid/src/mermaidAPI.spec.ts
@@ -470,61 +470,48 @@ describe('mermaidAPI', function () {
     svgElement.id = svgId;
     const tempDivElement = givenDocument.createElement('div'); // doesn't matter what the tag is in the test
     tempDivElement.id = tempDivId;
-    const tempiFrameElement = givenDocument.createElement('div'); // doesn't matter what the tag is in the test
+    const tempiFrameElement = givenDocument.createElement('iframe'); // doesn't matter what the tag is in the test
     tempiFrameElement.id = tempIframeId;
 
     it('removes an existing element with given id', () => {
       rootHtml.appendChild(svgElement);
+      rootHtml.append(tempDivElement);
+      rootHtml.append(tempiFrameElement);
+
       expect(givenDocument.getElementById(svgElement.id)).toEqual(svgElement);
-      removeExistingElements(givenDocument, false, svgId, tempDivId, tempIframeId);
+      expect(givenDocument.getElementById(tempDivElement.id)).toEqual(tempDivElement);
+      expect(givenDocument.getElementById(tempiFrameElement.id)).toEqual(tempiFrameElement);
+      removeExistingElements(givenDocument, svgId, tempDivId, tempIframeId);
       expect(givenDocument.getElementById(svgElement.id)).toBeNull();
+      expect(givenDocument.getElementById(tempDivElement.id)).toBeNull();
+      expect(givenDocument.getElementById(tempiFrameElement.id)).toBeNull();
     });
 
-    describe('is in sandboxed mode', () => {
-      const inSandboxedMode = true;
+    it('removes an existing iframe element even if div element is absent', () => {
+      tempiFrameElement.append(svgElement);
+      rootHtml.append(tempiFrameElement);
 
-      it('removes an existing element with the given iFrame selector', () => {
-        tempiFrameElement.append(svgElement);
-        rootHtml.append(tempiFrameElement);
-        rootHtml.append(tempDivElement);
-
-        expect(givenDocument.getElementById(tempIframeId)).toEqual(tempiFrameElement);
-        expect(givenDocument.getElementById(tempDivId)).toEqual(tempDivElement);
-        expect(givenDocument.getElementById(svgId)).toEqual(svgElement);
-        removeExistingElements(
-          givenDocument,
-          inSandboxedMode,
-          svgId,
-          '#' + tempDivId,
-          '#' + tempIframeId
-        );
-        expect(givenDocument.getElementById(tempDivId)).toEqual(tempDivElement);
-        expect(givenDocument.getElementById(tempIframeId)).toBeNull();
-        expect(givenDocument.getElementById(svgId)).toBeNull();
-      });
+      expect(givenDocument.getElementById(tempIframeId)).toEqual(tempiFrameElement);
+      expect(givenDocument.getElementById(tempDivId)).toBeNull();
+      expect(givenDocument.getElementById(svgId)).toEqual(svgElement);
+      removeExistingElements(givenDocument, svgId, tempDivId, tempIframeId);
+      expect(givenDocument.getElementById(tempDivId)).toBeNull();
+      expect(givenDocument.getElementById(tempIframeId)).toBeNull();
+      expect(givenDocument.getElementById(svgId)).toBeNull();
     });
-    describe('not in sandboxed mode', () => {
-      const inSandboxedMode = false;
 
-      it('removes an existing element with the given enclosing div selector', () => {
-        tempDivElement.append(svgElement);
-        rootHtml.append(tempDivElement);
-        rootHtml.append(tempiFrameElement);
+    it('removes both existing div and iframe elements when both are present', () => {
+      tempDivElement.append(svgElement);
+      rootHtml.append(tempDivElement);
+      rootHtml.append(tempiFrameElement);
 
-        expect(givenDocument.getElementById(tempIframeId)).toEqual(tempiFrameElement);
-        expect(givenDocument.getElementById(tempDivId)).toEqual(tempDivElement);
-        expect(givenDocument.getElementById(svgId)).toEqual(svgElement);
-        removeExistingElements(
-          givenDocument,
-          inSandboxedMode,
-          svgId,
-          '#' + tempDivId,
-          '#' + tempIframeId
-        );
-        expect(givenDocument.getElementById(tempIframeId)).toEqual(tempiFrameElement);
-        expect(givenDocument.getElementById(tempDivId)).toBeNull();
-        expect(givenDocument.getElementById(svgId)).toBeNull();
-      });
+      expect(givenDocument.getElementById(tempIframeId)).toEqual(tempiFrameElement);
+      expect(givenDocument.getElementById(tempDivId)).toEqual(tempDivElement);
+      expect(givenDocument.getElementById(svgId)).toEqual(svgElement);
+      removeExistingElements(givenDocument, svgId, tempDivId, tempIframeId);
+      expect(givenDocument.getElementById(tempIframeId)).toBeNull();
+      expect(givenDocument.getElementById(tempDivId)).toBeNull();
+      expect(givenDocument.getElementById(svgId)).toBeNull();
     });
   });
 
diff --git a/packages/mermaid/src/mermaidAPI.ts b/packages/mermaid/src/mermaidAPI.ts
index a63071364..5bf11fad1 100644
--- a/packages/mermaid/src/mermaidAPI.ts
+++ b/packages/mermaid/src/mermaidAPI.ts
@@ -328,29 +328,22 @@ function sandboxedIframe(parentNode: D3Element, iFrameId: string): D3Element {
  * Remove any existing elements from the given document
  *
  * @param doc - the document to removed elements from
- * @param isSandboxed - whether or not we are in sandboxed mode
  * @param id - id for any existing SVG element
  * @param divSelector - selector for any existing enclosing div element
  * @param iFrameSelector - selector for any existing iFrame element
  */
 export const removeExistingElements = (
   doc: Document,
-  isSandboxed: boolean,
   id: string,
-  divSelector: string,
-  iFrameSelector: string
+  divId: string,
+  iFrameId: string
 ) => {
   // Remove existing SVG element if it exists
-  const existingSvg = doc.getElementById(id);
-  if (existingSvg) {
-    existingSvg.remove();
-  }
-
+  doc.getElementById(id)?.remove();
   // Remove previous temporary element if it exists
-  const element = isSandboxed ? doc.querySelector(iFrameSelector) : doc.querySelector(divSelector);
-  if (element) {
-    element.remove();
-  }
+  // Both div and iframe needs to be cleared in case there is a config change happening between renders.
+  doc.getElementById(divId)?.remove();
+  doc.getElementById(iFrameId)?.remove();
 };
 
 /**
@@ -443,7 +436,7 @@ const render = function (
     // No svgContainingElement was provided
 
     // If there is an existing element with the id, we remove it. This likely a previously rendered diagram
-    removeExistingElements(document, isSandboxed, id, iFrameID_selector, enclosingDivID_selector);
+    removeExistingElements(document, id, enclosingDivID, iFrameID);
 
     // Add the temporary div used for rendering with the enclosingDivID.
     // This temporary div will contain a svg with the id == id
@@ -650,7 +643,7 @@ const renderAsync = async function (
     // No svgContainingElement was provided
 
     // If there is an existing element with the id, we remove it. This likely a previously rendered diagram
-    removeExistingElements(document, isSandboxed, id, iFrameID_selector, enclosingDivID_selector);
+    removeExistingElements(document, id, enclosingDivID, iFrameID);
 
     // Add the temporary div used for rendering with the enclosingDivID.
     // This temporary div will contain a svg with the id == id

From 2176bef537dbf668c5782ca22af8a777ad61b43d Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Tue, 13 Dec 2022 13:44:03 +0530
Subject: [PATCH 095/129] Bump mermaid version

---
 packages/mermaid/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index e4ce9e93a..1a271f27a 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mermaid",
-  "version": "9.3.0-rc.4",
+  "version": "9.3.0-rc.5",
   "description": "Markdown-ish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",

From 16b51800d0dd4c2271c2ea569d23f9eb12061551 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 14 Dec 2022 09:45:18 +0530
Subject: [PATCH 096/129] Update dagre-es

---
 packages/mermaid/package.json |  2 +-
 pnpm-lock.yaml                | 20 +++++---------------
 2 files changed, 6 insertions(+), 16 deletions(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 1a271f27a..3fa78bfe1 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -54,7 +54,7 @@
   "dependencies": {
     "@braintree/sanitize-url": "^6.0.0",
     "d3": "^7.0.0",
-    "dagre-d3-es": "7.0.4",
+    "dagre-d3-es": "7.0.5",
     "dompurify": "2.4.1",
     "khroma": "^2.0.0",
     "lodash-es": "^4.17.21",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 55d775801..3a9195738 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -173,8 +173,8 @@ importers:
         specifier: ^7.0.0
         version: 7.6.1
       dagre-d3-es:
-        specifier: 7.0.4
-        version: 7.0.4
+        specifier: 7.0.5
+        version: 7.0.5
       dompurify:
         specifier: 2.4.1
         version: 2.4.1
@@ -4899,8 +4899,8 @@ packages:
       d3-zoom: 3.0.0
     dev: false
 
-  /dagre-d3-es/7.0.4:
-    resolution: {integrity: sha512-fQL8ldFR9UYpecz48d1smrXNJ9zGUK38Vl5OzX6Fhn9LR+oQh0GzHRPQylP5kWawmMTKm1QtqcHMVySMJ5CYaQ==}
+  /dagre-d3-es/7.0.5:
+    resolution: {integrity: sha512-E42LEJ3KFzXCwNlYkY69HOlksJ2g+uuRIZkHd09Fe0yxOJqzHIzVn78Myjv8ZwFpFt9Izax2KHOK6B/GHfawTA==}
     dependencies:
       d3: 7.6.1
       lodash-es: 4.17.21
@@ -6161,16 +6161,6 @@ packages:
     resolution: {integrity: sha512-XGozTsMPYkm+6b5QL3Z9wQcJjNYxp0CYn3U1gO7dwD6PAqU1SVWZxI9CCg3z+ml3YfqdPnrBehaBrnH2AGKbNA==}
     dev: true
 
-  /follow-redirects/1.15.2:
-    resolution: {integrity: sha512-VQLG33o04KaQ8uYi2tVNbdrWp1QWxNNea+nmIB4EVM28v0hmP17z7aG1+wAkNzVq4KeXTq3221ye5qTJP91JwA==}
-    engines: {node: '>=4.0'}
-    peerDependencies:
-      debug: '*'
-    peerDependenciesMeta:
-      debug:
-        optional: true
-    dev: true
-
   /follow-redirects/1.15.2_debug@4.3.2:
     resolution: {integrity: sha512-VQLG33o04KaQ8uYi2tVNbdrWp1QWxNNea+nmIB4EVM28v0hmP17z7aG1+wAkNzVq4KeXTq3221ye5qTJP91JwA==}
     engines: {node: '>=4.0'}
@@ -6715,7 +6705,7 @@ packages:
     engines: {node: '>=8.0.0'}
     dependencies:
       eventemitter3: 4.0.7
-      follow-redirects: 1.15.2
+      follow-redirects: 1.15.2_debug@4.3.2
       requires-port: 1.0.0
     transitivePeerDependencies:
       - debug

From d194e78677d398b9e5a3a083388857ffe48deff2 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Wed, 14 Dec 2022 09:45:34 +0530
Subject: [PATCH 097/129] Bump mermaid version

---
 packages/mermaid/package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 3fa78bfe1..87837f81d 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mermaid",
-  "version": "9.3.0-rc.5",
+  "version": "9.3.0-rc.6",
   "description": "Markdown-ish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",

From 152994047e74edd5731bde1dcedbad5602ad1c4e Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Thu, 15 Dec 2022 09:12:08 +0530
Subject: [PATCH 098/129] bump dagre-es 7.0.6

---
 packages/mermaid/package.json |  4 +--
 pnpm-lock.yaml                | 46 +++++++++++++++++++++++++++++++----
 2 files changed, 43 insertions(+), 7 deletions(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 87837f81d..96f0a1c49 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mermaid",
-  "version": "9.3.0-rc.6",
+  "version": "9.3.0-rc.7",
   "description": "Markdown-ish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",
@@ -54,7 +54,7 @@
   "dependencies": {
     "@braintree/sanitize-url": "^6.0.0",
     "d3": "^7.0.0",
-    "dagre-d3-es": "7.0.5",
+    "dagre-d3-es": "7.0.6",
     "dompurify": "2.4.1",
     "khroma": "^2.0.0",
     "lodash-es": "^4.17.21",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 3a9195738..af68b5340 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -173,8 +173,8 @@ importers:
         specifier: ^7.0.0
         version: 7.6.1
       dagre-d3-es:
-        specifier: 7.0.5
-        version: 7.0.5
+        specifier: 7.0.6
+        version: 7.0.6
       dompurify:
         specifier: 2.4.1
         version: 2.4.1
@@ -4899,10 +4899,46 @@ packages:
       d3-zoom: 3.0.0
     dev: false
 
-  /dagre-d3-es/7.0.5:
-    resolution: {integrity: sha512-E42LEJ3KFzXCwNlYkY69HOlksJ2g+uuRIZkHd09Fe0yxOJqzHIzVn78Myjv8ZwFpFt9Izax2KHOK6B/GHfawTA==}
+  /d3/7.7.0:
+    resolution: {integrity: sha512-VEwHCMgMjD2WBsxeRGUE18RmzxT9Bn7ghDpzvTEvkLSBAKgTMydJjouZTjspgQfRHpPt/PB3EHWBa6SSyFQq4g==}
+    engines: {node: '>=12'}
     dependencies:
-      d3: 7.6.1
+      d3-array: 3.2.0
+      d3-axis: 3.0.0
+      d3-brush: 3.0.0
+      d3-chord: 3.0.1
+      d3-color: 3.1.0
+      d3-contour: 4.0.0
+      d3-delaunay: 6.0.2
+      d3-dispatch: 3.0.1
+      d3-drag: 3.0.0
+      d3-dsv: 3.0.1
+      d3-ease: 3.0.1
+      d3-fetch: 3.0.1
+      d3-force: 3.0.0
+      d3-format: 3.1.0
+      d3-geo: 3.0.1
+      d3-hierarchy: 3.1.2
+      d3-interpolate: 3.0.1
+      d3-path: 3.0.1
+      d3-polygon: 3.0.1
+      d3-quadtree: 3.0.1
+      d3-random: 3.0.1
+      d3-scale: 4.0.2
+      d3-scale-chromatic: 3.0.0
+      d3-selection: 3.0.0
+      d3-shape: 3.1.0
+      d3-time: 3.0.0
+      d3-time-format: 4.1.0
+      d3-timer: 3.0.1
+      d3-transition: 3.0.1_d3-selection@3.0.0
+      d3-zoom: 3.0.0
+    dev: false
+
+  /dagre-d3-es/7.0.6:
+    resolution: {integrity: sha512-CaaE/nZh205ix+Up4xsnlGmpog5GGm81Upi2+/SBHxwNwrccBb3K51LzjZ1U6hgvOlAEUsVWf1xSTzCyKpJ6+Q==}
+    dependencies:
+      d3: 7.7.0
       lodash-es: 4.17.21
     dev: false
 

From 774512df570b8105ea535ebc88daafbf2d4ded2b Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Thu, 15 Dec 2022 14:18:54 +0530
Subject: [PATCH 099/129] v9.3.0

---
 packages/mermaid-mindmap/package.json | 4 ++--
 packages/mermaid/package.json         | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/mermaid-mindmap/package.json b/packages/mermaid-mindmap/package.json
index 2795cf73b..0f1a98303 100644
--- a/packages/mermaid-mindmap/package.json
+++ b/packages/mermaid-mindmap/package.json
@@ -1,7 +1,7 @@
 {
   "name": "@mermaid-js/mermaid-mindmap",
-  "version": "9.3.0-rc1",
-  "description": "Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
+  "version": "9.3.0",
+  "description": "Mindmap diagram module for MermaidJS.",
   "module": "dist/mermaid-mindmap.core.mjs",
   "types": "dist/detector.d.ts",
   "type": "module",
diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 96f0a1c49..24d17fd36 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -1,6 +1,6 @@
 {
   "name": "mermaid",
-  "version": "9.3.0-rc.7",
+  "version": "9.3.0",
   "description": "Markdown-ish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "main": "./dist/mermaid.min.js",
   "module": "./dist/mermaid.core.mjs",

From bbc4e90c8910a835e4f34a397148bbd3d1d208e9 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Thu, 15 Dec 2022 14:57:08 +0530
Subject: [PATCH 100/129] fix Top level await

---
 .../mermaid/src/docs/.vitepress/theme/mermaid.ts    | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts b/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
index b287346f9..e9a038ec4 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
+++ b/packages/mermaid/src/docs/.vitepress/theme/mermaid.ts
@@ -1,13 +1,16 @@
 import mermaid, { type MermaidConfig } from 'mermaid';
 import mindmap from '@mermaid-js/mermaid-mindmap';
 
-try {
-  await mermaid.registerExternalDiagrams([mindmap]);
-} catch (e) {
-  console.error(e);
-}
+const init = (async () => {
+  try {
+    await mermaid.registerExternalDiagrams([mindmap]);
+  } catch (e) {
+    console.error(e);
+  }
+})();
 
 export const render = async (id: string, code: string, config: MermaidConfig): Promise<string> => {
+  await init;
   mermaid.initialize(config);
   const svg = await mermaid.renderAsync(id, code);
   return svg;

From 3fb0b2792eb726af9c8f088e1c1076f0b0173b4a Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Thu, 15 Dec 2022 15:33:51 +0530
Subject: [PATCH 101/129] fix: Add icon css

---
 docs/syntax/mindmap.md                                | 2 +-
 packages/mermaid/src/docs/.vitepress/theme/custom.css | 3 +++
 packages/mermaid/src/docs/syntax/mindmap.md           | 2 +-
 3 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/syntax/mindmap.md b/docs/syntax/mindmap.md
index 0214a5512..7e1d9c080 100644
--- a/docs/syntax/mindmap.md
+++ b/docs/syntax/mindmap.md
@@ -180,7 +180,7 @@ More shapes will be added, beginning with the shapes available in flowcharts.
 
 # Icons and classes
 
-## icons
+## Icons
 
 As with flowcharts you can add icons to your nodes but with an updated syntax. The styling for the font based icons are added during the integration so that they are available for the web page. _This is not something a diagram author can do but has to be done with the site administrator or the integrator_. Once the icon fonts are in place you add them to the mind map nodes using the `::icon()` syntax. You place the classes for the icon within the parenthesis like in the following example where icons for material design and fontawesome 4 are displayed. The intention is that this approach should be used for all diagrams supporting icons. **Experimental feature:** This wider scope is also the reason Mindmaps are experimental as this syntax and approach could change.
 
diff --git a/packages/mermaid/src/docs/.vitepress/theme/custom.css b/packages/mermaid/src/docs/.vitepress/theme/custom.css
index e1ef049cd..28ef8d338 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/custom.css
+++ b/packages/mermaid/src/docs/.vitepress/theme/custom.css
@@ -1,3 +1,6 @@
+@import url('https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css');
+@import url('https://cdn.jsdelivr.net/npm/@mdi/font@6.9.96/css/materialdesignicons.min.css');
+
 :root {
   --vp-c-brand: #ff3670;
   --vp-c-brand-light: #ff5e8c;
diff --git a/packages/mermaid/src/docs/syntax/mindmap.md b/packages/mermaid/src/docs/syntax/mindmap.md
index beaae7ad5..3b737a572 100644
--- a/packages/mermaid/src/docs/syntax/mindmap.md
+++ b/packages/mermaid/src/docs/syntax/mindmap.md
@@ -112,7 +112,7 @@ More shapes will be added, beginning with the shapes available in flowcharts.
 
 # Icons and classes
 
-## icons
+## Icons
 
 As with flowcharts you can add icons to your nodes but with an updated syntax. The styling for the font based icons are added during the integration so that they are available for the web page. _This is not something a diagram author can do but has to be done with the site administrator or the integrator_. Once the icon fonts are in place you add them to the mind map nodes using the `::icon()` syntax. You place the classes for the icon within the parenthesis like in the following example where icons for material design and fontawesome 4 are displayed. The intention is that this approach should be used for all diagrams supporting icons. **Experimental feature:** This wider scope is also the reason Mindmaps are experimental as this syntax and approach could change.
 

From d841ad8f3ecc34e4091bc8c1eaaa981e6d7e2c2a Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Thu, 15 Dec 2022 17:09:24 +0530
Subject: [PATCH 102/129] Update vitepress

---
 packages/mermaid/package.json |   4 +-
 pnpm-lock.yaml                | 438 +++++++++++++++++++++++++++-------
 2 files changed, 360 insertions(+), 82 deletions(-)

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index 24d17fd36..f31fac80b 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -93,8 +93,8 @@
     "typedoc-plugin-markdown": "^3.13.6",
     "typescript": "^4.8.4",
     "unist-util-flatmap": "^1.0.0",
-    "vitepress": "^1.0.0-alpha.28",
-    "vitepress-plugin-search": "^1.0.4-alpha.15"
+    "vitepress": "^1.0.0-alpha.31",
+    "vitepress-plugin-search": "^1.0.4-alpha.16"
   },
   "files": [
     "dist",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index af68b5340..01cb0787e 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -285,11 +285,11 @@ importers:
         specifier: ^1.0.0
         version: 1.0.0
       vitepress:
-        specifier: ^1.0.0-alpha.28
-        version: 1.0.0-alpha.28_tbpndr44ulefs3hehwpi2mkf2y
+        specifier: ^1.0.0-alpha.31
+        version: 1.0.0-alpha.31_tbpndr44ulefs3hehwpi2mkf2y
       vitepress-plugin-search:
-        specifier: ^1.0.4-alpha.15
-        version: 1.0.4-alpha.15_s3edpouswd4dgoi2en7bdlrp54
+        specifier: ^1.0.4-alpha.16
+        version: 1.0.4-alpha.16_ifjhkyx3os4sbm7zdnvthc52am
 
   packages/mermaid-example-diagram:
     devDependencies:
@@ -1727,6 +1727,96 @@ packages:
     dev: true
     optional: true
 
+  /@esbuild/android-arm/0.16.7:
+    resolution: {integrity: sha512-yhzDbiVcmq6T1/XEvdcJIVcXHdLjDJ5cQ0Dp9R9p9ERMBTeO1dR5tc8YYv8zwDeBw1xZm+Eo3MRo8cwclhBS0g==}
+    engines: {node: '>=12'}
+    cpu: [arm]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/android-arm64/0.16.7:
+    resolution: {integrity: sha512-tYFw0lBJSEvLoGzzYh1kXuzoX1iPkbOk3O29VqzQb0HbOy7t/yw1hGkvwoJhXHwzQUPsShyYcTgRf6bDBcfnTw==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/android-x64/0.16.7:
+    resolution: {integrity: sha512-3P2OuTxwAtM3k/yEWTNUJRjMPG1ce8rXs51GTtvEC5z1j8fC1plHeVVczdeHECU7aM2/Buc0MwZ6ciM/zysnWg==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [android]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/darwin-arm64/0.16.7:
+    resolution: {integrity: sha512-VUb9GK23z8jkosHU9yJNUgQpsfJn+7ZyBm6adi2Ec5/U241eR1tAn82QicnUzaFDaffeixiHwikjmnec/YXEZg==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/darwin-x64/0.16.7:
+    resolution: {integrity: sha512-duterlv3tit3HI9vhzMWnSVaB1B6YsXpFq1Ntd6Fou82BB1l4tucYy3FI9dHv3tvtDuS0NiGf/k6XsdBqPZ01w==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/freebsd-arm64/0.16.7:
+    resolution: {integrity: sha512-9kkycpBFes/vhi7B7o0cf+q2WdJi+EpVzpVTqtWFNiutARWDFFLcB93J8PR1cG228sucsl3B+7Ts27izE6qiaQ==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [freebsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/freebsd-x64/0.16.7:
+    resolution: {integrity: sha512-5Ahf6jzWXJ4J2uh9dpy5DKOO+PeRUE/9DMys6VuYfwgQzd6n5+pVFm58L2Z2gRe611RX6SdydnNaiIKM3svY7g==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [freebsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-arm/0.16.7:
+    resolution: {integrity: sha512-QqJnyCfu5OF78Olt7JJSZ7OSv/B4Hf+ZJWp4kkq9xwMsgu7yWq3crIic8gGOpDYTqVKKMDAVDgRXy5Wd/nWZyQ==}
+    engines: {node: '>=12'}
+    cpu: [arm]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-arm64/0.16.7:
+    resolution: {integrity: sha512-2wv0xYDskk2+MzIm/AEprDip39a23Chptc4mL7hsHg26P0gD8RUhzmDu0KCH2vMThUI1sChXXoK9uH0KYQKaDg==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-ia32/0.16.7:
+    resolution: {integrity: sha512-APVYbEilKbD5ptmKdnIcXej2/+GdV65TfTjxR2Uk8t1EsOk49t6HapZW6DS/Bwlvh5hDwtLapdSumIVNGxgqLg==}
+    engines: {node: '>=12'}
+    cpu: [ia32]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
   /@esbuild/linux-loong64/0.15.13:
     resolution: {integrity: sha512-+BoyIm4I8uJmH/QDIH0fu7MG0AEx9OXEDXnqptXCwKOlOqZiS4iraH1Nr7/ObLMokW3sOCeBNyD68ATcV9b9Ag==}
     engines: {node: '>=12'}
@@ -1736,6 +1826,114 @@ packages:
     dev: true
     optional: true
 
+  /@esbuild/linux-loong64/0.16.7:
+    resolution: {integrity: sha512-5wPUAGclplQrAW7EFr3F84Y/d++7G0KykohaF4p54+iNWhUnMVU8Bh2sxiEOXUy4zKIdpHByMgJ5/Ko6QhtTUw==}
+    engines: {node: '>=12'}
+    cpu: [loong64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-mips64el/0.16.7:
+    resolution: {integrity: sha512-hxzlXtWF6yWfkE/SMTscNiVqLOAn7fOuIF3q/kiZaXxftz1DhZW/HpnTmTTWrzrS7zJWQxHHT4QSxyAj33COmA==}
+    engines: {node: '>=12'}
+    cpu: [mips64el]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-ppc64/0.16.7:
+    resolution: {integrity: sha512-WM83Dac0LdXty5xPhlOuCD5Egfk1xLND/oRLYeB7Jb/tY4kzFSDgLlq91wYbHua/s03tQGA9iXvyjgymMw62Vw==}
+    engines: {node: '>=12'}
+    cpu: [ppc64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-riscv64/0.16.7:
+    resolution: {integrity: sha512-3nkNnNg4Ax6MS/l8O8Ynq2lGEVJYyJ2EoY3PHjNJ4PuZ80EYLMrFTFZ4L/Hc16AxgtXKwmNP9TM0YKNiBzBiJQ==}
+    engines: {node: '>=12'}
+    cpu: [riscv64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-s390x/0.16.7:
+    resolution: {integrity: sha512-3SA/2VJuv0o1uD7zuqxEP+RrAyRxnkGddq0bwHQ98v1KNlzXD/JvxwTO3T6GM5RH6JUd29RTVQTOJfyzMkkppA==}
+    engines: {node: '>=12'}
+    cpu: [s390x]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/linux-x64/0.16.7:
+    resolution: {integrity: sha512-xi/tbqCqvPIzU+zJVyrpz12xqciTAPMi2fXEWGnapZymoGhuL2GIWIRXg4O2v5BXaYA5TSaiKYE14L0QhUTuQg==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/netbsd-x64/0.16.7:
+    resolution: {integrity: sha512-NUsYbq3B+JdNKn8SXkItFvdes9qTwEoS3aLALtiWciW/ystiCKM20Fgv9XQBOXfhUHyh5CLEeZDXzLOrwBXuCQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [netbsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/openbsd-x64/0.16.7:
+    resolution: {integrity: sha512-qjwzsgeve9I8Tbsko2FEkdSk2iiezuNGFgipQxY/736NePXDaDZRodIejYGWOlbYXugdxb0nif5yvypH6lKBmA==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [openbsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/sunos-x64/0.16.7:
+    resolution: {integrity: sha512-mFWDz4RoBTzPphTCkM7Kc7Qpa0o/Z01acajR+Ai7LdfKgcP/C6jYOaKwv7nKzD0+MjOT20j7You9g4ozYy1dKQ==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [sunos]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/win32-arm64/0.16.7:
+    resolution: {integrity: sha512-m39UmX19RvEIuC8sYZ0M+eQtdXw4IePDSZ78ZQmYyFaXY9krq4YzQCK2XWIJomNLtg4q+W5aXr8bW3AbqWNoVg==}
+    engines: {node: '>=12'}
+    cpu: [arm64]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/win32-ia32/0.16.7:
+    resolution: {integrity: sha512-1cbzSEZA1fANwmT6rjJ4G1qQXHxCxGIcNYFYR9ctI82/prT38lnwSRZ0i5p/MVXksw9eMlHlet6pGu2/qkXFCg==}
+    engines: {node: '>=12'}
+    cpu: [ia32]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@esbuild/win32-x64/0.16.7:
+    resolution: {integrity: sha512-QaQ8IH0JLacfGf5cf0HCCPnQuCTd/dAI257vXBgb/cccKGbH/6pVtI1gwhdAQ0Y48QSpTIFrh9etVyNdZY+zzw==}
+    engines: {node: '>=12'}
+    cpu: [x64]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
   /@eslint/eslintrc/1.3.3:
     resolution: {integrity: sha512-uj3pT6Mg+3t39fvLrj8iuCIJ38zKO9FpGtJ4BBJebJhEwjoT+KLVNCcHT5QC9NGRIEi7fZ0ZR8YRb884auB4Lg==}
     engines: {node: ^12.22.0 || ^14.17.0 || >=16.0.0}
@@ -2853,15 +3051,15 @@ packages:
       eslint-visitor-keys: 3.3.0
     dev: true
 
-  /@vitejs/plugin-vue/3.2.0_vite@3.2.3+vue@3.2.41:
-    resolution: {integrity: sha512-E0tnaL4fr+qkdCNxJ+Xd0yM31UwMkQje76fsDVBBUCoGOUPexu2VDUYHL8P4CwV+zMvWw6nlRw19OnRKmYAJpw==}
+  /@vitejs/plugin-vue/4.0.0_vite@4.0.1+vue@3.2.45:
+    resolution: {integrity: sha512-e0X4jErIxAB5oLtDqbHvHpJe/uWNkdpYV83AOG2xo2tEVSzCzewgJMtREZM30wXnM5ls90hxiOtAuVU6H5JgbA==}
     engines: {node: ^14.18.0 || >=16.0.0}
     peerDependencies:
-      vite: ^3.0.0
+      vite: ^4.0.0
       vue: ^3.2.25
     dependencies:
-      vite: 3.2.3
-      vue: 3.2.41
+      vite: 4.0.1
+      vue: 3.2.45
     dev: true
 
   /@vitest/coverage-c8/0.25.1_oullksb5ic6y72oh2wekoaiuii:
@@ -2889,114 +3087,113 @@ packages:
       sirv: 2.0.2
     dev: true
 
-  /@vue/compiler-core/3.2.41:
-    resolution: {integrity: sha512-oA4mH6SA78DT+96/nsi4p9DX97PHcNROxs51lYk7gb9Z4BPKQ3Mh+BLn6CQZBw857Iuhu28BfMSRHAlPvD4vlw==}
+  /@vue/compiler-core/3.2.45:
+    resolution: {integrity: sha512-rcMj7H+PYe5wBV3iYeUgbCglC+pbpN8hBLTJvRiK2eKQiWqu+fG9F+8sW99JdL4LQi7Re178UOxn09puSXvn4A==}
     dependencies:
       '@babel/parser': 7.19.1
-      '@vue/shared': 3.2.41
+      '@vue/shared': 3.2.45
       estree-walker: 2.0.2
       source-map: 0.6.1
     dev: true
 
-  /@vue/compiler-dom/3.2.41:
-    resolution: {integrity: sha512-xe5TbbIsonjENxJsYRbDJvthzqxLNk+tb3d/c47zgREDa/PCp6/Y4gC/skM4H6PIuX5DAxm7fFJdbjjUH2QTMw==}
+  /@vue/compiler-dom/3.2.45:
+    resolution: {integrity: sha512-tyYeUEuKqqZO137WrZkpwfPCdiiIeXYCcJ8L4gWz9vqaxzIQRccTSwSWZ/Axx5YR2z+LvpUbmPNXxuBU45lyRw==}
     dependencies:
-      '@vue/compiler-core': 3.2.41
-      '@vue/shared': 3.2.41
+      '@vue/compiler-core': 3.2.45
+      '@vue/shared': 3.2.45
     dev: true
 
-  /@vue/compiler-sfc/3.2.41:
-    resolution: {integrity: sha512-+1P2m5kxOeaxVmJNXnBskAn3BenbTmbxBxWOtBq3mQTCokIreuMULFantBUclP0+KnzNCMOvcnKinqQZmiOF8w==}
-    requiresBuild: true
+  /@vue/compiler-sfc/3.2.45:
+    resolution: {integrity: sha512-1jXDuWah1ggsnSAOGsec8cFjT/K6TMZ0sPL3o3d84Ft2AYZi2jWJgRMjw4iaK0rBfA89L5gw427H4n1RZQBu6Q==}
     dependencies:
       '@babel/parser': 7.19.1
-      '@vue/compiler-core': 3.2.41
-      '@vue/compiler-dom': 3.2.41
-      '@vue/compiler-ssr': 3.2.41
-      '@vue/reactivity-transform': 3.2.41
-      '@vue/shared': 3.2.41
+      '@vue/compiler-core': 3.2.45
+      '@vue/compiler-dom': 3.2.45
+      '@vue/compiler-ssr': 3.2.45
+      '@vue/reactivity-transform': 3.2.45
+      '@vue/shared': 3.2.45
       estree-walker: 2.0.2
       magic-string: 0.25.9
       postcss: 8.4.18
       source-map: 0.6.1
     dev: true
 
-  /@vue/compiler-ssr/3.2.41:
-    resolution: {integrity: sha512-Y5wPiNIiaMz/sps8+DmhaKfDm1xgj6GrH99z4gq2LQenfVQcYXmHIOBcs5qPwl7jaW3SUQWjkAPKMfQemEQZwQ==}
+  /@vue/compiler-ssr/3.2.45:
+    resolution: {integrity: sha512-6BRaggEGqhWht3lt24CrIbQSRD5O07MTmd+LjAn5fJj568+R9eUD2F7wMQJjX859seSlrYog7sUtrZSd7feqrQ==}
     dependencies:
-      '@vue/compiler-dom': 3.2.41
-      '@vue/shared': 3.2.41
+      '@vue/compiler-dom': 3.2.45
+      '@vue/shared': 3.2.45
     dev: true
 
   /@vue/devtools-api/6.4.5:
     resolution: {integrity: sha512-JD5fcdIuFxU4fQyXUu3w2KpAJHzTVdN+p4iOX2lMWSHMOoQdMAcpFLZzm9Z/2nmsoZ1a96QEhZ26e50xLBsgOQ==}
     dev: true
 
-  /@vue/reactivity-transform/3.2.41:
-    resolution: {integrity: sha512-mK5+BNMsL4hHi+IR3Ft/ho6Za+L3FA5j8WvreJ7XzHrqkPq8jtF/SMo7tuc9gHjLDwKZX1nP1JQOKo9IEAn54A==}
+  /@vue/reactivity-transform/3.2.45:
+    resolution: {integrity: sha512-BHVmzYAvM7vcU5WmuYqXpwaBHjsS8T63jlKGWVtHxAHIoMIlmaMyurUSEs1Zcg46M4AYT5MtB1U274/2aNzjJQ==}
     dependencies:
       '@babel/parser': 7.19.1
-      '@vue/compiler-core': 3.2.41
-      '@vue/shared': 3.2.41
+      '@vue/compiler-core': 3.2.45
+      '@vue/shared': 3.2.45
       estree-walker: 2.0.2
       magic-string: 0.25.9
     dev: true
 
-  /@vue/reactivity/3.2.41:
-    resolution: {integrity: sha512-9JvCnlj8uc5xRiQGZ28MKGjuCoPhhTwcoAdv3o31+cfGgonwdPNuvqAXLhlzu4zwqavFEG5tvaoINQEfxz+l6g==}
+  /@vue/reactivity/3.2.45:
+    resolution: {integrity: sha512-PRvhCcQcyEVohW0P8iQ7HDcIOXRjZfAsOds3N99X/Dzewy8TVhTCT4uXpAHfoKjVTJRA0O0K+6QNkDIZAxNi3A==}
     dependencies:
-      '@vue/shared': 3.2.41
+      '@vue/shared': 3.2.45
     dev: true
 
-  /@vue/runtime-core/3.2.41:
-    resolution: {integrity: sha512-0LBBRwqnI0p4FgIkO9q2aJBBTKDSjzhnxrxHYengkAF6dMOjeAIZFDADAlcf2h3GDALWnblbeprYYpItiulSVQ==}
+  /@vue/runtime-core/3.2.45:
+    resolution: {integrity: sha512-gzJiTA3f74cgARptqzYswmoQx0fIA+gGYBfokYVhF8YSXjWTUA2SngRzZRku2HbGbjzB6LBYSbKGIaK8IW+s0A==}
     dependencies:
-      '@vue/reactivity': 3.2.41
-      '@vue/shared': 3.2.41
+      '@vue/reactivity': 3.2.45
+      '@vue/shared': 3.2.45
     dev: true
 
-  /@vue/runtime-dom/3.2.41:
-    resolution: {integrity: sha512-U7zYuR1NVIP8BL6jmOqmapRAHovEFp7CSw4pR2FacqewXNGqZaRfHoNLQsqQvVQ8yuZNZtxSZy0FFyC70YXPpA==}
+  /@vue/runtime-dom/3.2.45:
+    resolution: {integrity: sha512-cy88YpfP5Ue2bDBbj75Cb4bIEZUMM/mAkDMfqDTpUYVgTf/kuQ2VQ8LebuZ8k6EudgH8pYhsGWHlY0lcxlvTwA==}
     dependencies:
-      '@vue/runtime-core': 3.2.41
-      '@vue/shared': 3.2.41
+      '@vue/runtime-core': 3.2.45
+      '@vue/shared': 3.2.45
       csstype: 2.6.21
     dev: true
 
-  /@vue/server-renderer/3.2.41_vue@3.2.41:
-    resolution: {integrity: sha512-7YHLkfJdTlsZTV0ae5sPwl9Gn/EGr2hrlbcS/8naXm2CDpnKUwC68i1wGlrYAfIgYWL7vUZwk2GkYLQH5CvFig==}
+  /@vue/server-renderer/3.2.45_vue@3.2.45:
+    resolution: {integrity: sha512-ebiMq7q24WBU1D6uhPK//2OTR1iRIyxjF5iVq/1a5I1SDMDyDu4Ts6fJaMnjrvD3MqnaiFkKQj+LKAgz5WIK3g==}
     peerDependencies:
-      vue: 3.2.41
+      vue: 3.2.45
     dependencies:
-      '@vue/compiler-ssr': 3.2.41
-      '@vue/shared': 3.2.41
-      vue: 3.2.41
+      '@vue/compiler-ssr': 3.2.45
+      '@vue/shared': 3.2.45
+      vue: 3.2.45
     dev: true
 
-  /@vue/shared/3.2.41:
-    resolution: {integrity: sha512-W9mfWLHmJhkfAmV+7gDjcHeAWALQtgGT3JErxULl0oz6R6+3ug91I7IErs93eCFhPCZPHBs4QJS7YWEV7A3sxw==}
+  /@vue/shared/3.2.45:
+    resolution: {integrity: sha512-Ewzq5Yhimg7pSztDV+RH1UDKBzmtqieXQlpTVm2AwraoRL/Rks96mvd8Vgi7Lj+h+TH8dv7mXD3FRZR3TUvbSg==}
     dev: true
 
-  /@vueuse/core/9.4.0_vue@3.2.41:
-    resolution: {integrity: sha512-JzgenGj1ZF2BHOen5rsFiAyyI9sXAv7aKhNLlm9b7SwYQeKTcxTWdhudonURCSP3Egl9NQaRBzes2lv/1JUt/Q==}
+  /@vueuse/core/9.6.0_vue@3.2.45:
+    resolution: {integrity: sha512-qGUcjKQXHgN+jqXEgpeZGoxdCbIDCdVPz3QiF1uyecVGbMuM63o96I1GjYx5zskKgRI0FKSNsVWM7rwrRMTf6A==}
     dependencies:
       '@types/web-bluetooth': 0.0.16
-      '@vueuse/metadata': 9.4.0
-      '@vueuse/shared': 9.4.0_vue@3.2.41
-      vue-demi: 0.13.11_vue@3.2.41
+      '@vueuse/metadata': 9.6.0
+      '@vueuse/shared': 9.6.0_vue@3.2.45
+      vue-demi: 0.13.11_vue@3.2.45
     transitivePeerDependencies:
       - '@vue/composition-api'
       - vue
     dev: true
 
-  /@vueuse/metadata/9.4.0:
-    resolution: {integrity: sha512-7GKMdGAsJyQJl35MYOz/RDpP0FxuiZBRDSN79QIPbdqYx4Sd0sVTnIC68KJ6Oln0t0SouvSUMvRHuno216Ud2Q==}
+  /@vueuse/metadata/9.6.0:
+    resolution: {integrity: sha512-sIC8R+kWkIdpi5X2z2Gk8TRYzmczDwHRhEFfCu2P+XW2JdPoXrziqsGpDDsN7ykBx4ilwieS7JUIweVGhvZ93w==}
     dev: true
 
-  /@vueuse/shared/9.4.0_vue@3.2.41:
-    resolution: {integrity: sha512-fTuem51KwMCnqUKkI8B57qAIMcFovtGgsCtAeqxIzH3i6nE9VYge+gVfneNHAAy7lj8twbkNfqQSygOPJTm4tQ==}
+  /@vueuse/shared/9.6.0_vue@3.2.45:
+    resolution: {integrity: sha512-/eDchxYYhkHnFyrb00t90UfjCx94kRHxc7J1GtBCqCG4HyPMX+krV9XJgVtWIsAMaxKVU4fC8NSUviG1JkwhUQ==}
     dependencies:
-      vue-demi: 0.13.11_vue@3.2.41
+      vue-demi: 0.13.11_vue@3.2.45
     transitivePeerDependencies:
       - '@vue/composition-api'
       - vue
@@ -5541,6 +5738,36 @@ packages:
       esbuild-windows-arm64: 0.15.13
     dev: true
 
+  /esbuild/0.16.7:
+    resolution: {integrity: sha512-P6OBFYFSQOGzfApqCeYKqfKRRbCIRsdppTXFo4aAvtiW3o8TTyiIplBvHJI171saPAiy3WlawJHCveJVIOIx1A==}
+    engines: {node: '>=12'}
+    hasBin: true
+    requiresBuild: true
+    optionalDependencies:
+      '@esbuild/android-arm': 0.16.7
+      '@esbuild/android-arm64': 0.16.7
+      '@esbuild/android-x64': 0.16.7
+      '@esbuild/darwin-arm64': 0.16.7
+      '@esbuild/darwin-x64': 0.16.7
+      '@esbuild/freebsd-arm64': 0.16.7
+      '@esbuild/freebsd-x64': 0.16.7
+      '@esbuild/linux-arm': 0.16.7
+      '@esbuild/linux-arm64': 0.16.7
+      '@esbuild/linux-ia32': 0.16.7
+      '@esbuild/linux-loong64': 0.16.7
+      '@esbuild/linux-mips64el': 0.16.7
+      '@esbuild/linux-ppc64': 0.16.7
+      '@esbuild/linux-riscv64': 0.16.7
+      '@esbuild/linux-s390x': 0.16.7
+      '@esbuild/linux-x64': 0.16.7
+      '@esbuild/netbsd-x64': 0.16.7
+      '@esbuild/openbsd-x64': 0.16.7
+      '@esbuild/sunos-x64': 0.16.7
+      '@esbuild/win32-arm64': 0.16.7
+      '@esbuild/win32-ia32': 0.16.7
+      '@esbuild/win32-x64': 0.16.7
+    dev: true
+
   /escalade/3.1.1:
     resolution: {integrity: sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw==}
     engines: {node: '>=6'}
@@ -9057,6 +9284,15 @@ packages:
       source-map-js: 1.0.2
     dev: true
 
+  /postcss/8.4.20:
+    resolution: {integrity: sha512-6Q04AXR1212bXr5fh03u8aAwbLxAQNGQ/Q1LNa0VfOI06ZAlhPHtQvE4OIdpj4kLThXilalPnmDSOD65DcHt+g==}
+    engines: {node: ^10 || ^12 || >=14}
+    dependencies:
+      nanoid: 3.3.4
+      picocolors: 1.0.0
+      source-map-js: 1.0.2
+    dev: true
+
   /preact/10.11.0:
     resolution: {integrity: sha512-Fk6+vB2kb6mSJfDgODq0YDhMfl0HNtK5+Uc9QqECO4nlyPAQwCI+BKyWO//idA7ikV7o+0Fm6LQmNuQi1wXI1w==}
     dev: true
@@ -9520,6 +9756,14 @@ packages:
       fsevents: 2.3.2
     dev: true
 
+  /rollup/3.7.4:
+    resolution: {integrity: sha512-jN9rx3k5pfg9H9al0r0y1EYKSeiRANZRYX32SuNXAnKzh6cVyf4LZVto1KAuDnbHT03E1CpsgqDKaqQ8FZtgxw==}
+    engines: {node: '>=14.18.0', npm: '>=8.0.0'}
+    hasBin: true
+    optionalDependencies:
+      fsevents: 2.3.2
+    dev: true
+
   /run-parallel/1.2.0:
     resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}
     dependencies:
@@ -9873,6 +10117,7 @@ packages:
 
   /sourcemap-codec/1.4.8:
     resolution: {integrity: sha512-9NykojV5Uih4lgo5So5dtw+f0JgJX30KCNI8gwhz2J9A15wD0Ml6tjHKwf6fTSa6fAdVBdZeNOs9eJ71qCk8vA==}
+    deprecated: Please use @jridgewell/sourcemap-codec instead
     dev: true
 
   /spawn-command/0.0.2-1:
@@ -10774,8 +11019,41 @@ packages:
       fsevents: 2.3.2
     dev: true
 
-  /vitepress-plugin-search/1.0.4-alpha.15_s3edpouswd4dgoi2en7bdlrp54:
-    resolution: {integrity: sha512-Ef/VkhTVYlECVI0H9Ck6745UNPfYFppAqnlxVSMJXdxP2vjOZ5TYNczlTTQ2p9dh16MFw/IurbL1/GrG4nXdNw==}
+  /vite/4.0.1:
+    resolution: {integrity: sha512-kZQPzbDau35iWOhy3CpkrRC7It+HIHtulAzBhMqzGHKRf/4+vmh8rPDDdv98SWQrFWo6//3ozwsRmwQIPZsK9g==}
+    engines: {node: ^14.18.0 || >=16.0.0}
+    hasBin: true
+    peerDependencies:
+      '@types/node': '>= 14'
+      less: '*'
+      sass: '*'
+      stylus: '*'
+      sugarss: '*'
+      terser: ^5.4.0
+    peerDependenciesMeta:
+      '@types/node':
+        optional: true
+      less:
+        optional: true
+      sass:
+        optional: true
+      stylus:
+        optional: true
+      sugarss:
+        optional: true
+      terser:
+        optional: true
+    dependencies:
+      esbuild: 0.16.7
+      postcss: 8.4.20
+      resolve: 1.22.1
+      rollup: 3.7.4
+    optionalDependencies:
+      fsevents: 2.3.2
+    dev: true
+
+  /vitepress-plugin-search/1.0.4-alpha.16_ifjhkyx3os4sbm7zdnvthc52am:
+    resolution: {integrity: sha512-D+rs7bwzH+IO+7T9NlxvqSOqmSKbN1yHxUoqClTy5JH+DomL3CcrH2TgSvXc2s58ztlc1dC07c7THo4cNjlUAg==}
     engines: {node: ^14.13.1 || ^16.7.0 || >=18}
     peerDependencies:
       flexsearch: ^0.7.31
@@ -10788,23 +11066,23 @@ packages:
       flexsearch: 0.7.31
       markdown-it: 13.0.1
       vite: 3.2.3
-      vitepress: 1.0.0-alpha.28_tbpndr44ulefs3hehwpi2mkf2y
-      vue: 3.2.41
+      vitepress: 1.0.0-alpha.31_tbpndr44ulefs3hehwpi2mkf2y
+      vue: 3.2.45
     dev: true
 
-  /vitepress/1.0.0-alpha.28_tbpndr44ulefs3hehwpi2mkf2y:
-    resolution: {integrity: sha512-pvbLssDMgLUN1terajmPlFBxHSDGO4DqwexKbjFyr7LeELerVuwGrG6F2J1hxmwOlbpLd1kHXEDqGm9JX/kTDQ==}
+  /vitepress/1.0.0-alpha.31_tbpndr44ulefs3hehwpi2mkf2y:
+    resolution: {integrity: sha512-FWFXLs7WLbFbemxjBWo2S2+qUZCIoeLLyAKfVUpIu3LUB8oQ8cyIANRGO6f6zsM51u2bvJU9Sm+V6Z0WjOWS2Q==}
     hasBin: true
     dependencies:
       '@docsearch/css': 3.3.0
       '@docsearch/js': 3.3.0_tbpndr44ulefs3hehwpi2mkf2y
-      '@vitejs/plugin-vue': 3.2.0_vite@3.2.3+vue@3.2.41
+      '@vitejs/plugin-vue': 4.0.0_vite@4.0.1+vue@3.2.45
       '@vue/devtools-api': 6.4.5
-      '@vueuse/core': 9.4.0_vue@3.2.41
+      '@vueuse/core': 9.6.0_vue@3.2.45
       body-scroll-lock: 4.0.0-beta.0
       shiki: 0.11.1
-      vite: 3.2.3
-      vue: 3.2.41
+      vite: 4.0.1
+      vue: 3.2.45
     transitivePeerDependencies:
       - '@algolia/client-search'
       - '@types/node'
@@ -10956,7 +11234,7 @@ packages:
     resolution: {integrity: sha512-fmL7V1eiDBFRRnu+gfRWTzyPpNIHJTc4mWnFkwBUmO9U3KPgJAmTx7oxi2bl/Rh6HLdU7+4C9wlj0k2E4AdKFQ==}
     dev: true
 
-  /vue-demi/0.13.11_vue@3.2.41:
+  /vue-demi/0.13.11_vue@3.2.45:
     resolution: {integrity: sha512-IR8HoEEGM65YY3ZJYAjMlKygDQn25D5ajNFNoKh9RSDMQtlzCxtfQjdQgv9jjK+m3377SsJXY8ysq8kLCZL25A==}
     engines: {node: '>=12'}
     hasBin: true
@@ -10968,17 +11246,17 @@ packages:
       '@vue/composition-api':
         optional: true
     dependencies:
-      vue: 3.2.41
+      vue: 3.2.45
     dev: true
 
-  /vue/3.2.41:
-    resolution: {integrity: sha512-uuuvnrDXEeZ9VUPljgHkqB5IaVO8SxhPpqF2eWOukVrBnRBx2THPSGQBnVRt0GrIG1gvCmFXMGbd7FqcT1ixNQ==}
+  /vue/3.2.45:
+    resolution: {integrity: sha512-9Nx/Mg2b2xWlXykmCwiTUCWHbWIj53bnkizBxKai1g61f2Xit700A1ljowpTIM11e3uipOeiPcSqnmBg6gyiaA==}
     dependencies:
-      '@vue/compiler-dom': 3.2.41
-      '@vue/compiler-sfc': 3.2.41
-      '@vue/runtime-dom': 3.2.41
-      '@vue/server-renderer': 3.2.41_vue@3.2.41
-      '@vue/shared': 3.2.41
+      '@vue/compiler-dom': 3.2.45
+      '@vue/compiler-sfc': 3.2.45
+      '@vue/runtime-dom': 3.2.45
+      '@vue/server-renderer': 3.2.45_vue@3.2.45
+      '@vue/shared': 3.2.45
     dev: true
 
   /w3c-hr-time/1.0.2:

From 9f2d29b68b00d9719add89b4f23938ff2db45077 Mon Sep 17 00:00:00 2001
From: Tom Moor <tom@getoutline.com>
Date: Thu, 15 Dec 2022 06:09:22 -0800
Subject: [PATCH 103/129] fix typescript error

---
 packages/mermaid/src/utils.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/src/utils.ts b/packages/mermaid/src/utils.ts
index 767fdaa7d..7c844ca8c 100644
--- a/packages/mermaid/src/utils.ts
+++ b/packages/mermaid/src/utils.ts
@@ -194,7 +194,7 @@ export const isSubstringInArray = function (str: string, arr: string[]): number
  * @param defaultCurve - The default curve to return
  * @returns The curve factory to use
  */
-export function interpolateToCurve(interpolate?: string, defaultCurve: CurveFactory): CurveFactory {
+export function interpolateToCurve(interpolate: string | undefined, defaultCurve: CurveFactory): CurveFactory {
   if (!interpolate) {
     return defaultCurve;
   }

From 78dd03dcdbae77ebf5cb163209be48dbb594d7a2 Mon Sep 17 00:00:00 2001
From: Tom Moor <tom.moor@gmail.com>
Date: Thu, 15 Dec 2022 09:29:30 -0500
Subject: [PATCH 104/129] lint

---
 packages/mermaid/src/utils.ts | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/mermaid/src/utils.ts b/packages/mermaid/src/utils.ts
index 7c844ca8c..70e47531f 100644
--- a/packages/mermaid/src/utils.ts
+++ b/packages/mermaid/src/utils.ts
@@ -194,7 +194,10 @@ export const isSubstringInArray = function (str: string, arr: string[]): number
  * @param defaultCurve - The default curve to return
  * @returns The curve factory to use
  */
-export function interpolateToCurve(interpolate: string | undefined, defaultCurve: CurveFactory): CurveFactory {
+export function interpolateToCurve(
+  interpolate: string | undefined,
+  defaultCurve: CurveFactory
+): CurveFactory {
   if (!interpolate) {
     return defaultCurve;
   }

From 992d1623a7168d98894452ef4932dca9f7e6e123 Mon Sep 17 00:00:00 2001
From: BD103 <59022059+BD103@users.noreply.github.com>
Date: Thu, 15 Dec 2022 09:46:00 -0500
Subject: [PATCH 105/129] chore: update docs folder

---
 docs/config/theming.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/config/theming.md b/docs/config/theming.md
index cfd86caa0..ee5831fbb 100644
--- a/docs/config/theming.md
+++ b/docs/config/theming.md
@@ -16,15 +16,15 @@ Themes follow and build upon the Levels of Configuration, and employ `directives
 
 The following are a list of **Deployable themes**, sample `%%init%%` directives and `initialize` calls.
 
-1.  **base**- Designed to be modified, as the name implies it is supposed to be used as the base for making custom themes.
+1.  [**base**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-base.js) - Designed to be modified, as the name implies it is supposed to be used as the base for making custom themes.
 
-2.  **forest**- A theme full of light greens that is easy on the eyes.
+2.  [**forest**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-forest.js) - A theme full of light greens that is easy on the eyes.
 
-3.  **dark**- A theme that would go well with other dark-colored elements.
+3.  [**dark**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-dark.js) - A theme that would go well with other dark-colored elements.
 
-4.  **default**- The default theme for all diagrams.
+4.  [**default**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-default.js) - The default theme for all diagrams.
 
-5.  **neutral**- The theme to be used for black and white printing.
+5.  [**neutral**](https://github.com/mermaid-js/mermaid/blob/develop/packages/mermaid/src/themes/theme-neutral.js) - The theme to be used for black and white printing.
 
 ## Site-wide Themes
 

From 333b974f10337d5ae9c332d0212fe87d0e7029f0 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Thu, 15 Dec 2022 21:50:00 +0530
Subject: [PATCH 106/129] Add `workflow_dispatch` to lint.yml

---
 .github/workflows/lint.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/workflows/lint.yml b/.github/workflows/lint.yml
index d67144540..95e4256b1 100644
--- a/.github/workflows/lint.yml
+++ b/.github/workflows/lint.yml
@@ -7,6 +7,7 @@ on:
       - opened
       - synchronize
       - ready_for_review
+  workflow_dispatch:
 
 permissions:
   contents: write

From ac5a1b45014d7e049cea46ff3d32a0404dec62fc Mon Sep 17 00:00:00 2001
From: Alois Klink <alois@aloisklink.com>
Date: Thu, 15 Dec 2022 00:01:29 +0000
Subject: [PATCH 107/129] fix(er): switch to deterministic uuids in ER

The entity relation diagram uses uuid v4, which is randomly generated.

uuid v5 uses a SHA-1 hash, which makes the uuid deterministic.

The input strings are unique for each diagram, so this should be
okay.
---
 packages/mermaid/src/diagrams/er/erRenderer.js   | 16 +++++++++++++---
 .../mermaid/src/diagrams/er/erRenderer.spec.ts   | 12 ++++++++++++
 2 files changed, 25 insertions(+), 3 deletions(-)
 create mode 100644 packages/mermaid/src/diagrams/er/erRenderer.spec.ts

diff --git a/packages/mermaid/src/diagrams/er/erRenderer.js b/packages/mermaid/src/diagrams/er/erRenderer.js
index ebf338ae1..7a7920160 100644
--- a/packages/mermaid/src/diagrams/er/erRenderer.js
+++ b/packages/mermaid/src/diagrams/er/erRenderer.js
@@ -7,7 +7,7 @@ import utils from '../../utils';
 import erMarkers from './erMarkers';
 import { configureSvgSize } from '../../setupGraphViewbox';
 import { parseGenericTypes } from '../common/common';
-import { v4 as uuid4 } from 'uuid';
+import { v5 as uuid5 } from 'uuid';
 
 /** Regex used to remove chars from the entity name so the result can be used in an id */
 const BAD_ID_CHARS_REGEXP = /[^\dA-Za-z](\W)*/g;
@@ -643,9 +643,15 @@ export const draw = function (text, id, _version, diagObj) {
   svg.attr('viewBox', `${svgBounds.x - padding} ${svgBounds.y - padding} ${width} ${height}`);
 }; // draw
 
+/** UUID namespace for ER diagram IDs */
+const MERMAID_ERDIAGRAM_UUID = uuid5(
+  'https://mermaid-js.github.io/mermaid/syntax/entityRelationshipDiagram.html',
+  uuid5.URL
+);
+
 /**
  * Return a unique id based on the given string. Start with the prefix, then a hyphen, then the
- * simplified str, then a hyphen, then a unique uuid. (Hyphens are only included if needed.)
+ * simplified str, then a hyphen, then a unique uuid based on the str. (Hyphens are only included if needed.)
  * Although the official XML standard for ids says that many more characters are valid in the id,
  * this keeps things simple by accepting only A-Za-z0-9.
  *
@@ -656,7 +662,11 @@ export const draw = function (text, id, _version, diagObj) {
  */
 export function generateId(str = '', prefix = '') {
   const simplifiedStr = str.replace(BAD_ID_CHARS_REGEXP, '');
-  return `${strWithHyphen(prefix)}${strWithHyphen(simplifiedStr)}${uuid4()}`;
+  // we use `uuid v5` so that UUIDs are consistent given a string.
+  return `${strWithHyphen(prefix)}${strWithHyphen(simplifiedStr)}${uuid5(
+    str,
+    MERMAID_ERDIAGRAM_UUID
+  )}`;
 }
 
 /**
diff --git a/packages/mermaid/src/diagrams/er/erRenderer.spec.ts b/packages/mermaid/src/diagrams/er/erRenderer.spec.ts
new file mode 100644
index 000000000..ca0f62bd2
--- /dev/null
+++ b/packages/mermaid/src/diagrams/er/erRenderer.spec.ts
@@ -0,0 +1,12 @@
+import { generateId } from './erRenderer';
+
+describe('erRenderer', () => {
+  describe('generateId', () => {
+    it('should be deterministic', () => {
+      const id1 = generateId('hello world', 'my-prefix');
+      const id2 = generateId('hello world', 'my-prefix');
+
+      expect(id1).toBe(id2);
+    });
+  });
+});

From e2b05d3cf68ba1f89b163bc51d4109167b59c0a5 Mon Sep 17 00:00:00 2001
From: BD103 <BD103@users.noreply.github.com>
Date: Thu, 15 Dec 2022 18:24:23 +0000
Subject: [PATCH 108/129] Update docs

---
 docs/config/theming.md | 78 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 78 insertions(+)

diff --git a/docs/config/theming.md b/docs/config/theming.md
index 3fcd1cda1..8ccab7804 100644
--- a/docs/config/theming.md
+++ b/docs/config/theming.md
@@ -3,6 +3,12 @@
 > ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT.
 >
 > ## Please edit the corresponding file in [/packages/mermaid/src/docs/config/theming.md](../../packages/mermaid/src/docs/config/theming.md).
+>
+> **Warning**
+>
+> ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT.
+>
+> ## Please edit the corresponding file in [/packages/mermaid/src/docs/config/theming.md](../../packages/mermaid/src/docs/config/theming.md).
 
 # Theme Configuration
 
@@ -53,6 +59,18 @@ Example of `init` directive setting the `theme` to `forest`:
     a --> b
 ```
 
+```mermaid-example
+%%{init: {'theme':'forest'}}%%
+  graph TD
+    a --> b
+```
+
+```mermaid
+%%{init: {'theme':'forest'}}%%
+  graph TD
+    a --> b
+```
+
 > **Reminder**: the only theme that can be customed is the `base` theme. The following section covers how to use `themeVariables` for customizations.
 
 ## Customizing Themes with `themeVariables`
@@ -127,6 +145,66 @@ Example of modifying `themeVariables` using the `init` directive:
           end
 ```
 
+```mermaid-example
+%%{
+  init: {
+    'theme': 'base',
+    'themeVariables': {
+      'primaryColor': '#BB2528',
+      'primaryTextColor': '#fff',
+      'primaryBorderColor': '#7C0000',
+      'lineColor': '#F8B229',
+      'secondaryColor': '#006100',
+      'tertiaryColor': '#fff'
+    }
+  }
+}%%
+        graph TD
+          A[Christmas] -->|Get money| B(Go shopping)
+          B --> C{Let me think}
+          B --> G[/Another/]
+          C ==>|One| D[Laptop]
+          C -->|Two| E[iPhone]
+          C -->|Three| F[fa:fa-car Car]
+          subgraph section
+            C
+            D
+            E
+            F
+            G
+          end
+```
+
+```mermaid
+%%{
+  init: {
+    'theme': 'base',
+    'themeVariables': {
+      'primaryColor': '#BB2528',
+      'primaryTextColor': '#fff',
+      'primaryBorderColor': '#7C0000',
+      'lineColor': '#F8B229',
+      'secondaryColor': '#006100',
+      'tertiaryColor': '#fff'
+    }
+  }
+}%%
+        graph TD
+          A[Christmas] -->|Get money| B(Go shopping)
+          B --> C{Let me think}
+          B --> G[/Another/]
+          C ==>|One| D[Laptop]
+          C -->|Two| E[iPhone]
+          C -->|Three| F[fa:fa-car Car]
+          subgraph section
+            C
+            D
+            E
+            F
+            G
+          end
+```
+
 ## Color and Color Calculation
 
 To ensure diagram readability, the default value of certain variables is calculated or derived from other variables. For example, `primaryBorderColor` is derived from the `primaryColor` variable. So if the `primaryColor` variable is customized, Mermaid will adjust `primaryBorderColor` automatically. Adjustments can mean a color inversion, a hue change, a darkening/lightening by 10%, etc.

From 32a8061cc2e8b5a315329d3a970a905fbd2e0a08 Mon Sep 17 00:00:00 2001
From: Tom PERRILLAT-COLLOMB <tom.perrillat-collomb@protonmail.com>
Date: Thu, 15 Dec 2022 18:55:08 +0000
Subject: [PATCH 109/129] feat(er): add UK attribute constraint

Any attribute can now be PK, FK or UK
---
 demos/er.html                                      | 14 ++++++++++++++
 .../mermaid/src/diagrams/er/parser/erDiagram.jison |  2 +-
 .../src/diagrams/er/parser/erDiagram.spec.js       |  9 +++++----
 3 files changed, 20 insertions(+), 5 deletions(-)

diff --git a/demos/er.html b/demos/er.html
index 06fbf020e..a326185de 100644
--- a/demos/er.html
+++ b/demos/er.html
@@ -57,6 +57,20 @@ erDiagram
         number final_price
       }
     </pre>
+    <hr />
+
+    <pre class="mermaid">
+    erDiagram
+      "HOSPITAL" {
+        int id PK
+        int doctor_id FK
+        string address UK
+        string name
+        string phone_number
+        string fax_number
+      }
+    </pre>
+    <hr />
 
     <script src="./mermaid.js"></script>
     <script type="module">
diff --git a/packages/mermaid/src/diagrams/er/parser/erDiagram.jison b/packages/mermaid/src/diagrams/er/parser/erDiagram.jison
index f0411fd72..1cd1d62a0 100644
--- a/packages/mermaid/src/diagrams/er/parser/erDiagram.jison
+++ b/packages/mermaid/src/diagrams/er/parser/erDiagram.jison
@@ -29,7 +29,7 @@ accDescr\s*"{"\s*                                { this.begin("acc_descr_multili
 "erDiagram"                     return 'ER_DIAGRAM';
 "{"                             { this.begin("block"); return 'BLOCK_START'; }
 <block>\s+                      /* skip whitespace in block */
-<block>\b((?:PK)|(?:FK))\b      return 'ATTRIBUTE_KEY'
+<block>\b((?:PK)|(?:FK)|(?:UK))\b      return 'ATTRIBUTE_KEY'
 <block>(.*?)[~](.*?)*[~]        return 'ATTRIBUTE_WORD';
 <block>[A-Za-z][A-Za-z0-9\-_\[\]]*  return 'ATTRIBUTE_WORD'
 <block>\"[^"]*\"                return 'COMMENT';
diff --git a/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js b/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
index 43bc13e6d..83ae3f7ac 100644
--- a/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
+++ b/packages/mermaid/src/diagrams/er/parser/erDiagram.spec.js
@@ -176,17 +176,18 @@ describe('when parsing ER diagram it...', function () {
     expect(entities[entity].attributes.length).toBe(1);
   });
 
-  it('should allow an entity with attribute starting with fk or pk and a comment', function () {
+  it('should allow an entity with attribute starting with fk, pk or uk and a comment', function () {
     const entity = 'BOOK';
     const attribute1 = 'int fk_title FK';
     const attribute2 = 'string pk_author PK';
-    const attribute3 = 'float pk_price PK "comment"';
+    const attribute3 = 'string uk_address UK';
+    const attribute4 = 'float pk_price PK "comment"';
 
     erDiagram.parser.parse(
-      `erDiagram\n${entity} {\n${attribute1} \n\n${attribute2}\n${attribute3}\n}`
+      `erDiagram\n${entity} {\n${attribute1} \n\n${attribute2}\n${attribute3}\n${attribute4}\n}`
     );
     const entities = erDb.getEntities();
-    expect(entities[entity].attributes.length).toBe(3);
+    expect(entities[entity].attributes.length).toBe(4);
   });
 
   it('should allow an entity with attribute that has a generic type', function () {

From c7f085a13835d010c6b38fec00fe5950543c2bf1 Mon Sep 17 00:00:00 2001
From: Tom PERRILLAT-COLLOMB <tom.perrillat-collomb@protonmail.com>
Date: Thu, 15 Dec 2022 19:03:00 +0000
Subject: [PATCH 110/129] doc(er): add documentation on UK constraint

---
 docs/syntax/entityRelationshipDiagram.md                    | 6 +++---
 .../mermaid/src/docs/syntax/entityRelationshipDiagram.md    | 4 ++--
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/docs/syntax/entityRelationshipDiagram.md b/docs/syntax/entityRelationshipDiagram.md
index 9b938bc36..5c7c18bcf 100644
--- a/docs/syntax/entityRelationshipDiagram.md
+++ b/docs/syntax/entityRelationshipDiagram.md
@@ -234,14 +234,14 @@ The `type` and `name` values must begin with an alphabetic character and may con
 
 #### Attribute Keys and Comments
 
-Attributes may also have a `key` or comment defined. Keys can be "PK" or "FK", for Primary Key or Foreign Key. And a `comment` is defined by double quotes at the end of an attribute. Comments themselves cannot have double-quote characters in them.
+Attributes may also have a `key` or comment defined. Keys can be "PK", "FK" or "UK", for Primary Key, Foreign Key or Unique Key. And a `comment` is defined by double quotes at the end of an attribute. Comments themselves cannot have double-quote characters in them.
 
 ```mermaid-example
 erDiagram
     CAR ||--o{ NAMED-DRIVER : allows
     CAR {
         string allowedDriver FK "The license of the allowed driver"
-        string registrationNumber
+        string registrationNumber UK
         string make
         string model
     }
@@ -260,7 +260,7 @@ erDiagram
     CAR ||--o{ NAMED-DRIVER : allows
     CAR {
         string allowedDriver FK "The license of the allowed driver"
-        string registrationNumber
+        string registrationNumber UK
         string make
         string model
     }
diff --git a/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md b/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md
index c666877c5..7abe0319f 100644
--- a/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md
+++ b/packages/mermaid/src/docs/syntax/entityRelationshipDiagram.md
@@ -164,14 +164,14 @@ The `type` and `name` values must begin with an alphabetic character and may con
 
 #### Attribute Keys and Comments
 
-Attributes may also have a `key` or comment defined. Keys can be "PK" or "FK", for Primary Key or Foreign Key. And a `comment` is defined by double quotes at the end of an attribute. Comments themselves cannot have double-quote characters in them.
+Attributes may also have a `key` or comment defined. Keys can be "PK", "FK" or "UK", for Primary Key, Foreign Key or Unique Key. And a `comment` is defined by double quotes at the end of an attribute. Comments themselves cannot have double-quote characters in them.
 
 ```mermaid-example
 erDiagram
     CAR ||--o{ NAMED-DRIVER : allows
     CAR {
         string allowedDriver FK "The license of the allowed driver"
-        string registrationNumber
+        string registrationNumber UK
         string make
         string model
     }

From ec026eaf8230d9f97fe4004f8ef0d294ca16a098 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Fri, 16 Dec 2022 00:37:37 +0530
Subject: [PATCH 111/129] Fix book link

---
 README.md                  | 2 +-
 packages/mermaid/README.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 059940a02..9a500283c 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ English | [简体中文](./README.zh-CN.md)
 
 **Thanks to all involved, people committing pull requests, people answering questions! 🙏**
 
-<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
+<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/intro/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
 
 ## About
 
diff --git a/packages/mermaid/README.md b/packages/mermaid/README.md
index 91c2d1640..e6c7db608 100644
--- a/packages/mermaid/README.md
+++ b/packages/mermaid/README.md
@@ -10,7 +10,7 @@ English | [简体中文](./README.zh-CN.md)
 
 **Thanks to all involved, people committing pull requests, people answering questions! 🙏**
 
-<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
+<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/intro/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
 
 ## About
 

From d6ddf9568ef3ac93e23c546cb59168e0a38feb84 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Fri, 16 Dec 2022 00:49:35 +0530
Subject: [PATCH 112/129] Fix theming doc

---
 docs/book/class.png                         | Bin 0 -> 34954 bytes
 docs/book/cover.jpg                         | Bin 0 -> 17803 bytes
 docs/book/er.png                            | Bin 0 -> 13419 bytes
 docs/book/flowchart.png                     | Bin 0 -> 14794 bytes
 docs/book/gantt.png                         | Bin 0 -> 43239 bytes
 docs/book/index.html                        | 340 ++++++++++++++++++++
 docs/book/sequence-diagram.png              | Bin 0 -> 19823 bytes
 docs/book/state.png                         | Bin 0 -> 15574 bytes
 docs/config/theming.md                      |   6 -
 packages/mermaid/src/docs/config/theming.md |   6 -
 10 files changed, 340 insertions(+), 12 deletions(-)
 create mode 100644 docs/book/class.png
 create mode 100644 docs/book/cover.jpg
 create mode 100644 docs/book/er.png
 create mode 100644 docs/book/flowchart.png
 create mode 100644 docs/book/gantt.png
 create mode 100644 docs/book/index.html
 create mode 100644 docs/book/sequence-diagram.png
 create mode 100644 docs/book/state.png

diff --git a/docs/book/class.png b/docs/book/class.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b2f663d86f967ca5d96c5fffca73b6e8efb3ad4
GIT binary patch
literal 34954
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
Lk}Q`n`TTzYoi0Wu

literal 0
HcmV?d00001

diff --git a/docs/book/cover.jpg b/docs/book/cover.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..24f8b13bfb3098917e0f4caed06470b9ed0f8b32
GIT binary patch
literal 17803
zcmc(`1yo$k)*#wI1C6^|)3^qAcXx*n+#xsw3+^7=-Q6|8-6aHv;1U7^2#`Rg$@ky;
z-&t>Ftv7G2S+BdgWLxdCYj;(hed_%A@@EHtsURaS1Au`60AQeBz@K$MC;$lw8H5Z%
zK|w-6MnOSA$3#U&LBk=y!^FkF$Hqp-$Hu_Lz`(`ECB(tUB?1$Z6A>~|l2YT4l5s#d
z8F^_SY%mB=Ml^I3R8(|yR5VO<GF&uN2reE0Iyr~{6%!v5ivR@^2Nwm42#Xwv2o(e&
zB*VoZ!$d>Hz{f<v#iPO}{4)T+0>RwCq{6{K0I*mva9A*Zh5+0zD#E|0`tJ`691tD>
z5f%gkg~GjL|Ng+jz#+f`5&x_KP~l(zu$XX|P}J<A#y9`RD*LJlsbvjFRnAvNhDL7O
z@k*{zZrYThqD*MMhew-IR^kmQSx8yRl3La@V`OON#{Dv^%>k|8;T{p*T`J24`}ZjL
z3ne8>CjYu@saiPqk<ZA614Lz{1jD*e*0M7I%jmE(QX*9g5~X6rsBtL4p+hBDU?l|@
zBCIhVLIV$m+b2ddPlyyP4N{Z|J4~#ceX<K%ngu&Ulmaczv6&=06(*9Bf;eSHQY5rs
zh?1j%@MFlLsFaF)DpgYHqvWczVlAgo<r}{rRe0sM#^_YErv6$i>lC;#-N+koZjF;z
z8DqwA6<f{s(QqZ>h8Bha8!01WN^VF_j)qMs)Iyf>c-Qv6>AXvEO~<k7BggWyKOw#$
zUI#(S*1@ws@miZTXJGCJ*kRl)hvB63Av1OV9DSAXdMWRWkE=YY{Fyo8g6tZ-z5KB?
zU#o|<dwipS!PGfo)YwQVSjnUj#g+5*lC3AOS8r$%K0R<bbUpdiXJ3D@>)wjFb6E3u
zon`&{2hR7y*m&B<GMBiYiu}#^r%M6eOKr7=mN(TzAF3(1%zKWmn02}`=UEK>=iA$2
zrR|#Wzr6ln@XO`27jdzk<~xB0N|6~3s#K8%5-^xUGV#VkfV<+Z7i>)ZGxAbPnV*wB
zQ;u4}lv=7ZR0$${&?vAsTXLSyN&Rp~i!CKL6y7qF*F?B<Hc@-QHC5ySP83VohZ^P7
z-Cq5hk635iPpPwyvZG^Oy}m_f@#1HnuZ|t(4QumyeQLh7+s+>qw5p26<}LOXp1<qS
zovqiq%J>oxtCIBTnAn;-VPdhzRM_cJ<lKis2L>rhj0PgkRIQ&mp&a&HiIgbyV*L}l
z6sEav0_=k9$rGlv0iyXewgON2<HaVMomTpSj%l5yQ9pXzn77vr19;&ai+HEs8?DoN
zlDu{rHF7eDXL|ccv`Kr|)08n4&qL=lclTPSOtw7H9_lI(4XEGX*-8>whCN3iMS;fR
zB^Q=zYQOn9g<ps9uhVz7$(CoQ%=unrrsxjM>lCFd-9*!84cKW8rPAQ$mGjN$8Q#y=
zU7X<^*>g13bH3KdQ82R;r%r}Sg)KD>F|yQ2&$3|WhkCKm-P+-L`!Nk##*FshmR~+M
zON>gj_qg_muZkOvEwh!q2@X+quV)(_!`F4voRuEYtT!8G!de!rYylZxzPT8iakhDK
z*%OiE=+^A<5(;>an6YP)EgqZWV9Qam(<ApOy{gH`sUH25=Sr1$)A_A+`qSGvsccJv
zk7g{XtT<Nnikye`56U!#vC7$N#RHEy$~DUd$+b%MZQ5B`oH~cJ!|!CuqFV(rEQIYw
z_`SR`ioIeg!^JO-jG4F24q2?%*>^RH@z1i|rBd-Y_^KmwF2DA&`o48}yZ&ppok*a=
z=Hd36N2`E=$G40grO!MlwJK%Sw#9YcnXAXUHiw>72Fvc}Np%aE8_e9RmD8{7?HzcD
zo6MOqm-I(A-_}fx3=4d1Y+N@@B@xt<`bHq&q13LoQgu3_(}o*+RD(kJg)Ps|Nbb=i
z*b|-(>%<oSC;n6WM-rFxsgv&?ROWTnJ0fQ-JdhdIYS?0&L_CmINTku;HIw)&b9jtQ
z)($;+qje-f9iNsaP%0eiVl#A1QJJv|xys(yDN0IXV(i(ZvZW=48-||Gzhef>+yH$L
zNhno=9Ib>nrRK|Q)Ib9mFo_}xRPAXaFPSm$dt3}fmHRKgwez)E>kGL@26lR&0u7j!
zXoV7-iA0OT&aO@wC}E}toyK4?lX3Wodkx3y=&!!7%)em>?OBQ0t)v9R?tB$i9?WvD
zO1*LJT=OuVT)g28LW+{3Vdqa&Fw+1b4~1fQk4DtfC*{!6)L=)Qijt^qdZxc>5L(~i
zd^P_Oq{x}nIdIUbEKUftM#MUGeE#kGQ0Go|d$Wy}7dG>YLUHaf85=1n6IezAy^PN=
z7$UKrv1s{{d*+fK*RzNNNJ^?nF-E=jgh?HRu?PMD(i<K)*wem#*xNqN^NZcp$RsM`
zr6~vG?Ckame_9^K$Tq<VnrX9+(meNTuKiVmSl)m`#Q{=M1boI-Qq-f{_S)&D`w-v7
zw}YbCCLV}J=lON3tw!(sqdW+K;0|cD#B^dcigt2i`om%5enNv88zM|}*fr|9^e9@K
zEBx-*Yl4msNNu8Mq@=7Qm#9FU`?K)(A3*1ix}2!PCIB2o8byk3>84-M-AQ7i2`72e
zmjpM#50gQ+K4K4TF!;KIxD$J-IIyFcx9x?^k-WJiHCq%a7Hnv?jN&hYh&1LNph<xs
z`1`WAynj~F(CB`}e6&lK=9Eim=+_^BfSCpo>I5`fLxefKWxqZL0OiU}KZFo|Y$Du<
z{xN>}G^la>)9t{(_zBh$ITPu{rctP{0&R;Gj=x!tcZB}{qI|lp7TmWv{w)c6$KSX_
zL^%+;n5s38#~M726&Bv`t{RE2xT9xX(&uacmv{ADuPl2`sTc-t?f2Se_%Bw(5AMIL
zXqng<NrH0!Ed&sSThpXwZcSxo!o^y9wlIsCms{-KISlbfk{d8n18J3a*tpMHAFXc;
zmR~2B8#f73#1bY3&R~NH*JR;NZz-=G{#o*2SuSMQKZK|*_<YKj9-^y0>BZ-+jJmmv
zoO-+vi2pgE=j}^s*z9Z^A?N-Fz#I;B;lxCh1wIPHN{kOC|A+uUm2u=?Gr1*CeS5nX
zd7jI-_kAb<Kd|rW+obCGv)Zlum>e}HHX+cFD(Lnx@qy=GY%itIV{8YtCz@{ULra<>
z(b;ikR0jeaJ0(Q31s(45spP@he-gt|dygFG+Xx()CMfE{|JdaI12B|j&K)(r4e;}w
zdh#iuvn55WU5c1&fx{A;WvN3FOVMPkbszM1tBX{i{<kC;Y?e!3DnGXxL<=8*cfP*w
ze6NdN!&KV8mUB7#SjBI2D?WVvTF;enQ_q$Vy@nrtR+qHCN-FT*`~U<l6<3Ld|8D<R
z4JHmJTh&VJ{{hDj!GLbVI4}XQFtBilKv-B9AlwTPv<1KdV&h<fDcRULBp{q(;<##5
z>eTRDk}gsjn$SHMbb|(f0m0HV6L)K`)h&Bgx4y3Wrfc{AuE7l@H(H+lU!(>9MK6j~
z*`LZA?=2}dd0n1T-n(y(-l;$R3;fOt&qcqQ+p1=ynYa_0>DW!{hZ*@*JfC#O-ws<<
z=Z8TNQ%n)V2^R@2>sfUH+S69|E>DXTn%Xm8zAoWW6Pw*~0GS*s;wW#Pg@3uW`ITu!
z=|SX4^@m)V4$R6*B#9a;68T(hu}Va80lsqJFP|mLE1R@HjY-W3uRE*ucA&~_tw&w3
zn7!ZNR%pZ_FN?81`5fy&qL4oyCe|w;oYD7<KIU3lsj&^xC!M8Z;1Rq%GEZg_C>>!v
z1|jlTF@I!h42$P=qKCMN=$pj~^3{CWJJm^1C^p0_zt^&n&ZfcCN;JiK=E_Xw9y6AW
zbG44Ke7J%dpzW(ytr@d5wTgJMAQ7I6)cj0Adc`WaFoQd;i&vshr7h@p^*qx<da1>7
zs(#TT0j;!=Mk}@42Wxs=9x4lm1oD(%Jk58&zONyP)#%0934^TyHM_4ZEp$Q{rrxkQ
zF)P!2B3D<mHNjdmpjU7Te||`UcG`Xt)Cw111RaHM-RAb^jl%rXILv0Mp%{#!T~2qK
zHuWK|lVqPc^DH<@?E2djpJ#*<<r*8Ak2upvFW<4hXnkZbgSWuQPBFGv&^Km=7=oow
z83dD59IY2K946(ry4g@jq{FxS+wY<}JeRfdz6pmoay(llV;6FxDUA>!V46hshKv2Q
zw=x?6U112&VF}wXQO|%{L4mDN@>@L<Lx^1JMY&E;&lnT__Uypb{^uIb_aEHYCZo88
zVl(xan+4d7D1N6ny1lu_3u%*QLXh3pazNl8RzaRx(YEa8aiFkB4L$>x>7Z&&A@5>h
z62`<*^w=Ez4queP*`zVGqS}FTyob8ix-0LZ-_o^}*{I%$?ZTLP2$H4k8}=AH2&*P5
zqdbB->Ilg}t<~H@MVXCuV6-I85$bRWhuTPQuX1#1v4xG5jU=G%bT$2l!P0%Y`^5ZL
z4jDC*r#<ORIxEd+d!GOh&sM@kes48f&9d8-^8&L5zLoFT6sI4Xm-(;qpA^n4OKlsq
z0|{{EjoKNj`U=^^fJ8a%DQ^dG;43j~2N0u!%_R?GXT1s1aWN-AfY@m0ixomGbiD+S
zjXj?{jc&xRX}p18Gm7Dc!L6!Q;80pysF6?MnI~#lhMODMJJVBpaj6S?!f0oT>0MMv
zP#WFf2@^$5;)GzJ&RA*opJEO5%CU|e_A6$M^*B_08d1MKU~c%iP~`)oO-g^j<T9(-
zCffDh<tJXIulCcs?Rvv@WaiNdFN8f#mr^TD59Xmm$_$d&>5<1|gJse%xlcdEHw>ED
zPiwR`6+6$|99jtD0o{3>S<Ro2J6o$c;V0m_Vo+ywd0G)5^#R^{O)s+l0HjEM9p0=`
zY>IaLitMbje?_s^Y;c1u(QnUmRp{!#@reZ9jL*^sv>Is7U9ZCxIb+Xog*;lC72R-_
ztkBqcI&B|YYrjy;ORU8l8d#$ombFsHUG{Y~i=(Qg+Igfnf#cAjcBHSNn*Aj40HMaw
z2Xs`LV9+Sc?C3KQu<Gcz44q`4hEysgBJ{x;<}5tPgKqZwP=Hhq@F<q*2G#B@4oK?a
zsbZ)`7DSeoHhtQbH{8aYcAmN&`h-4d%_GPf<KK)=O>d>lwSh-OY0a<jE1t>?X2N%<
zN`EA3E-YvIBQ!JYN+%C#uz?B=HMHiE9DSzBIjTBtwC5OV1~octS5w2qb(O;FdKC_6
zhq4<58=e+_CG<#lo&N!JHU8@D(vCM;mq<n`wKCogTZkaL5aunshWd^xdlo-{?4me0
zSQa{y@<mR&bZ6l++L?{;)rl=Ob~Tz@ThBZEc2B3go_TA%l-;(COLD#Y!sxGJV5YbE
z(VO=`@<8=M^i)7?Z#-fmf8+g9h?A0t*7M$Tj*Pofw$^$QMyeSly$9lnX;>LIvmM)1
zOsneW-y&K9E<@twr>gVP;aLhwq)fy2=y7XaTH8JpjARH?G8A-mqOpA0aLx|z2>sYp
zjk5Et-AOJ64<rlLBL@vvFh;avaFCmGVDDoQf8MJ-<=~2{1}A!APB<(FNAFLpLq!EO
zZbnQ*h<A#R@YcPG2~3`v&t0XGm(H@u!f%Xnl?d_loP^806-<0kJLa_tviwTOkyC%!
z&nU?#M;*&?F-|;@sRvzNxKlL~%g-D{w9^;RZ<0!?t<!iTS3i>DI}$V=%shU;-w*Lm
ze9*Xy1{0rjiJ4kuqmK`ZkmKN_-|z45(Trshq@bNrFdEOdl;3vq5Q<iDIy-EmU_`S&
zS^%+JdYNOet(b?uG`j{hRtQ!4%Ip#pfi{!5QuIs1zMfqcC(9)iF&ioO|D;ZW7|l}0
zF}?20cq3pu-=n3gJo_sh<p5(dVL&%Ykbs2#B3@Z<FnXlS=GDx=!@^y>xayg!Tyc7r
zo<&UkU_Zr9+bB_D^vU#JoH`U|#Mn-l!I90|-{;A*8m^z?=KRsUw>U%dac!cG`Px+9
zd-#%#e11I^e~8?PU?#oAE!s&Q*VRitB3UHo9C9#Nx8e2aue5|f&Bt|WEO`w{X8(64
zRwnc)0G_?xtAB8zYTA+OwB&Rr)EuKLAA*$@jy6U}zVdgxT*MVKedP<T5}e9=|G^X)
zRD{yW-*fTqALPV)9YJ!!lGA%zg7)w68>FJw9~b-O>q_$eYU7uU%wS}j#{1om?hk-R
zSLHVs(Tvx|aGM;4Aj*;AnuwLUw6f(V&kOGFVDW!6neUtkoj043Kiu^@@s&NE7NXyr
z4*dg|FU<70zI?g#o6qH8B%KW*{S7}@T*$os!fvItZXKv)i%s^)YH=r5++Jjh8ja(4
zIFQm6o8%7{<ofK^ac=s`9CB!)6XnQ9Y4@K+Qt*(GrOt<~XizQckl^U2u$mchkWrg8
zgm8?lb(HBH4pW9skaMg`^f;)fjp<dOh9-Uzc~5LS-x+tyg{3iYgl%G;^9N9NfN6Uw
zXNEQM>BKTc5^-OO-cSZji_QM4yD*V+xOeQELz`W;D`qAZX^MO79&c0f9sy^<MSLA0
zBB>$VgrnI##WmhO^~LZ>6oVQ>MQFworoJ%gI|p!o_;J5*m$0e|r4Y3gjYHBy(P{qt
zfBCz}9`Fgemt??#?j_-1;h|Bz{|er{>?MI%nAkYby(9-bE;}ce7)0FU?-mjk1_lJs
zdR=XZ-A3b}@Flg;-t6;mZ49)@;$ZNl^`B;xA^v|hV|4v#KOlY0Uwrp-T>f80*3M@p
zM-v_Rf083!TZ6AxzF$hn?^3hatMD({A@ruoTz1Y%70A)@+E;Odl(rl68~Ul@R`TYq
z5@~QmtT57xh0}QFTmIJ?-esZW9K@20^e7G&UKjG%!e@|?JuC4fT==a`KBb{>bw0kh
z$`UUQ!qB==#+rj-Zo6xC$0HvixuDF{X6bj|MIIQ0G>z`?miw7zWNczx|B;#QG-0;x
zAtGf;ovUeylKN%V_!u62>k@6%J`lO8XI`Ep%{Q<F+{`b_-Nl_|uC6>pbdD9TIQvmS
z6?blEn&(haqLPopP;L@Vtt|kzK$(Ou1`RIX(>{#Zl8g_B@DNxsKQ>D$FJ!a4k|4tJ
zH3{Xz7b@bHo-wYoV9{+7MeM;IkS2kXBz>ZhY)rWY9RwG>^Q5>}f0dPyfseFV4Mtw2
z(}2aSL5f#Wk5@pVm8&B;svG_KwkWQn6_gkHHYZJ%I+4mRSnh~Q!1%A7vR7zqy3kuY
zJZjI3q{!?c9WlvFt~&d*1F?}Ds#pTi8%!}2;xbx9bcOdE;69o;i`>D(82W<#25GFU
zo?rVVSIVejhha@-p-j(V&bT@GP8`b2AP~4Ogf^@Lm1&)Y5C)!pokj?GIL_Cy*rC@(
zj7_Jv>HW4t>bI3TC1h9n^;&9iy|(sVy5tYTTsDf>HvI|lFq9mWg9wEV&Nh;<$al-6
zz6gR+)>*%96rsK{Cd=~kIIYmbd#V0P)w8ilrbU+K1(3T7jejN6TYR5&POLL9T+NFZ
zD{zIG4{zTtdJW0kH5o@e;W+Ts5c+)0LD}8G)!vSx^D~C`ffqZI+H)R3Uu-GX*8h=a
zncCfC9DYrKCvW=T6CQ6}U@AC{*=(EMNrLO+6ZZA{d7YozNW503ll;jnV$2dT-avYS
zl-T8;$LU!p?J=-LxwJ$oL!TQJm-81(-yp!tYo1(<wv5ldf3!T(VU%Ph*x9uLk{36+
zvvakc)PB}Fy2V(0WyO?fcAB^~Obc_A+pfq^4Hwn<BzZHr9)73Sz(_Jy+DH0<Pi}Ks
z&wns~NmQx#OT87eqmN;aWUuOY+mY-S(^;t89wScDKjBR^ddr`pk7?Ojl79(**9#T$
z+r=jo2+w%B$1n-i;aO}7UHjG1o0MBF5nDHu`;!+~XqMKMs(Oy!%x_y_)!*--e}8H$
z01O-)@INB=&`>=V93}@gn2nuMOdO*A&p#hZ00IES3?u>z=#gPxGWZ0To>Urntt*f_
z-^^gcMQMoIvECz{2QzVm#OS<WrOA>2{^!+D)Tl;p=`o^4`pO+BZ278<KNKYpbHJ}a
zEYUq5Weiz$=-mmFl)SU`g>l(PCZpmH0G9L~#vW7Q)$^J3HVim8O0rJUPLCTstmSz>
zT+GK!9+gQx7^h?a{G6V&FCP3c+h53Pslg7hucb&js^ud0@DSP}L&5Kmhi@(w|7LqB
z!NMf3riDjtDG_h*BBz7_Kb0q6CJjxp(8fR_3`Qah8TV}}qgJJ+&kH(6-EN^!B8)r^
zs*>btX^5sA3(!ZrxhoA#>7A`uFtyuI!Mu4}8d}3UTk+iiSq6}^Mt?gngt8v}hTO!d
zG{m#5d~j+HY6_ALp-_+zM=Od@Ui*B1_W|M`fVZr;=;0$DZzy(opgYdvwk*QcEZj@+
z$U@=p91g|g!7h5`3m)%mD>W2%#iQLS^Q72PgvFDs#iQM!82EDOWpK6d{vA94Oz4e2
z5Dth09YGlQzi|NQ;9*m;i>sSrg4x92ARH2E8ZJToIE9T=N%Nd$!Ml>K$xUCc{wp4U
zBnnG=oT5O39VJzyPXB*Y$<4ga3!ux7I{NzV-<90a)-K$;Mfk}0qt4e<^5bf&G7bu{
z_sI<#7m;y!2kvonG!n0xFk5)MLRHpXJ9DS*_##^XSU=|pl-5VB-?w<GWtZ!4BaN8Z
zC204S(_xzf&9Mkme(*5CG=I|22FDpu;rhbT=PiMABy&yhYymmeznDV(H4CP=Wvuqb
z54|{76Lp+JbrmQ#!zbR6cF9asjLb1fG07ay-?_Re+rYMfHP=}|Tk8z_t|!2v7A?nM
zXHF0g@{bXuJ`Hquq7VWFk=$GD<<~?;gK|ZrN5-Ui)<Zu8JJziT_LAUc4!xWN)>$vW
zv7RRlGK_&g^mDf^^+#7tma}m93K<B&*#s!K!V1{^JYVWvvvH#9z=ecNC}qE@;!=x>
z&E8wA$~7Lk31-%v_Eh)c<!HhMy(SUc9IG*F<TCD-)*iy->bkC58bQjn`r5#D$SIh}
zgl98sQW3hRz2p=L$J0ld1(>R;kdHPuauf4t6eCKiGPjz>@Q5BaHp_yU&7AsyABq=6
z?PhHLuyOJ2yQkM>SD&mC&t^y0MPzE2!mvqo(?)&9vlq}&T5<u@E>S0FT$M|SpplJ3
z$P5Z5qU7}5m92w}?R2N#>Vs%A!tXxFXUJGujX2jxkexE|?0Tx2*mSqW+Z8VPaY|NF
zYg5h70@-nJDL)5~m8Gjj|G=!&bIpVH%{HwSKU+7r+QeJM%`5X$OQvE4_pQ54g0^0<
zJ(W*x_~}aUt<24xERugxYieB_maMk@HI(m4l>PSwk%6F!dO!ss2`;Mg2UVTZ%CdB2
z8m`Y{_@i8?oMH>7Y(E%>;S>vO-O(Jf&ga;s;ZPM2hzcZ4l(wRGf`F*f0|>Ckcyf_p
zgjpx>a-fPpC0JniMu8d)Tovv#Y)~*rlUq7o@ENKk$4J5MMGnODtu}LAAaC})3T^<A
zT@0;#R8*XL%Ey`4VEFi$c$+>YdC+HT3X6v-C0C6*OYn&3fQRAxi)9g*+8{d!WlLO9
zE_ws|G|5fwTdCb;7p@7U&n~PtQksv>y;o8)&7<Fdwl}3B4XTC5`>3BWRT4WQArP7~
zQWGxef@JGIfMq`Qu;e}BaxWCqTFv_TNiy|>lgaP64)^&|50Xe3R`o=3&r2tc41A%E
zL`irQ?x%`CDOoE5jp5EBMv>#F0&^7BsiL=*@js!X+PHbAwQ8!|yIv&AZSMb#016V+
z3NA%FMWrvqnvV=PrO;}5-wH5+R6R6Y7tEbLQ5Lm`oHnooJ>xdD4rrsV=*~;1KD=K`
zKVDG1DZKegb0bM!+_FFpQ}lyk<{oin;0EefS1eGueu~nEqWOpoY`e!*qguy)#BswD
zeVP$Pjd<F}e*ol&%TAWke*kfr&Nu5{hAbyHR@Dyrx~eaUoQ?(-T{jQklXi<!zacEo
z_gL`%ke73_vyY<E%~tH?x_i>SHr#prWx0EBQ}52GsqT9@hVn)AkJ)7qxyIK*^WJl>
z#>(B}rmZ{IHuM8Q^iMc*&NupRBf~yhZ>O}oY_KkVB2~sWA{Lws#uUmm3>w#Z`wQM}
zXx?(*Bf7Q|`u=PiN`;qy@E-uy@Zy2xV8xre_s9_+TtJA7vS_($S1k|vE^iOD-)6XG
zkY&X4<TJ5~YVC*eGv6J(kdJ}t8YanQg*&d?AM{-%KALn*Pq|#xZFF?`)pV*<H-n_C
z_%dpE4qj*{Jyas0O&#kaH<*|9l*j7~3Db=2&ZduonJ@fq5{PVFdlwa6qJ2)LBT$MN
zfchOhW;Y?~Pv50I+v}#IPmX6i&pnPJI>v~>oiC6}nFOuxX4$`7xE}Pq1;wR8X>Y{h
z5%QT{AtUES4s%_cKuHe6@XKK{{1YMDOe~XOF=pG^F=h&Ga`VD1y_%~qK1DRMz&jaS
zRSOqSq<NS|EBSA}J`R*>ISa1QZc49!yI9USNCa?wt{dNPf<<B;$w+;4etq$!f6kX@
z`U5zL_I7^sw<SUN1Gok8PoI%$0x=}9xq}nt>^DV+bj?pp-&#H)DY<5Ae@V;qrB6@W
z*gejEEOTn(RRsopMt%EiM+Wv=B=lH6EnMIV4k!^Al)Xo&X1PR|mx6^QaspstiFqSb
zzrtR&{Ay64u28B`sa2)TnEHQKX?O$O%`ie2L^v2A%D--9UXD~?{ap?VU)DpHpvM0B
z%c~@{-G2qdMJY!GHgva{zNh|NS%2f`-+K4ID{TEs@6s2bB!3HWfA|}Mr8m&x7FwwL
zOaCtlA`a?>YL2rf)=`g4kLPsruIa8n0L8{ltIhYNUoM)RJ}sPk>9@cB5c8QfDxDR0
z&aFWf>@gW49+~r2IR1?1tY)E)%jxZg@m-(+SRuj#O8oORI($V~kWj~WFvu8$Y1`>3
zSeRg@&XYNc-VbEJ{GrBvmAzfDS)g5@6#NiKdf_fv3Rn`u-yf3c=f;xOSV<Evfgc=+
zaBRX<o`Cm(m;1;`2C!)_8JatP#a<eV37;w;jywS@+x>FUd;6FvaDww2mWIuQx}qZ$
zQ+%gJ#$*|C#g5B(T(Vd?iw6{=>?DTQ>XeIxfm@;*HPJ=JoLvFZ>LL%_<0j|!lgZnP
zYZhxn7NH|juS<qV$5(%WZE<nAZ=ler)L}4-bU}ZoelFK~gUMW7#T9~=0^(Zt6s-3T
zC_#6kg78Hloxl#z?jOLvGL>>)k9HRXsV2dhHsdiC%Uu`iLFQr!!Vqj^f<osr6er$+
z+r;}(<&i#W6@b0(DW%SL>AQ8%tCFl4ql&H(Ds?g@uok{vK)``%GX1kj!906Z@HR5{
zl9|D=tZDEH&3(k5j@Ry9x}I)bw^)aOd7MT)zSl2<VM~<(uo8Fkyf^{L8L<s}#Ua-l
zWFfDi<M?ysl$ai~nF+@VWFCyW`YBHQyk08o!n816%vv1iyyJv#ZT{DUfqW>F5QRbs
z;`7E_1n~BL=-N);lOB`1)Uu70xw?iDJ64D^eU&6{MFkh--tjwROCL(+aAftU1JFUy
zTU__Iu%KdtepKf<zEzQ!0c^c80#WA;!Vu+%zbd$0suMfNo}xh}lBVk{1Brv}l$4{l
ziW?W-gQ^`FhH9jgH&?NM#3ORBPPC0%6>Lf9rapWSf<;P_*ojZ5kYLyX{c^RyeM~C8
z;<%lZ51Tteyy)uES)1`^+ixn-fSAL`9Syki1o2~@5nNkA&1^~sW^uR%z>Z_q*yOjb
zifqIuqLjIC!})6XtZrf1ZSe>w4U(k_A$>k;xM2ypW=?^tbcD*4Z!2WELn;zJoMvXL
z>`mBv3KqdE-pS0U3&PPcdg-ouu!4&<YDjWnTEOCk8(AUB#!%zGwZr5l+>6id-ZTi!
zDyWM(@G->*fWwoZ6EkrxCd89CC@GYRQWQ=vTV&{&4ge#8k(2vjxG-VCWFT^-)iIr5
zTF@8^Eqyh-J}Ndf>;lXNa{`OXU%7<1!PKOhP+0zGRyl#F4zmN}Q6i=c0KZaf&p8Ek
z?!8iIFqH|Nw2%Q)N|_$~;#gI3U(WdP;3&vEY+zN=e$e_f8}__4{sF9fE+dcC;OMPH
zR>rFS0|c;^UgCh^?7GIJQ0hZyDy0NZVtZKO&-NoFW^j%y9p!mZlU#A|IIAGY(V@ax
zl6mI#_l<P<lCAXiR{AC^;7m*qVNpjV(M)_4U|5^Gpl_L!aE5{W9MOz)bq=2^_8fkc
zx@Imd4{?=f;u$&wPwdmfkHUg6B~UVQLU6yLOGRGRGCo9-)Q}TyMUudE6I2|ihb%kE
zb(s4g5|T*-fEjVL=$XGpk#b9tEK5kh$ZTX5H*Wf_Z}%rbkYOT8?)o~HCF}m02(M3`
zPKAbmJ4{hvnF~>Z28X(KR|y*Wf}>7q0J{RSyXe4_HlV;j3Gx2we$pjiFw&tzLzoU~
zJR={hyEK`I7_7-Tj8r7^JZz4dU^{9#t{h+*p&mH6iYT34zCJd`o<$5xAbTt+55P;*
zQ*p@KXyWO<mkK>+AXVdssWOP_7$<!t0}%ff&lWqx>n9n7I~)^PWJQgGzvZkt4GW-@
z!bS+tEf_JAG>R0b>L!k@)zLVzl@trs2SicAmN0oFhDG)z%1Qai0i1=J%oqtbJdk4a
zx?c=k;p&38hEExENP^Zakxq$$$^sxBq7EUb3SWx$N(JQF*!_^@gP3TqT^@hOhC};G
zmz8EVm{B=R4hT~VCdFysH1wek7Xbj`ODsee*tOV}d)GlJv_orlX-(jxV1z!*fkI*a
zC?dT^M#3?9{7At<z+SobG&aoi*Q@Z@5GgV7S;|2AhN&=%q{mV#w3cZ5sz}+Cu295x
zNUaZ%SZLpuQ1$ukL)eE^q*VM+)SL_Y#yhUT=3l7k*$V)KfEWv9`M@19TGGDU;fo0D
znmUBnScrk0a25)MLvuvf=rjlS<7f0`efkEe-yR!5>!?Pev{eAJMeHBHE#6=Nl+Bpz
z1Uj#b{5jaO4NCUlyo~SeY9KtA&f8x@;SvFEVpzfbkU|Nt73TGs1W-k)UM(nk<3d2{
z&dQI@cCGCYi4GJdG}0UhHVBz%Z_fJJ-bzHs8CG*W6HF8KnFQ;c;Z!MOU25yQ_3rNc
z8jK^Ec2E_nZ)-!jQB+!c-V7*bkffkr3w=69s@Q!Vh=I)G*}^Lw*;b2<=lhlt^CM+F
zK5eSn`P|xO9P`+)q7ezgF|4?A#`#kYblmDr?)f2)qgQn(ncG3&4l%-`raL#|yPwxE
z)Vr97q<11S_FG%e@@VJKIV7p!FY0Q%F>sWO^->VSn%kdvOWsd34nATZGth>bp=?=^
z`zdFU7=RB@S8>&UPqB+TVz?Su7Ht0I<$NM+AlP~9H69XSt_-RjcW=&TIVKPXDyEZ^
z_nX{50Fn-@C6Xu@Nl38v7w6<aSadi?(+V#7Bj{7xDol^%J2!pG0{jcyAYom-f>&MH
z!%|_afqH6|`XYd{->+`6u!VPOsJ4*bgV_9-c}D^(6V?MN*_~LUOLA0d(odZ&?0ora
z5*HOH`IEHM5g1=bnlYlE9v9ylaL0{8CMARGpFKu#!R;7ar_pm(l*(2y#AK@0+{wg6
zCZHHX%$lGtzD{9<@zK88K`r+9C?vr_fkq_St(E5}UMwOrHaPaV+*zT~+Q{_^spu!q
zui}0wW>G|bX&KU$ZO)qPVx^Ddwo8un39jxP4tqTV^OWeR;c)@t0Vf)1f#KrqSEnsE
zxms&nt=1NU;bP&%H%{LOi(dz;#kpe8>joFRZl(&!Vlxs}nC!BHEseKpH-eX-n;`qi
zyRVbQ{=*=kV2BSK%S{@gmTKuTPGU3JWsfIEAEHx&DF&;BXP6PZ6D+RgB|2-5Z<rWV
z7>H`;>tead!xqfQ4V114(`rNM>=N<Hg`u;-;fslJtY$rFG_i~1#%D)I6IVePE7uY7
zdUM$9pzo!e30TIoBi<1%@}Xs**X!@NfDwN510uelDxoNKOlkL!LaU;zTRal8&i+zK
zN9OLbE#x+8alD0l!-b;Mo0Bz6G9@5P3jpCOO}hI=WC@iK*Tj{(!`#u=z9pd@v_{KK
zUI`2Q2n`coT;on}`#^wEEQo2y`_$F64Jzv!h$j<EFW0L!<vMsb&<XtmQimVGDb6M!
zMFlLsj{kb`9kmp$S`B4fv_Y-#FJzG~rIBAz5Grhu3p8JJyi9_ZB8-Gwo4^73)a+JG
z{X6u%RCmLjFpvxEb2}|JMZ>8hwS|K#bo#k7V)pZGpxCbs%3NWO@OG1xi8WwKpgG~W
zBJ0WT!gH!2M!hTzkylq%9ja32di~4H-Q_=mXZO1t#E+uO;IAcA=*wO&Y7Dr1(w;|$
z%r1Qc!dpcJYg2>9;Xu?O4PbL7kT?h51WSbGtTs*>EiVvNQLmUxMsEg$Aa0;;7UkBO
zwy|76Q}726N$(j1yP=PZkSrNbsVm-q&DVYjP*1Q-cV7Y<m^n`X79OSLPLfDE9gr-r
zSp%Ok#XW|Ws-hLyTlgy3z~Uz7#Yh{Kn2DK_x<C=eYrD6Jy8Fc7Ri{Z_ekx=inKWD9
z>PGe2wM*5NBBVcnAYXo{nTruU(HRQE2JC_xLeyZbI1xJ8I_QiLwe$j~03|?`-B&;`
zG60W05H>L~*?B22FcP2*R$!I`E=ODn=cK(}d^DbcTIuPPH8mkj!QhG>QBMu(mJY&O
zCOF>IpzMjh=>rq1>jutu|9>OOj$=??p3*R4Lc_AK03ZVFzaq7NZ)`BZ;_7UsF3@|L
zpd>N1!v4npzOlh%fHD-cq0XkiU%meR3*&iZ%fJ0UQt_7m|1O1W`TtE6Pl!Fg2>zAQ
zdw%`939YyPEB*YB3bg*eOh^AS{HVvCaA0M-=l=OZ^TGPE?Ze)$PSt&nuin-o*M6d2
zKYXr);G$-G@-a3sP@s{2z*o2Lbb~)7AFL^NNLBpz?*qOgex_<<+Muh>t@z|{y*EZz
zEX;pA%PQ1@p^e_#e+z5Nk4_ip!cQ&;Jz=+j&PXC5tUc84G^AVQGa=;MvO|KvB$Xu@
zwJTJ2kMmCCO?OBSxQ+cRnDM-s^eEExB=t7<rk7TJJ3an;`~oVG#CzK&`^6~!3qpPI
zkIk>1gdPdvWrv8akS&Q%uf#DEGOOu4>1=#H(8DIJlK^e;3)FaEZ=E2BV?8XEz1kTy
z31fl~JRF=lR&Ko={U7>FktqSn=8<D9kHX&gw(@J0odFb}uUBiTAHMJNUb!LtxS`Q#
z5Vn~F^0(cD1mVdQy<+ewrCvYah!7by?=WtFYb90re7W-t*wDw=+8AP$x(<Z5#?WCk
zf#2$nY{U9wcPLoT3W?WU&PwY_!{6j;<iZ|OS6rfJHUdlwtyOdOZo9=4L0B)Yn+9de
z#Z%$!hM!J5ctbE2v|x4XM~V<!J6{>v_uua|NM2vbx8&1pj|~IR>w<T(JiEAL)F()p
zonD=0197~y;5^GN9;ef`l)oWpE4~4;6Cr)^4BhB`twm*y+ku=ZqhVtSHjdF5_)TtC
z9ZE2=ksyN=lk&Sj5pR1fmKY9&Lxy%GZRk}stIT!#M=J!lseXlpcc&UCvKV&sDe}Q9
z1>sHjslo__foad%@{Tq3z`B8zq`@dFnal-t^Q7iM+6BM-_w>-PwYC@^c*40xt46D+
z3ZTGPN<(<P6RZi?l|9p}o!~s`fT>i$%LsujoGe<gf{zgH=-Gd<^#P3C-W2aZKTLDu
zSIa8+xjz7d75E~PeOd2UsI|Z@j#xg@avqr}wzG)B%fDurpkie}O7ZL2y0o*4#*|@E
zq)8sPMxjZ*yE`QrHWoB!wbRN+oJLb(N#Wsj=Bg11#R;15#`RG7@xy%T6zXQGpOO$)
zK|T@tV3>y#d{(kFrMksue0cb<fKalWP!yG8nz>T9-*Vn~iPufyzY<a=1@_m~H8w#*
z$VEw>pP5Y{F;R0P@JWUrmV?Lb(Z1l_hY0b1j3KN}f9D<=w%?f=_BJ3ET+Aig+qYVb
zw5frK1xC;|b?%xCz5ZlS8cAg>vf!8g9?V_fBcsQAz4#>k8Hs%B=sfNNY~Z(@koj|b
z4@{IGfq|x^9>XM)KY%+^pLJQ@m}&JxN>rNk+NQc#Tqf}wBF?J;2lf0`TD%mPkK?bN
z`yZR%@aXZ0DGR?vFuYD@mZ@>7F-ezo28QekO;m0fASPbE*!rt9B{tX4Z_-{FMvWl%
z{^}aIGCgEgv$#u7q_@>1mFQe7IZD4AKC$$r&aR`nE_y@{H9xxx1eu2l3z})!3Pr&+
zerYU1aP!$iip(KX8Q+lp84nuHB0r$*Ghc+P5La-}-^<*jVMU1<5FJ)o-$NK(%LZDm
zzd<g^pW$S1ipajcwfh6W6tEHT#1N=4Eur!;wpdYpzNbFh5nQ{O{Z;<KNx$$8Lzt)1
zk3+kbL=&~N@EC1zpbehTHYy{0F{Gmug8>T*rz3k;0^Yt6&iPBXbn+OH+Cz~ihNP0j
zPkh5UN8JL287!%>+|S9dca#^km~R^%g6RT_eD%~ZSalOUN8Irvq_{35$dwg##a6pG
zrriRj6f!Be+{p3XobRv4&YeZ%JXMj58Xjw2=47aU96pTn4B7<vV2`NZR`zaqpbFad
zL`pNXmk`-Oy1l-A7I1~T?QpB;q0g;blHkr{fYJJH@rn+&)t=EVQ@`S%P`ap5DxfQQ
z%zd~w)pCKgB}Jbap--CRCd@adbD2yDo`cKwo8~f8b>DC4HiS2w+ORG4a)Il~^eurN
z&h;EH2dJzyUAoc>N>8X4na$2iXy`YYBR@*VEK*fAEe|(8kb&d6eJwXV+A}V@F&DSv
zH>@IznCpq+QZ8ib9lzTigVGIOdBnh<imv0(5eqGrX@zQdMB>8FHE}bX=O!bH*EgTw
z!Dl<%N*N@-E0-Y8B(FD{dfHrAli{uLjG9QtQqi5@sXVj6DxDNG%Nt(>qk-d)LdNlU
z@)8&7UMmZ<zLr?4<yEOt!h74vv<tGI=juJBPxjmROkCv9{wsCMK+uPo9-=w!`<{(S
zEh4{TL`u8+LU3<!5LapyXk2#h_`9<35}sL7p2;s_gfC$V6Ctymd5(d{LgEszCfQUk
z9<|SkC6gkT>tvm;Hk|v~ChcQ1WVD8;eDv*cmg}6V2RnPE4lQrp!m!fBXmax_$5?#W
zue)}X13lR(R`ANiDv>-a4jQ%+GcK!umHi*Ivll4)VZlwSWxrDq4Gftm9;1Wh^sep;
zYPD-fZ$Ifb7Zr(8PmEqbLpfb#<9_4jV(3kQN&`H>->-;8oASk*Og$h;B;@1Vu#f`B
z>GHHc08K$UcTy@G?>G|Wj<apA9yz0T?4HSq94q?{bCB>1{r*^Vt+~}d00uqhU6!8;
zh17=HmZ^vC{b7sZ$XwwrQF%ekRYW<~LB*dnw0lfjj#-o}Q2Hbs6hlCopt|e^&GD3P
z_4@5Z1-nk#pVybOWDw3Tc7V8&-1yr-u7;9TR?u*-7GUjXm;-;1O)u-fYaDiN*F95I
zL7g291`E4_rrZ796By-5Ox)K6nNpK(MTE>~6$M}pMCmE1juPZnUFkc?G#g*M5kL`a
z0b4P*jN?ebja{N02Q!=S?%A4eMIe%uP|+YyH9X5(LPw!NWUg;&GZX1WC7od<$jQs6
zQ}92j7-BDq$b6jDrkM~0KQ=~5w-tEe@kmo&d|!R@o=(fw%v{41xw`6ru_lT%1v@;}
zx`$u8-%?wz3<LjrJAOl_jvqsz9CHkNxFwlfPp&!%m{Mzx&8q%&)VH9Rtl^z#4a{|C
zyiY`3Gb{~_8Fjg}p3waxzlPHkzGb^PLd{#sLd^NHxww7zXEnANg%$V#usG8vqq;T(
zoHgV=<oO8Rhu_7;DfW$vsR|c)Xb6S<X^e!|ScQXD=FoFuP1H6{zc6e1liFxWc3Gkw
z7CV%*@#D$IB*%5p`jyGnwUmsJA`upqf7pbG6Rmc(8r6MPABd8oA$@s5OG>{hi%gk%
zOSuv(5zpmJ#0WAwGn#%-33vZIM%n$v$wbVM8!aoZN#ghllzB<s^o`{rTb&qr@<Z8-
zW5*Cfd;KTc6xmvhw6~D>1ZPXJqU-3$CEcq04voM95*-AwE<hYO`?VSOS*EpsJaN{%
z;A3u9njF&e&b!E>$;@|ey$bN-Q;B~^4#u0009z7k*|LR%@5#_Rj?5BVHMQskcfE2M
zy8;BI0dfF(RDfNX)3JvaXSc&5XSIDxJumSN@_~MmxcDlkSQRmimll_zU8<yH-!mb1
zNjfQxDoOx>Wc_YVu8?Hn<YS`hj<?_+fVMjpi5#5d&f9@wuisvy4tlcBpV0Xb1<M^)
z8;`cMKSRo{X89MHU2Rvcw(%q#1hw@)G9k~N#!egAO{V?+HTh1;Vo0GRVcajSU6mS(
zc_q}_Ix-l!w6#|#XTtf3u+Nb=Oza)-y5V`AX*}fS+WOTm()G#9*JT3;C#eK38~S=!
zz{TH^fzxIz1~x1sdZ9D9aBKN+JTSJ)8TbTrAN~M1Ma;X$=uNOk92T1=dp^OhhegQk
zqTn=fa=Js`VS~>fZqUnwD~7$K@8d!}kJTNQeZ=OS`2#TNl3k*zdNT-Jmw-w?;K)(~
zx^s|GEGV{9k4&FvF|z5t9rzHh6alz|vZ3m9MAyEf!s7i9;ALTwa=Jx9xPLNQ%l_<S
zBl(KOxAGYq@k0{`{GMjQ=KVMQ>P&wQ!M|LcsIs%`8>pnvCvuA&ei|Noi*c$Lm+wc|
z@2^e;{mGq*1GCYnubH2a4`}jtX594C2==!-N8iZ|ua)ooFjdQIx=YEQhFqb`e&Db`
zpSFlhvvBp+fvrW*VK?jnO-D7Wo%)rd9o#>U=d8Gp5B`|YMcgDy*1uf@1<w-gi!(&7
zAFHCUVd8DVNW0zapjAK7mI>o{2Z%NYBdN$`T6j=}CwIbgKM3X~C3w8rM_|GzTsix6
znW$jtbNZci))m2}RWIkl)=FR#kg(bN2e2a~x>N$s!+!rfBi3+Zo!ot$Mkq+(!(H^O
zx(ZYjqUvj%=glcF`*i(LZK|+Tf9wcO`d(_K8a<+Srzczb>M3V6|DLw{Vc%UX!JPAP
zByb0Lo!mNVr{IF!BJSvYaU_-z$uxSX!RPZGHfPnc42w%+<$Y*h?%2uW;`U2sT!Z8C
zCEsN0y-%5Mq?(0P$(E?w$N@Ad6j2s;vrG2<yyGqT6stQ0g>Gy$=OfdpBa?t76r3qb
zfTQtqZt>N2|BW|ku8``Fj+;=z-$#A?UeKE!AvSuWX(mB-97`9ymD1JIbfn%P`4rrr
zK|-Foqn_I^(~?Hn<5y34^th~6WVsn(rhS^4<UIuxB3CWlzDS@;KOqFQ&8wpPj!Tsn
zU1!PQz<pdo8BY|mFv<#MTMZ~jsEo(fq9CgBK|*MRZc65n8gKM>J%O!=X!E_`#u&E@
z&$}FW<l~h14^8Z$+cW-h$sadI_g8@)eMhxz+Gp1QKiGGkP(?+fx)?5$3Rc&69OS??
zG#2g;RLom>35Ois0qsX-NFF7tQ!(^q%R{9?wqD<p>y{(-`u^dIjWHRrLfhUK$DDj6
zAJZ;K3mKaPEk0j~wW~8}E9FG(;;Tw9#r*+vY)AgRg8gsuiRNcmHjMAH?C&^9I71TF
z-v^s9p8s6C3j_cV0Q<a4yTK9sXxGpUwP^E0m|flvo^b3hH*n4XK*5}A*6a-iV1;MF
z@4fYn9TtYV{l1KUm&)YH4sitQ^$XCW1+NJ=-iM-*^G%jR+S{U^51ESPNR4T(?uT2d
z3FptL${{GLqxaYKUlOz#+ABBw>&z)x!$j}&etf4Jy?d__G8Y}xizNDG;ip^i%~$K8
zbK9qpe)8<+;=o?<L7@B9Um=~TM@7t)J=fE4CU$SYMI^Ff<&RL`7!Oh>Z^3GgH1C{e
zq<J-g(4=ENQl6kq$=F>>Zpj9r?`69=R*xnNW7wJ!H0rGhQV+X_)$Fy?|KvS);Ll#;
zD7H39tmsy3QP~zZ1ta`pPC>cjqjBOY+f9NvvgRXTLnHm?Y{L0I31<AAmfd%|TwnT{
znFBa2jZV~pI9;on*A@a?iyJdB=N?hp;l|u7l?sBU0T`x=b(JjVVG7y2SSfvMSi%wr
zI*`#5Do)!aK{<p;!V~x{kvm1-6YTjV4kZE8C(t&u2QBI^N_ojK1}p=&L6I<tXpf^&
zF(85|XmBRoGN6?sUaYV#$&@V8aA|26why-3Bu__7v`7m%ys7}UTMQn6hERYD^ChcF
z8RazebF8y*g&_{{I?NjZ&L{NW@2&5Aub%Q(Pi=#ex{#-yv;wL`wJE9+mSs<iZ`B_w
z{x1QX+pKUmomN_)krv^X191QZ1VltQSj3kjRnSMs|D35ZO~O=%9;RxB14Gz28vDh}
zTnp!SFL5M-i<%@gO_B!|{yA0!3xgyIu=j)PR?xPCvo?b5U6E?X{y$b3Yo14HllFzn
z(G7LRuJ3aA9Sx}_*PIVp9TF%D?pnolNVo*LFSn$ll_@zr&|FKfsZoxV8)_jk2Nnr@
zGO!#TdgexW?}DzFUR%QmfQP$()x1a;vw^;Uw-Os_WL-?n!|cyk%&$_$$~Wwhh{+Wb
z)sP8XzR}7i!-+L{tr=j`RToOal;yF{tl}mA#T{GJ57bTkVS9lmvirA!nRFxpcYQj~
zeVp!aMFdY!gnEbqBg{y1O_8E)i~dEH&dL?!$UQivA%4ss2h;CEOgHy$w+;!nKw&m?
zcO3x%h}<<FJS%QDI?vq2Ki9OGi9<2w^~H6qO*U~}KTACjxtlxy2{Xtych?T6&UW~Q
zGueEo3-ECw`gj|BH&T%0Bg?0R7H3<BW?vA4#z0}PXmkzC=wN!3s6<4MH*zZO<Z54%
zE_nEv@mJ&=jLGrd11X;60MVsUw)~U>{|B$34B{g!>1NtU-p+uP-~e196Sb`@^7l&I
z-!izuiw^_KE|SfWkcvw%V5NrmFsSE@edMF6qSRDRKnUYiOY~e{#`BhsPz9&{G3;;p
zQMK<2_RHZ3xPWhJwKw0{{u!$$tJ9jTIJ3oQA=*-XTFttL?<#qGsOM5KOgT!$5UXvU
zfMKjNS>5_^;`0Po=(~s-9=;brH?l|WIo~P?_uNVT08+{W<hv6*B3P;|-r00*zPV_`
z%6soFt#ct|71`ts5jl>o{R3EMm4a|e8B$DYK!nxt3=<!Vu<%wtcAs~(I8;C2N`N6i
z!(PnDU$=j?`bJD@lF8DQrs?V%slwsbier3cGW!!^lVqv0^8UJ#FN<zr=qE~8nsWX!
zD2s(G*S)H4im^SI`r!NfP5wEhJV>L3^sjkHMfV_mhkTxJ4&5E_NVj_sD4ll$RNdu!
zEsvxB;S;^|{7D*petLAQa{78N0k*mb!!MVt#oX&=jSXQ{3h{qDo0yEaeL0o_nL59r
zVm}hdgYM=q!TF{%@Yy)e+Q=Gj8?T7beMsA?vTH8)dKq6=oy%A8M`*suVA^t%P(;h_
zq#Xwso&DU($cSNQyty`lrK&9-$0?z%#9HqT#mVyM`o@OW!ryVex;lcTi!UZpn`GTv
zczw)aQhEt3mAHZ7K*U)zIgH@6qneiFGL9hMxQ(>!giY7-7cZ%-$DU(G)79xFEvVt7
zG4-k&D!o?{%k-lz;*)RT73Y%AE%1ZMuy@>Bk-IuF2Y$yh&sATMFyilyd!3ly8sCyc
zQ|?hENr2d77~7|uD10C9U7@G2%MF6QZ&Z`bEcB?zeqR|(+1g)jbQLXol9@s5SkrB}
zy*%LU{?=}B+E*;SPItE4p?zh<WwiK0c(dp<z8us_vFKTBjc6;JmNon7Zr(Yb`l$;l
zc)N?O#UjwY-jmqzT^@l4RLYnB;~lYO5@-x#)(~COKQYmxSjp~J8UF79U#~YwixCVT
z=YFCyl7|sRw{v0K&pwJmXFz7?3<wK^hXwvK{r#N*DaF+LFEO#$O`E{tE<s82*c=)r
zu7&?hcyKQh9-IOg69k059{^NnXVi-NkKdqi4Dt|Or$!lt!t8-aXSvu>R`RSu&COHI
z>_=z(1BE1>1BDFlhgUc|IeC+9g>ZF|_{*X#Xix@XKPJucui+MmAegLkT@M;Q6xUL@
zY}ZmH=He%50s4N!R7R=wR7Ue0?oN#o<-fn^cBUz*^&DXc%dAYp=cDq^_#3yjNS~<i
b{^x}7<a^DwNA^G%h(kBI4SgHy&+7jGSXlCk

literal 0
HcmV?d00001

diff --git a/docs/book/er.png b/docs/book/er.png
new file mode 100644
index 0000000000000000000000000000000000000000..e3d8dd7cab662c310680e37dd612f987a9ae489b
GIT binary patch
literal 13419
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
QcZx_!PE8grZTjKA0f;sM5dZ)H

literal 0
HcmV?d00001

diff --git a/docs/book/flowchart.png b/docs/book/flowchart.png
new file mode 100644
index 0000000000000000000000000000000000000000..714626b70e398905987bec0c460308fa7a84471f
GIT binary patch
literal 14794
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

literal 0
HcmV?d00001

diff --git a/docs/book/gantt.png b/docs/book/gantt.png
new file mode 100644
index 0000000000000000000000000000000000000000..95c8d08a14bc4306426530921fd538b404dfc1da
GIT binary patch
literal 43239
zcmdSB1yozz*EdL&r?fx?r$8xC99rC=MFYhpI4u;nQUVkW6`*+0;O-LKtu4hZNN_10
zyg+agz8m`V|GnR=cg>nvGi%L!dja<*_uM1<oU`S(_aRVCMV^p=iU1D}j}W9Fqk)Ha
zQwk67D#brHfp7Rz9&zE}`Qm|Oo@>3I+???=)OKmU*sWo@&J6L5w|3-rfrU6EnIU%l
zVGpQR8PUJ}VRFBths+yQO=0&E<I9IbO!XGtfK-@VujSm~NJixNs<6#IiKCkENK=!a
zdCB`tUF0r0c#dxR@TQE`tM4lZUSjX>*cR`c!Us;bnRqKC&dxCCg8cmadq8I{$(OpW
z9rgDE9^NGNt-F6e{c=_C{d<pBBYpMy-w(Ak_aFVe|F-oN@5<i~4guHy`FsCXlu_#M
zz3&wLm8*Y0OcVX@(FFXZN~6cYy7tk7l82d#&wLq}Wp|$m==HfQzPc5``9x>UHIt#W
zO)EAgzi0@>f*T#=<|SXmWgRl?1QK6xG$q|9cagLx1U@__?_hn#Bwa@|d$$JuQqM`?
zMtJb(`qqSqv0=^G(sOf1?x<e54!7)w-CwG@EGoLE3s0O)Z<Tdf1gqP<h#Yd>WaAZ?
z?$O9kdY{PQ<FmI<r0zvDaJ-zarIV!h{Z<{!-57q~USPtG918E%Nwj-brr2GZU|I0;
zFodzKef&*DLh`9#kN!~&C#yL4-1-_G9!k#xIWjUrL4%uBk>|irLk(tDRz9_Yt(4EH
z+OD5fr?<F>s6EKNo4He_sl_HZn_~c`vzs=j%26xSE8x(m=6{|IirC{9>1AI~Q+y*S
zyJKhOJp8mTR7vf8;UB%mkT8r!O)Namhc`yQg{EHF#G<X!6k<3dYaYA6@mjw`yPG2j
zR@|5B7PjCSs+oAPcPAx1lob?2xNE<7%e*|dXmDX%xtq&D>Fm3Hgf;lZlp~JCGZeg1
zzy*;J<teb1Vo+S(w)%xzS(H^#-B5b3HS2e1YQe~Bu#Qe_`MV&kVf!dLaN2RL26#3-
zvFMp1H;+i1((k=@7(=h75l)j2u!)!mlES>6lt8B#Sf9essVS&!BW5<D!ct{>q}%D9
zeNwt+7CP?L4Y?Zr6MB%q#K(qZW@2FfvP<DMLz+ARvY?k+TVG%QXg^z`&&#BXnw-@u
zt}EZDtQ;)Q_9VL#<=YT4jlRB>e>PLe0%9%uzMc46w^aFLRgpR+%J~F8I=)(&oh$_T
zYSopw#@0fsu^wHZ(R?q+6YBRuInsLkYBrOMOG8Zey9Y%)XE)ZvJOx;*%6ah{6xIT#
zsH+8-%nf%nw9~1HQHIv}8*?c~QB@AxPx-OS!g<ID+i2uECmAafn+$JFDr8bncRsk9
zWlO4gm_Om%-hhND(UF;m2H@o#**}BX(=J6mHZhs2rwjgQe=jIVS<8P0er|s|$@ncf
zJHLQ2rMX<kG$~0}N(}g@0aW(v-ge^oSH?nZoeIZRXVYr`PBO~O&sh&ilRZreUnEDG
z<Ad1+o{gct7?=ktsKsW=5qU;F=9H6nK4D`IFYJ3jGpXrNfB#U(-cc2-GZEvmY+K#A
zxv_Ct!~9s$iPd$PalroNN0Jh-B0G7P@)r$A!LU_`QC1~)aCAhiZUntfu5B&WUX<L?
zc?VhnjN<L{OZlXH+)WjgRb)RO+7M)-<)IQk_`&505h?#j$3GEmrVz24Jn}3O46^J=
z&W}KP-TWe4l@*HS*+1C_%;#L0T)!n)#^wpN-Qag<iL-UAd#xV1pd*6(McJT&Uw(h;
z>&RZr1Z=qkXwBpP<xaPXV0u?ZCS;$xN=8W&x%-gF__yeOIcxh#sEct}&_g+VKUeMe
zO!PtDYVsziOGCZEq?e;&S;M|N`W{_w`z=<pDz0Zb^h^A>6@B$jjqxRVI=Oudg<O8d
zPdw!!P0j2G%Fr4m##MkEQLc{DWy)FVbjnu}(jb{Agn1nBu=nRnU5X|yj6TWzI^94@
zS+HT@x3vt#z@m+sxtG}jn{)XnpU|VhLU7|dF8-^BcbK@sqWf%I>n=LmoD^-Oi^8Hi
z+c#u$@+8K7bt;Z5bl%lVIt}?UupYf|U;z^xjUgPfgXyx<bb|uHA;o3hCB|fa<EA8u
zaT!TUOa@dbuvi~1j62dLBPseiXIN#I4P0`Jqp&Y0Zk*A4ockc3e~Sye1}Y0G<KN<z
zD+8@{+aHFf?VeEAOj;kUJN4~!Stm^?>B&V3AThMfoXXT2`$nGkqf@5($!&*^%~^Ka
z+CPU_4^naF<Ou_O;`(^0VnlS~H(ATd<1r-fJH#g|#SQS2*U8A~26PS&mG$q7t6(?;
z+N$zvrOG0C-f87OHs>HxZ*dyb-x}Hh(M+FY#7;X!6{&;Dsg05vIKY7sWG6Rf)0w!p
zwGMaN$!ps>DysI|4(eCK65mv{u`QQ>EN-|cW%6)ZeV%NGs(5+to`6g7*bf-Ft-42%
zU91lkd6WKB1@)8?v&&P@1_92%(OMre*(Xbt(vgMc=6X)$@n_bCXvL;lUV~6NgR(G7
zOWU&?Pl$Y4Do4bv`XvIV7}xBdlW(@&3N2<UKvNZohc!lt+wu7ZXYMt{Eh_Vd=VFHH
z)d~})>%5QL6}!9b=X$g!V=5|~oYhOK^d89T1W_fTeMQ6o_SCX9g%SZ*JfrB$&SmO7
zUXB&^?E)5d*@^x_)E(MFHKi@~o$klEKV_Y&M+0O#kA^wgj1~-L+BP1L7_1<IxoII=
z73B&ODwMGcBc3FrcG@b2outgyy*See2xAxnHYX1J@|3B_Y_u2ij;p7kda(<Se^g@A
z_WQq6QQJho7z3JiW#2m;K9QZ;eD@}c{V;OQhFep|D>`Fi8~S@(O|OwnJK9@~xz&u6
z(yNVb%$$|&osVLX&B?R6BwcoM)u4#26fM}txt!PO<q628eewKc_72t`*k+CU3~#Kl
zU0wI73K0Hqqtwt~TVemnTBfm8DUmwo>~=lp=%lC&7Ny%Wq~=ymBQzenX&c+Yhp?#3
z3?9~>HQQY4DUvWKyUK+>m9E#+s&w(H;klPw$YYMk39`&b#aby@jmISBoJ6t3Mm+X0
z-O3@3arPNy)Kx-1YV@cZoc(3g32r&e830C{Z(=@R@JJ23ePtAyRi8@9-?ggmh+VFJ
zn|qj(;DWEe;b_$NVN|s6*4VEEO6s|iE^d3DW5bpDgtt*tXSe5c_RW<rNlNf|`dn9y
zP*yLazB6S}PI0x0XVXg~T#Xh6!8FECU>hbLcWiB%i$E#!4|m2BWV=#F`Di{`9MM%4
ztVqc!!BPju+usyC1MyQe<UQF^T5Vsok+8S^I_3Haz6%#cc<cxDCXn_!4Jg3#=_1)f
zs}{Z$B&0n_bzG@?@<~0xB&yM>sK@y!LmeUATk6yaXKQEM#Tc8c@BF+17NcGhoBJ%q
zUC@@URRLGCzTCcclvH1RS^t2PJ#;nU0Ia^h{K1}|{RRFQheyluz|Ob&o?|<>zO3>J
zTh#FJD6~9v)b5VWc|$2%#ln5e!#usQ^;Io(XD-PKi>V+)`!l-6v?p6Vv8V5vt2g#>
zR&nKLrc&U7c&Vq-n6Yim!CRCjB>UM=HXxQIJ9;vPmYTlMalh5VAW0*VtV^rKO!YK-
zLsWsPflc!;L`arzYeZ0{j5Sb2cKV2gp=Q6(8J1n54rwJHRo372@xPz>F_Ck^th$Yr
z!7}m3hTBr{SVDBhs3<p=PMNhIPsM%GHJ%6Gihjl3teYWaWqP8Rn3SWy@g-0#_<_{q
zLtFTL@)EEy#^RXF-27*kg#%C9x3Pk}pB(0JtM{gryaMWaTV*49dj6vv@YIuMI)yyW
zF|@W(*%KW2CVC7D(GgKabqB8>8s>jS^W+Ku>*@<~-9MhrtZExz=86Tzz3cw{%+E!S
znFJC~Uip^aVd5u|G)as5a;hpYZcSNaTCCbtU&PeuDmOQh<r-LXdc%J$MR|fP7Sy`p
zFqm5h3aYGxxMs8MCkaS%)bF`l18hXyx-{F-YBA>KTz<LiJ>6Q-iSVBkiA9S#g-%tp
zQ7iC3jo;cveM-&E#U)XTw!s=&t)nW-hUH}KciP$~xtg&pj$a<H3OM9U28&oRa<|v{
ze9XELs6RXzY_AkOT6EiHd^+kYd|Juy_49=USA8GU<L+*)mAz+L1-*dnrP%nGQ;<~z
z$$Iw8HQCgluBG~?etb;Eu|N6r^GS*p-O=Fc!$?l9=e+BJ!DH;%$_HlputbvFQ>v*P
z?OlDdeS6GxrRaqPD#@BHN)>)kH%~Mo4x@&szux9=n9;(O!NG1ssJin}L6}&&lv9q-
z?c6kI^7XhaA(6Vw=j8<@WK2wcC+Y)ki`KmOW7$mRdtSvXZK0Lz93>@ZAR8|^CsMXF
zj$UonLzrY;e;gGx6%oV_*6J;>G;|a7@!*TvuZWD~J4*$<i{9o7v}j`r=J#a%Nrn`<
z{e;`7PPVwpBt0%Hg|!q*bmHFNV=z}@lJ+A5Y@6%MN;quDl>2jS!CYyQ%+{g(wB3@s
zlF;R4uYjzuI4`%w()#+74@+$9`A$L4U%r_l=)w<>;d97Z6==-j?&-36`Pj;T!4%#|
zq`dl0d6qNCCerFob^h!7U#i(zGn29A$<z7DN7Lz2k`;DkYkg5PF)=hcziELf-wwP~
zid?3pWOhB^c5M=3M^H9{JZm7Jbtm5Nk2UEE8kh$MYI>-j&3<TGK)W`Ui;v3Jhn#VA
ztDDuWP!g0?zb4@%<A?Lba(deC#8`f=EalK#<@JLPoz;=EV!ids$hx)-RmFcyzEI!K
z=`9!H?$d$9fVcvT^i-5Mis{A*yWT02pHS8`?`E0uGrr!e;}+N^4%Jd{(<|w!JFe4V
zDVX4hd*vr1%qbZgJ-8B2$y>c#SXnu;yxOD6d*HJt$4Njp{q)O3q6Hh{W031=RNqQr
zQXo#+rubiuEh&zV1M*>%$#T7C=rL29F84Frd7kKH7W$#bJ3fmfO>d&AEiE_RW5zJS
z;q0DguGuR_NYeUf9{Gr2oi7~r?kD!HD!vMb8KWkv)Ug*7VmiEJ_Ue<lt4p0hU>WM|
zt)ViJrA~+Ggx6)2tRyhTvHpxgC0`O!VWwiZ+E?&QlZe(*65^J%(u-X7JS`nXFEg50
z(g*_U`PSQIZ6e4`keY`Bb;HqKOi9T`IMaB}mpol23zD^-r8+_k*-oAOvs?W%p82~O
zkwM*Y_W)PeSLZ-L1eiHIir4;;1KI3DJ#|E#*&7hU{O;-NvT{WuDW+qXOC`vZuOT~u
z@3N;TBHy9sCdKdcoz0o;`oi+Ylya<7y?(lWOtl=WsXMNuYPp^XHWjXJ7?he=$+q{H
z_uC7*AbwC`FcYgPNUtu4kf?dR#~|Z=Ok6}kybJqVnvelC6}z`arU;HgWeppn#fJ?+
zB;Sj0?!O@k&PDg7Ez&f$5FH|2Ogew+XCv#?XquV86})um?U@{ae>c?dWL~q%S-fwy
zmA*(Ou&@2LR9PT+&~3afXy^g;Mr@oZ$-Q@F0}?XT?RUQH8Qv!aw}R;-oU^xF^uiV%
zl9Gbx$?{#hDjxB_B<)cGJE#|Z<dh4i0@|-<i~R;LNeaI}OXr7awg98#3Y##q(yeDk
znLe`eJO)XtSC+a5W2@qWf(&hFb*CyFVjG_Jxbqh#WmI!oEO)we$Muz>3gmk2bgWw2
zRhEsB9{SC|YXZ(C<r1J=77d;5l=i-b1A_hL_ghg;g~>S(Qf3zMLhm7U3+K||Q59iH
zg75U|Duu7i+3A^buSLBAI)&Q4l&fjiCSsySjw2y*FJ5f4mCpnU>xS;^SG?h_N3$y5
z&c#2<IuGD@*H1~hIzILFsg;J%j7?p=2(?9U&pSm*;X3eOJdERe=o(43Mb~VK<GN@D
z)=z17zel_1U~MZZgykJ;is?JfM-T3&*QT}iH6m@JHAZHy;Sd(LKOW9jTG8@M*yCjp
zZ;)6PbDveIuDR`db%UbM=pv=Yhg_O+Lpkkzh|YR*s0UG@z4~H%KchK`(Zc6x2$K-0
zipjluUM^SO`?0*!UOfNUcr0TcZRGAoW)LzQ5~-}H&@w`3^jK__;8)n8iZ36lj}Mao
zlM(VgawhJbM$*{#3MBGY0eMlLP;UN<$xP3Tg_z;?UL|#vu%JoXPN0j3<p>-Y^etw0
zPh*k1jCW)Kw%lg{a~u(6<Hp9852d6-a=CqA+O9`__8&<psb@>I8zq{Njs-Atz}?>p
zo#G{vH=MEacjz1=%Wgk!rEO!XjO8n5f97Dmc>65PC5WJI(goT0COBw#{IqX@oU}q{
zd5F8WhbuCqREEt#-E7Fz5^c(~WV~L-r5TaAEMQSs>||!?|E_1m2iO)$`d^E<m6WtS
z0#lu>RY2_aV2ySp2U<I4`ZGnF$f_inOxGx*qfMA10x;%i@WHl8oGQg8^)C;zSo}h$
zbMrn=yFL^Gh6yphgtp$A7kv-1dS8>68xw5cam8A@bogvg*~vC~5WVb>EiDWRHox7N
zTc-0RYqMyYOZV>io^HlM6@1?Qly(M~-(wE>DA*~0ba3eWq)8lkduAqRqpU@oz^OUV
zlQaIaj&T2Bkf2{zwNUm+u#bG~0)w6YP^n=QD0qQ<qhOydlB7{LFqAGKNHdevG+0|v
zX~Mtz@iJpuw?!2jye*%&Ip~WL!Z0_hzuUk*2-K^w|4=?VsQf;uS;cxzTx=BA%CCR;
zn~&z;ZNZvaBU!0D@)M+-(#sm>hEIxv0;Ai;z|FAZXYxYK#aYQ9%Hk&>-S3>u-J<i0
zim)B@o+`0JQKqEkRqLZMo>Uh!Rz;(2a-B7L++=NxPeeltvp#LO$V&!4CSzt3X9vr=
zU_>{C3BB=WqY6wx_+Ty_FN53=fRAaOh5tuO8s6NaDj4RnuE`&nZ=s6{N;n#*<13)t
z7?R@$q#=KLI_|gC=B3K2zrV<lV70}}2aU1YDS$ccM0xa<%U#Y4${T45KaJ(yKjp`f
z$&;~O{<_(gm#ypDP`kcY{Ne&NPfmJN>Qh(1d4P3I(o=s8{7ef>Wh>kF!9_Wh9eIb=
z;HdWwFTbdO>&%CQplZn0p5rT{zP6q1o`fTE{_yl&XIuKPG#7q+uKO}=A6)p;l~b?4
zp!mwEpVAUsI9+wrqv|r&FvM_51M=agQ8px%Wh=uy*h-1w35q4J)Z$QOrPlR_npS<)
z+(u!eMVkAbE$D$?2{)`ws(t3Uqio6UG@mysr*GIKV66f6_<EY&#DS`C-M4l@Lu7Yc
zCpC)}CuHHgf*;LdBI*j9^yoo=!y1#ET)ert=rVUmTXbWpJUSxc7oXWenohWqR#?5T
zQnbdqp~}Z2Ya8or9UI#hX(}T8{C;qa9P#W`k|4(j*oy@o^ja+CJD+kD+9FSjFj3_P
zL$5f;V@rx^?^bmzh0Br2GFq@er>?>%0K@EwQ{0QH$6Okt!Pn<W@8=ff4EQEp(D1nv
z`Rgqs7sQCTCl+`spH0`LMv3T>5AT|S++Bscx%OS1E25XQ&KX#^UeLpwJQQS-hTpxP
zP*fObDi{>>gR8ysfdddxv0$YPE32SM7yAoy8_kYZKDWgy6BP?23!d8afKo_He1yZ2
zeG6ZyztM>3r%@Pfm*pi9DOw);+Fbp9IjLtPR+g8qdOmdTRVblR8tK$5*vC2|(zIxA
zk3ik9{ffPHc8NpR{rt~Gu^nA}99n=KptbkGnXNkr);ETF)o|712Db`W-MV>puKLC8
z7abx@kM-X>h_KwWeHj^~*kVV2Gs@r3-{yM|r(%CEIG;i3mij1Jtj)WjZr(@3PyPJ+
z5gDOf-M!o~ttlDf!A<E$1Uh#9MyU=4>6B*pf@=&~w{<>O(#rEH2d4(G3-BE8`Lm7Z
z#NiZVWO=lw9?hN6aRjA)rA^|HggCRj&c}=*`^MWQg&FtDwIJJ?+4ctMH`3GJ(M+oO
zap|VpTc@rYMi{Y{!9*p1HG=B@FQ6{o(O!V$`FHcPTuDs+AU#OfX`SD}duu1h<#gm;
z?yF2QfQxvD*KwD~e40E<xhQ9zMMVLAY&<^jz=PxxkHVWaF^|2!P);q-%J3273p~Jc
z2>S!_3+m)&Br&$h$yjT8&%7Ic+-6+xO#pcA>rhfNh*Ma2QVre8(VPOZ09t(bJxZA<
z44IL|AM~4FL;?4dCiG7|M;dxLo12>!4a%)6Hp+?_WcX)PH1t3LUzJOk71#k(Vmj$$
z6-D$BL0^K@WJ>jn<vMV%b=vTs*uyX57YkaN4=f=hxO(r%-Gkt+IQsun2;+GG1;0(S
zTqu<}ghHHX(Sf6Vjv}O?i~?%*bi4i4bZFZ#^(QAmvPH)`?KA&*Al1R}zhC6!lJ)<e
z#(z|HZj*CS&|I5FgbL2GfEG^H4gbSx)AP{pwE(MIM8KjBAuZ1++{~U~aT5T18@wxc
zb1{q^nX5{dDUA~Nvo|h>Gp*v7dCk{T)bp?idpg!qkd`K8*`K6tZk|0z@4~{(%}q%0
zRO-r=E2q2R&>}46jGE^D<$HK|Xaz<o#B1!b308JM;;d-!HKd@sTalEEte~`1ZDL}A
zfS7o!<>IV`nuhG}8$ui({D|f^Hl`NGG75`|M*5RQW1^$qKrW+9Kq189SG?y9XFC^I
zM<cfx7rB5zb1&@4>M8Dv%+`Nv@ul@+Dn-EiQ^X6CMcwK*H|APee9)P6U1MY5l#~>?
zfbn@O_NZl}1d1ud0=?$joT{)4_rF8=LK)`+;0VRo3$$~(SutQ(eRi}{a_hkpls~lt
z>RuNysD9p`nuLrjhwl6rKH(V~J9}a%;h(qg(k{El#=!xZzz&A{yn!hAp8ySPmd`-!
z{w;z>1B41EkrNe`M%9kB^EWf4c|uA`N_t#}%PvI+Pz>_${v#`JOiYYi0K%NlXfOEh
z6W{*-`>{wIDk_f1KO#B$(cB~S`eSUn>TsHC{kdOe398018G#Um=6lK?S`Q18T86VR
zY<bg&8^Ilyv*~6ZGER;B6S}!Gv(}1}i#V#~v+%`(sd=DDF^6uBYrobM-48Z$eI%os
zPZ!c=PiH)u65PI{e*Y<qhsXKq=075HY1TpEsVns*K02KU(SsgO`2zcW9+B^UnTnnp
zpPRSDwcI2iC32_8Es2zz;whr_aRcZOd8_5R1##xJ8~;`%WOnl(L{NqNMb?AJn<~i@
zU(dg0Nwhvj)3q{rd#bscXi?KV`L}4=Eel_Y{PQ@TS&pyn{g4~Lf_zEtIv*WoVZIjC
z_&@}VEgqSY$N1m0&gjdD_>|C3T9?LMJ`^46^3p_GvB~??+6p0~ob*1};n3DQL2hjj
zjP5mH&PsP%PxqAXR<(3lc$J@(PH<9Y5;ZzoFKm?u+58;l<D|kHPzCn;yY!_zQE}Hh
z%Zd{kIrRGHf{%VvXFP8WusuZ!C-7N(^$Ka;=lV6CSf-z9$Vqx^)u9<BLzKlt4nY@_
zqepLXW8NMs_+b%B1!B3G@<(gMX81AWO^Qc153H>ckGegWQjc|-y!~zLtRxS(FfZhf
znzCmFi5<nSXy~_$Aa!S)j}%ToLw?Su8CsD(d34pKPr!67bc!PBj!N8lFYYfR{#|Hk
z8>lqON7^>^ENU*+=>$ilHjB+il}@i}Q@q$z9`wo0`QWn&=Y$B(jik>Lua|*1a|LeR
zkhglZCr?H4ENQ7j_F%9xo;WWR3_Wn`emebHv;aKXlKp^E-bJ7@2O9~Q{~VTbtTUuA
z)3mNaSlHwCGV#z2)8xj!7PzkIaS>Akc_BIS*-w+YUvq8lz>kq|i(9fPqg-Q-O8n*D
z6+}*BaP1A6ZL70a%fcdu=cqAvX%)=om6kQ^iQX`2%)gqs(|j%Fq2kaf&6$?5%dUWg
z8SO}6d;>ZWw4HRz2HywX6+Y=LP0FXGv34t&y?Ab-p$j^?=KRT_)(V@cpUX3=aR_eW
zNB4X3+kf5Xh;Rh`-KSE5NOyiIG4D6D5=Ktk$9Z0pQIl?`Ml@`3xxRRr0eCYnhD9D3
zOYEKKL^dNPZWnN>&06NQ&kh+dW8bMY4B_Vwj70Q3U{=<mo69afYmRiNGZ<vROy0#=
zv^Yu=MV&uJNqkQb(w}sz)n(F-guF~_jkON2*f{B>Sevn|a<|RdYl%J2NCkKQnBOZB
ztztZ~x1T-Dk?7*qt`b`kd=v7dFIc@d3lEm?xI-YodV<LM@N|pH$Erf0#ZxyMIdpLC
z6Q6bei?)}J^-EfHDm2|{Ly0@<YO~hf#go-$IRnE#*38}<LL3Y-LQHx`Pg^sqY&tXv
zxW<bt7w3@kLpJUq*eYXhHr=|GxZ;BVTLU^{NrTrL8!E||MjjY3Opym2Jh7oYCX)%?
zLTKKD-_sT*THER~I5<rI;XmH-GJJ4P_&Zk_?9KU$id25vML0e`DsK4r{W0rP)AWT{
zd8@BV=QFAY`9}voM(vW%boQv;2R{ixYwmPAi+G@AqGD%Hcaw=xD&cRkX}pzML{C$0
zhJ_+3Fa8-!BeQw$<td<4LL;Ut+Os(RJh}F_*$v^EjTw2LNJVa~!WSBJe}!p%aKEZ=
zo??NG`vtQBjP1k-s+>q$?EBF$o*Bt3Spc!y&}e%?UT}IU<<}SXRgY-d2Oa1tR;Nly
zhtcQ8SVSgpF;<x&ubN-?XEjx+T<S#1r!K8Eh4w`6b}2TY6W0g>KNOgOPTLA-*miG^
z{G1r%@zm*xNKEft1+(tYSczW@y&!a?4^;bo$c^5dVoDJ54zqwQ6?iRB#4`~lP!wCA
zD(uj3#ag5JlnL^b2JVz78NDYO`iZiNzil(cM;&OE=yFj`BT~FUN+Doy&jQ(2p%K5+
zKf2G&=@y!MD&EwjCla$8==DTpDCrj)>6<sG-<}&TEv=fYGj-oi{luE8`3+W^G3ie@
z3=6CU$5hv9)2J1pg*6E)QeqB>PEoMcdz2H+OI4lr?~taq=(HE)Tu7QvhQVpjGRIU8
z;wDYvmqOX()ifgpP!ae%Z$N&!cB;f_de)G$Nq)H>qJVv!tn+l97!>wrRpUvK51-t+
zD-W0Gj>;M&c-y55?AVXyli2<w3tlosiPIR<sN30th0*6)GG-ZOb<&hAaU}<5DI*n>
z-}@}oLyY5#a&rWY-?$@Lo6ZW)s&;?NVb-_iJzR{pP7P98$=CDe1_mF&e93H1S5EZn
z81x){cvM^Bmlmm_iEKOMhbtwPSwpQOjVL6%(|c2Hc<j6_yQv&B_~VIFmt}1Z_d|GO
z$j6miU-wi==o+MR`SsbOQZ>wuZ}VI3WAv-d0!#%}N8tFMmc?G4y~{pe-QjC5e_KDB
zbis?k{?;)kc{$YRP(Px(7WheIw|I&C-d6N^E#D5ce^>R}(2rrw8J4pm>6=U51p3-w
zjwY2IpLG5AM+yf=6a}IIwAy>$A?DY`^MFanmO4FN3y4%fB{j3f+~n7zFRVmIGg@0g
zWBYNQ2|&K^9JAmw(Ly%Z;&?;Qh3wXlD(&lG{y`@0S3?720;)cFY+%rCfOhe%AWx2r
zE)L>~#|yM0R-k}6tW0h~(s}~o>yog-FpPWTE+{vO2U4^vwO_rb^*bvtGRwO|pKDCw
z_52TuuJA(b-`f`EI!ZaIoDfByk#=6M`FF}uTA0}e5v^^HS(N)TWz$=TxPPLuOqa=`
zD;>Wkqkc?qGlHb?4_Y$zF>=^|c14XfauK)h2jhUSD{$3Npu3@*T=0Pn*<2~Prsd)t
z>{EY220DEq+@X|+K6mqWLMLT?pz`6}m;5tQytKl#@#~%Q2MIJ}Ii;mf{rprl(dD6&
z&iX^&CKSIUvWy9nKHzW6)+4wP5UtK>jb^-YR{3^XQtJB?kYAmMHe89C&(KVaQ9E^r
z71k&PNI4IK3sO-N&DI|zWCD5>J~8T^sA%av&3~RJ2u<e_k~cnNV(a9LT}lUi=e*-@
z>FXaJoAq)zr5@sl#eSL;Zth<dw8~>#`<Y+Cb;jP@sWBS3vNeD`$m`b;+RB6H88mk*
z85j4t)zi!HGWf7~#}prhVVfLsYaEE`Wt*6iXJc|Q35CDfV8kt9uF0_;bEcYiA4vTj
zYtLFEQ>oZF-<$WP?J~WCNnhqUN3*Q*b=(3orI3-3V^ANFXL-!+=)y)t`&XlBuRsCB
zh2Q9rHy04{E%hd<+h_WFzlTxQg9N|x3$JN-l=+Am5FHl?X}#5r{K(%qJ>&!>q+(nv
zg><VA>1zHAJ)p$WCH!uEFbUiJ=(FFZ5W2aV-R&&zg8p3NPehkj5|%t#*2qor3}xZ2
z1x^3d<+zqMJN9k<dHuwWL9(ca7BeH}?GG8krk@1*80P8xTlgl3X0(xr$fj{9I;s)s
z6<|Rmo>QZegfQ3`V<}8c^)NYBT<va&Y4m6Jm<&fA`qlkAaJ=Mfvj>kd!PXs`_rPG^
z28sN86gj9@&g_H%?8iY|TG?g>&~)Y_Z_e<+LUe(1XoQ)@N;wUUhzwZdp}2p?BV~hH
zHSbvuO{j>I+Jwn*-W=l5%*m_IA01f6OonGi49?2Y<WqfA6S=AFvy=rvpE@85+-DH|
z$T8vo+aHw|2<Y_#m^?L{^q#N|ehrP*<QWwC+g&oY=A3VD)}+8>HWi&KNrNnNUd@`7
zpb|PH>I<RB$G-W`5>;9UR5h%t#iv_Z>a!_Xm~{Y%oG7_FhAOy}Zdkr6H=E2h1R_vz
zRZdAHsZf)!LetR9jYJ_b;A*dfz?m6>udPGX_Cz-|(Y)aZT+T20E0=D-Fo$lSXzozw
zB2AQ!8x^L*jkH{93Zk3Xdlvqh_aN~&Uir|Y5Q^aIBTo2h*h(EC++`6ZBWbVvKpO4L
z-S**Y#5d|r^YkNGb+2F}6(3f$4PWcXn^E#m5Yc`oe4`UXde<&et62I5C&>wmWRB_{
zqjiSA+r=I(aCS+MICv`FZhW4*BsGh6OK#tQ52O6>;&Ml{0pguSR-?80*F8gfY{^`q
zE-h8l(-&7Fmn0Rg&_?bNuf-|da|z&yoNZbt#o*uQl-Af~?ilg+SSGys*pyFSV}7Nt
z`)%FCeVWO7?K4Kgkd(}4G+&GUs^o7*kQ1g-M%GuenjU*2+~^H)RkqV8M&&p@^-o?|
zdzz`JOz+%-gRg+v7<$N`Oj2fv<e*7>3VMKllGhzk7%tHTwyxrPdj3pYDBtH+{(J)V
zmsL}fPijhteu3)akLIz`b(HaJ6cW!f#Shnh&xb=g@1=j~(WA3HhKLJ^=xq=?jtphj
z1^pwS6lQob;QoByzvf*E^fT@G0dxIDm$$woG*%+$i<+-$9RUvyq_$F@_JicG*|XNE
z7VKr@3dcK#ECWU<#)>EHO<7Bz9UI%B#M7mwH(OB<%(q9OfnkG<?olH{L2C0ow9%>#
zk+aGY#U;!1E%XogJdHz4pWNtlzv?HvAm{-~ByBknH{b3o*%GwK^x<XJmAK)!0d5&D
zIB=xX{JA%8A5tT*@@4MaSbKNC#?~UobxCQA_+dsM6Vnh=_m4zoj2!DH2@MUPc@_q}
zfI{0Hemmok*nwNk^%;AACK>R<@o1v(D4PxA<9ntib$fVuUDifZc*5f|JKB4#ohc+*
znXONfK=$jNYCk`D&@X&n3Anm~%6CgDSu6RH%R@RCizjxC4^u`C{KgWW$%|$821Aw}
zJO%YYo!7<<HZrTs{<c(G0XMn!pKRG*JQ08sy|=f=Bl4Lmv!I~cJn?_=WVZ^S7g(+-
z=*8JwC{fo_b0BIzrQ898J}(L3q~M!oL`cc=)BFsIU4@1KMLNQ0oF^Paa9|sbe8U!F
zZ+)Hb;f;xp&tGm04a-`kd}jK&M?=+eAO+d%eTGJYP52G&cN=*hAi>?;-9um#Z)E8}
zPmdCVT*y-qzCYFAp`LkA)8I`jU0^Y!w6t&lG!WRt;T-^iU<<MG2XG3@TO5DO$~XvL
zyWW0!1if(6*3qG&k%R3n(p~6YV0SJYAQb<WLS#O@cAaJcdT|8RHZm%v!~PBs7oc2N
zUe5mg`)wrMzolN`-G7973Y59X%~pb~R}4sKzJ8q!w7PNFbr(QZ4tC~Dr2X#<e!0h>
zdx*=c#?c)hwoilO9OK{pgqIvf_2}{$@aNkWdV4rGeDK*fLZl>E%p^JZFSMrn2l9Ek
z4PLeB2*u$&{~~e!0fIh+b=>)jfB*<$-j%D6Ys@N1YOb!;{Yk=^EtoAwHg0amDsL^V
z=t24;tN&m~wd1vC$H%C4YR3`ZE7x$~h%ewINnd*JX~RHhtiIH-1)~F`Ur$!q!fb48
zLWuD35X#XoSdT*u@UxK_E-{2&8+KVub}Mjm#O7XdC~fuE#f@u5<7VOFIo!?1KTuDB
zG+13_<xtn{>HGo73qxFoLV=n9@>P*0yqgxRsI1I%as|&y(9h4$W23kxgb2v^#XW7k
zb2sfa8w-n?zJ5Yavw=gMY!tJqPKyr)&3&=QEf??)9_j}$gILwo{$x!#Ie&?Z^L>Ae
zsOu)8GlIcozfX{w<}t1&Jen}dM^fbI@A!1JcHtDyUMR(K41T4TR`3Bb^wvxOu#4|a
z=Uq;N>X(uLv}6?KeLNo^7jW4{saycRhdc+CrprY0Vwh+M(Jg=n%JDpH<_&Amj?3DA
z!4-V*j1c*nxtF+;BSZl}mDd5}>FtDs^Ge7d{pFk^ST9Qn&Ur1Cd(XIxQ38-#T4Fu+
zbi=56AXO6g7LFhUe~@h4{r|;m^)-7Of-D$w@zDYLXp2WBE`QFuRO`bQ<RntOkl(HK
zUZ{tV_Qnqk_nB8m3UV?_9*#1^RS$&o!zmx(;qj@z6M7!*AY}S?C)5)30)bIT$hYj%
zU!St!XX}=JAs)K<8$Xbwt2#nFsiT>;N9&c0QG?$vYr*>!gbSofMQUZVa*Gvo3=?SE
z{{{bQZE(RyBWY0cVOACk=SC@kQXvzuBq62!aBm)qAHF~`yGBN1wDM$hxk+wItk}7~
zRi%B7MIV9Y*NF;bkI-S!XcKjqLMH7f`^FD*_y)K0fnl-uLOMO~n2iH6Q@>#fb>+{N
z`i8_sT2NOND_7U>E9W~8sDymVSBTIN-M6dU920=V((EF6ld<}z7yi}pg*!u&49LCT
z)Y+_>0i6{>s-D9FoxD~rHg4VRptYZTD}$uftUL@nU6L<m8!)I`a#OX^NekaIdFp{n
zTLkEB6)>B4^>|RflJN|Bi7N!Zt*1SqBeccMo}a=R8^JeTs}p?9ifo<q%+eovBffje
zKxG8m(XC&KR&hTyJio7f;;}YJD3b9Z;iPxSf1e6|@sn4M_+L+Aa*$sRSbe^XU7HE#
zc{76g)#{N!#Dxg;mI?{y`T5CF=+~P@d>883=dcu=b!*~KkN3r~H>;ap{tL<0O9F@=
zUVT`Oixm7Q$|QynBkPwP*&BH-Z(GnOEnn_x+mj=8!g<RvMaVj1{r7DTmaWP+2AL-Q
ziQF`os~&h+{IZJA1?RBJV>o^#y?x8WoLdRPZt#^!|4PJ=`~zChNNZF;XPMil*xrzl
zfd{UvElZCvWI3qa4!1)6$iuCn`TKunCJi4qGf#~{IkZp~Z9n8SerM@~q13bN*jZ@H
zcDT39(Tys^tn=3&bf6JBW8=azhltGv!L<(!WE<J%1s2K|k+C_AX#rK{TO{sUbc4es
zv^vOahCjTL5|jtBrd|nk%o~YlaK>+YYAJp4n)FH;NE;0Dcw$r{E~ZF}^i#xaiLzM@
zwVQPsito$RUX>ddW5^WKYVwRS?q<00r>0+*2@`j~`p4v;p}cRt>>_gyB}_D#@`Y6W
zlw)fN5`>ki_y;hg)o=2P*mNdyz%i;sf3)VeV%+kl=qC|UjD#@GxnSkoje|78`5aA3
z9m5H_lU=o9Hf%wW;a*|}b%?ZleWy98HAsQ+xMw$N>W|`-!e77K!^f&|CGpq7S+<t(
z(Zh{h31UCxm;F4ej=qG;h1aa3eHsoeSJtrK9=Yo*TaP&kTGbfGx_nfAp2J4EJyXaK
zd9yz$dl07koc+}(Lqgrgm2CUT4DrlS)@eKR%%w=hOJe|39NsIj0V&Rz(&tB^d+H|<
zGm74pC7US%;(PBhQr<7X^m*F~_9{utV-@xuX5@$W#&9C!b1R0T6Y334Br^H;2RTn?
zhNRr9=k<?D;vN&z4CcU&@*4@~|DEi!*FXR`ZT~tK5}%I4{v;0iHDeU>T)mGdj-UQe
zSourw+@ZSEIOf!R98+xEE$Njk@sHz4+$u^Jv-@d0IEA_vea(pDC2o%a!jKpzi2kMj
z=f`zWADfSwcIxb)n1eC7fa`duoCK_!!th1dWgFj&a5^t7(V@P}yrH&s9Q75@Tw22y
zM0F=CiJ^ep2gp|iNNYiTyh%*ES)Lpb@%oRb4~L#-_Efi-J`-WQ?5oI)TY%z9;Iobt
z6BDDVmOR_!6$ez)=|V8Kmb&_D$a_3rE_h?3p^4Y7pMc|RQ498<gz!vUObk%M7Qj;+
zL4sxh8IUF%)s-deyuu<ZT=#lzH5Cd6ROmDc0rYHK6?&>U^R|^xF5t5JQn{~gcA7V&
z4a|C~h=yTXQBuEFEPCV8aZ0@vhyn!CVNmi30`>`muP+-wSc_QP?6e%PJ{O<TUasuf
zKa(~;8G|A>C-(W=8)dx>RS~?I+v?>RRa>3XRIkx_l^%{Dee_RP?X}NdJSm#T#34lg
zY}@rE@B{iA2{&rc($qAA2mz`u4_soLAmLrV-MFukDSg?wG)))8eO+xXAQDq>x_T?Q
zQzG4EV#jLcSN`PhX{w1+YVR}fHy#a5e8(~49<9(vCm)DL8{8Z*t59sNTsSR|D`1x_
z>?{X8o0`)yHg<qm0UYe@=#UqjeV=*r4n-OOLRgSo?qiRvu;ME`+fL?Ug36L#vmCil
zn}JP}^%lvl$<x^ZP=`TkQB%HN)V*3m@Ai#B8hLcypi`PWr3fU?pNPhz%hhepyM}SC
zYRs5dWQjKLe;Qn(mrR3=0{Aj~BNNMDVXHjkNXiCcc0+x0%5-e8Wt%LM19h}K6S;F)
z68KYJ+|T`S)-ua(k#Q{vtA~tzfK3NxM~=Af_Sms{CZEm7d%posg@MMS_=Fhxiw@7z
zle}GhPc-!!o&3Q{<}(616E~G!{U$KFPrLFWVD{{UC6r40Xn+665PmVio5{y!5zxO*
zO}ga{R9TIzuIL+;2FW8$yU@^w+C$P6=FascSx1rR-g=|SdVZy7y?<pp-mh-R=6zkx
zg2>6}<Gh3LqZEX=>cg)CztohCUa8X=Ap(sWqR(ZjT{khsv)){Wl2$_(qK*;_q+1%U
zbcs*o!$$;}U9HDHxS@YGI`4VaSkLcOSGTB;O<m<gxxMh56HasHym59y#8lij1aGqB
zci6Mzq=2f(&rKC>_62J}UMJ3;pZsG49z!P%L_!8K`b5;1Goi^3izDVPa>JTyz=^4y
zvCWc7+;DpjlfTSND;ANw^6oJ2kTxdEiE46Zs1N$ozG{|YQohyyz<T;*pQ7n#f6Zgz
zo5hw0Ej%vAPo_LvvBeYY**=zg*9SfUsyIkZB(~azFA_L<yhxlp8vHULIratGnEQZS
z$rtt6HQAt8@TfO7TVlBEkyg0MMfRbC>gb2Kd*ufaS&z4LEA*HPPFYXe1P_30HP2w$
z+|&X07x-9rt&RZ@17|XJ4G<2rzkUWj=<e?yjpwyQ*R)`imzS620!E5uWMwI7Uer9b
z9p!*+9a0Ilx0oIOH<mYU{lfKEIX@iq-AKmR1&p4b-=YC9LHBAq`-BC=9RG=WjpOu^
zQ)K_zx4?=%RZ8+qzeOWaIsu1-Q;>)oT4p~xo2$l~-GUpy1r>&f+ilC0BM;ZD)MuJA
zGACU$h7c5ev}+JYOs@6G51&XCwzG-~`-VqA<^!<(wrV^ULj}>ti{Trs#FEi74$LQ4
z0E^Dpn5$t1PAqw@h7(dTNl8V3PcVuq1-j~6I8??fMI@H~MO~F|PEtspTf#vzRlp5R
z?0q=v%EYvT{P5sHE5-|r*%^apx}bkbG99!)$mcGaIfi5{94e*Hg4Z*5fV_S9ZCMd|
z(A-h9YDLeeaaG?D;DR9J!o?5cnvWN51Huc@1|0sg0*w6A^ZkKPBAka(%a&YoJ$Cho
zAM#TnG?A(pWz8^YJhzZIfSwi)uEfa1EbW&hJQUZ)h}mxVK79J7bMpI9fK66brtHOt
zBonOccvUi(5yTMSb3q^i=wK^78ymJRVmw$j5ak{-bPk0#9qRv)U2uhtCsOU=@Q~FU
zBiUy=P^*E~s;=<wgWPOu=@En#a@g0xxnG#;tqHO&6qK>xHPos>mDz=zxJdIhym_L8
z#$W(+3Rb4=+60c`AtVS02%=+SSIT$lH{em>;o%-f+r_r<wMK3ALFa>wG5@Q+PkR9o
zl#BDcfYo!llIUo7xG#uX8Z+9f<j-3kS`wp@uW4(vEbDJXpQEs+w(HWjE6oO7oA$r)
zCC7;=GqhZ&(s(<TNR;f2AeM=(*-mf`t4JLGx(3_YfH$aMu~@l)8)>)eRuXKN*49{|
zP$*_U^+HQqTf4Pvr}?b^G8XL1K2-JK(S=xgW+b1(XMai>CD8_lp92RA!9y9Iz)6Uv
zu2aKEKxA-2EviiAj8Bp%ffbR1bA!uga>LKOimywZZA{gaT*m6{#&BmhadFnSvh^>o
z{v6iSKw65ZGlrIqY;7KuP%*E4`!E18WT1|EL>^}2sUc{DE$H7BTwP0{xhUwE>qi{>
zNUEi7goFWsxY|O^T$MVzqwN`UEb}8@t~~2L;!Bqa1+VYCIHO7Lx{YspwlYxVFe^r5
z)U02)8mg8`H(vSFqm+ozaa4R>p5J9%?V#@Miw0MkuLHGen2jzw@02RAJS-g1=@27z
z9H8=0D7^rBI5>C|>GI=5?IJxvtUu>9rU6NK1*do1#i5{eWFZW2>`*`Q0M8Z3b{&+x
z|7fT*j<IPMvx>GGGTstb%fbg*rZdXDN8FT0-g5DocE&?$$4;_fhnOa}E4-z6d7ccz
zYg<ff6jhYfber#;zMH<lI(|aq`SUIBR~54pK9v)LTYDq59do13!z|bTSgC+h7=w#a
ze+hsrbxOnBHRuQv5A%$Z4y~dvl8DZ@)k@}^6H1JII2&tEK884Ft&U+>f4e!`3^vsq
zgJGZ*$q1f#r_=$b7Em47iXSW55|rIpn|D`5eS44?V{X7stpxdFDFRb95jQp6W@t&7
z+r_}N_L0lWxvJ?>nFHfR@J8T0QyipaYH~9qPuQ09l=2K$+}q5>_F{pjm-H(L5>NF=
zTq(k}=p<VJ%4P3kQTl>;>dhL15li>b>}C|(*em6kyTg414M2-&MzS5&ixk7=NoqyX
z?29qeDzFy&3H`o1zjb7vC(wFh7j>o%>FA2%YeEsPqH4s}4>9w^(5I#&xVF-++`22R
z%O}bzEj_2Cvj^wcf?76|Gr9Xf^V<9Li`{Qq+P-lsSOZR)`KD}Co9j#PO3k_?B9TZ9
zX{t*TK1BNJ&!>`zFV=uYu$B}QxeHVZk?q>mpMZ$SV~V~8UCkCh1#*8g!louV=++0!
zZd%D4&}X+Kz*Uu)x>Oh2^+LmNYF~;N=Zye!q+PnPMHs$r5A)8J!@opSaBeWLP7oS2
zVe3Jr$>;kW9{XDuIBOtw(dFnopK1_Mtxwv<90NU;ZaPeFiYYu^t2Pg}vha1=;)u>o
z9qU-SgfSuNV-&b!uz>V+NwiR*$;6AQ(NfP?STH4pX?3<vW%=H6TaPfWsjD=qK3Bmc
zb{WtXsDYfyf(DdkbMS85*>yNz^Qr06l<}>}y6=66lX(CcQD2@@_I21XYl@#QLEN5D
zyr_J}KJPZgBhCXb>xvm)2k^*<ZLRtq)h|xa>cK>C_(n|qEjph?2L9%S;b0R}g-SAI
z!ml+2+Fqz)|9xDoX@!4sL4Vy;lvHs8`HXCzy|iRw>@vx@=OWsoy~vGJu|LYSJ(At0
z(~+HXFMLU>A^V-HDb6c!GvL4>GvIO|{z+=84US#+9of@Kz2efcEt!?^8}G*90n7!<
z(>D>5Q$w6;UuCk<<Yp7nB`tChKkI>AREid&%RqJBW9#O6>VeCG#zVjT<4a8Y@{6dH
zxs8rq+0B!fQ^U`yYn@C;D*hO0<Bldoe0C2<<(rhKp^vegZkv+E`|`(Q*jYiTMMup-
zf0?;_17+IFjhKmZ`2Z8IVJg-dOA#feRlFeCQgCtFwipy14nB{fWV2$$H&q?mSA`E3
zLQh||kwylz$eL}3Xd6~m>1jGbqZ-)>qA_}bjE*-x&$4f{El}Jq7IowgMB|J!U%2mO
zwjrW#M!?j!k!h`$zUg=}7p9w0V4N>8g9%!o^VV-5U}JRe<g+MPIp(+4F)ES<L_Qi^
zZX3mlWq_>CaAr%LlL%K-t9&UKpb)=wO#UP&qPB0McVii2NOl~}_F5<OypPW<*<zP8
zfaqsi7p9=t9a}a#4bHLwVHqBiivO%iHd*qflKdvEQ57Vq%<FLpQ~le$ndC;bhW?lq
z>qaW(x5sOv4IQ?nZo{KKL58(2BWgsH4@y18`X8xR6>uA#i)1&LAhEp2$N*4{O7hTq
z&KA}LNgt`LAuv-at9Ts(^#>;V_n-+L*zzJEb*=il*&C{-&%=uewRTT{3F7aXYtUaE
z0QY2;1iZZB)>AO{hK@&@;p(*|y5qQZ8L|y8zkt((^JUKb`f+%;r2Up+wxa5p*66a?
zoAQ^4#;L=NlkjZTeQEQ2?(;#*&)eSXtl8Oh{a4-JhgHtoXUgO7S}D~Zmw;+oLk06j
z8(Olk_C;h(%gZNGr+K<36D6qK&qm$c`LXBM4x*+QwZ~&pO^WtOk$c;=kzGsNJL?3b
ztCs91ZEq&HU5bCa$sQw@x#&u!!bF`AR0+k1AN~FsAivLpYRV769ehoTdUgrDqqrg$
zt9a^`rL)gWG|#bP`a-5-qs)@7lM+QWHMFDIPt3f|&ofVtA9rk)h~>xhi~Ec>_SHHq
z8dfiI-xmZb!h?`l_~NdY^#8`czxcKCud{qK;|4g(X}4`p1v7GT+Hr0%@IM7E537Ca
zn}G}~b4|_poE2Yc!vt(-?FtpvkpU=E&y0m}07Vn2#om|pxVpR7T^2c}zEqf($3wpL
zDJSrOXlZE)r{=u&LlqSjwTz7V-s$2oBDp+q7(5iapNg}As15-O0ySw{!hd;g_*W46
z&v_&W$A9&YaoFl!<O3AWROA)8Zur5rq)Dd<ICg&Nll=<9VIO#D_;Jt7{I6cU3c$=#
zf_s^Cm@gAJ<Qg@q;0s*PcWp<D1}m+Hj|BvQV^8ZyC0>hO#A3Ll!zHBoP5U)2s^CkT
z;kGk-I&g8W8cHj!59CFP07x(Pu%<=*H-)d4mlp&urft6YULm-B+pHZIV3@x8=a7;G
z3Xx6)c$+|CrRab0HKQE>b$0xz$5m0WTl=8n7$^H`4LLqs>JH!@Z~8w;qG}lDwtZyX
ze-c6eWa8dj^l^c^PXEcz{hKuUCqI`4T%ejN0pumxUorq!8&ElojW3|DoKXn+rrmaG
z5ufwgP1gos211DPjnG?DW2n0xd^ktt?5xM8s@tY&9p11#l&7AFL%;#@b@&8`DD+*x
zYV_FaVm_F59$0JGY33Dqh-a^+p^<?(JF*2rGn38U4W?#hRUQX6nXQ+SGtB^p28zqP
ze_tC$D{cc|&Tz!V8T3MRKx{vxyu2L8IVu|5<^c2(Ex!~nVef$kKt6a53#h@&@~N%A
zfCmg0_;~9qANFu?SXFYXd?!qF8*z<T>`@`IV8?sM69^FedW;1EHDK2UBWgj1k=Z6s
z>O(q7A47|ZiGLFwQA0Qd<FLI9GjW|D0&-ia9UIfj%sL{^@#<@Fl~9Sg7HMc`KmZ4+
z;UPO48_(qe1Xed6V08Xk0b*R(4)Zf0vcLy`Kj2^U0d%etT-@A(|3X3k77L>h1!ChA
z6jlIW1ecPM^6e48EeC+~aTde0;V>*qLIRkh>%Rz&Pfh@c3W#3dAS!^QU~-p61@0c0
zw*Ry6K-wAWz*q{*m9^w2O6rwR%AeKq_8ySZOAiEaE)kl4v$-$!qBr%5ryN_1YFfTR
zC+zn$X@~qrls%5uUK&k!?szr5J=?0s9Fj*vWmg4*wLEp^;JCuvm8t>BSrXgG$>Eg`
z9O@RpQNs(F*#_Nk=1q;1%mU4wU+bwi(zcF89sk>eaeNV4VBAtQyicvlZ?1cUraokW
zW`0`xps(oU<z26K=H@um>L$Ow%6h`KlcoFq51#$4?ayxKf(@W_oA#aqNy+H<ywIZ$
zu{TGt#@g=`-SxO_dtx!=E$6<pEEmc5cZj1c@jJd%TyhML%O41G0KR#&t9Ww8$9|*a
zeED58UDjYlirT`Cg$<CFn6J8#d^I!E<~j0p6B;cc91?bEdf-8Xa5A+%JW^a=-0f4?
zh<(^)AjODWf~`wwFh`kn5_)Re)v78jH!#%uP0W5WF?Tof$wuJQu|w_U8{J+9{7uzv
zEh^A0ddZD9Ge?~oe#Gmjy4xC{S<%TojiAE`C2daP6GBSPsp$rONe(HANX7tH%(;Vo
zxu;dPKcwv@e`vmpr_KP<pW(?&&9aN^4ZiIGPs?Cq#R+ClYnK_JalWJN6N1~n*ASk2
zcN$IDb2f)s8&o%tM(zou)Jr_Kvl<_1mNXwG9BxY%moOPg{w51e5iwD+xWTXYqd>-;
zHL;S_yv0Vco1V%(F<-CZ2g#d5yVeRd_(ySW>){?x+m2tSAL`o#lwK>UuN$kLyre14
z`*!Lh&{auqRCaCupg$HCT|NLGTJQJ%GgDG$K*}#(+S%`iS+|^5ZMs=BZ{rt6r<Uuw
ziJzAr!tO-duNeLh*1iL%sjgi&7W5MpR6qnoEYu*N6cLc32pEt~2p#FYH>p7pP>Mh(
z5fBgvC80!0KspwrNiU%zNDm!C=(#)K_uq5woVhc1=I+4^lD*eneZA{_pXXU^A73EM
z$gM-G>z8+wb#shEL<+9BJWal#lcBtm$}Hkhm>sdMUg2N<V5D4!hgIA+U2#W%uiuc?
zNxk1Dmh;!gyb2+%CM{PT8$0A&VWSYilKX>2vWSre&eLi}1Y0vPfHhQL*UdD~Qw`9X
zCS)~u%}?;@iaR8IN_4YpOrLU2>gTUein8+D9675>6|5Z34qcJVe=_SV#D+Ii>IW}5
zSDeiG)i+Y1NsoGB;oz;~#TNkCxhSfW@v9F=3Q2065L48gY47X3Njsh8&{_DcQocay
zJV%S)K0n{!XZ>L6?zjp!5suFWJ5{1KJ<Fz}#ikAp>zR*no^>0quiP*ypbyn8(^cvC
zHrW^t@$fk6qm>+#jusKW73ipHXQrPfqg*4c#^Fni+j~|-DAKIj+-wcTJZS3;`H@A9
zNuIlB*K0dkHSt!Ftic`nTDWPNJ@k2rk@jToV~-O0Wms=&U#0K&%QYV>RW;#ak6G^<
zXRvR$NXF@LNBZbs3(g}e4(l~SxAJRYEL+&VY{|!ZjLQOP=SqYd%<4Q>#<KiLQQ99g
zWvFy{ij|n9Tea~D?*!T4&v1ry*&Y)YCGF5=QQG5GkN5D7-Kn2Es8^c8CQgM~$D!`@
z1-r&Qdv&M*Jyh~>UkdP-bk2UTU%0l>b)Xba{$?r}oq!py6@HApdoj+c*<?vlgU_Zo
z_2t3k$ii0WT|-yJoJaorJ9pz&e05b<$a>7UC)oUCJ<$gn42P75J@s~Wg28FFo(J|M
zvYg&t<>9@`fEUa7-Z)>})bt%6Z>Lw^m~-$)6&mRH8W{ATa_0pBUk|<R=v;K90G=c9
z`$~^rEUITOZrpzTyH=aivw&V4ZE_Y5A}&6shxM{GG}Xv|_bo=mC~Ci(XGh)FBUrjP
z<AHZ{nQ;z#v(Pim*<|)5SpS4;P8pSWah}flhYVdhzlF*Gs45#e;iq(laY)tHUAHec
zbnh#6U(Q;R?&C>&hpN=&rCIX71<kSO_K)KC*zsdmrQ-L0DkO=TER}4@!;HdOzvG0+
zkD1+@BedezX;+{)6i*32OvL7#oE_&%MlIBM^9yORLo#P<53TX}YW2Czf)H>!FMX`c
zQDNr-D3(iv$c7gXuBFx6hxotLO0L@3)mq|pkdDfBYC4z}RYM$ReCvMTJ~f|7Q?RY}
zQpY!sBeGZoa=JHE;^|`mmgg-F#3%pxEY}RSAxr39Y^cgx_nZfO$(6#2#H`2E1f%_^
zVk-1>VUX4^(I!66?WLjy5Yrvx@E)M=oqQVhiaO~gL_zDNB7$tKjPrgrRKN%LC4Lvb
z=7T{--&|5n<4i+E)$OxGa;B}7<iC%ro|3Tnc$9l!&HyZ`K>bw~*KkzboV(4tDGimX
zr&&21^H(pfRdtUM!XqV?n2Db?@WBLE7y|4<kI_TC&+i)<#+P*$8%z^L?*Dqw##{%n
zBdv5@Zq!m1f$>PYVS!dGu_wA+SDfO`*LJ|W_4(kZ+X(MUa}eE?gF>e)wvchgxsM<i
zmA+HuIc2V<MT!`X=HswtsvXW|<qY3om0Uj$$!>lhO<g?|xYznft@|>%6lLJ5LKTn9
z?G@uc%Kz^pyK&^T825AS1Gz1j*ZgX)PGq6)ilN6B&+Iq(Ce(t)eH=py{xe@~dq!?*
z@?Jc}(7TElQ=qd{j%hp`Rcr=#_M&r$?aQ{_&l9uGN%46|!V0`t-3Q+#x2kJ=$T5X5
zGjMAfn)e~hnX`DxZWZ)G@7p~&h&$i$m>SNmPB(L-zfifZuay!qt*H_wC5{6j!v5L0
z(<&csN0pAYC=TXTas9H*-E#%=%IP8=Wj|MYadu4lxa%-ey3R<DcX2}dXjZ6(7on?)
z+9LTndtLXVrMBX{A+xv3`r^8<RPripyONfEjK*Y_7L%NM&%AhMT)MKY)xrCWa-Uz1
zV@);TElu(|&X{vlRHSL%4=&;<X-tY*?hLNhb5Y#$>Qjj?Qu!xex%9(ASjOJ-&iuWc
z2Ru*5#nT>VG7z6v+WXpu59S<hu?`wVY1nZzO9o|ZHf`T67_E~Fhx_Qna?!?6lWbRF
zH0F2Le9QyX8u{IhBd3+80W%gf@+Rlx%J?U%8Jd{dGG1OjsEuyUwDh5r!%InZ^;d>d
z@ud2jgX}gdwUw{O9T;xv$3ejX&?xB|<6`;dtDU8G$+lJPgaM91evD$y*kFdT2T>|x
z0Xb`%YgeoQulTl0m|5LP0z(?S!PVvmG$r2x5_3Zx0x<lN8KVF?CWY%_;`-;Z>ccnR
zbPkUYKY=%10mgB?GW}digLGfdv>VaYHpvsd`buj1rXlvx<>}HmEymwMkKI-P4BtwB
zf^y<Txi*%#Szhd?>CNE52TFgS1q-$|`*-zAnE0gVW-w(0zM;6me5?4`S+orvXOsSD
zn$gIx1%*M$_@)NPgqL5BnMzmZU3Sw;<(1Jy4ouyuGI}X4x6>AuBoT*PN$TSsz@xUk
zp%t}-HA*`MU?j9wRh7JHWO32^2{x-w@;rP$C^h^dEHLV*TgcFUy`lpGk<>JDzX$h$
zE2LC?$9dev%x{?X<eobr==F^~y7a6gY)I~X+y3ZTJ!WpIrv-gUJyEu8W4KD+aXV%w
z7VIl2jh*>}mLa&FF|BR}lFmxR7~Ep@+ERI~^ROmX#O{fb)A}iToM)tpbfvs6eyqSB
z8;Nw-m)XfR$RSzTkms=?=FP2&AEDzVb@HmX=0DF8Jf(LvQ&QL8-guYNIg|BGuNoG0
zD`~%pS@O!vP<Y21h0UtH>ps7yk;Hn{@fb>AoKqFbFw0|?W|)<fkAuHNm3b;bQ#}tn
zgFFe-m7Y-WNEJ+h{o+Tly!6^uxs>*vF>KbY;KZT$$^G;_yWex_NtcA5O+7xU5@$HY
zgSY%u`Z<ZOxjR!}NqfOK>BjT;NAmL%uzsFuUiv3UT?#0|uFTM9r;mPVI0bWnC}evX
zF5gk3@0R(EUxVwr=3~v-R@)m{pTarZe$j0{o3txl^3la+FZL|=0ypF9_2uoBN8K10
zW`;^S-WV?sFUpqMv`UCqOQ>ccV?Z{)Cvt8DowP_1hnCo9isUvdzRo$Bk=jFe>>Gzb
zU}|)2ij@FNOGZ~L%v!tGoT@KvR_v)JTVfv8YY9J5=?Q=kv588{{rjH-mGCS7e9RKj
zTqkZW3uir$OaMDvd#G8bWPm9w22(^WfDQ4rn)WnlV>9<l&e8yF56M1H#2br>$K42a
z5!HsVk^!h*r9Cpvpg8b#GP)Zr8D+N?atBjZpgttPwYo&Uk!Rp7@aR)$k4mfi_|=*l
z49-MDPeC{wPaFY~1>jDSim(HTacB+saF2i3Ys96IvhV#LNTpvi{C79+i@$LUq5$SZ
zXVH%{9jFngb=RP<piH|}b+rL*h=vOU_ZN*6NJH5!{eGZgk!`K|xP*Gx^?JKTDm!g#
z;vk#kllb*9h`Lcpv&wW!>!aI{Vw!cKV}38F^D6+I13A;?c+St`1X>G`IExn>ljF<}
zb?q`<^BYQ^95vdRVBFkJ7~S=0&08-~iRNo!@4%Q&TP(%a0C3a(y;4(GB=?!)t%LX_
zV4oA{drcVHkww#$>NVCib`VMkgZnl)HCZd`-dEblInzwW2)tgdw{p)nf_uL%9vjRu
z+#~Vu;q-99zqzcJ5fx$7=U;FhZxba!l=SviX|=Ww>VSXpXHRDCTwpFh7iEfw^v@k*
z#{$(UMfiIi370y%amE5@20*$7aN8KX$|ieatCqzxWsi5_N))!P<8p$&qst&aH}^ft
z4))W0ouRR@@qfR?@yFZC{KH3l&|4?IoK%%QC~e&$)siItkK4Y!rUH<owgY1TH8Ue4
z!yRxgq)5ZZfW3BU1`72wl!mo?q{59zp?I5+ff#$<t5av0S&yO3hI#;H74T!_0{{$&
zi;Ih1iKX)Q+8SSA+8?Wt4?Xjn`XbAN=Xhgy&A$MKEaF?Ho9|_v2uo2a=$1JdQ2k9>
zsqIh4oMq6^SHRChf9cYTzo<5MZvap$RtAj)NCq?eLf#3>Q3nDJ2e~rSDc+$RZ1aQA
z4#E!C3aq=Rz4{)=osWr$DJ(LwPXxdDc0}~ICnX>#x&1q67r>2L|3$aCpJy#StsRd^
zUdHf4O^mXsHw5E9(ia*_Gvq*KRKCcPLCP04)g1e-D^Il|KtA_WRaFo0@B?JFN(u%*
zF32`Uu^~qtVGzi>uJjXM{s97Ux&_+64}cCd{55sdM!yB!?Jq`m<(2+H|Fffnz)U^d
ziWwW*&-a{K>5AP@LdE3>H`ir4xkP8zeTMZ&><R+t#0VxKd9$Ap_r)VT-SCE95QGu@
zz#~(3KIR(ysBd&aJtoDuQw3?GI@cME`Y>HLG>9e*PKPKr<agUl&6S^owv*tHfBR9V
zp~vEd=&OkgYrkD<SZdUF5}g(@gXu&@EqL;;OxM=v>W}X~-N^#{x@jR1i74;;_mk*<
z|LNBBejHLJRRv|*$-?v#nXd`U_vCc+pdcsKk?!_x9}<>woh0=;toZTHNTun8HmkJ0
z<UJLFoi{K(uC*l!8C0;4xV^qzliRn{Fq3Z72JZy_1NAS3>c<L}u597~nw*HqSdfpi
z(PweL+voqytF@3Bcp|CM+9#TQnh<NIV%Gs<?djjkEM4Duo+7B)yEtdvmTIltoX+aA
zZl%84r$CdFt&iKZA`p!N;!l3F<Q4Zp{K}E)+R&#(*D8>ITgxeg@_Y`ygn3_s-pkZp
zAnhp%bK93?SgFPh7OB=5lYLpYlCyJeBu^#vHo;*|QhU6k<i%S&FDo;wLV473a4RHU
zhAQHR4+8%VOBuXL{e?>qK|8fT)FYnq`t+eEH#v6aU`2}jaq?Kje$C5~Jx>xO0G8ek
z0k_g@6@Pg@?)HAx>nH?e8)G3b7c3TJ%ffF^sF~9ul6wfIW3-+4VK(&fBiav1Nb9az
ztAm-~ASI%;sOhgBLP`MoRA2^+pXfGVc!>J_xP6u${QbV6K#h=L&?ACpTXHTr%ts@!
z*@@6u-6-6p0Muj3OlP_*1q$H4zwI)(<Owjj4g7Pypn%z)8Ne_^CnYTuj~e~?xy|x@
z&V@uGA^U9O`)vCFVt1B$raaS8pkeMzMB<4_RHfs>Q>Y_ik`|^!H@T_vW)K%6_QZwu
zeS*7=6WkT!nU<q43KtjM?EUoEK__BCt58ryiCIv!C&=HRu;kuP_W4pNu^DU6q0MVK
zQ=#lTQC$ENDh@rODIWzyGv;_|_m(9Nh*)^vRC6rOVfew)cwO4mSx~w5vG<V>4>Rgo
zDjzT8N`3hR3jIalL(32@s0P05<)EjgvB=fyo`Za~wYeP(m-+l0LG7lBHt1f3+-K%S
zJG)hv&4}|mox`kag5%iX9hUfY5;kQk2G*H?{6}g%XB$Xs&OFU;{T<-nC60QHGqF;G
z+$+f>@?l!4_Y6~TXebNt7r=M)FesrO3_C#52c1pih;LF?<AaFrPuT}c4i2HGan0`o
zy%h(z5AfIk>{NW0&#+Ue>12Z4?uW;fQ;J%LC#Vr|UYMsG2&IB31Y!t%{qYHN07fr^
z-<XP3#pLJzn!5+8cUFkH(FY*3iF27z%*QX~4!UwPCvNW@yEpd>HHU+!U8d`=OuDEa
zl)Emh{tkH)3}1c3u^84_<W;^f*yg*r2R*+z^TwEvHU3<~&amlvKID~#Q2=60QrM98
zJz6PIi?zE7(ttQAg6_Kslu3L%=8nSVW{)Zh>lu(c)7sivB>;?e2Y}muUw>2f%1vmf
z;HD#vJ?fvxbJ6U_1Sk4SmotOS9tmWM!Y`)X$U$<-S#Na54;8II91g7`0))^w@0*r#
zccc2Nikf|#pmEgSZqqLsXN*KVpN9EbH+3ZNzTT(QyQxvYjzy*{5Q*pF;W?I))9c+4
zkx`_v*(g~-101vu^VEf{9v7%-V%aVH5We2TM+-Zr?Z&FRC`3Ab!<Z4b?I#@UPwn2;
zY6r~FaI7@-@{rH%4*sOC5qA2*&qW0+L!C@Vp53`ipiiw6N8t?q><!C6t@u`#MZ*U2
z0;y$>LUs#Frt5Sbu$p{yVE-aJfIMa?$+90e$yuTDm0LQ2S3&0U$ps-gj?g$4u*~JJ
zkvQ>|R=e}zANB=OYPnzT1@QTMeVHs<>AY4_=hyTS@Tv1J4-}cnhXRi8_O(Baku;P@
ziJ=yNKcT_m7e5o*JdN2(pQ|2Nz7MHlXFVyrg68sAV65v;<;o;Nx=$-7J$xnw#-mlG
zx@&uk?V14F(x&|;1o0=9y<q$Uw(XSNu(!Bte2gx)cZBvYRG`vn?Tpv5!5IEEb;qB>
zU}q_FnoiVxI))dV6mV^2!uq=FQ8mxzVQU4&DZXfT^^^yvrgmS+(qFnKe;I%!ntp+|
zM*gB>AZZkH)>J_uP5~Jt1PM}UbSmg4x432Mj52d?XD|HMlY)<1Wn%|ZY7P>#(o`XQ
zJ>RC?=ojH=>wOWM2|@qO@B$wJG3;QMxwrKu21cY0mI2;&bj>A*bDj|Ns}K}I8V^>a
zT1F;reE9jRLaXG3GW?!S4_meQJ-yUKbavOvGrzhtSA^@H^`S2uEF2QWs{`_+61P8a
z?mqjDv|2DN?-{!PZ=x?ED9F49ZyM%I$XA3`;W{to=W)aVxFe$9jqYZSRCh8Hm2DZK
z>`$~*OZ=2c!eHavO-g%Q<FSS&NgZtZJ6sSIKavhW=7n;~sLYRUa}oE5(mkc<4Pu^E
zxh<i;z-J4#AtK^aLjwcsHnR=-=d2W@KB<V$7|?pc@U-<(XPQ;)|Bg4-%uGtsu<)$=
zO<4Zzx`Jy~l|#2r*J1h2zZSp0AgA~?T+7+{jVaww05AZ6rU|)`1Y$zX3oLeS<Yh2i
zy*XWr%%7Svx46EcwOSfK^yLq<K^X<200ufOUhcHmM|Mu4uBZ6I<HflyBGRw>CZZGv
z-83R@P|5>BqRqlSd7VFGzEPwWC3jc&2>k$Ri{s(#S2amy=Xo}fXUb6iP~$;3_SfaL
zmX`cD<E5`O?izWGJ2tqkBYY<ikL#rP+bGWRM@zc!sBeydj*xaDdo%uO4vFy^E6i=e
zW@mT(fPvZG{ph}<SR07%JRVc(7q2bcpPtJtnWGxZD8^S;`Xn(6*SKCT0-vr~kO^+b
zZ6*YK-4llabrg0=uTOpAET6`D&a9T+pX>12vGIrHYt#FfQ<z+|x^f#*k;WlCiXqWs
z7LMUlDHnaYEMJpmtmowz3E;c5e3msi1QzCk(JHo@I@PXVj^?|=li8V!C_u1w!2oTy
z6unOpwRMb*vRWO9Y}qgF#r<r`S+V<*Q5ixMF|%Ee9#={uPro{)7*X0{s-OR*h$yS0
zCt4en+@QT{!P(FURA(T~)1zRGHK)PwdJhAeO*|Hsb=|XS(KB?)PTN^4!*#tJy;Vcx
z%$iMrAo6e7CHWEH@wbC&%**&36Q*=7G2AUdwT!qItVFMt^GI{4tADlJ(H1u^9|q*i
znp^Rhw*&Ok=KXDII%&CgL)mrduM9srRSX6{twn&{G)kw;mukQA3dYA?$@?b{Tip@{
zJP6g|+(`;zi2sne@4$K>53kX1wQU?}WloplPt$!52+mq;Iqd&xsrIvod<#`n$=2?L
z%cKv-#nAI6H^49~X&H*fi9vVFOZrE1M*%P(zk<d2Tlp`I#dthskqpg_0vd@(?A=?p
zigTZf+1)Ok`m}NG>L4Hv1(XD<=<DDMslA$Pswvo~Oc<hUjSMLPARr3+j%tOA=jQ@P
z{4_WJfd0YBQw-MzRL3quieZXI{nt49l@kZz;_d(?3}Tplq-3fT_oSNLJD9u0d-sht
zH|LML=;vZQtTBf=>A&Kx>DHi%^B+?Ak~Cku_;hk_r};{9mLSA(n3<y>8nqPG0Y<Rv
zKAD^nhgoE10Lh5O#p^Iy%{{RAF>J1#waBAhygiDlua_B}nk{(CUIm`!uzUWxEVxW^
zh_?vcq`nu9)xAaZN=eipC0bPYSq3ENSoDpR_Oth8F`GUyCnB^G^G@5<Rr=0ly?t|<
zqadH)eDIv=%o%WI?tI@Yn2-O7CB#C^g?g(B^6HgnGj@3}+LrE?a$=jtPt)-IU8?>v
zS`{tFEOz5$(+8f5FDYYElHsV5>Ko)6<UepgDtOfO(q`SQJ0$fCNb)15;XMYBq0|h6
zP<AR__Oe=&+{rtySyaxye+!dUc_D{-?GMx{xaO4Y%TUh7mKomWnDl|qL{}Q}RQA1s
zW^n9OUUaSp0=4+%!n7hnOh;XXDf+9vJ#_*q<8Ff!cC;KUg?Zo-os4=rr<LN)l=M&5
z07o-e-~OzXOwxF%shyJ^Q;|tw+F-LXwZ3NZ_S(gF-Qq|(Ug*3#ov(IbFNZXulbb4;
z1N}_bMdeS`?2Q6+ipm`~XY&%~n-*f{l6EqB8rBoITaEVeI6jC`CIcA-N<<h0dZ>T-
zZa8~$;Rpv;GHZJ~#<2F8W%zA&$Z)(y@(K0N1<QH+=O@iep1Dr-b1K}urDuSo)49xa
z*BD|^F^>!w44^W7ZI>xfl4Iw4zEO1gDg;q|_bcw)$5^E}geDI@iJ5rrqvABXJg+{Y
z^x0)?>`+XzVaCiIHw`8aA)&hoO*CIhw4Exqgm_DMYo?R6)t8icUlyW7m~bTm)lW(v
zO6&4I5y&+6{*3kGfW(7aJtgB7xbqGg@cCsCGU~dzv+wDEGIV}F7Ww)}m27A1j1;rA
zk{8CIpLvXLAhQZV4O?*|L;hbMIB1zgMrGvdG*~h~ikq&M%XCxAo!L`#<>qP@J1A1#
zQK2fg1H!dEr3;?PcM(~h>tTKl?+Oq4$Un~DAFQrx7-|-%{zAwiV9w?aHHgjz>Y`_^
z<~&6v@r9QX{q5i-KYL3Dyc9=&F?sKJ&M63&OGQ_9SgZe0<}J$dEqqsy(so<GJCP&B
z0Npe|KiJA{Y!`Q>I7}-kE!)FwIQk!mS1)J%6z|4Jcw_un`W>KDpig`hvL&T_1sApu
zupa;6*f<up^nXgAw+PxiKP(gC@*=+2Tky(OsE0Gy>*quBP?wA$?+vo->lS&-ADfxS
zzaN^MVzlV6{`jg`(n#0tHoe6;^<MdA6I}CcG&gT;gD$&;93u~n5&RLC>@HH5)g=gV
zhBrfMVuHJy6J7N7WtQw#KhX0$ME%zrtf^|RVdaLeFfcOQ4j0jI;kiY9Ka|_Pr#alq
zMNnN#PQ6&?S8;=bmfAwgkj3XSSk3%`2Zb3QpW?bHGf<$)5q1USoIp@Z%wH#p;M<t3
zZx=g;yuA(v*!fl%gex8WWfSey$%o$Fka#g3jNxOucN(sy^w+OseEFj24RM{y7KYp%
z$*eabmCCLrYfU|i_Tx}!H>GO-<@m>YFs!u++B^AzYPg%;%<=i}hZiHRTOj(%HMZhp
zfKy9+qR?p8IM6xO=r+AQJ9S5mB|}EBI5poMz3UG(9ct`&R0YO_R0IkW^QI!$<#gMM
z8#rvgW=puQ?Q4}yUMV(L`rLf|dfrI)vq4tGpe@>;|2mW6TSwm`sDL<)(hJJ`(Y`>C
zYr0LSoC#%oszWexXXN>A1Gm*!64WuOtwmgKu{Dsun7rdLHWq-;Ond&?q=ne#f4_V^
zZ?*N|$`pcrT1$}{ICNq0W4+C_Ykdi{YZ{*&Qus4%<@cDXpV_>N!4ajvZt+HGpPF;^
z6MkLEA84(Z4@p*qx|^!VIxr4rB{@-RY8fn9fsMoSwZr|O*%|q#<$_1LZs80meaJxS
z2*VH<9<SH}%tl$!4T*Xao7wQy4B>)z_mnVkl6Q>I?KxRLd2@1?Nx-BeG5fHrkvH$~
z!yOoe6-icGn2Z}bIiBzjM@^mLV}6CRcFPIo4i_Bee-Rabx%Qr&M*#Uwd=oLmuG(ap
z<&-$ge(nki+C0pR%(VShxeV6e43ZTwgBGv5(J|P>0H%=UWNER~<Jd|a9-L^wTNDWg
z&TXD|E9V}Z&W3S|3F(G^9J*Mx-OqPZTNn1{&*W893UEfi=j#xcu&~nRZpy(H>pjXQ
zyzwnVFrauc$YbeS$#AUlIT1d_wL*%a2T3;V=WbQUm*r|1&&=|YTQwN^+N8K!l{FS6
zm62jC+E13~&rMtY5YY`md%oiV`WR;grwYHo%fT!BSA3Pxg0S4OdM|^J>+wc{3O{(u
zGx!hpfx}$XQE?6Gde`d;8^+2Tt@_#nY?A72terzmued=uDcX?g>hogLv$MR?<d2GW
zt_*ApnFFOvd|Rwntnd}5hJ|4c)9zR~UB##<L>~;%5|?}}^R4gJL!2Z!KE|cRS*xY>
zdiwSVb$mb~c7NZ`Uso?ZBd#G#?>aW5%7`KBnSR_AmZ6kb$p<<{h?ZhRob$UTd+ic-
zfkau;Qcfv#rX3u<g)FSuOt>lx5vTObd(_9vKRPy<{_2&iHy5f}!2T9RdKS2CO!2Su
zkvKr3xbms5-a|f#TQIqJF-6^OKj!*oj&m)}595;Er{|-}LgAsiazA+_@#%ut%I$)y
z-cWJ#j%U4-4U9a$V_0({Mp~|3c^J8Mw*vY#oG#u%Kr;(Cqy#wlB~RDLLJl|<1p0ij
z{b~nq-X<`7Vs^rob2Z{EXa-9Vr4I*G%lRP=M&|odoTFU=8ZPq{u5sSYcvHZ^5#Nxf
zLE{^8g;7BJz>u~bqVA&-(*h<8Cr(4jgCP!;<|j5p-Z6nOlth8!H!9O!Bxg(_;$rKT
ziWAr<vrgxI?$^K;BQSL$RmM;|Wi1x1=dFOzHfk3swp!p^31=NCl-M<#AA-Tu*!??v
z+D1wa*W0@wd=-6r-33Ml8J`)E2HG6~V>RN-Ml4Qx1gqt)tmR#E;OL4dJN>Npz9)Ur
zHo{z@qv^?d4<)T17i(O}G{^nq4)`NERH89NKjYPvbhCh!k`rg*U!lOIn@+y&vaHtx
zj59MSZF39{1@SAqES75X;>+NN1kG~t{<saSb|oyVfX@X4Iug1D1wKelpZdW~rH}eC
z!rdUT=o$xE7iqQKif50X=Co;>E|j7K=RS=dV;ez3_Bk02>S3xK>gu{#er+C9ooz;7
zw}JSWOIg45k=9XNCY045ke#Ev!5{&s8A%~%UgQx7M<(xYW+~qtpT!mE_|069iS;DN
zU2NY0nD*)$j+WdxPREMrtH*wUhYtsUojXwJaz`-TIZpYAYbNgh0E*A2si-KA0vi?X
zqe*D=$7`zdQ`6Ic$|Ys5<m(GCB$kiyg6`^+h!3dp-Cu_^1$JimQvklBq<i-&g;EFT
zCLJF}#NxgB^(-*Rtbjybe7SG-bMDpI8~2VthwdiFi6jDIgxoi8%HR#YljBZxZW#D3
z;e3Fnh>g;RU2|$cVx0|tp|1w1c7+x4-$Q9(rluKVFaKO*1rTchf{lZN18{?bSig;r
z8z1#&C?zU$<n5-o|L4ve?Wx=~0oQLA;QEfB$!yFODBa&BU|Cod%U2KgR;ujNq~V8{
zT{DWNB+wN;NtlfutsB7OfOLQlX}+g%?%MB=g*4t&Y<t6Bfyw^}4v_NPa1_Vi|D^j#
z!TtQboF#gXu+g9BxKy|$B=iB{$*%FkEzx)+(ijRav21f4d><BOi+nho$7XQj=ctZ+
zR2{&CajagGr>Ihzn3z!i^Uu8_obk|`V;FQ0g`f1_X@-@b0QUsop9FsVH@g)6<r@;0
z+js%gTPJR<P8-Ni;Elzi#v471#(pM1+f=?wN@89Dpgn2u!-@caOL&Acl*v1enrx~8
zQU~nPAcL51-=5SE`}L1-hMi!`KuW<R)gC{7)!p4~utm|ZTwhyL2f`8_Z6Zs1hUkEU
zT_*ol0LS=$Fn5@@RtAb>?<l<QZ4({0cYg~c!*>jc?>yxXG(P_@;GR#}KRB44pC4QX
zp!lQ1B6x#4s;V6!b(h<v_E%*yzXQ$mh5Im#B39XXDn-(_-=gXW%z63~%N#(j0VF8v
zIDqdA&mGUJXT?1h;#vU|PyYM!zXA5$mL76R$g2H_d{cis8bCfbXFc{g&;U!5g6n0m
zu6#PSvoU+baQ&TeyfFt-1kf}8FT$1A?ygTn4sEYq-!Yupo(opB{)1iVi>3+x{eVxu
zN*zF7Y8h-oH;e5H9ypHV;#wW;NdFu->SqJW66gb8V7dsbx_z_>0EJXSMK@!F>od}}
zaen*#C;U0!@W^}OT0z^9b+Fc)Gfl%lqz9;sf@4D)B&$0;4nv%2x-#@_;#PS}FAT9S
z@}jz{$g}oPS~qu~>GC@1-jSciUG!)ug6g0BIp`~2#-BJ5(?&zfBrS7@V0YS~U9<D8
z8#RJQ){*dGDa^UGKu-YXN~*thFKE*`Xiu1bN%*Er45FKbX4mEyh#bPVQhSHpf6=FQ
z{AF7rneJd11oy^sP-A$*pw8A&V~S+0EM@GhSKjSe<-QLfawS1KFJn6boJ8fBoKTR0
z2CYytpd>M~$p%|x7Iq>+_4*7{Ha?~EU&B|cL^QlYqSONc{ss{*MfRFr@z%sHNfWv~
z_lu`1fjcq$T~=IKmroozR06dJQae&|0A|ro!~1*U4x^vGYJQ9gu?<AKv<^$x<1ST>
zJLqjSr6j#rLzXK9D~5$b4K!}iI>nxpoh4A{B3HFZRm!cVv%JFf#$%ZN9e_{52+J*R
zzD=g#|4iY5G_=z~KLNR6-~jXUYeRykM!f<Lm)dn2<n#@PNZL4X`(jTXA+?v6qc3GA
z2FOvp@?W&^g+Do8JrYBOtinWI1VT=o%zidx==-we#pq2)gO&SFVVP44)ai`<DJ<UO
zT2wEUz&j;Iqx(rx1<A|*n}4DyLgr$#>j^~&KkW+727kh$!cHy??N>`Z8b<jmjLt+`
z^CdBVs>NuprNt5_?IMLV^SfLsy&@pl_hZ7O=&@5n$vsw1oO6G=yLoFVD;W@k0X{+Z
ze!biw#h^CC(+oceAs(GMof~kaDK7BDdbF0Gp#E%!5`S=~Q;lXh&1$r}(GF82z+VO*
zY<n;9ViKlqwHCzSBoxR`wPQmmTpC-m^~|yZD{;+qnvGa=dCSx-fVP1IA{T?P#=SWW
z2y+b?>p%Mm8b?YpUljj#MsC^X9#pjgb1R|JTIvpGo}Q47K@FSV_kITMZ;tpbuBpL?
zd@|QxIXTY&$Ipf)d)4f%aNz2;X*(SdKck9z%LMq<l4^vUT>T6u<-k%Ko*PN*;P{#;
zKZo4IJK{q3fHHm&J6^RxnGvhVI`;UuIiYwAYA%8k;7y+(@6yfhUmE?*hu%gBDsqs|
zGj6i2J8{1mQ<IqTd$(2IOG-SCiH3}g`3uV+c6<4qp)L~<;$Dsozju{dg)K85ytm1+
zS)t*73aqJsgzwRG4Z1ef&$9arf$3nx_Y=22KeOVz&<To##*~kJszrpUTIOnL*gSp*
zmfyxRJRuLvbz+~%L5kYTH9D#%&2v<g0b3+6`LB@lnWFx-$uG|7%MI}PVemtt$EVI*
z=-&?9oyIQA*!g)HF$i(2R6d!T=a?1I9Mdp{M<SEjPOh;m8teB~Prg=BtehAgIsk&m
z^HWuiGS4$0nyd60;P3I-qh~G%19juWPJs^r@4NLg?*Umo9r5~GNX<Nz6+o=XEZePE
z*kA)oq7l^S^h=dBPiHxrhmHGhDerCds6Ic$)g^rF3V@`=_x7J&yLRalPk_TaEWg=p
zCn8g4H5|TD7Lc}VmckRmPJ8j64;c>(DWD4LvwvIt5)pSF?0zVeGdjNm#^`fm0(SEB
z*z(G>zm)G@NZ6bYEoM|g)a850w=VPsi>yl>3<nO?o~OxDLQt2S*SZV2aaH*P8(Kd_
z=yJfJZEDAWG4e|^z=x3_uH@*?j^x}w^(bjnUAE<ibUjDv=AvH;a>^v})85R;5c|1q
zW9bSBy>g}l7a&9ROP^04L3giBJb?G9fOxtfNX%3f)R|N3suJYSI?O}GD7W)kZ29i)
zIOn_>M-E%}Z{NlybLLDrRb9#y;=R|}iwCGd?Xy;MZM&|wf}0hkg>^{p?>7%$!R$mu
zs++HQL!0#dmHqoPcGiHbjEW1W`5%y#!~6BL{A%@X_$#lI3e_Nx;OYazjv;vNvxyV0
z76{T$!ut>P()_nkMmuWV69tMl_CL?40{xY4hEN0#2gpFw&GSPXH`3<+z@$WXH7Q+&
zg(5rwT-QFO%Qx;IEIHb|7(c4xHh@BG;Z;tcdEf9ir{-_JDc_tGnuVs<3MM`mBofs;
z<ciiyV&gv(&BVM+RNuqC>BF^M<Z!mJw490ilI~Jup%k?Bt)}n#L{ooXCwSs>PH$LR
zSK9bc{vtxDyl&!5j$K{NW7RsGDpdmmW~(r~uNPLstEja(D_oN(zfQ5Zm%@*o<1Yfc
z@u|Hncz#!B66ZlimgxjQF-#mWA0IsMarhp9>l-}4^3*Q135*4hGuy6+A{Xl1$-_PY
z<YA<=4&Nw+=i_|t|EnSfkmB5{|IYJavED7um>&ls8-ay?&977co#k^T>9F9-znU2T
zS`3n%WT%w?v!UwsYBF4qMdsP9JP`OKxFJOlb?0l)3%zq-k@ihdXQf~pt7m!N+=EIo
zB_45WRdH15=XySY=LL7Ed>G|f44QiE;;HwjC!|dO8hQ(?uZecfi?l-B*Er=R{wF`|
zvgW5NPcuR=wQK|XWGlMZaKhvPBIC!*<hFsagt4)dahltEHtE`#EkF${V)+V)PA82Q
zIL@}q5SX0?u24~?{NJG6F;Z<#TwL7r@PxCDkdTm`fq}W$U67q0K)C>Z@7>%i{Wh_>
ze!#=SBksRj+C`C08R$02JW_!8J=WUX+y(Iar#!2WE9XPM+no`OwJ|mQHm7+e+MGgR
zS*}`<%B%u9<YxfXeRKYaY)w+)#qgDjKo%CARHb%M00lf^`3#6|x818Yb78^u_~rsh
zaNy})T|G>9Hz!e*$v;e8^FSHQ#|P~Rn2&}kd-tw=6WE+pQ`6j#_o6KL5;k^rnjRiF
z8dh<0cNpkHeY$MuCJ+{0m~04__X14d7YcV@Sy)U&hwN5*Sfp$7Te%1_Ygy;2j>4{L
z5nOG1u9m1asmEc+8}KOZJ8g47lAsq{p|ouMfSQS!<o@b+=Ihscx3|9lqFQbb<j#Ix
z1T?iO0jyShS{k+|M^(t}0tocs4AmuG7B@n$@yo2CA#)LK()qe*7;dOiF4@*V)@Qb2
zHbTl5NSGZE=uiXHy&!fgfF*3;wucAQ1PpN`gT>u-08~~-`YKlcwyNkYU~<)un$R9C
z%|{s$Bb9;#`^Hh-wn%vn<sCy?%w3p`4Z4Mw(7U*9r-;bjUvTii6jy6yWldx37vi|C
z8R5ITZ`?^?ruOL_)IzU!Ys4prYxQ&%*4FcH?R;Q~&neLrc@O+C0n@9V8PadGgBKO)
z!)ABeR%CG9!gre?VVJ@}28jU0!!d0!WCs?KlKSaevefF3S>}>^i;#HvyqLt^6OD&o
zva#=zEGzmwggbRH-EPZs7fBV?!&zBihXwq?o!Qs23l0tg&SSFa9yJ%;F{PUyGx#b!
z9MLt<z3S8AN=UZZnKp>S$Vqd>SGArZy$=ySg_HtQu6(Z*WPQ??jQ3~Kex5w<+S`kf
zdX)X@mB~d<QR@LK*u)3puaj)(>@pp?!vOElQJ)Ha?izen%OWwdg7_`*4j7ZG?NB2;
zL28+W>$A?DnX;P)0u{-VLm{`P)ZIo~nX6+l`NeGL+IzBYkJGBhjB~$=e%fu7v;`ZD
zcE2ff7j6>0+W9(D9!E5Zym-O-<!Aki-=zl6H%`%BB`ApCz^SWw;}UmCtsc}1k{$(8
z@0?`}XPMnS>>n$HfwlDGd6l=Pi50~47j@O-k-YYnY7s-$c{lW^=uM~G=L{l5a2n<L
z+~tr@Gd@1Zy+jKv?4Z;bR&z%~J$PZMqU+4Mb_4tM&iHJ`snm9jm`rVA1zPU|@XX%%
zn%_&B2birm3z+{w={~H6Sv>~4uoPDIfopjE77?SG@|LyaR?~u$cqS}_F)j(3&DO^V
z20XB*PC3>*8pwGSj_-xmRJj3T<LG)Jd1?!!+u5X5#P6GA(eZYyXKE4FLu=Hv`qr39
zz$iAy(I&c9T_nY-_xBBLQhhEsg{vP2%}yXyYLz^49Lsn9tjf3`E<Dn8*GoO^!G4R+
zL||o-QUC9hKbV?DjSY>QUet_C&O&>I2M(wI-mXnga;)~AVAf=7YW$z%j|)z_uZ);(
z#7O^<Gu-IqV?4ubC+?B`wP0fTM5MMj!%}zLBSxTFpM$Hm$CAF1XVmJF+N(3ZA|-mA
zRy2qU-#P{YIrV&|b)h3@={^iw^<p2C^!Z~0jm5JTH(@kSo{%1hrx2>y!>ON;!;n`*
zxY#$OV(l?+g06!ZN{LDE#@~W?(};*zpf@nEJ78@G&7KhD&W-EJwyvj58}mgLY`b~C
zpKmFs$se<<O2}M{NF}WD7A%xhX-gv4(s(HqSpU$>%<R8R5~CGvjdT1Q4S*t|ojW59
z`=sODNvDXQt0Z6pJO_9mU;zQODrr&$uV0_ctU7&O$ecD>(CWZ-O%@Sn1q(Jrv}map
z`Si;tEi%wRy5C6WMxJLI)cWGt9oTIzV(WM}&RrjN=A^_Hhj1r4uRLqy=N7afN=Lt;
z%{EUto^xb@gw?--`GwxaaozIWWY^MGFERkm8xZylzTOq9cF*&Q37Mfru=-|7W$u=T
z5L+CqAe_$v5i)(_LLtE=vK^Z|h%mfiH%`FsW_lsY3b%{0>w@kuD}Am}ZrgFk?UkW4
zZ67%q>z6j=X}h_lqb^reXZjwG*}$nCz{f%abQI@+xwkUlpwe-y+9q-GEa=4wfOb?6
zbsFmhq&<jH<n1Wes?lBG=E&u%cWu+`U#Ehz9M>{Op2R~CS0^3Yv<<SgAm_ifg>mL7
z^ZaIsiNjFu&1lNmdxo;xyu5p@QP<x43OFM5$GUFB#f#RDHFSghdvq@h26u5}|J;Av
zW^<NFw<SzMoTXs=EUJ3_^)3hGaWJB2RK8OH%N`GHs%>r_qRtG?JV*ZE>G!4T5ye>z
zl5yP!babI`c-`%ow_S!OKp(W&uXItgJO8dES1szV=#XTVfFpiEAnpvv)5ltc%ASz#
z-_4Su<7%c~(J^l*b-yl5<?ZWpNc#BUeI2NzgeUlC#?r;Q{W`7P^#`HtZ9I3E1~pV~
zsg^7l-RNa4ScG30J!>xRZN+jyo@~-OykGH_p(5nqD{HF2QO62cO&;HuhwuMkiv$+R
z`rA@~fEL9e<Fh-T6S+)%_h%AS^y#~IpJ^1f1ZbsybHH5irqOq06W#Jsm#azG;u_Z~
z^6#KNIU$2g0^XO>D`;5VpA{ef<s^diam07?OET4+#A%Ax1XMp(;Xz0k^PWu+A!TJ{
z%>!$kxZn2YT4I5J@c<x{W=tU;Zvsmc0XWozIuusMI!7SHjymE2bsvY!s(;QGS)MSz
z%?<3T7{Fe`r_7WzFIqLJ<5A4RH487w>>ohBYnT8>62#|>Is{b-PS#+C5h{lE_+5u*
z2%j<~E|v>6iVZC1#p%qtW?O4}HjbvIdqZ#lC0bCCl8})7>(}$lDk{*ucTWBUeZT<*
z1rAim&dI@j{=D8dN5Eq>K|n89w`0l-z+Ppa9y;&!K{BS`iEkn5K5;LIR2ucbH<;a~
zeipXPKRnd6xyiZr_BjuI9O`yFBUfd8e`&VY$OrSbX3P^r$N}^4l)1twDTqel=+E_|
zuJO4e_({4*xsc$NZI>k|u#Z*J$GvTdxN^UKRM7i`xr!U%Oz-S|itSQrv_@;M4$jtW
zW8iS=uzn!v_4jv4mQa-9ofHRGst4~ELib;#h|Y`!Ur?xFj#4`B<c0ZOvL?M{P>=1Z
zDu|f6DkmCEy2$f6y}*8uT9YHv+IrMGbQhcJv~dPX@1Q38>a;jgJ$q=#0OFKaBJr8?
zaN-5FQq;GW(t@D9Zt{KyIlsbx`?Clm5-_rA>bAq{bliOX{6^;ZznVS|h!_0C2tFka
zorvZ$drTLA^#dePI$fZ+@?6(G_t%T-%up0f>)zIRO!dJXoS}XE9aW7GSw>%G2624B
zvRk|>qnMUS2Xx`vn|-4+`RptVOwyKDbxTxFrD@Ou@-_QB^UIyH>xN=k)S=2uNt&Ir
zeZK*<LBF*mAA)@q{H=ZHM_dK7XI;U0=?`j9Xu9CcPhpd~+^rUS27GDmuY<5N#)S!P
zpY^s3Y`%>PtmqV}#An$$ztkC<h{hoCjV%e^b@N6{%ExL~Pbq6b(f7<$%;-D~?Xe@4
zTk=U^EW^+hr%otI40;Bv#p-{L=&Rsv6+3%`i2W>GV1zY999f7!#c<*R#&ZV;b%Dt@
z{J!@Il%hbHc@sQK73MS^qfw&u5~EF=?Z{jIQTbXfM0RP#P}@WyXXLw6t28Tb;4?*u
zi8z8})h@Pj3c$WeW?1W6KyA@(n3h_F9`B9owgi7w2LI7Y*S?%`ERCXg#-A<MzBDYd
zq}vlo8_nsvVNrvjsp%HY2fpPM$y0kU{03#ugVjU&WVM&6)GT?}0q4XIwssKKv&095
z<okRls66T>wLewrHYo88C41~Z(SPElF4p-&zoT`*rGxZ#F3E-Td1#VkJn8TWY&T@8
zw(|S&@S%)q!-w?mp5B)Cy6tkpBOx_bAGc6ZB=|7u;7`SDYAkyVpt&mVH7#>%`RDD!
zpEv*gyt(|&8`uKiM*?ONt(Gy8lTH^V9rF*E$yRCpo^4AbBL+atf$kN(d-qPH9DYDB
zW*OzsdD~1na&{ke#eugc|KkP!d_8vM*r5pmJySK@hNW~X?2-ixdyvWd`x6`3T>jaz
zO7gsje;JqL%jX^CWHqY!?x{w2URs6MV9UnRuF2!d8K;`eemL2gG}_DyTcTytTwA-I
zmGfg+|08}eO*%e@1Y@RNf?NWoslQua5a{_bYPmH!&Z*~5;{)<e^M0m=<;;merLFst
z<J+Y-c-}HdUuDF7`NExrB3K8!OFc|RYVAdL`JWD~vFc{J*<f4iBHJeKMcK3h*IvDB
z%Ofykr#J<%xm?L6{Zd0rfrCeLXBrU_vAklmr-p}<-mZr;64$E8>0WTQ6gs!XDW(I|
zmilzg)SUVBAJ_3}M|Xu2FI4|Vf<T}d?NoGT5qyU65pJT9Her@m6A@SV>uglRc;UOz
zYEMW3BfNsLZVSNS%53AQNcOC$M<~}!iE|*|Unn7&qilf!Km1`*G~V?Jc$M0{0J+(?
z`7B^&y<ju50nxuy;F51()h<<t*#9+sAb53_%Y$GRHReMiv5@G+JT+ANpz|@We+~TM
zw+(PL*kBPaD-~#}cC6{a5cPc)E$gDpxYD|N;-hkJavAa{MM>^i`7g}(VXq7hn7O#b
z9-a)u{YOI~drN1g3tGP1v&N-O-i%v!({{|Vx;po@Pg-j0Ln^r{hnUN!InT3^l=!iC
z>Q}W!x7+5ZrWMhvLps}x5JgTd5r;;j-T7=iT{U83H^e`hX<Alp^%gaz;>SNqX06Pi
zcr60tV`F2J5|Q0eGkH_<bzMplj*Dxbs7+H0J~H7~NM%)k^67DS0_gNV-p{|ZSA+Zc
zY3%HXwFta?((RNf9WeQ2ITqFI5;;4?D_wSZ*Q#jTe}M}Meufm@kT_5vVM|L*kKcLl
zS!SLJD!#WJx;yOw@lnHFgn}P}Z4ML8RFVzxvV`~Jc|CrgwJ$=c#4&QphwTNeb$W@3
z>uO6%y95Q-xQ!-F%)z#mE4)mOg;u)oPa>i;cP(a|dBgogz2uK$Z!552)B%8;>^9mZ
zLFK~yJREg0O0hDj+)c1BRP%69Qc8S+=o2I=R+V5L5QftA-#t_Wti#&<)p4S_v${r@
zJy%-T*v{%7A8szW?ue7*B8~mGH`qG2Zxr$nU-m(!QO}skFO`8u94iF~q*z2;=4(w_
z$F6U(yLn{d=$sLckm$4t*$s3SbmR&EI@1SykeGPVZHU|M1{a<oLR&^_^$WWsr@l%U
z3Nji%ri<*jYuhG2N89i~HH};%FEu!@=|p}+cc5Tddm~os@GYOu{uE!0+lEo9xp)5R
zZRPjI!(X`G)%La}4qC&6!bNE{mo&lcaVYOmW<O<8=^p6CrN7QtP@p%16<8BtX-VIS
zOgi_T(6#S3%_zy=CY8I_&7nNjzh|tN=;pRdj;pA?yt_Vjt3-%-D1T{9tc_P;ex9iX
ziHevz3EOb{lT3eWt9vagRJ;8S83Xq>PnM;1D*gu_g!9=of3LybHtu6wv$j-D1Iku7
z@i*9)?Xg~a0n$CWXzp$tMR*)3orK;07`oZpyyvdfJ+(w4W}yU}+N^6I3YA^16w3o`
z2*oBDj?B!K<2#mKs^L@{6FT%REM$(+uDGn70Y%9ECtaeN{nf@11N-0PR=Y}(!`$_a
zsJ!YIHamF((eM}A8`5#zW-RG-5<+=wU_<dFw5!ecyU}KiLYc`)9Ub#!sJ+_vWAJU~
zpOR9oE^Tc}V)Nli`=cG3t*5sHq_=u$Jp}a*I=4IFbLCpnpzAjm|D9fA!LZW9``ASN
zG`{h@<pLK7kK()KfWoZZ(Aw&PL~k4KJDbTuN%5%7=aQu+E30NckGO<(I}%+kLa2W|
zC7p&e3v|*oPR<+Wn`XFMOgY(03rUWxaKdxfm>`Pk0bl9D2<aU21Dd-KZ+E)whURfX
ziWfQn^iYR8@OV0^M<s0i{D8NA(KoshfO%n`n42|?&5+V^$F90tTt{y15h}%aAc;P6
z^Lmn{n0KM6yYCd&Gabfvw+$iPR=`N$f$%(#^x5J`F))1hFaaG&j7Zm+c+$eNod;cF
z>uDB}?z*$X!_sbDVUE!KoGraV6M)f$@RTVKV}*cT`*?kG+qiF`NQA`NLub{>;QyA1
zYRrQmbfW(2HwufBa^1^m6l6#N31$x4af<G1m;Y34woKO5Jp|8eja1)ghTyw?HM0A2
zld9MV+s4uvA3rMet_slFxLO)1c4)PC%@wPcq!kVc?+cZW9c+I&+>N=OHLNnfsLIx*
z8C#MBt9(Cmy^nJ^iZJ?B)uVX1N<2w7Bg8YA(~2?PRahZ$9+(3YVLmfM<IKAcb6Z}o
zELd9>F%OZ|UlGVCe4*0rRM<$Pz}#ZyP78c9KR|Cij?-#33mPREd!;iJ8~F_JUeZN7
z$6kpl;Q|AhST|?f@3q{)MpzLr6x!829ViLt#2**)L-+a())FC>GGQ{X5bzZm9fB>n
z#i`hVZj4HHJXjnb>t6Y3C4$XtX>L|;@1o~xS6%3NTz<IJGNk<7sS=(I_a%5GeKgi8
z-Hy)u_=~<RfVp#fpEG5DDvV!%H7ynW@#FO@f%gP2Cl5Pk%h^9GRZe|o##N}aI%15Y
za=YDq$$tFDOz}t3nZH-Y)K?_#6y0IN4{AOr_$2^QS8U;g)8zaE%8xkq1_P~<B>*R?
z?hYF}tbHFp)PUCwT23sd%{z?}md{_Dhap4gv7MdR&5~_eps%F&Ukpx886vyRB^~-(
z=jgKFiLG^YscLsm)Q9~SjKtm0|7wF!-#o4uV0m!;x4Qy=X-x+K?#Scoe|+GkBYX!5
zub9~aB$dqEkBrAdN%I5W3(n<#lL`DHxmth9&hbb~+3OtWg$7|<wieL#r&vW7{?4zL
z%KtP*VJrM++gXonCp2;8)`R3Widp`jWB`qwaZNz=Xno1~VSZvF6CXc+@%5{K`;wvv
zb(N7(L{hTA`C+vmTv0I$a346hlV02pja)v?{JkikMJUR^j^(~PwZLtbm(GI%pGt20
z5~>8GECE03U5fe(<+^$6zc^p(Z`W?5tmIZ!4$V2%zy3EbZ*Vvqy0TIa;3*1L0zQsd
zare3CRKInIVfD+dxx)Gkos&m~HHdw2b>jQc*_oki0XjiJLCkDyctD-GJ$num=)fxG
z`jj*duUp^P@Yvn7v7|RuRsU-wR%z?#<O1-5%&HjS4oT9-V@_=)?^$Z#zz0BV*yZfj
zjbjMkQJz}?yKd`8PFjHNe;g`+O$xYGfY1N@^56eUvv{Q3e)RbNrJ+B{#yn#;b?2ho
zr_-A3R137VP{*UAwg!Q&-}^67hJ^pj@4&4z|E`>Xw^)o`=I?7jfzxXL+YJ8y`T$LF
zg><tUT3v*J0`-9Q8EdUXqPGJ?r_`0?qE1S%iVo%JRT(bHy5+Iyys}%e%|}O%IwET_
z<Yxu8=7OZ#9JYx(s&1Pfln;e{Cl?6;bg+?A3xku@OIxEqC9n3d)Kuyi<F4=hRJu_>
z>%XnamOE=&gIQGax7Xgou?X7yzzaU!=dj^-R$hwCdv8~l{gUjvtaPT)ANrzCb3C85
zr%?m0|A?B2waWb7-NUt6-{6q`sg$rJ`HflDQ-7p}>cGoe;65h?(w9A(+f@(K&@45!
zXfbT6%){EoXHQbcJB`oJB){YkI^;bV;2dWg@GH@FolKQU9k-BHHmPfr?kt(M!c0pu
zNHU9vzkfG$e_3-~c-ZR^DS@`kyAYAMf(&MuLzl144%S5ODN0XP7b5A`OLH@<8uP$z
z_aOWD_dHs;Gu6!-H6||7zyDatAk;u&x!+C@g;Uk@e09Fg&l%F)IkjM)s~OH!y0KDL
z+9FZ2@%?m&0duP>=38pfW^1JjTE6|g)I|ZwRd=<+SB{1cdva5|9!i5g^o{<IJi+qk
z1_SWI!gS43cj&q#vV)jC%NL%TMI}i42JiOy&AhHWD^D+>NOwny=pme2IDN{Emgd8)
zLqxWewR&WUtpE4C_XL8PtYJ7}pv|}O_ZNZ0J<U4)e(^rZVp-W+QF^xRxqVeP6>x^$
z@{KEwOjpT2*8Q8tt2kGlpA9whZbSurldoO=p1JN>5LU%0Tue_Qo^l}Nrjee1n-$8D
zQLO>9h%<0w622!~#eW}hNHr#&Pv{UGR&v}&>W|(Uk99&YkWOO>1qn``{zhjS;AbtA
z<Hb$f@6yHO<2AJlY+Fjo_g%Wz50b_mG&kNeqW0pxx)@&}dDLVJ_j(w$Yhx#U^oLe{
zT_JZFr5FnV@cK{E{T;yRd;hDw>kMlu>((>ZK}JOx1;-%@Sb|7bAVdfdN2ElW1VTgz
z=+GtzL6Cr$kk|l0YG?vNL`oz`kP;x2V51wUp#~Tw6e&SMPayf?_dRo;=l;I;d+z;l
z&+mQC-e;Znto5#U@4fbm>sL9lo0|$rHV2Pg@GuvB8>vhtkw|UBNN6m68L>L9V|o`9
zTwMT!!}(pwi9R)gvE??QP6Sj^YV44jTDTTJIzV|krLAN_Ck8L3(=Ay9z8|-c+@#Df
z6ta6wlCzf@<+lhhSOJ#|jeSL!)fp$A`+jeDz^JtDlS^Mj(QP+XRFX+YCKB<<-`@Kx
zZL}R(vUJx}i%G?c3)^sDPg#9oYa6b7W@Q+RX(5OclQ#$gIG1kUa>}}^8|i_U4`1_#
z6%=rX+j?(Id!}z%5}OLR{#<q<^RbDvN9pPcMXZ=<`yA4ucb->%zDc|yR%D&~-X-bC
zsinZRA3V0hxP?m@mo78Kcy4^Qhxx~@p-olN(kYLf6a0arWX+8rm8H~61X0Xz?!HNn
zjY;v21$U>=t<s1m7B;qR(gf(;F}YpH<m|GXcqMU{a%pU*_M}o^u7~NkU~3xOw8hGT
z;s9bRpa@UAzGAz&>D6K)G7hBUD@Rv!)kUs!p~MDV>E8$7_rXnPr=Dn{74Zo#Y7EGY
z^qLZ~ZAG8ySCy?#>M+UQAWd&&5^z9LH+JU;x#3{=a!ldm<&!E!%1&qPx5eN57C@o_
zWzX>0lC~qtJH~wfg)A_SQ={|S(T#@?!fxOZNgeDLhE0O{)`E9Fbb~Yv$a-P^0{=AK
z;K=2<zV4zluA$W3YyE((ep%S(d-k-i7Y#d~406a0BLxZj(u|VJR|6<AIWJ#2L;`KQ
z+ABZ{s8*A6uFVns^CWvX!n%ZN|AFa{w0w{1>guF|{s{hcXTWo07nM+GHgkEUYE`Dt
zJELSe4%Peg-98KH;0y^KuV2{dgF8=3fzo_ib06w^XONMOr3F8hG1A}Zp68L|YeOwc
zdC&dn@zk+U^K`X{?%@+lA;|y;1QB+U8R*5kxw{pbhbKF~(!&;ZM%Z*}BW-icNc!g#
z2k#ydwwm4<o5`U$PQhsoQFcy)#n(vNjv5p98Z37jd=D9uzx`P@Qg4}x=%FPH@N0cN
zIN02bkR(3K52rv>yN@T{Td}Q}R0_+jxyC%_x?S@N-`#oRDfdqrqByg+dyJX;4$S4P
z!Xo4SUJeOdtn8Q`DqIKG+ch>u8}Gl>TJPa*sU;c#jHXh|Sn&u8OKn3NIkB2;B(Obi
zZ|kmDku1zHG~8PsEOk+r4Jmya1bzM8?>YQn`1k=~4W|C8I`HW<{za`DN#CHH*>=$R
zImO`<Zx5oXrkyeQ@FV)=gjO26{a}~dT%?qi6&#bU`{g_*HT3YtrGUd5Ne@KlU?8d{
z>d5CfIrT6rexiC6tA2*Vc?PVnsEj+n)y`BA?dz>7_|m|^22k3a7m~P$TNkHq{K?6O
z>-n(>rS?c|r;<C_Kglsa!=uBlC9EIF(J<&c^TuHP_ieD%@d?Uh(q8Wx@1_1ZQHAoP
z_SeTi#IRRAWv3zfkP$hl0W}6t3!zq)>fSG;kXB4_-Fz0Q@d?qXVT+(AeQILCmIEHr
z>~htbSeR>&i4*(01NRStG!Gkee0|NIC*&s$sti_fZ#mzbmw(3XLP#9!vr_)F0kyID
zM#xWLt=+Yj&Ey$JL_gjo_r4uFZ6q$iE%@na(Xe{xdEi$6sPa{X=dw~$8L0?VL$H?L
zZsBp>(PNL6^^Uinxp(Y>W8QP1n$FFX<c0oI9V9OKTK1d#`Bb}-Ig+(vTJ`Mlj?igL
z8~At{qNOHxjk7;dkg7t-zna~s8n@~J_hfhYIGUJEyQ<y+2Ms=xXrcgwX5gc-vYr4i
zd`z9!w|5JuhEzB@e!?+LQi?}zL|~nm&)-Odd9y3BL+%GxHbc+;%J~+M5R<fJz|%9}
zIjDYeyE3&4f&xTwu?&z_ba1P739|!`y|x&=8EA|b;+ufRAYfRTy?J~o^&I;JS9p$h
z8?d;P1}V9?xSx^%J+nw93$LD>kz@8yXgAuO&xB`r29;5fD+x!_RZn#(zro8@hAk(?
z>P!TNT;a3an<FMaA6;o+^I3-~KM?h-9|n74({x=G*J<wd){$gQieHV!HgM%O!e7?5
zsnmg{G2;dP`na$>C@~h&<x3u5)WI`fRn=(eHACwwTr#M^px#9%+uLPPk~0MQdW$~4
zu)yZ(q-DZC5grR$-j_lpj_0UU(ymu$0#kl^mPT2VQ+$74iCz`OovnL;v}*+m6!~lD
z3kYh^hamhNr$M(}q<j~;>&M3RH3q#(dG$lvy}ImYMPr)h#%rxf+Y!OIhdoo5B@vu=
z({aq;==|buVV1eUU`}S~!n;MG@!EZBTKPqgfzwmM!+{88;^-c>7p#w_jZ(;pJ^cH-
zEWliEA!cR2jOICg-ttobyZbe8iyONCOdWZO$`aUQ1*R`#Z?+~c72dnM5SoTGP`iSM
zDPo(81W8pRk{3#)xP;c5VQGdrOa6$d)6uH^_HvJB@DJ`2Y_0bmsO2gpG)Me#iK%Gt
z+V*lT^zoKYj>!|^y93TlhHB8niSLL92D=MSh%{QIxL@NBbQo%U#9^DV2m4aH6t%YX
z+5YtlNWLjDl8e5X4#{^xp=NB5{v&aDLD8@;WJ;eci&_qoW7>h(pkiEsjaC4*Xb1W_
z@C)HhOV>TGydQ$^*+zpI9qvs{W|Ea*KIF?fVI_3qaq!!u?c5v1Mesrh!SML23xV}@
zmdE@8X`FBS<E!G_(%97{gEJWuOBuvA%6Ro&Z}hcsyTp$h5u4{HX{S2Qlw4WyPK?^_
zxvf06M5?svwW@JrvY00TmYkVi4NOykW5Y%7Pb3;a8ajfjsh?gUHA)tQo4%=?!)|$+
z@oj9U;^2BzD2}0??N+|_fW?r>%nM3vy>!JL22Xy5vQC5o?K2$Bv(jrS?ZGw;Z{|dg
z#p@D3LD-No%&u0FA6Z(r<aj=KKX+?j?u+zM==O&}`<0<Be3AUIm|s&X)kmCZ=kSew
zC2b^&I_z-$aP$Y@)YikNfdfPDHz%a#XR>hzH*&t?-FAD14*k;Pg_+H&Yb`kG8_8G~
zT~%Ek?0eauO-@DR*9AxeQq~yiuP)d>F=7{V=3pz{h1!$e21ToVQC3=HZ`JMNPZ`Wr
zw5oPZ`4|RAvwOM=lv0>Iyu@1N28nlZk$9Ku*%<zLMN;6`iSpvQ@vjFNfMb$Uu;oxY
ztTm}_s%n&7Y5F8V&<}a0;u{&!y7u$?`|hYYrR4m^@V>x8pHz=48<Cf_mL{{(^W@mJ
zeihbPN)Bz0G|U%%3xoCUGU^-4tLt4zi*H-$z%q-SN!)z_6?-lj2YEDZEmo*C`(QCA
zf%ZsBgNq$K7raz+5~*jly`m23$1z+Gq1hEcwa%j077O-}*NAtUOg!$SUv>zgk~Kp?
z?Tu4VY#tkxU7k>zC_6J?*yLfxbf*u>qemu6r!~MfjJFen$GA{$%C_jlng_<oW#G|n
z?Wz*u*l(`*9sR`3u2x!6(OlZixHvf~#*c*ReXa9+f5va^1hR?MmX9Ou7x5#-D*UNM
zZ_Z@<igPD8hMZBpoCu<dG<Hdf#k?{Y&I+6d3hrhJpCfZT;dzx7Q=?M)ur1TNxYfr+
zjR8iE7!Q##Y8bGXS4M}g`y_r`Paf#5egD(4GQtB#*><tRhUPk=L!&CJ=lh3e;GQ&(
zF;)&hm#sbPAUwg74%(Kn`gQMd=_{eRwj}wV0~)-tv!5KOavBN-P2DcW0hiY;cXj}s
z)HF{@nOx+qy58~9gO>GK8gdFftQ6Lx74BrbFtnE+J2mvhceK^SI{W|((AOUYZbaKg
z1HBKUcbMc8_LOUlF2U8g;6*34iq8{bC_2ZT(W_cEq0>}jZyWB(m#TDfoH@(Z^=fG`
z`LQ_maCYy&VL`e98BB?g6Qj7oDv9m<8;?^8(8vou0NHVHkO$f}yl|#}WFbjk)8o22
zdWU0w$dEh>SX3x)Lbg{H`#)JvNuQCu&UC2=TW*3#t4u7QIbm(z4P0-ib850_y8Ea*
zqoqL8cWwP)uyBayZhvA+up5|GjEP1?rKBwF;#b`TY0aNC;GMPIHuL1iTTySlQZ%#D
zaK`4CW$_%FV%CjE!9mdL5^7TMotjkaol4SQT)P><l6|*#Qve)B5KcnYOC7|giEe(W
zKv2ij#yls>3(%c((<bs0UvYq+(|5(U(#^A{7#FjDHcDQ`3ZAa}F(g3Vms2BmK#H5<
z^t4)((q|Xc<+vI#s^M{c417c+pA={VH!t@uSyEn<&`SHrPtG}D+?tuL$2Jm*d2Xpy
z>TV0kn$jOtMVL+I-fNKSc{}~}TV0?i>affv&>L2~r^c@#;-I*`ed9D;=L;cFz$p6=
zVLIHQp`EHviQI2Z+zrx1PyXzEXl46;Cs<=$TO|E7uS}>C#0@W*%6`<<`PXKdY4t=Q
z`f!KK4O;x;!6DW>x}P$B1BL*N5HfcpynI%sk|n7(H=;-aTGm^NK5eE;jUADRhe${s
zLrqEr{RifKTt{RiV`#!+x9;!4lRW8L5)kT2K<MCJF4<_=V#FT5ZPrus+%SH<rnuBT
zjQ+uHGs>Qa7A7Eg#j+#p0dV7r{9@0|x*<pbR14)AMG48Lpil%D!du;-@9M3KLFB$G
zgDPv%Md><#X$zCNg<xxSCwfExeliAkBh%4^wA*N8YEN_ZKrR4|bdBEbAoZ2|#gu$|
zd3OW?g8!LQSY~rr%nlG2djzn?0PWPXGk=x84N7#iDDR*G8H0hQL~|4d=E7F5R#5zi
z8j@a41W!Z<uFjHtojT3-d``lwx;Zxi+0TY5F4XEMC~YJObk=5D`r%J*u;TA>=Oi39
zH3D5XtmH1cuu)5XjV!rBz+xrP`DzXZQ$;lGEtRx1@>RX#Y5m5;=X};RoPzk$v3`6d
zGAL2wd!T%(C9=L~YTlIUMgi`G=~}!iqrAr4K>-}opRuP#we>192G@#wZ*gReB{b&i
z6Qzg@He=iU=s<tG5<P5-K7FlUX8m`LELW1=dPSd1w)!w@_t*G7>ANB0!=?K*+`Na`
zy;yVKYF5*aYePA6&iQVl+a>Dk8)LOjw5aRZg8GsgrI-7|`@i_7g_Uf*NeB)9W8%@C
zRj0P$#`gO`Yq!NQ5T2tF2w9D(%k{$8W^hVNCafmo>M!!E&a>-ae+^bEI6t3hcsBZq
zI52w+y3%^=<3aIZM>CXP!0q<3y>t}Dac$T1_8D(~4l<iWVZcjGqeo0~sBXluMsG|9
zyt&XF`^=yxQlK8y0_EYA;Y3gRNEF!cw1oE25^|)m>k6kPm6$z+bGrwNIx+H~x{xVO
z$D5C1DA@(*GP%oO32Pod*BFdp`_OSoGqP69t!UzAGzdzR%p0dCa2{@!Ril{DH(NeB
zUvl4I8zp=&xWMKR5e8T+MWAM$c8mzvsDO$i0;4^RxzncI=B-luy$rF8CUkcE#0Ia9
zKv%P`RCkRCuEO=ZplSF(f6m~gAmO}#{U0V3korQ4jBTIoU+RtEMURPB^G#+DHO+S}
zV%RDScf)|(OnXUsCw)iqN1XP#ckBwfd8R*Nkpw7-l}DAHMVcex>p~beH()^+s~t=+
z)u-NMZxQz^=X7|PquZE-a!1Fer#pSrBIOsEXW&?w4U-ADPzFE;MDu@8syV!X@M{PO
zn3Tf01!WW%BSKf_g015_{L7sKys7A*QncQ&S%eT{Ks@)O-Up(&l_%4o(C8X>ZvL!9
z-`=cMJzfS^Y|LQ89gBt>3pf=3dab|)@|&811fKke+z!A9`>MA`LPR=?Mr{dQTh9zU
z3)fx8l0#ou1ZaVRUp0hN+Z^)KX(CW_;v)h2&@$ORE4B+eKT>Fc&}#l?1h%fL_W4Cu
zRI8dgBWuGP=C_$h4){87iwV2Sk*lXk(oNWQLtMPL7p_4vV|$;*=ar?j&7=MPys(Q@
z;iotfnz>^lX?DPK^1$s6P+QgX;4%JMX{xJyJrm@zY^JNrlg9navfp)2t2&7|ew($J
z_Ai0?R^Wfm4F7NFr2l>;_P^1?vDix|59UL@Z!-Pom1OgOMqmDWNdG<s`~Q3R+XDZi
i69a!g^uK<%74Z*|jFq^N&*7Ti8^Fx%F3~PtfA9|xrB)39

literal 0
HcmV?d00001

diff --git a/docs/book/index.html b/docs/book/index.html
new file mode 100644
index 000000000..4e3ab79f8
--- /dev/null
+++ b/docs/book/index.html
@@ -0,0 +1,340 @@
+<!DOCTYPE html>
+<html lang="en">
+  <!--
+> **Warning**
+> ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. 
+> ## Please edit the corresponding file in [/packages/mermaid/src/docs/book/index.html](../../packages/mermaid/src/docs/book/index.html).--><!--# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in packages/mermaid/src/docs.--><head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
+    <title>The Official Guide to Mermaid.js</title>
+    <meta
+      name="description"
+      content="Landing page for the book The Official Guide to Mermaid.js: Create complex diagrams and beautiful flowcharts easily using text and code"
+    />
+    <meta
+      name="keywords"
+      content="book, guide, mermaid, flowcharts, sequence diagrams, class diagrams, state diagrams, pie charts, Entity Relationship Diagrams, User Journey Diagrams, Requirement Diagrams, Gantt Charts"
+    />
+    <meta name="author" content="Knut Sveidqvist, Ashish Jain" />
+    <link rel="stylesheet" href="https://unpkg.com/tailwindcss@2/dist/tailwind.min.css" />
+    <!--Replace with your tailwind.css once created-->
+    <link href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700" rel="stylesheet" />
+    <!-- Define your gradient here - use online tools to find a gradient matching your branding-->
+    <style>
+      .gradient {
+        background: linear-gradient(90deg, #7557c9 0%, #f4f4f4 100%);
+      }
+      .p-shadow {
+        text-shadow: #7557c9 0px 0px 5px;
+      }
+    </style>
+    <!-- Google Analytics -->
+    <script>
+      // prettier-ignore
+      (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+    })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
+
+      ga('create', 'UA-153180559-1', 'auto');
+      ga('send', 'pageview');
+    </script>
+    <!-- End Google Analytics -->
+  </head>
+  <body
+    class="leading-normal tracking-normal text-white gradient"
+    style="font-family: 'Source Sans Pro', sans-serif"
+  >
+    <!--Nav-->
+
+    <!--Hero-->
+    <div class="pt-24">
+      <div
+        style=""
+        class="container lg:px-24 max-w-5xl px-4 mx-auto flex flex-wrap flex-col md:flex-row items-center"
+      >
+        <!--Left Col-->
+        <div class="w-full md:w-1/2">
+          <div class="flex flex-col justify-center items-start text-center md:text-left">
+            <div class="flex flex-col items-center">
+              <p class="uppercase tracking-loose w-full p-shadow">MermaidPress</p>
+              <h1 class="my-4 text-5xl font-bold leading-tight p-shadow">
+                The Official Guide to Mermaid.js
+              </h1>
+              <p class="leading-normal text-2xl mb-8 p-shadow">
+                Learn to create complex diagrams and beautiful flowcharts easily using text and code
+                using Mermaid.js.
+              </p>
+              <a
+                href="https://www.amazon.com/Official-Guide-Mermaid-js-beautiful-flowcharts-dp-1801078025/dp/1801078025/ref=mt_other?_encoding=UTF8&amp;me=&amp;qid=1628153965"
+              >
+                <button
+                  style="background: #ffa41c; border: 1px solid #ff8f00"
+                  class="mx-auto lg:mx-0 hover:underline text-black font-bold rounded-full my-6 py-4 px-8 shadow-lg focus:outline-none focus:shadow-outline transform transition hover:scale-105 duration-300 ease-in-out"
+                >
+                  Purchase on Amazon
+                </button>
+              </a>
+            </div>
+          </div>
+        </div>
+        <!--Right Col-->
+        <div class="flex-1 md:w-3/5 py-6 text-center flex justify-end">
+          <img class="z-50" style="max-width: 350px" src="cover.jpg" />
+        </div>
+      </div>
+    </div>
+    <div class="relative -mt-0 lg:-mt-12">
+      <svg
+        viewBox="0 0 1428 174"
+        version="1.1"
+        xmlns="http://www.w3.org/2000/svg"
+        xmlns:xlink="http://www.w3.org/1999/xlink"
+      >
+        <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+          <g transform="translate(-2.000000, 44.000000)" fill="#FFFFFF" fill-rule="nonzero">
+            <path
+              d="M0,0 C90.7283404,0.927527913 147.912752,27.187927 291.910178,59.9119003 C387.908462,81.7278826 543.605069,89.334785 759,82.7326078 C469.336065,156.254352 216.336065,153.6679 0,74.9732496"
+              opacity="0.100000001"
+            ></path>
+            <path
+              d="M100,104.708498 C277.413333,72.2345949 426.147877,52.5246657 546.203633,45.5787101 C666.259389,38.6327546 810.524845,41.7979068 979,55.0741668 C931.069965,56.122511 810.303266,74.8455141 616.699903,111.243176 C423.096539,147.640838 250.863238,145.462612 100,104.708498 Z"
+              opacity="0.100000001"
+            ></path>
+            <path
+              d="M1046,51.6521276 C1130.83045,29.328812 1279.08318,17.607883 1439,40.1656806 L1439,120 C1271.17211,77.9435312 1140.17211,55.1609071 1046,51.6521276 Z"
+              id="Path-4"
+              opacity="0.200000003"
+            ></path>
+          </g>
+          <g transform="translate(-4.000000, 76.000000)" fill="#FFFFFF" fill-rule="nonzero">
+            <path
+              d="M0.457,34.035 C57.086,53.198 98.208,65.809 123.822,71.865 C181.454,85.495 234.295,90.29 272.033,93.459 C311.355,96.759 396.635,95.801 461.025,91.663 C486.76,90.01 518.727,86.372 556.926,80.752 C595.747,74.596 622.372,70.008 636.799,66.991 C663.913,61.324 712.501,49.503 727.605,46.128 C780.47,34.317 818.839,22.532 856.324,15.904 C922.689,4.169 955.676,2.522 1011.185,0.432 C1060.705,1.477 1097.39,3.129 1121.236,5.387 C1161.703,9.219 1208.621,17.821 1235.4,22.304 C1285.855,30.748 1354.351,47.432 1440.886,72.354 L1441.191,104.352 L1.121,104.031 L0.457,34.035 Z"
+            ></path>
+          </g>
+        </g>
+      </svg>
+    </div>
+    <section class="bg-white border-b py-8">
+      <div class="container max-w-5xl mx-auto m-8">
+        <h2 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
+          Get up to speed with using Mermaid diagrams along with real-world examples and expert tips
+          from the authors to facilitate a seamless development workflow
+        </h2>
+        <div class="w-full mb-4">
+          <div class="h-1 mx-auto gradient w-64 opacity-25 my-0 py-0 rounded-t"></div>
+        </div>
+        <div class="flex flex-wrap">
+          <div class="w-full sm:w-1/2 p-6 flex items-center">
+            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+              Flowcharts is a diagram type that visualizes a process or an algorithm by showing the
+              steps in order, as well as the different paths the execution can take.
+            </p>
+          </div>
+          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
+            <img class="z-50" src="flowchart.png" />
+          </div>
+        </div>
+        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <img class="z-50 w-full" style="" src="sequence-diagram.png" />
+          </div>
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <div class="align-middle flex items-center">
+              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+                Sequence diagrams lets you model and visualize interactions between different actors
+                or objects in a system, as well as the order of those interactions
+              </p>
+            </div>
+          </div>
+        </div>
+        <div class="flex flex-wrap">
+          <div class="w-full sm:w-1/2 p-6 flex items-center">
+            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+              A class diagram is a graphical representation that is used to visualize and describe
+              an object-oriented system.
+            </p>
+          </div>
+          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
+            <img class="z-50" style="" src="class.png" />
+          </div>
+        </div>
+        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <img class="z-50 w-full" style="" src="er.png" />
+          </div>
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <div class="align-middle flex items-center">
+              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+                An entity-relationship diagram is a graphical representation that is used to
+                visualize the different types of entities that exist within a system.
+              </p>
+            </div>
+          </div>
+        </div>
+        <div class="flex flex-wrap">
+          <div class="w-full sm:w-1/2 p-6 flex items-center">
+            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+              Use State diagrams to model and document state machines, an abstract way of
+              representing a system or an algorithm.
+            </p>
+          </div>
+          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
+            <img class="z-50" style="" src="state.png" />
+          </div>
+        </div>
+        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <img class="z-50 w-full" style="" src="gantt.png" />
+          </div>
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <div class="align-middle flex items-center">
+              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+                A Gantt chart is a graphical representation that is used to visualize and describe
+                tasks (events or activities) over time.
+              </p>
+            </div>
+          </div>
+        </div>
+      </div>
+      <p class="text-3xl text-gray-800 font-normal leading-none mt-3 text-center">
+        These were a few of the diagrams supported by Mermaid.
+      </p>
+    </section>
+
+    <section class="bg-gray-100 border-b py-8">
+      <div class="container mx-auto flex flex-wrap max-w-5xl mx-auto m-8 pt-4 pb-12 px-8">
+        <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
+          Book description
+        </h1>
+        <div class="w-full mb-4">
+          <p class="text-black mb-4">
+            Mermaid lets you represent diagrams using text and code which simplifies the maintenance
+            of complex diagrams. This is a great option for developers as they’re more familiar with
+            code, rather than special tools for generating diagrams. Besides, diagrams in code
+            simplify maintenance and ensure that the code is supported by version control systems.
+            In some cases, Mermaid makes refactoring support for name changes possible while also
+            enabling team collaboration for review distribution and updates.
+          </p>
+          <p class="text-black mb-4">
+            Developers working with any system will be able to put their knowledge to work with this
+            practical guide to using Mermaid for documentation. The book is also a great reference
+            for looking up the syntax for specific diagrams when authoring diagrams.
+          </p>
+          <p class="text-black mb-4">
+            You’ll start by getting up to speed with the importance of accurate and visual
+            documentation. Next, the book introduces Mermaid and establishes how to use it to create
+            effective documentation. By using different tools, editors, or a custom documentation
+            platform, you’ll also learn how to use Mermaid syntax for various diagrams. Later
+            chapters cover advanced configuration settings and theme options to manipulate your
+            diagram as per your needs.
+          </p>
+          <p class="text-black mb-4">
+            By the end of this Mermaid book, you’ll have become well-versed with the different types
+            of Mermaid diagrams and how they can be used in your workflows.
+          </p>
+        </div>
+      </div>
+    </section>
+    <section class="bg-white py-8">
+      <div class="container mx-auto px-2 pt-4 pb-12 text-gray-800">
+        <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
+          What you will learn
+        </h1>
+        <div class="w-full mb-4">
+          <div class="h-1 mx-auto gradient w-64 opacity-25 my-0 py-0 rounded-t"></div>
+        </div>
+        <div class="flex flex-col sm:flex-row justify-center items-center pt-12 my-12 sm:my-4">
+          <div class="flex flex-col mx-4 rounded-lg bg-white mt-4 sm:-mt-6 shadow-lg z-10">
+            <div class="flex-1 bg-white rounded-t rounded-b-none overflow-hidden shadow">
+              <ul class="w-full text-base font-bold px-4">
+                <li class="border-b py-4 px-4">
+                  Understand good and bad documentation, and the art of effective documentation
+                </li>
+                <li class="border-b py-4 px-4">
+                  Become well-versed with maintaining complex diagrams with ease
+                </li>
+                <li class="border-b py-4 px-4">
+                  Learn how to set up a custom documentation system
+                </li>
+                <li class="border-b py-4 px-4">
+                  Learn how to implement Mermaid diagrams in your workflows
+                </li>
+                <li class="border-b py-4 px-4">
+                  Understand how to set up themes for a Mermaid diagram for an entire site
+                </li>
+                <li class="border-b py-4 px-4">
+                  Discover how to draw different types of diagrams such as flowcharts, class
+                  diagrams, Gantt charts, and more
+                </li>
+              </ul>
+            </div>
+          </div>
+        </div>
+      </div>
+    </section>
+    <!-- Change the colour #f8fafc to match the previous section colour -->
+    <svg
+      class="wave-top"
+      viewBox="0 0 1439 147"
+      version="1.1"
+      xmlns="http://www.w3.org/2000/svg"
+      xmlns:xlink="http://www.w3.org/1999/xlink"
+    >
+      <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <g transform="translate(-1.000000, -14.000000)" fill-rule="nonzero">
+          <g class="wave" fill="#f8fafc">
+            <path
+              d="M1440,84 C1383.555,64.3 1342.555,51.3 1317,45 C1259.5,30.824 1206.707,25.526 1169,22 C1129.711,18.326 1044.426,18.475 980,22 C954.25,23.409 922.25,26.742 884,32 C845.122,37.787 818.455,42.121 804,45 C776.833,50.41 728.136,61.77 713,65 C660.023,76.309 621.544,87.729 584,94 C517.525,105.104 484.525,106.438 429,108 C379.49,106.484 342.823,104.484 319,102 C278.571,97.783 231.737,88.736 205,84 C154.629,75.076 86.296,57.743 0,32 L0,0 L1440,0 L1440,84 Z"
+            ></path>
+          </g>
+          <g transform="translate(1.000000, 15.000000)" fill="#FFFFFF">
+            <g
+              transform="translate(719.500000, 68.500000) rotate(-180.000000) translate(-719.500000, -68.500000) "
+            >
+              <path
+                d="M0,0 C90.7283404,0.927527913 147.912752,27.187927 291.910178,59.9119003 C387.908462,81.7278826 543.605069,89.334785 759,82.7326078 C469.336065,156.254352 216.336065,153.6679 0,74.9732496"
+                opacity="0.100000001"
+              ></path>
+              <path
+                d="M100,104.708498 C277.413333,72.2345949 426.147877,52.5246657 546.203633,45.5787101 C666.259389,38.6327546 810.524845,41.7979068 979,55.0741668 C931.069965,56.122511 810.303266,74.8455141 616.699903,111.243176 C423.096539,147.640838 250.863238,145.462612 100,104.708498 Z"
+                opacity="0.100000001"
+              ></path>
+              <path
+                d="M1046,51.6521276 C1130.83045,29.328812 1279.08318,17.607883 1439,40.1656806 L1439,120 C1271.17211,77.9435312 1140.17211,55.1609071 1046,51.6521276 Z"
+                opacity="0.200000003"
+              ></path>
+            </g>
+          </g>
+        </g>
+      </g>
+    </svg>
+    <section class="container mx-auto text-center py-6 mb-12">
+      <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-white p-shadow">
+        Purchase The Official Guide to Mermaid.js
+      </h1>
+      <div class="w-full mb-4">
+        <div class="h-1 mx-auto bg-white w-1/6 opacity-25 my-0 py-0 rounded-t"></div>
+      </div>
+      <h3 class="my-4 text-3xl leading-tight">
+        <p class="mb-4 p-shadow">Written by Knut Sveidqvist and Ashish Jain.</p>
+        <p class="p-shadow">
+          Knut is the creator of Mermaid and both authors are active core team members of the
+          Mermaid open-source project.
+        </p>
+      </h3>
+      <a
+        href="https://www.amazon.com/Official-Guide-Mermaid-js-beautiful-flowcharts-dp-1801078025/dp/1801078025/ref=mt_other?_encoding=UTF8&amp;me=&amp;qid=1628153965"
+      >
+        <button
+          style="background: #ffa41c; border: 1px solid #ff8f00"
+          class="mx-auto lg:mx-0 hover:underline bg-white text-gray-800 font-bold rounded-full my-6 py-4 px-8 shadow-lg focus:outline-none focus:shadow-outline transform transition hover:scale-105 duration-300 ease-in-out"
+        >
+          Purchase Now on Amazon
+        </button>
+      </a>
+    </section>
+    <!--Footer-->
+  </body>
+</html>
diff --git a/docs/book/sequence-diagram.png b/docs/book/sequence-diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..8c51ac1c5d6601960112784757061943d9d6dc8c
GIT binary patch
literal 19823
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%0D)Muw-s
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
Un8|I}2s%m4)78&qol`;+0CsIFnE(I)

literal 0
HcmV?d00001

diff --git a/docs/book/state.png b/docs/book/state.png
new file mode 100644
index 0000000000000000000000000000000000000000..2ef66ea2f1368a71013d9cc74b069f99d8445f8f
GIT binary patch
literal 15574
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
DRc_Wx

literal 0
HcmV?d00001

diff --git a/docs/config/theming.md b/docs/config/theming.md
index 8ccab7804..9b81be1b9 100644
--- a/docs/config/theming.md
+++ b/docs/config/theming.md
@@ -3,12 +3,6 @@
 > ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT.
 >
 > ## Please edit the corresponding file in [/packages/mermaid/src/docs/config/theming.md](../../packages/mermaid/src/docs/config/theming.md).
->
-> **Warning**
->
-> ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT.
->
-> ## Please edit the corresponding file in [/packages/mermaid/src/docs/config/theming.md](../../packages/mermaid/src/docs/config/theming.md).
 
 # Theme Configuration
 
diff --git a/packages/mermaid/src/docs/config/theming.md b/packages/mermaid/src/docs/config/theming.md
index 3fcd1cda1..fb3026fec 100644
--- a/packages/mermaid/src/docs/config/theming.md
+++ b/packages/mermaid/src/docs/config/theming.md
@@ -1,9 +1,3 @@
-> **Warning**
->
-> ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT.
->
-> ## Please edit the corresponding file in [/packages/mermaid/src/docs/config/theming.md](../../packages/mermaid/src/docs/config/theming.md).
-
 # Theme Configuration
 
 Dynamic and integrated theme configuration was introduced in Mermaid version 8.7.0.

From 2743b72a8702bdcfdaac20f79906d59466e8d767 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Fri, 16 Dec 2022 01:12:50 +0530
Subject: [PATCH 113/129] Add book landing page back

---
 packages/mermaid/package.json                 |   3 +-
 packages/mermaid/src/docs.mts                 |   2 +-
 packages/mermaid/src/docs/landing/class.png   | Bin 0 -> 34954 bytes
 packages/mermaid/src/docs/landing/cover.jpg   | Bin 0 -> 17803 bytes
 packages/mermaid/src/docs/landing/er.png      | Bin 0 -> 13419 bytes
 .../mermaid/src/docs/landing/flowchart.png    | Bin 0 -> 14794 bytes
 packages/mermaid/src/docs/landing/gantt.png   | Bin 0 -> 43239 bytes
 packages/mermaid/src/docs/landing/index.html  | 337 ++++++++++++++++++
 .../src/docs/landing/sequence-diagram.png     | Bin 0 -> 19823 bytes
 packages/mermaid/src/docs/landing/state.png   | Bin 0 -> 15574 bytes
 pnpm-lock.yaml                                | 180 ++++++++++
 11 files changed, 520 insertions(+), 2 deletions(-)
 create mode 100644 packages/mermaid/src/docs/landing/class.png
 create mode 100644 packages/mermaid/src/docs/landing/cover.jpg
 create mode 100644 packages/mermaid/src/docs/landing/er.png
 create mode 100644 packages/mermaid/src/docs/landing/flowchart.png
 create mode 100644 packages/mermaid/src/docs/landing/gantt.png
 create mode 100644 packages/mermaid/src/docs/landing/index.html
 create mode 100644 packages/mermaid/src/docs/landing/sequence-diagram.png
 create mode 100644 packages/mermaid/src/docs/landing/state.png

diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index f31fac80b..cd809fef1 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -28,7 +28,7 @@
     "docs:build": "rimraf ../../docs && pnpm docs:spellcheck && pnpm docs:code && ts-node-esm src/docs.mts",
     "docs:verify": "pnpm docs:spellcheck && pnpm docs:code && ts-node-esm src/docs.mts --verify",
     "docs:pre:vitepress": "rimraf src/vitepress && pnpm docs:code && ts-node-esm src/docs.mts --vitepress",
-    "docs:build:vitepress": "pnpm docs:pre:vitepress && vitepress build src/vitepress",
+    "docs:build:vitepress": "pnpm docs:pre:vitepress && vitepress build src/vitepress && cpy --flat src/docs/landing/ ./src/vitepress/.vitepress/dist/landing",
     "docs:dev": "pnpm docs:pre:vitepress && concurrently \"vitepress dev src/vitepress\" \"ts-node-esm src/docs.mts --watch --vitepress\"",
     "docs:serve": "pnpm docs:build:vitepress && vitepress serve src/vitepress",
     "docs:spellcheck": "cspell --config ../../cSpell.json \"src/docs/**/*.md\"",
@@ -77,6 +77,7 @@
     "chokidar": "^3.5.3",
     "concurrently": "^7.5.0",
     "coveralls": "^3.1.1",
+    "cpy-cli": "^4.2.0",
     "cspell": "^6.14.3",
     "globby": "^13.1.2",
     "jison": "^0.4.18",
diff --git a/packages/mermaid/src/docs.mts b/packages/mermaid/src/docs.mts
index 313d1f2de..17505b6b9 100644
--- a/packages/mermaid/src/docs.mts
+++ b/packages/mermaid/src/docs.mts
@@ -260,7 +260,7 @@ const transformHtml = (filename: string) => {
 };
 
 const getGlobs = (globs: string[]): string[] => {
-  globs.push('!**/dist', '!**/redirect.spec.ts');
+  globs.push('!**/dist', '!**/redirect.spec.ts', '!**/landing');
   if (!vitepress) {
     globs.push('!**/.vitepress', '!**/vite.config.ts', '!src/docs/index.md');
   }
diff --git a/packages/mermaid/src/docs/landing/class.png b/packages/mermaid/src/docs/landing/class.png
new file mode 100644
index 0000000000000000000000000000000000000000..5b2f663d86f967ca5d96c5fffca73b6e8efb3ad4
GIT binary patch
literal 34954
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
Lk}Q`n`TTzYoi0Wu

literal 0
HcmV?d00001

diff --git a/packages/mermaid/src/docs/landing/cover.jpg b/packages/mermaid/src/docs/landing/cover.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..24f8b13bfb3098917e0f4caed06470b9ed0f8b32
GIT binary patch
literal 17803
zcmc(`1yo$k)*#wI1C6^|)3^qAcXx*n+#xsw3+^7=-Q6|8-6aHv;1U7^2#`Rg$@ky;
z-&t>Ftv7G2S+BdgWLxdCYj;(hed_%A@@EHtsURaS1Au`60AQeBz@K$MC;$lw8H5Z%
zK|w-6MnOSA$3#U&LBk=y!^FkF$Hqp-$Hu_Lz`(`ECB(tUB?1$Z6A>~|l2YT4l5s#d
z8F^_SY%mB=Ml^I3R8(|yR5VO<GF&uN2reE0Iyr~{6%!v5ivR@^2Nwm42#Xwv2o(e&
zB*VoZ!$d>Hz{f<v#iPO}{4)T+0>RwCq{6{K0I*mva9A*Zh5+0zD#E|0`tJ`691tD>
z5f%gkg~GjL|Ng+jz#+f`5&x_KP~l(zu$XX|P}J<A#y9`RD*LJlsbvjFRnAvNhDL7O
z@k*{zZrYThqD*MMhew-IR^kmQSx8yRl3La@V`OON#{Dv^%>k|8;T{p*T`J24`}ZjL
z3ne8>CjYu@saiPqk<ZA614Lz{1jD*e*0M7I%jmE(QX*9g5~X6rsBtL4p+hBDU?l|@
zBCIhVLIV$m+b2ddPlyyP4N{Z|J4~#ceX<K%ngu&Ulmaczv6&=06(*9Bf;eSHQY5rs
zh?1j%@MFlLsFaF)DpgYHqvWczVlAgo<r}{rRe0sM#^_YErv6$i>lC;#-N+koZjF;z
z8DqwA6<f{s(QqZ>h8Bha8!01WN^VF_j)qMs)Iyf>c-Qv6>AXvEO~<k7BggWyKOw#$
zUI#(S*1@ws@miZTXJGCJ*kRl)hvB63Av1OV9DSAXdMWRWkE=YY{Fyo8g6tZ-z5KB?
zU#o|<dwipS!PGfo)YwQVSjnUj#g+5*lC3AOS8r$%K0R<bbUpdiXJ3D@>)wjFb6E3u
zon`&{2hR7y*m&B<GMBiYiu}#^r%M6eOKr7=mN(TzAF3(1%zKWmn02}`=UEK>=iA$2
zrR|#Wzr6ln@XO`27jdzk<~xB0N|6~3s#K8%5-^xUGV#VkfV<+Z7i>)ZGxAbPnV*wB
zQ;u4}lv=7ZR0$${&?vAsTXLSyN&Rp~i!CKL6y7qF*F?B<Hc@-QHC5ySP83VohZ^P7
z-Cq5hk635iPpPwyvZG^Oy}m_f@#1HnuZ|t(4QumyeQLh7+s+>qw5p26<}LOXp1<qS
zovqiq%J>oxtCIBTnAn;-VPdhzRM_cJ<lKis2L>rhj0PgkRIQ&mp&a&HiIgbyV*L}l
z6sEav0_=k9$rGlv0iyXewgON2<HaVMomTpSj%l5yQ9pXzn77vr19;&ai+HEs8?DoN
zlDu{rHF7eDXL|ccv`Kr|)08n4&qL=lclTPSOtw7H9_lI(4XEGX*-8>whCN3iMS;fR
zB^Q=zYQOn9g<ps9uhVz7$(CoQ%=unrrsxjM>lCFd-9*!84cKW8rPAQ$mGjN$8Q#y=
zU7X<^*>g13bH3KdQ82R;r%r}Sg)KD>F|yQ2&$3|WhkCKm-P+-L`!Nk##*FshmR~+M
zON>gj_qg_muZkOvEwh!q2@X+quV)(_!`F4voRuEYtT!8G!de!rYylZxzPT8iakhDK
z*%OiE=+^A<5(;>an6YP)EgqZWV9Qam(<ApOy{gH`sUH25=Sr1$)A_A+`qSGvsccJv
zk7g{XtT<Nnikye`56U!#vC7$N#RHEy$~DUd$+b%MZQ5B`oH~cJ!|!CuqFV(rEQIYw
z_`SR`ioIeg!^JO-jG4F24q2?%*>^RH@z1i|rBd-Y_^KmwF2DA&`o48}yZ&ppok*a=
z=Hd36N2`E=$G40grO!MlwJK%Sw#9YcnXAXUHiw>72Fvc}Np%aE8_e9RmD8{7?HzcD
zo6MOqm-I(A-_}fx3=4d1Y+N@@B@xt<`bHq&q13LoQgu3_(}o*+RD(kJg)Ps|Nbb=i
z*b|-(>%<oSC;n6WM-rFxsgv&?ROWTnJ0fQ-JdhdIYS?0&L_CmINTku;HIw)&b9jtQ
z)($;+qje-f9iNsaP%0eiVl#A1QJJv|xys(yDN0IXV(i(ZvZW=48-||Gzhef>+yH$L
zNhno=9Ib>nrRK|Q)Ib9mFo_}xRPAXaFPSm$dt3}fmHRKgwez)E>kGL@26lR&0u7j!
zXoV7-iA0OT&aO@wC}E}toyK4?lX3Wodkx3y=&!!7%)em>?OBQ0t)v9R?tB$i9?WvD
zO1*LJT=OuVT)g28LW+{3Vdqa&Fw+1b4~1fQk4DtfC*{!6)L=)Qijt^qdZxc>5L(~i
zd^P_Oq{x}nIdIUbEKUftM#MUGeE#kGQ0Go|d$Wy}7dG>YLUHaf85=1n6IezAy^PN=
z7$UKrv1s{{d*+fK*RzNNNJ^?nF-E=jgh?HRu?PMD(i<K)*wem#*xNqN^NZcp$RsM`
zr6~vG?Ckame_9^K$Tq<VnrX9+(meNTuKiVmSl)m`#Q{=M1boI-Qq-f{_S)&D`w-v7
zw}YbCCLV}J=lON3tw!(sqdW+K;0|cD#B^dcigt2i`om%5enNv88zM|}*fr|9^e9@K
zEBx-*Yl4msNNu8Mq@=7Qm#9FU`?K)(A3*1ix}2!PCIB2o8byk3>84-M-AQ7i2`72e
zmjpM#50gQ+K4K4TF!;KIxD$J-IIyFcx9x?^k-WJiHCq%a7Hnv?jN&hYh&1LNph<xs
z`1`WAynj~F(CB`}e6&lK=9Eim=+_^BfSCpo>I5`fLxefKWxqZL0OiU}KZFo|Y$Du<
z{xN>}G^la>)9t{(_zBh$ITPu{rctP{0&R;Gj=x!tcZB}{qI|lp7TmWv{w)c6$KSX_
zL^%+;n5s38#~M726&Bv`t{RE2xT9xX(&uacmv{ADuPl2`sTc-t?f2Se_%Bw(5AMIL
zXqng<NrH0!Ed&sSThpXwZcSxo!o^y9wlIsCms{-KISlbfk{d8n18J3a*tpMHAFXc;
zmR~2B8#f73#1bY3&R~NH*JR;NZz-=G{#o*2SuSMQKZK|*_<YKj9-^y0>BZ-+jJmmv
zoO-+vi2pgE=j}^s*z9Z^A?N-Fz#I;B;lxCh1wIPHN{kOC|A+uUm2u=?Gr1*CeS5nX
zd7jI-_kAb<Kd|rW+obCGv)Zlum>e}HHX+cFD(Lnx@qy=GY%itIV{8YtCz@{ULra<>
z(b;ikR0jeaJ0(Q31s(45spP@he-gt|dygFG+Xx()CMfE{|JdaI12B|j&K)(r4e;}w
zdh#iuvn55WU5c1&fx{A;WvN3FOVMPkbszM1tBX{i{<kC;Y?e!3DnGXxL<=8*cfP*w
ze6NdN!&KV8mUB7#SjBI2D?WVvTF;enQ_q$Vy@nrtR+qHCN-FT*`~U<l6<3Ld|8D<R
z4JHmJTh&VJ{{hDj!GLbVI4}XQFtBilKv-B9AlwTPv<1KdV&h<fDcRULBp{q(;<##5
z>eTRDk}gsjn$SHMbb|(f0m0HV6L)K`)h&Bgx4y3Wrfc{AuE7l@H(H+lU!(>9MK6j~
z*`LZA?=2}dd0n1T-n(y(-l;$R3;fOt&qcqQ+p1=ynYa_0>DW!{hZ*@*JfC#O-ws<<
z=Z8TNQ%n)V2^R@2>sfUH+S69|E>DXTn%Xm8zAoWW6Pw*~0GS*s;wW#Pg@3uW`ITu!
z=|SX4^@m)V4$R6*B#9a;68T(hu}Va80lsqJFP|mLE1R@HjY-W3uRE*ucA&~_tw&w3
zn7!ZNR%pZ_FN?81`5fy&qL4oyCe|w;oYD7<KIU3lsj&^xC!M8Z;1Rq%GEZg_C>>!v
z1|jlTF@I!h42$P=qKCMN=$pj~^3{CWJJm^1C^p0_zt^&n&ZfcCN;JiK=E_Xw9y6AW
zbG44Ke7J%dpzW(ytr@d5wTgJMAQ7I6)cj0Adc`WaFoQd;i&vshr7h@p^*qx<da1>7
zs(#TT0j;!=Mk}@42Wxs=9x4lm1oD(%Jk58&zONyP)#%0934^TyHM_4ZEp$Q{rrxkQ
zF)P!2B3D<mHNjdmpjU7Te||`UcG`Xt)Cw111RaHM-RAb^jl%rXILv0Mp%{#!T~2qK
zHuWK|lVqPc^DH<@?E2djpJ#*<<r*8Ak2upvFW<4hXnkZbgSWuQPBFGv&^Km=7=oow
z83dD59IY2K946(ry4g@jq{FxS+wY<}JeRfdz6pmoay(llV;6FxDUA>!V46hshKv2Q
zw=x?6U112&VF}wXQO|%{L4mDN@>@L<Lx^1JMY&E;&lnT__Uypb{^uIb_aEHYCZo88
zVl(xan+4d7D1N6ny1lu_3u%*QLXh3pazNl8RzaRx(YEa8aiFkB4L$>x>7Z&&A@5>h
z62`<*^w=Ez4queP*`zVGqS}FTyob8ix-0LZ-_o^}*{I%$?ZTLP2$H4k8}=AH2&*P5
zqdbB->Ilg}t<~H@MVXCuV6-I85$bRWhuTPQuX1#1v4xG5jU=G%bT$2l!P0%Y`^5ZL
z4jDC*r#<ORIxEd+d!GOh&sM@kes48f&9d8-^8&L5zLoFT6sI4Xm-(;qpA^n4OKlsq
z0|{{EjoKNj`U=^^fJ8a%DQ^dG;43j~2N0u!%_R?GXT1s1aWN-AfY@m0ixomGbiD+S
zjXj?{jc&xRX}p18Gm7Dc!L6!Q;80pysF6?MnI~#lhMODMJJVBpaj6S?!f0oT>0MMv
zP#WFf2@^$5;)GzJ&RA*opJEO5%CU|e_A6$M^*B_08d1MKU~c%iP~`)oO-g^j<T9(-
zCffDh<tJXIulCcs?Rvv@WaiNdFN8f#mr^TD59Xmm$_$d&>5<1|gJse%xlcdEHw>ED
zPiwR`6+6$|99jtD0o{3>S<Ro2J6o$c;V0m_Vo+ywd0G)5^#R^{O)s+l0HjEM9p0=`
zY>IaLitMbje?_s^Y;c1u(QnUmRp{!#@reZ9jL*^sv>Is7U9ZCxIb+Xog*;lC72R-_
ztkBqcI&B|YYrjy;ORU8l8d#$ombFsHUG{Y~i=(Qg+Igfnf#cAjcBHSNn*Aj40HMaw
z2Xs`LV9+Sc?C3KQu<Gcz44q`4hEysgBJ{x;<}5tPgKqZwP=Hhq@F<q*2G#B@4oK?a
zsbZ)`7DSeoHhtQbH{8aYcAmN&`h-4d%_GPf<KK)=O>d>lwSh-OY0a<jE1t>?X2N%<
zN`EA3E-YvIBQ!JYN+%C#uz?B=HMHiE9DSzBIjTBtwC5OV1~octS5w2qb(O;FdKC_6
zhq4<58=e+_CG<#lo&N!JHU8@D(vCM;mq<n`wKCogTZkaL5aunshWd^xdlo-{?4me0
zSQa{y@<mR&bZ6l++L?{;)rl=Ob~Tz@ThBZEc2B3go_TA%l-;(COLD#Y!sxGJV5YbE
z(VO=`@<8=M^i)7?Z#-fmf8+g9h?A0t*7M$Tj*Pofw$^$QMyeSly$9lnX;>LIvmM)1
zOsneW-y&K9E<@twr>gVP;aLhwq)fy2=y7XaTH8JpjARH?G8A-mqOpA0aLx|z2>sYp
zjk5Et-AOJ64<rlLBL@vvFh;avaFCmGVDDoQf8MJ-<=~2{1}A!APB<(FNAFLpLq!EO
zZbnQ*h<A#R@YcPG2~3`v&t0XGm(H@u!f%Xnl?d_loP^806-<0kJLa_tviwTOkyC%!
z&nU?#M;*&?F-|;@sRvzNxKlL~%g-D{w9^;RZ<0!?t<!iTS3i>DI}$V=%shU;-w*Lm
ze9*Xy1{0rjiJ4kuqmK`ZkmKN_-|z45(Trshq@bNrFdEOdl;3vq5Q<iDIy-EmU_`S&
zS^%+JdYNOet(b?uG`j{hRtQ!4%Ip#pfi{!5QuIs1zMfqcC(9)iF&ioO|D;ZW7|l}0
zF}?20cq3pu-=n3gJo_sh<p5(dVL&%Ykbs2#B3@Z<FnXlS=GDx=!@^y>xayg!Tyc7r
zo<&UkU_Zr9+bB_D^vU#JoH`U|#Mn-l!I90|-{;A*8m^z?=KRsUw>U%dac!cG`Px+9
zd-#%#e11I^e~8?PU?#oAE!s&Q*VRitB3UHo9C9#Nx8e2aue5|f&Bt|WEO`w{X8(64
zRwnc)0G_?xtAB8zYTA+OwB&Rr)EuKLAA*$@jy6U}zVdgxT*MVKedP<T5}e9=|G^X)
zRD{yW-*fTqALPV)9YJ!!lGA%zg7)w68>FJw9~b-O>q_$eYU7uU%wS}j#{1om?hk-R
zSLHVs(Tvx|aGM;4Aj*;AnuwLUw6f(V&kOGFVDW!6neUtkoj043Kiu^@@s&NE7NXyr
z4*dg|FU<70zI?g#o6qH8B%KW*{S7}@T*$os!fvItZXKv)i%s^)YH=r5++Jjh8ja(4
zIFQm6o8%7{<ofK^ac=s`9CB!)6XnQ9Y4@K+Qt*(GrOt<~XizQckl^U2u$mchkWrg8
zgm8?lb(HBH4pW9skaMg`^f;)fjp<dOh9-Uzc~5LS-x+tyg{3iYgl%G;^9N9NfN6Uw
zXNEQM>BKTc5^-OO-cSZji_QM4yD*V+xOeQELz`W;D`qAZX^MO79&c0f9sy^<MSLA0
zBB>$VgrnI##WmhO^~LZ>6oVQ>MQFworoJ%gI|p!o_;J5*m$0e|r4Y3gjYHBy(P{qt
zfBCz}9`Fgemt??#?j_-1;h|Bz{|er{>?MI%nAkYby(9-bE;}ce7)0FU?-mjk1_lJs
zdR=XZ-A3b}@Flg;-t6;mZ49)@;$ZNl^`B;xA^v|hV|4v#KOlY0Uwrp-T>f80*3M@p
zM-v_Rf083!TZ6AxzF$hn?^3hatMD({A@ruoTz1Y%70A)@+E;Odl(rl68~Ul@R`TYq
z5@~QmtT57xh0}QFTmIJ?-esZW9K@20^e7G&UKjG%!e@|?JuC4fT==a`KBb{>bw0kh
z$`UUQ!qB==#+rj-Zo6xC$0HvixuDF{X6bj|MIIQ0G>z`?miw7zWNczx|B;#QG-0;x
zAtGf;ovUeylKN%V_!u62>k@6%J`lO8XI`Ep%{Q<F+{`b_-Nl_|uC6>pbdD9TIQvmS
z6?blEn&(haqLPopP;L@Vtt|kzK$(Ou1`RIX(>{#Zl8g_B@DNxsKQ>D$FJ!a4k|4tJ
zH3{Xz7b@bHo-wYoV9{+7MeM;IkS2kXBz>ZhY)rWY9RwG>^Q5>}f0dPyfseFV4Mtw2
z(}2aSL5f#Wk5@pVm8&B;svG_KwkWQn6_gkHHYZJ%I+4mRSnh~Q!1%A7vR7zqy3kuY
zJZjI3q{!?c9WlvFt~&d*1F?}Ds#pTi8%!}2;xbx9bcOdE;69o;i`>D(82W<#25GFU
zo?rVVSIVejhha@-p-j(V&bT@GP8`b2AP~4Ogf^@Lm1&)Y5C)!pokj?GIL_Cy*rC@(
zj7_Jv>HW4t>bI3TC1h9n^;&9iy|(sVy5tYTTsDf>HvI|lFq9mWg9wEV&Nh;<$al-6
zz6gR+)>*%96rsK{Cd=~kIIYmbd#V0P)w8ilrbU+K1(3T7jejN6TYR5&POLL9T+NFZ
zD{zIG4{zTtdJW0kH5o@e;W+Ts5c+)0LD}8G)!vSx^D~C`ffqZI+H)R3Uu-GX*8h=a
zncCfC9DYrKCvW=T6CQ6}U@AC{*=(EMNrLO+6ZZA{d7YozNW503ll;jnV$2dT-avYS
zl-T8;$LU!p?J=-LxwJ$oL!TQJm-81(-yp!tYo1(<wv5ldf3!T(VU%Ph*x9uLk{36+
zvvakc)PB}Fy2V(0WyO?fcAB^~Obc_A+pfq^4Hwn<BzZHr9)73Sz(_Jy+DH0<Pi}Ks
z&wns~NmQx#OT87eqmN;aWUuOY+mY-S(^;t89wScDKjBR^ddr`pk7?Ojl79(**9#T$
z+r=jo2+w%B$1n-i;aO}7UHjG1o0MBF5nDHu`;!+~XqMKMs(Oy!%x_y_)!*--e}8H$
z01O-)@INB=&`>=V93}@gn2nuMOdO*A&p#hZ00IES3?u>z=#gPxGWZ0To>Urntt*f_
z-^^gcMQMoIvECz{2QzVm#OS<WrOA>2{^!+D)Tl;p=`o^4`pO+BZ278<KNKYpbHJ}a
zEYUq5Weiz$=-mmFl)SU`g>l(PCZpmH0G9L~#vW7Q)$^J3HVim8O0rJUPLCTstmSz>
zT+GK!9+gQx7^h?a{G6V&FCP3c+h53Pslg7hucb&js^ud0@DSP}L&5Kmhi@(w|7LqB
z!NMf3riDjtDG_h*BBz7_Kb0q6CJjxp(8fR_3`Qah8TV}}qgJJ+&kH(6-EN^!B8)r^
zs*>btX^5sA3(!ZrxhoA#>7A`uFtyuI!Mu4}8d}3UTk+iiSq6}^Mt?gngt8v}hTO!d
zG{m#5d~j+HY6_ALp-_+zM=Od@Ui*B1_W|M`fVZr;=;0$DZzy(opgYdvwk*QcEZj@+
z$U@=p91g|g!7h5`3m)%mD>W2%#iQLS^Q72PgvFDs#iQM!82EDOWpK6d{vA94Oz4e2
z5Dth09YGlQzi|NQ;9*m;i>sSrg4x92ARH2E8ZJToIE9T=N%Nd$!Ml>K$xUCc{wp4U
zBnnG=oT5O39VJzyPXB*Y$<4ga3!ux7I{NzV-<90a)-K$;Mfk}0qt4e<^5bf&G7bu{
z_sI<#7m;y!2kvonG!n0xFk5)MLRHpXJ9DS*_##^XSU=|pl-5VB-?w<GWtZ!4BaN8Z
zC204S(_xzf&9Mkme(*5CG=I|22FDpu;rhbT=PiMABy&yhYymmeznDV(H4CP=Wvuqb
z54|{76Lp+JbrmQ#!zbR6cF9asjLb1fG07ay-?_Re+rYMfHP=}|Tk8z_t|!2v7A?nM
zXHF0g@{bXuJ`Hquq7VWFk=$GD<<~?;gK|ZrN5-Ui)<Zu8JJziT_LAUc4!xWN)>$vW
zv7RRlGK_&g^mDf^^+#7tma}m93K<B&*#s!K!V1{^JYVWvvvH#9z=ecNC}qE@;!=x>
z&E8wA$~7Lk31-%v_Eh)c<!HhMy(SUc9IG*F<TCD-)*iy->bkC58bQjn`r5#D$SIh}
zgl98sQW3hRz2p=L$J0ld1(>R;kdHPuauf4t6eCKiGPjz>@Q5BaHp_yU&7AsyABq=6
z?PhHLuyOJ2yQkM>SD&mC&t^y0MPzE2!mvqo(?)&9vlq}&T5<u@E>S0FT$M|SpplJ3
z$P5Z5qU7}5m92w}?R2N#>Vs%A!tXxFXUJGujX2jxkexE|?0Tx2*mSqW+Z8VPaY|NF
zYg5h70@-nJDL)5~m8Gjj|G=!&bIpVH%{HwSKU+7r+QeJM%`5X$OQvE4_pQ54g0^0<
zJ(W*x_~}aUt<24xERugxYieB_maMk@HI(m4l>PSwk%6F!dO!ss2`;Mg2UVTZ%CdB2
z8m`Y{_@i8?oMH>7Y(E%>;S>vO-O(Jf&ga;s;ZPM2hzcZ4l(wRGf`F*f0|>Ckcyf_p
zgjpx>a-fPpC0JniMu8d)Tovv#Y)~*rlUq7o@ENKk$4J5MMGnODtu}LAAaC})3T^<A
zT@0;#R8*XL%Ey`4VEFi$c$+>YdC+HT3X6v-C0C6*OYn&3fQRAxi)9g*+8{d!WlLO9
zE_ws|G|5fwTdCb;7p@7U&n~PtQksv>y;o8)&7<Fdwl}3B4XTC5`>3BWRT4WQArP7~
zQWGxef@JGIfMq`Qu;e}BaxWCqTFv_TNiy|>lgaP64)^&|50Xe3R`o=3&r2tc41A%E
zL`irQ?x%`CDOoE5jp5EBMv>#F0&^7BsiL=*@js!X+PHbAwQ8!|yIv&AZSMb#016V+
z3NA%FMWrvqnvV=PrO;}5-wH5+R6R6Y7tEbLQ5Lm`oHnooJ>xdD4rrsV=*~;1KD=K`
zKVDG1DZKegb0bM!+_FFpQ}lyk<{oin;0EefS1eGueu~nEqWOpoY`e!*qguy)#BswD
zeVP$Pjd<F}e*ol&%TAWke*kfr&Nu5{hAbyHR@Dyrx~eaUoQ?(-T{jQklXi<!zacEo
z_gL`%ke73_vyY<E%~tH?x_i>SHr#prWx0EBQ}52GsqT9@hVn)AkJ)7qxyIK*^WJl>
z#>(B}rmZ{IHuM8Q^iMc*&NupRBf~yhZ>O}oY_KkVB2~sWA{Lws#uUmm3>w#Z`wQM}
zXx?(*Bf7Q|`u=PiN`;qy@E-uy@Zy2xV8xre_s9_+TtJA7vS_($S1k|vE^iOD-)6XG
zkY&X4<TJ5~YVC*eGv6J(kdJ}t8YanQg*&d?AM{-%KALn*Pq|#xZFF?`)pV*<H-n_C
z_%dpE4qj*{Jyas0O&#kaH<*|9l*j7~3Db=2&ZduonJ@fq5{PVFdlwa6qJ2)LBT$MN
zfchOhW;Y?~Pv50I+v}#IPmX6i&pnPJI>v~>oiC6}nFOuxX4$`7xE}Pq1;wR8X>Y{h
z5%QT{AtUES4s%_cKuHe6@XKK{{1YMDOe~XOF=pG^F=h&Ga`VD1y_%~qK1DRMz&jaS
zRSOqSq<NS|EBSA}J`R*>ISa1QZc49!yI9USNCa?wt{dNPf<<B;$w+;4etq$!f6kX@
z`U5zL_I7^sw<SUN1Gok8PoI%$0x=}9xq}nt>^DV+bj?pp-&#H)DY<5Ae@V;qrB6@W
z*gejEEOTn(RRsopMt%EiM+Wv=B=lH6EnMIV4k!^Al)Xo&X1PR|mx6^QaspstiFqSb
zzrtR&{Ay64u28B`sa2)TnEHQKX?O$O%`ie2L^v2A%D--9UXD~?{ap?VU)DpHpvM0B
z%c~@{-G2qdMJY!GHgva{zNh|NS%2f`-+K4ID{TEs@6s2bB!3HWfA|}Mr8m&x7FwwL
zOaCtlA`a?>YL2rf)=`g4kLPsruIa8n0L8{ltIhYNUoM)RJ}sPk>9@cB5c8QfDxDR0
z&aFWf>@gW49+~r2IR1?1tY)E)%jxZg@m-(+SRuj#O8oORI($V~kWj~WFvu8$Y1`>3
zSeRg@&XYNc-VbEJ{GrBvmAzfDS)g5@6#NiKdf_fv3Rn`u-yf3c=f;xOSV<Evfgc=+
zaBRX<o`Cm(m;1;`2C!)_8JatP#a<eV37;w;jywS@+x>FUd;6FvaDww2mWIuQx}qZ$
zQ+%gJ#$*|C#g5B(T(Vd?iw6{=>?DTQ>XeIxfm@;*HPJ=JoLvFZ>LL%_<0j|!lgZnP
zYZhxn7NH|juS<qV$5(%WZE<nAZ=ler)L}4-bU}ZoelFK~gUMW7#T9~=0^(Zt6s-3T
zC_#6kg78Hloxl#z?jOLvGL>>)k9HRXsV2dhHsdiC%Uu`iLFQr!!Vqj^f<osr6er$+
z+r;}(<&i#W6@b0(DW%SL>AQ8%tCFl4ql&H(Ds?g@uok{vK)``%GX1kj!906Z@HR5{
zl9|D=tZDEH&3(k5j@Ry9x}I)bw^)aOd7MT)zSl2<VM~<(uo8Fkyf^{L8L<s}#Ua-l
zWFfDi<M?ysl$ai~nF+@VWFCyW`YBHQyk08o!n816%vv1iyyJv#ZT{DUfqW>F5QRbs
z;`7E_1n~BL=-N);lOB`1)Uu70xw?iDJ64D^eU&6{MFkh--tjwROCL(+aAftU1JFUy
zTU__Iu%KdtepKf<zEzQ!0c^c80#WA;!Vu+%zbd$0suMfNo}xh}lBVk{1Brv}l$4{l
ziW?W-gQ^`FhH9jgH&?NM#3ORBPPC0%6>Lf9rapWSf<;P_*ojZ5kYLyX{c^RyeM~C8
z;<%lZ51Tteyy)uES)1`^+ixn-fSAL`9Syki1o2~@5nNkA&1^~sW^uR%z>Z_q*yOjb
zifqIuqLjIC!})6XtZrf1ZSe>w4U(k_A$>k;xM2ypW=?^tbcD*4Z!2WELn;zJoMvXL
z>`mBv3KqdE-pS0U3&PPcdg-ouu!4&<YDjWnTEOCk8(AUB#!%zGwZr5l+>6id-ZTi!
zDyWM(@G->*fWwoZ6EkrxCd89CC@GYRQWQ=vTV&{&4ge#8k(2vjxG-VCWFT^-)iIr5
zTF@8^Eqyh-J}Ndf>;lXNa{`OXU%7<1!PKOhP+0zGRyl#F4zmN}Q6i=c0KZaf&p8Ek
z?!8iIFqH|Nw2%Q)N|_$~;#gI3U(WdP;3&vEY+zN=e$e_f8}__4{sF9fE+dcC;OMPH
zR>rFS0|c;^UgCh^?7GIJQ0hZyDy0NZVtZKO&-NoFW^j%y9p!mZlU#A|IIAGY(V@ax
zl6mI#_l<P<lCAXiR{AC^;7m*qVNpjV(M)_4U|5^Gpl_L!aE5{W9MOz)bq=2^_8fkc
zx@Imd4{?=f;u$&wPwdmfkHUg6B~UVQLU6yLOGRGRGCo9-)Q}TyMUudE6I2|ihb%kE
zb(s4g5|T*-fEjVL=$XGpk#b9tEK5kh$ZTX5H*Wf_Z}%rbkYOT8?)o~HCF}m02(M3`
zPKAbmJ4{hvnF~>Z28X(KR|y*Wf}>7q0J{RSyXe4_HlV;j3Gx2we$pjiFw&tzLzoU~
zJR={hyEK`I7_7-Tj8r7^JZz4dU^{9#t{h+*p&mH6iYT34zCJd`o<$5xAbTt+55P;*
zQ*p@KXyWO<mkK>+AXVdssWOP_7$<!t0}%ff&lWqx>n9n7I~)^PWJQgGzvZkt4GW-@
z!bS+tEf_JAG>R0b>L!k@)zLVzl@trs2SicAmN0oFhDG)z%1Qai0i1=J%oqtbJdk4a
zx?c=k;p&38hEExENP^Zakxq$$$^sxBq7EUb3SWx$N(JQF*!_^@gP3TqT^@hOhC};G
zmz8EVm{B=R4hT~VCdFysH1wek7Xbj`ODsee*tOV}d)GlJv_orlX-(jxV1z!*fkI*a
zC?dT^M#3?9{7At<z+SobG&aoi*Q@Z@5GgV7S;|2AhN&=%q{mV#w3cZ5sz}+Cu295x
zNUaZ%SZLpuQ1$ukL)eE^q*VM+)SL_Y#yhUT=3l7k*$V)KfEWv9`M@19TGGDU;fo0D
znmUBnScrk0a25)MLvuvf=rjlS<7f0`efkEe-yR!5>!?Pev{eAJMeHBHE#6=Nl+Bpz
z1Uj#b{5jaO4NCUlyo~SeY9KtA&f8x@;SvFEVpzfbkU|Nt73TGs1W-k)UM(nk<3d2{
z&dQI@cCGCYi4GJdG}0UhHVBz%Z_fJJ-bzHs8CG*W6HF8KnFQ;c;Z!MOU25yQ_3rNc
z8jK^Ec2E_nZ)-!jQB+!c-V7*bkffkr3w=69s@Q!Vh=I)G*}^Lw*;b2<=lhlt^CM+F
zK5eSn`P|xO9P`+)q7ezgF|4?A#`#kYblmDr?)f2)qgQn(ncG3&4l%-`raL#|yPwxE
z)Vr97q<11S_FG%e@@VJKIV7p!FY0Q%F>sWO^->VSn%kdvOWsd34nATZGth>bp=?=^
z`zdFU7=RB@S8>&UPqB+TVz?Su7Ht0I<$NM+AlP~9H69XSt_-RjcW=&TIVKPXDyEZ^
z_nX{50Fn-@C6Xu@Nl38v7w6<aSadi?(+V#7Bj{7xDol^%J2!pG0{jcyAYom-f>&MH
z!%|_afqH6|`XYd{->+`6u!VPOsJ4*bgV_9-c}D^(6V?MN*_~LUOLA0d(odZ&?0ora
z5*HOH`IEHM5g1=bnlYlE9v9ylaL0{8CMARGpFKu#!R;7ar_pm(l*(2y#AK@0+{wg6
zCZHHX%$lGtzD{9<@zK88K`r+9C?vr_fkq_St(E5}UMwOrHaPaV+*zT~+Q{_^spu!q
zui}0wW>G|bX&KU$ZO)qPVx^Ddwo8un39jxP4tqTV^OWeR;c)@t0Vf)1f#KrqSEnsE
zxms&nt=1NU;bP&%H%{LOi(dz;#kpe8>joFRZl(&!Vlxs}nC!BHEseKpH-eX-n;`qi
zyRVbQ{=*=kV2BSK%S{@gmTKuTPGU3JWsfIEAEHx&DF&;BXP6PZ6D+RgB|2-5Z<rWV
z7>H`;>tead!xqfQ4V114(`rNM>=N<Hg`u;-;fslJtY$rFG_i~1#%D)I6IVePE7uY7
zdUM$9pzo!e30TIoBi<1%@}Xs**X!@NfDwN510uelDxoNKOlkL!LaU;zTRal8&i+zK
zN9OLbE#x+8alD0l!-b;Mo0Bz6G9@5P3jpCOO}hI=WC@iK*Tj{(!`#u=z9pd@v_{KK
zUI`2Q2n`coT;on}`#^wEEQo2y`_$F64Jzv!h$j<EFW0L!<vMsb&<XtmQimVGDb6M!
zMFlLsj{kb`9kmp$S`B4fv_Y-#FJzG~rIBAz5Grhu3p8JJyi9_ZB8-Gwo4^73)a+JG
z{X6u%RCmLjFpvxEb2}|JMZ>8hwS|K#bo#k7V)pZGpxCbs%3NWO@OG1xi8WwKpgG~W
zBJ0WT!gH!2M!hTzkylq%9ja32di~4H-Q_=mXZO1t#E+uO;IAcA=*wO&Y7Dr1(w;|$
z%r1Qc!dpcJYg2>9;Xu?O4PbL7kT?h51WSbGtTs*>EiVvNQLmUxMsEg$Aa0;;7UkBO
zwy|76Q}726N$(j1yP=PZkSrNbsVm-q&DVYjP*1Q-cV7Y<m^n`X79OSLPLfDE9gr-r
zSp%Ok#XW|Ws-hLyTlgy3z~Uz7#Yh{Kn2DK_x<C=eYrD6Jy8Fc7Ri{Z_ekx=inKWD9
z>PGe2wM*5NBBVcnAYXo{nTruU(HRQE2JC_xLeyZbI1xJ8I_QiLwe$j~03|?`-B&;`
zG60W05H>L~*?B22FcP2*R$!I`E=ODn=cK(}d^DbcTIuPPH8mkj!QhG>QBMu(mJY&O
zCOF>IpzMjh=>rq1>jutu|9>OOj$=??p3*R4Lc_AK03ZVFzaq7NZ)`BZ;_7UsF3@|L
zpd>N1!v4npzOlh%fHD-cq0XkiU%meR3*&iZ%fJ0UQt_7m|1O1W`TtE6Pl!Fg2>zAQ
zdw%`939YyPEB*YB3bg*eOh^AS{HVvCaA0M-=l=OZ^TGPE?Ze)$PSt&nuin-o*M6d2
zKYXr);G$-G@-a3sP@s{2z*o2Lbb~)7AFL^NNLBpz?*qOgex_<<+Muh>t@z|{y*EZz
zEX;pA%PQ1@p^e_#e+z5Nk4_ip!cQ&;Jz=+j&PXC5tUc84G^AVQGa=;MvO|KvB$Xu@
zwJTJ2kMmCCO?OBSxQ+cRnDM-s^eEExB=t7<rk7TJJ3an;`~oVG#CzK&`^6~!3qpPI
zkIk>1gdPdvWrv8akS&Q%uf#DEGOOu4>1=#H(8DIJlK^e;3)FaEZ=E2BV?8XEz1kTy
z31fl~JRF=lR&Ko={U7>FktqSn=8<D9kHX&gw(@J0odFb}uUBiTAHMJNUb!LtxS`Q#
z5Vn~F^0(cD1mVdQy<+ewrCvYah!7by?=WtFYb90re7W-t*wDw=+8AP$x(<Z5#?WCk
zf#2$nY{U9wcPLoT3W?WU&PwY_!{6j;<iZ|OS6rfJHUdlwtyOdOZo9=4L0B)Yn+9de
z#Z%$!hM!J5ctbE2v|x4XM~V<!J6{>v_uua|NM2vbx8&1pj|~IR>w<T(JiEAL)F()p
zonD=0197~y;5^GN9;ef`l)oWpE4~4;6Cr)^4BhB`twm*y+ku=ZqhVtSHjdF5_)TtC
z9ZE2=ksyN=lk&Sj5pR1fmKY9&Lxy%GZRk}stIT!#M=J!lseXlpcc&UCvKV&sDe}Q9
z1>sHjslo__foad%@{Tq3z`B8zq`@dFnal-t^Q7iM+6BM-_w>-PwYC@^c*40xt46D+
z3ZTGPN<(<P6RZi?l|9p}o!~s`fT>i$%LsujoGe<gf{zgH=-Gd<^#P3C-W2aZKTLDu
zSIa8+xjz7d75E~PeOd2UsI|Z@j#xg@avqr}wzG)B%fDurpkie}O7ZL2y0o*4#*|@E
zq)8sPMxjZ*yE`QrHWoB!wbRN+oJLb(N#Wsj=Bg11#R;15#`RG7@xy%T6zXQGpOO$)
zK|T@tV3>y#d{(kFrMksue0cb<fKalWP!yG8nz>T9-*Vn~iPufyzY<a=1@_m~H8w#*
z$VEw>pP5Y{F;R0P@JWUrmV?Lb(Z1l_hY0b1j3KN}f9D<=w%?f=_BJ3ET+Aig+qYVb
zw5frK1xC;|b?%xCz5ZlS8cAg>vf!8g9?V_fBcsQAz4#>k8Hs%B=sfNNY~Z(@koj|b
z4@{IGfq|x^9>XM)KY%+^pLJQ@m}&JxN>rNk+NQc#Tqf}wBF?J;2lf0`TD%mPkK?bN
z`yZR%@aXZ0DGR?vFuYD@mZ@>7F-ezo28QekO;m0fASPbE*!rt9B{tX4Z_-{FMvWl%
z{^}aIGCgEgv$#u7q_@>1mFQe7IZD4AKC$$r&aR`nE_y@{H9xxx1eu2l3z})!3Pr&+
zerYU1aP!$iip(KX8Q+lp84nuHB0r$*Ghc+P5La-}-^<*jVMU1<5FJ)o-$NK(%LZDm
zzd<g^pW$S1ipajcwfh6W6tEHT#1N=4Eur!;wpdYpzNbFh5nQ{O{Z;<KNx$$8Lzt)1
zk3+kbL=&~N@EC1zpbehTHYy{0F{Gmug8>T*rz3k;0^Yt6&iPBXbn+OH+Cz~ihNP0j
zPkh5UN8JL287!%>+|S9dca#^km~R^%g6RT_eD%~ZSalOUN8Irvq_{35$dwg##a6pG
zrriRj6f!Be+{p3XobRv4&YeZ%JXMj58Xjw2=47aU96pTn4B7<vV2`NZR`zaqpbFad
zL`pNXmk`-Oy1l-A7I1~T?QpB;q0g;blHkr{fYJJH@rn+&)t=EVQ@`S%P`ap5DxfQQ
z%zd~w)pCKgB}Jbap--CRCd@adbD2yDo`cKwo8~f8b>DC4HiS2w+ORG4a)Il~^eurN
z&h;EH2dJzyUAoc>N>8X4na$2iXy`YYBR@*VEK*fAEe|(8kb&d6eJwXV+A}V@F&DSv
zH>@IznCpq+QZ8ib9lzTigVGIOdBnh<imv0(5eqGrX@zQdMB>8FHE}bX=O!bH*EgTw
z!Dl<%N*N@-E0-Y8B(FD{dfHrAli{uLjG9QtQqi5@sXVj6DxDNG%Nt(>qk-d)LdNlU
z@)8&7UMmZ<zLr?4<yEOt!h74vv<tGI=juJBPxjmROkCv9{wsCMK+uPo9-=w!`<{(S
zEh4{TL`u8+LU3<!5LapyXk2#h_`9<35}sL7p2;s_gfC$V6Ctymd5(d{LgEszCfQUk
z9<|SkC6gkT>tvm;Hk|v~ChcQ1WVD8;eDv*cmg}6V2RnPE4lQrp!m!fBXmax_$5?#W
zue)}X13lR(R`ANiDv>-a4jQ%+GcK!umHi*Ivll4)VZlwSWxrDq4Gftm9;1Wh^sep;
zYPD-fZ$Ifb7Zr(8PmEqbLpfb#<9_4jV(3kQN&`H>->-;8oASk*Og$h;B;@1Vu#f`B
z>GHHc08K$UcTy@G?>G|Wj<apA9yz0T?4HSq94q?{bCB>1{r*^Vt+~}d00uqhU6!8;
zh17=HmZ^vC{b7sZ$XwwrQF%ekRYW<~LB*dnw0lfjj#-o}Q2Hbs6hlCopt|e^&GD3P
z_4@5Z1-nk#pVybOWDw3Tc7V8&-1yr-u7;9TR?u*-7GUjXm;-;1O)u-fYaDiN*F95I
zL7g291`E4_rrZ796By-5Ox)K6nNpK(MTE>~6$M}pMCmE1juPZnUFkc?G#g*M5kL`a
z0b4P*jN?ebja{N02Q!=S?%A4eMIe%uP|+YyH9X5(LPw!NWUg;&GZX1WC7od<$jQs6
zQ}92j7-BDq$b6jDrkM~0KQ=~5w-tEe@kmo&d|!R@o=(fw%v{41xw`6ru_lT%1v@;}
zx`$u8-%?wz3<LjrJAOl_jvqsz9CHkNxFwlfPp&!%m{Mzx&8q%&)VH9Rtl^z#4a{|C
zyiY`3Gb{~_8Fjg}p3waxzlPHkzGb^PLd{#sLd^NHxww7zXEnANg%$V#usG8vqq;T(
zoHgV=<oO8Rhu_7;DfW$vsR|c)Xb6S<X^e!|ScQXD=FoFuP1H6{zc6e1liFxWc3Gkw
z7CV%*@#D$IB*%5p`jyGnwUmsJA`upqf7pbG6Rmc(8r6MPABd8oA$@s5OG>{hi%gk%
zOSuv(5zpmJ#0WAwGn#%-33vZIM%n$v$wbVM8!aoZN#ghllzB<s^o`{rTb&qr@<Z8-
zW5*Cfd;KTc6xmvhw6~D>1ZPXJqU-3$CEcq04voM95*-AwE<hYO`?VSOS*EpsJaN{%
z;A3u9njF&e&b!E>$;@|ey$bN-Q;B~^4#u0009z7k*|LR%@5#_Rj?5BVHMQskcfE2M
zy8;BI0dfF(RDfNX)3JvaXSc&5XSIDxJumSN@_~MmxcDlkSQRmimll_zU8<yH-!mb1
zNjfQxDoOx>Wc_YVu8?Hn<YS`hj<?_+fVMjpi5#5d&f9@wuisvy4tlcBpV0Xb1<M^)
z8;`cMKSRo{X89MHU2Rvcw(%q#1hw@)G9k~N#!egAO{V?+HTh1;Vo0GRVcajSU6mS(
zc_q}_Ix-l!w6#|#XTtf3u+Nb=Oza)-y5V`AX*}fS+WOTm()G#9*JT3;C#eK38~S=!
zz{TH^fzxIz1~x1sdZ9D9aBKN+JTSJ)8TbTrAN~M1Ma;X$=uNOk92T1=dp^OhhegQk
zqTn=fa=Js`VS~>fZqUnwD~7$K@8d!}kJTNQeZ=OS`2#TNl3k*zdNT-Jmw-w?;K)(~
zx^s|GEGV{9k4&FvF|z5t9rzHh6alz|vZ3m9MAyEf!s7i9;ALTwa=Jx9xPLNQ%l_<S
zBl(KOxAGYq@k0{`{GMjQ=KVMQ>P&wQ!M|LcsIs%`8>pnvCvuA&ei|Noi*c$Lm+wc|
z@2^e;{mGq*1GCYnubH2a4`}jtX594C2==!-N8iZ|ua)ooFjdQIx=YEQhFqb`e&Db`
zpSFlhvvBp+fvrW*VK?jnO-D7Wo%)rd9o#>U=d8Gp5B`|YMcgDy*1uf@1<w-gi!(&7
zAFHCUVd8DVNW0zapjAK7mI>o{2Z%NYBdN$`T6j=}CwIbgKM3X~C3w8rM_|GzTsix6
znW$jtbNZci))m2}RWIkl)=FR#kg(bN2e2a~x>N$s!+!rfBi3+Zo!ot$Mkq+(!(H^O
zx(ZYjqUvj%=glcF`*i(LZK|+Tf9wcO`d(_K8a<+Srzczb>M3V6|DLw{Vc%UX!JPAP
zByb0Lo!mNVr{IF!BJSvYaU_-z$uxSX!RPZGHfPnc42w%+<$Y*h?%2uW;`U2sT!Z8C
zCEsN0y-%5Mq?(0P$(E?w$N@Ad6j2s;vrG2<yyGqT6stQ0g>Gy$=OfdpBa?t76r3qb
zfTQtqZt>N2|BW|ku8``Fj+;=z-$#A?UeKE!AvSuWX(mB-97`9ymD1JIbfn%P`4rrr
zK|-Foqn_I^(~?Hn<5y34^th~6WVsn(rhS^4<UIuxB3CWlzDS@;KOqFQ&8wpPj!Tsn
zU1!PQz<pdo8BY|mFv<#MTMZ~jsEo(fq9CgBK|*MRZc65n8gKM>J%O!=X!E_`#u&E@
z&$}FW<l~h14^8Z$+cW-h$sadI_g8@)eMhxz+Gp1QKiGGkP(?+fx)?5$3Rc&69OS??
zG#2g;RLom>35Ois0qsX-NFF7tQ!(^q%R{9?wqD<p>y{(-`u^dIjWHRrLfhUK$DDj6
zAJZ;K3mKaPEk0j~wW~8}E9FG(;;Tw9#r*+vY)AgRg8gsuiRNcmHjMAH?C&^9I71TF
z-v^s9p8s6C3j_cV0Q<a4yTK9sXxGpUwP^E0m|flvo^b3hH*n4XK*5}A*6a-iV1;MF
z@4fYn9TtYV{l1KUm&)YH4sitQ^$XCW1+NJ=-iM-*^G%jR+S{U^51ESPNR4T(?uT2d
z3FptL${{GLqxaYKUlOz#+ABBw>&z)x!$j}&etf4Jy?d__G8Y}xizNDG;ip^i%~$K8
zbK9qpe)8<+;=o?<L7@B9Um=~TM@7t)J=fE4CU$SYMI^Ff<&RL`7!Oh>Z^3GgH1C{e
zq<J-g(4=ENQl6kq$=F>>Zpj9r?`69=R*xnNW7wJ!H0rGhQV+X_)$Fy?|KvS);Ll#;
zD7H39tmsy3QP~zZ1ta`pPC>cjqjBOY+f9NvvgRXTLnHm?Y{L0I31<AAmfd%|TwnT{
znFBa2jZV~pI9;on*A@a?iyJdB=N?hp;l|u7l?sBU0T`x=b(JjVVG7y2SSfvMSi%wr
zI*`#5Do)!aK{<p;!V~x{kvm1-6YTjV4kZE8C(t&u2QBI^N_ojK1}p=&L6I<tXpf^&
zF(85|XmBRoGN6?sUaYV#$&@V8aA|26why-3Bu__7v`7m%ys7}UTMQn6hERYD^ChcF
z8RazebF8y*g&_{{I?NjZ&L{NW@2&5Aub%Q(Pi=#ex{#-yv;wL`wJE9+mSs<iZ`B_w
z{x1QX+pKUmomN_)krv^X191QZ1VltQSj3kjRnSMs|D35ZO~O=%9;RxB14Gz28vDh}
zTnp!SFL5M-i<%@gO_B!|{yA0!3xgyIu=j)PR?xPCvo?b5U6E?X{y$b3Yo14HllFzn
z(G7LRuJ3aA9Sx}_*PIVp9TF%D?pnolNVo*LFSn$ll_@zr&|FKfsZoxV8)_jk2Nnr@
zGO!#TdgexW?}DzFUR%QmfQP$()x1a;vw^;Uw-Os_WL-?n!|cyk%&$_$$~Wwhh{+Wb
z)sP8XzR}7i!-+L{tr=j`RToOal;yF{tl}mA#T{GJ57bTkVS9lmvirA!nRFxpcYQj~
zeVp!aMFdY!gnEbqBg{y1O_8E)i~dEH&dL?!$UQivA%4ss2h;CEOgHy$w+;!nKw&m?
zcO3x%h}<<FJS%QDI?vq2Ki9OGi9<2w^~H6qO*U~}KTACjxtlxy2{Xtych?T6&UW~Q
zGueEo3-ECw`gj|BH&T%0Bg?0R7H3<BW?vA4#z0}PXmkzC=wN!3s6<4MH*zZO<Z54%
zE_nEv@mJ&=jLGrd11X;60MVsUw)~U>{|B$34B{g!>1NtU-p+uP-~e196Sb`@^7l&I
z-!izuiw^_KE|SfWkcvw%V5NrmFsSE@edMF6qSRDRKnUYiOY~e{#`BhsPz9&{G3;;p
zQMK<2_RHZ3xPWhJwKw0{{u!$$tJ9jTIJ3oQA=*-XTFttL?<#qGsOM5KOgT!$5UXvU
zfMKjNS>5_^;`0Po=(~s-9=;brH?l|WIo~P?_uNVT08+{W<hv6*B3P;|-r00*zPV_`
z%6soFt#ct|71`ts5jl>o{R3EMm4a|e8B$DYK!nxt3=<!Vu<%wtcAs~(I8;C2N`N6i
z!(PnDU$=j?`bJD@lF8DQrs?V%slwsbier3cGW!!^lVqv0^8UJ#FN<zr=qE~8nsWX!
zD2s(G*S)H4im^SI`r!NfP5wEhJV>L3^sjkHMfV_mhkTxJ4&5E_NVj_sD4ll$RNdu!
zEsvxB;S;^|{7D*petLAQa{78N0k*mb!!MVt#oX&=jSXQ{3h{qDo0yEaeL0o_nL59r
zVm}hdgYM=q!TF{%@Yy)e+Q=Gj8?T7beMsA?vTH8)dKq6=oy%A8M`*suVA^t%P(;h_
zq#Xwso&DU($cSNQyty`lrK&9-$0?z%#9HqT#mVyM`o@OW!ryVex;lcTi!UZpn`GTv
zczw)aQhEt3mAHZ7K*U)zIgH@6qneiFGL9hMxQ(>!giY7-7cZ%-$DU(G)79xFEvVt7
zG4-k&D!o?{%k-lz;*)RT73Y%AE%1ZMuy@>Bk-IuF2Y$yh&sATMFyilyd!3ly8sCyc
zQ|?hENr2d77~7|uD10C9U7@G2%MF6QZ&Z`bEcB?zeqR|(+1g)jbQLXol9@s5SkrB}
zy*%LU{?=}B+E*;SPItE4p?zh<WwiK0c(dp<z8us_vFKTBjc6;JmNon7Zr(Yb`l$;l
zc)N?O#UjwY-jmqzT^@l4RLYnB;~lYO5@-x#)(~COKQYmxSjp~J8UF79U#~YwixCVT
z=YFCyl7|sRw{v0K&pwJmXFz7?3<wK^hXwvK{r#N*DaF+LFEO#$O`E{tE<s82*c=)r
zu7&?hcyKQh9-IOg69k059{^NnXVi-NkKdqi4Dt|Or$!lt!t8-aXSvu>R`RSu&COHI
z>_=z(1BE1>1BDFlhgUc|IeC+9g>ZF|_{*X#Xix@XKPJucui+MmAegLkT@M;Q6xUL@
zY}ZmH=He%50s4N!R7R=wR7Ue0?oN#o<-fn^cBUz*^&DXc%dAYp=cDq^_#3yjNS~<i
b{^x}7<a^DwNA^G%h(kBI4SgHy&+7jGSXlCk

literal 0
HcmV?d00001

diff --git a/packages/mermaid/src/docs/landing/er.png b/packages/mermaid/src/docs/landing/er.png
new file mode 100644
index 0000000000000000000000000000000000000000..e3d8dd7cab662c310680e37dd612f987a9ae489b
GIT binary patch
literal 13419
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
QcZx_!PE8grZTjKA0f;sM5dZ)H

literal 0
HcmV?d00001

diff --git a/packages/mermaid/src/docs/landing/flowchart.png b/packages/mermaid/src/docs/landing/flowchart.png
new file mode 100644
index 0000000000000000000000000000000000000000..714626b70e398905987bec0c460308fa7a84471f
GIT binary patch
literal 14794
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

literal 0
HcmV?d00001

diff --git a/packages/mermaid/src/docs/landing/gantt.png b/packages/mermaid/src/docs/landing/gantt.png
new file mode 100644
index 0000000000000000000000000000000000000000..95c8d08a14bc4306426530921fd538b404dfc1da
GIT binary patch
literal 43239
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

literal 0
HcmV?d00001

diff --git a/packages/mermaid/src/docs/landing/index.html b/packages/mermaid/src/docs/landing/index.html
new file mode 100644
index 000000000..7b256f47f
--- /dev/null
+++ b/packages/mermaid/src/docs/landing/index.html
@@ -0,0 +1,337 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
+    <title>The Official Guide to Mermaid.js</title>
+    <meta
+      name="description"
+      content="Landing page for the book The Official Guide to Mermaid.js: Create complex diagrams and beautiful flowcharts easily using text and code"
+    />
+    <meta
+      name="keywords"
+      content="book, guide, mermaid, flowcharts, sequence diagrams, class diagrams, state diagrams, pie charts, Entity Relationship Diagrams, User Journey Diagrams, Requirement Diagrams, Gantt Charts"
+    />
+    <meta name="author" content="Knut Sveidqvist, Ashish Jain" />
+    <link rel="stylesheet" href="https://unpkg.com/tailwindcss@2/dist/tailwind.min.css" />
+    <!--Replace with your tailwind.css once created-->
+    <link href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700" rel="stylesheet" />
+    <!-- Define your gradient here - use online tools to find a gradient matching your branding-->
+    <style>
+      .gradient {
+        background: linear-gradient(90deg, #7557c9 0%, #f4f4f4 100%);
+      }
+      .p-shadow {
+        text-shadow: #7557c9 0px 0px 5px;
+      }
+    </style>
+    <!-- Google Analytics -->
+    <script>
+      // prettier-ignore
+      (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
+    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
+    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
+    })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
+
+      ga('create', 'UA-153180559-1', 'auto');
+      ga('send', 'pageview');
+    </script>
+    <!-- End Google Analytics -->
+  </head>
+  <body
+    class="leading-normal tracking-normal text-white gradient"
+    style="font-family: 'Source Sans Pro', sans-serif"
+  >
+    <!--Nav-->
+
+    <!--Hero-->
+    <div class="pt-24">
+      <div
+        style=""
+        class="container lg:px-24 max-w-5xl px-4 mx-auto flex flex-wrap flex-col md:flex-row items-center"
+      >
+        <!--Left Col-->
+        <div class="w-full md:w-1/2">
+          <div class="flex flex-col justify-center items-start text-center md:text-left">
+            <div class="flex flex-col items-center">
+              <p class="uppercase tracking-loose w-full p-shadow">MermaidPress</p>
+              <h1 class="my-4 text-5xl font-bold leading-tight p-shadow">
+                The Official Guide to Mermaid.js
+              </h1>
+              <p class="leading-normal text-2xl mb-8 p-shadow">
+                Learn to create complex diagrams and beautiful flowcharts easily using text and code
+                using Mermaid.js.
+              </p>
+              <a
+                href="https://www.amazon.com/Official-Guide-Mermaid-js-beautiful-flowcharts-dp-1801078025/dp/1801078025/ref=mt_other?_encoding=UTF8&amp;me=&amp;qid=1628153965"
+              >
+                <button
+                  style="background: #ffa41c; border: 1px solid #ff8f00"
+                  class="mx-auto lg:mx-0 hover:underline text-black font-bold rounded-full my-6 py-4 px-8 shadow-lg focus:outline-none focus:shadow-outline transform transition hover:scale-105 duration-300 ease-in-out"
+                >
+                  Purchase on Amazon
+                </button>
+              </a>
+            </div>
+          </div>
+        </div>
+        <!--Right Col-->
+        <div class="flex-1 md:w-3/5 py-6 text-center flex justify-end">
+          <img class="z-50" style="max-width: 350px" src="cover.jpg" />
+        </div>
+      </div>
+    </div>
+    <div class="relative -mt-0 lg:-mt-12">
+      <svg
+        viewBox="0 0 1428 174"
+        version="1.1"
+        xmlns="http://www.w3.org/2000/svg"
+        xmlns:xlink="http://www.w3.org/1999/xlink"
+      >
+        <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+          <g transform="translate(-2.000000, 44.000000)" fill="#FFFFFF" fill-rule="nonzero">
+            <path
+              d="M0,0 C90.7283404,0.927527913 147.912752,27.187927 291.910178,59.9119003 C387.908462,81.7278826 543.605069,89.334785 759,82.7326078 C469.336065,156.254352 216.336065,153.6679 0,74.9732496"
+              opacity="0.100000001"
+            ></path>
+            <path
+              d="M100,104.708498 C277.413333,72.2345949 426.147877,52.5246657 546.203633,45.5787101 C666.259389,38.6327546 810.524845,41.7979068 979,55.0741668 C931.069965,56.122511 810.303266,74.8455141 616.699903,111.243176 C423.096539,147.640838 250.863238,145.462612 100,104.708498 Z"
+              opacity="0.100000001"
+            ></path>
+            <path
+              d="M1046,51.6521276 C1130.83045,29.328812 1279.08318,17.607883 1439,40.1656806 L1439,120 C1271.17211,77.9435312 1140.17211,55.1609071 1046,51.6521276 Z"
+              id="Path-4"
+              opacity="0.200000003"
+            ></path>
+          </g>
+          <g transform="translate(-4.000000, 76.000000)" fill="#FFFFFF" fill-rule="nonzero">
+            <path
+              d="M0.457,34.035 C57.086,53.198 98.208,65.809 123.822,71.865 C181.454,85.495 234.295,90.29 272.033,93.459 C311.355,96.759 396.635,95.801 461.025,91.663 C486.76,90.01 518.727,86.372 556.926,80.752 C595.747,74.596 622.372,70.008 636.799,66.991 C663.913,61.324 712.501,49.503 727.605,46.128 C780.47,34.317 818.839,22.532 856.324,15.904 C922.689,4.169 955.676,2.522 1011.185,0.432 C1060.705,1.477 1097.39,3.129 1121.236,5.387 C1161.703,9.219 1208.621,17.821 1235.4,22.304 C1285.855,30.748 1354.351,47.432 1440.886,72.354 L1441.191,104.352 L1.121,104.031 L0.457,34.035 Z"
+            ></path>
+          </g>
+        </g>
+      </svg>
+    </div>
+    <section class="bg-white border-b py-8">
+      <div class="container max-w-5xl mx-auto m-8">
+        <h2 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
+          Get up to speed with using Mermaid diagrams along with real-world examples and expert tips
+          from the authors to facilitate a seamless development workflow
+        </h2>
+        <div class="w-full mb-4">
+          <div class="h-1 mx-auto gradient w-64 opacity-25 my-0 py-0 rounded-t"></div>
+        </div>
+        <div class="flex flex-wrap">
+          <div class="w-full sm:w-1/2 p-6 flex items-center">
+            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+              Flowcharts is a diagram type that visualizes a process or an algorithm by showing the
+              steps in order, as well as the different paths the execution can take.
+            </p>
+          </div>
+          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
+            <img class="z-50" src="flowchart.png" />
+          </div>
+        </div>
+        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <img class="z-50 w-full" style="" src="sequence-diagram.png" />
+          </div>
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <div class="align-middle flex items-center">
+              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+                Sequence diagrams lets you model and visualize interactions between different actors
+                or objects in a system, as well as the order of those interactions
+              </p>
+            </div>
+          </div>
+        </div>
+        <div class="flex flex-wrap">
+          <div class="w-full sm:w-1/2 p-6 flex items-center">
+            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+              A class diagram is a graphical representation that is used to visualize and describe
+              an object-oriented system.
+            </p>
+          </div>
+          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
+            <img class="z-50" style="" src="class.png" />
+          </div>
+        </div>
+        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <img class="z-50 w-full" style="" src="er.png" />
+          </div>
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <div class="align-middle flex items-center">
+              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+                An entity-relationship diagram is a graphical representation that is used to
+                visualize the different types of entities that exist within a system.
+              </p>
+            </div>
+          </div>
+        </div>
+        <div class="flex flex-wrap">
+          <div class="w-full sm:w-1/2 p-6 flex items-center">
+            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+              Use State diagrams to model and document state machines, an abstract way of
+              representing a system or an algorithm.
+            </p>
+          </div>
+          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
+            <img class="z-50" style="" src="state.png" />
+          </div>
+        </div>
+        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <img class="z-50 w-full" style="" src="gantt.png" />
+          </div>
+          <div class="w-full sm:w-1/2 p-6 mt-6">
+            <div class="align-middle flex items-center">
+              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
+                A Gantt chart is a graphical representation that is used to visualize and describe
+                tasks (events or activities) over time.
+              </p>
+            </div>
+          </div>
+        </div>
+      </div>
+      <p class="text-3xl text-gray-800 font-normal leading-none mt-3 text-center">
+        These were a few of the diagrams supported by Mermaid.
+      </p>
+    </section>
+
+    <section class="bg-gray-100 border-b py-8">
+      <div class="container mx-auto flex flex-wrap max-w-5xl mx-auto m-8 pt-4 pb-12 px-8">
+        <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
+          Book description
+        </h1>
+        <div class="w-full mb-4">
+          <p class="text-black mb-4">
+            Mermaid lets you represent diagrams using text and code which simplifies the maintenance
+            of complex diagrams. This is a great option for developers as they’re more familiar with
+            code, rather than special tools for generating diagrams. Besides, diagrams in code
+            simplify maintenance and ensure that the code is supported by version control systems.
+            In some cases, Mermaid makes refactoring support for name changes possible while also
+            enabling team collaboration for review distribution and updates.
+          </p>
+          <p class="text-black mb-4">
+            Developers working with any system will be able to put their knowledge to work with this
+            practical guide to using Mermaid for documentation. The book is also a great reference
+            for looking up the syntax for specific diagrams when authoring diagrams.
+          </p>
+          <p class="text-black mb-4">
+            You’ll start by getting up to speed with the importance of accurate and visual
+            documentation. Next, the book introduces Mermaid and establishes how to use it to create
+            effective documentation. By using different tools, editors, or a custom documentation
+            platform, you’ll also learn how to use Mermaid syntax for various diagrams. Later
+            chapters cover advanced configuration settings and theme options to manipulate your
+            diagram as per your needs.
+          </p>
+          <p class="text-black mb-4">
+            By the end of this Mermaid book, you’ll have become well-versed with the different types
+            of Mermaid diagrams and how they can be used in your workflows.
+          </p>
+        </div>
+      </div>
+    </section>
+    <section class="bg-white py-8">
+      <div class="container mx-auto px-2 pt-4 pb-12 text-gray-800">
+        <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
+          What you will learn
+        </h1>
+        <div class="w-full mb-4">
+          <div class="h-1 mx-auto gradient w-64 opacity-25 my-0 py-0 rounded-t"></div>
+        </div>
+        <div class="flex flex-col sm:flex-row justify-center items-center pt-12 my-12 sm:my-4">
+          <div class="flex flex-col mx-4 rounded-lg bg-white mt-4 sm:-mt-6 shadow-lg z-10">
+            <div class="flex-1 bg-white rounded-t rounded-b-none overflow-hidden shadow">
+              <ul class="w-full text-base font-bold px-4">
+                <li class="border-b py-4 px-4">
+                  Understand good and bad documentation, and the art of effective documentation
+                </li>
+                <li class="border-b py-4 px-4">
+                  Become well-versed with maintaining complex diagrams with ease
+                </li>
+                <li class="border-b py-4 px-4">
+                  Learn how to set up a custom documentation system
+                </li>
+                <li class="border-b py-4 px-4">
+                  Learn how to implement Mermaid diagrams in your workflows
+                </li>
+                <li class="border-b py-4 px-4">
+                  Understand how to set up themes for a Mermaid diagram for an entire site
+                </li>
+                <li class="border-b py-4 px-4">
+                  Discover how to draw different types of diagrams such as flowcharts, class
+                  diagrams, Gantt charts, and more
+                </li>
+              </ul>
+            </div>
+          </div>
+        </div>
+      </div>
+    </section>
+    <!-- Change the colour #f8fafc to match the previous section colour -->
+    <svg
+      class="wave-top"
+      viewBox="0 0 1439 147"
+      version="1.1"
+      xmlns="http://www.w3.org/2000/svg"
+      xmlns:xlink="http://www.w3.org/1999/xlink"
+    >
+      <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <g transform="translate(-1.000000, -14.000000)" fill-rule="nonzero">
+          <g class="wave" fill="#f8fafc">
+            <path
+              d="M1440,84 C1383.555,64.3 1342.555,51.3 1317,45 C1259.5,30.824 1206.707,25.526 1169,22 C1129.711,18.326 1044.426,18.475 980,22 C954.25,23.409 922.25,26.742 884,32 C845.122,37.787 818.455,42.121 804,45 C776.833,50.41 728.136,61.77 713,65 C660.023,76.309 621.544,87.729 584,94 C517.525,105.104 484.525,106.438 429,108 C379.49,106.484 342.823,104.484 319,102 C278.571,97.783 231.737,88.736 205,84 C154.629,75.076 86.296,57.743 0,32 L0,0 L1440,0 L1440,84 Z"
+            ></path>
+          </g>
+          <g transform="translate(1.000000, 15.000000)" fill="#FFFFFF">
+            <g
+              transform="translate(719.500000, 68.500000) rotate(-180.000000) translate(-719.500000, -68.500000) "
+            >
+              <path
+                d="M0,0 C90.7283404,0.927527913 147.912752,27.187927 291.910178,59.9119003 C387.908462,81.7278826 543.605069,89.334785 759,82.7326078 C469.336065,156.254352 216.336065,153.6679 0,74.9732496"
+                opacity="0.100000001"
+              ></path>
+              <path
+                d="M100,104.708498 C277.413333,72.2345949 426.147877,52.5246657 546.203633,45.5787101 C666.259389,38.6327546 810.524845,41.7979068 979,55.0741668 C931.069965,56.122511 810.303266,74.8455141 616.699903,111.243176 C423.096539,147.640838 250.863238,145.462612 100,104.708498 Z"
+                opacity="0.100000001"
+              ></path>
+              <path
+                d="M1046,51.6521276 C1130.83045,29.328812 1279.08318,17.607883 1439,40.1656806 L1439,120 C1271.17211,77.9435312 1140.17211,55.1609071 1046,51.6521276 Z"
+                opacity="0.200000003"
+              ></path>
+            </g>
+          </g>
+        </g>
+      </g>
+    </svg>
+    <section class="container mx-auto text-center py-6 mb-12">
+      <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-white p-shadow">
+        Purchase The Official Guide to Mermaid.js
+      </h1>
+      <div class="w-full mb-4">
+        <div class="h-1 mx-auto bg-white w-1/6 opacity-25 my-0 py-0 rounded-t"></div>
+      </div>
+      <h3 class="my-4 text-3xl leading-tight">
+        <p class="mb-4 p-shadow">Written by Knut Sveidqvist and Ashish Jain.</p>
+        <p class="p-shadow">
+          Knut is the creator of Mermaid and both authors are active core team members of the
+          Mermaid open-source project.
+        </p>
+      </h3>
+      <a
+        href="https://www.amazon.com/Official-Guide-Mermaid-js-beautiful-flowcharts-dp-1801078025/dp/1801078025/ref=mt_other?_encoding=UTF8&amp;me=&amp;qid=1628153965"
+      >
+        <button
+          style="background: #ffa41c; border: 1px solid #ff8f00"
+          class="mx-auto lg:mx-0 hover:underline bg-white text-gray-800 font-bold rounded-full my-6 py-4 px-8 shadow-lg focus:outline-none focus:shadow-outline transform transition hover:scale-105 duration-300 ease-in-out"
+        >
+          Purchase Now on Amazon
+        </button>
+      </a>
+    </section>
+    <!--Footer-->
+  </body>
+</html>
diff --git a/packages/mermaid/src/docs/landing/sequence-diagram.png b/packages/mermaid/src/docs/landing/sequence-diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..8c51ac1c5d6601960112784757061943d9d6dc8c
GIT binary patch
literal 19823
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%0D)Muw-s
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
Un8|I}2s%m4)78&qol`;+0CsIFnE(I)

literal 0
HcmV?d00001

diff --git a/packages/mermaid/src/docs/landing/state.png b/packages/mermaid/src/docs/landing/state.png
new file mode 100644
index 0000000000000000000000000000000000000000..2ef66ea2f1368a71013d9cc74b069f99d8445f8f
GIT binary patch
literal 15574
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
DRc_Wx

literal 0
HcmV?d00001

diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 01cb0787e..951d3cc1e 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -236,6 +236,9 @@ importers:
       coveralls:
         specifier: ^3.1.1
         version: 3.1.1
+      cpy-cli:
+        specifier: ^4.2.0
+        version: 4.2.0
       cspell:
         specifier: ^6.14.3
         version: 6.14.3
@@ -3492,6 +3495,14 @@ packages:
       indent-string: 4.0.0
     dev: true
 
+  /aggregate-error/4.0.1:
+    resolution: {integrity: sha512-0poP0T7el6Vq3rstR8Mn4V/IQrpBLO6POkUSrN7RhyY+GF/InCFShQzsQ39T25gkHhLgSLByyAz+Kjb+c2L98w==}
+    engines: {node: '>=12'}
+    dependencies:
+      clean-stack: 4.2.0
+      indent-string: 5.0.0
+    dev: true
+
   /ajv-formats/2.1.1_ajv@8.11.0:
     resolution: {integrity: sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA==}
     peerDependencies:
@@ -3684,6 +3695,11 @@ packages:
     engines: {node: '>=0.10.0'}
     dev: true
 
+  /arrify/3.0.0:
+    resolution: {integrity: sha512-tLkvA81vQG/XqE2mjDkGQHoOINtMHtysSnemrmoGe6PydDPMRbVugqyk4A6V/WDWEfm3l+0d8anA9r8cv/5Jaw==}
+    engines: {node: '>=12'}
+    dev: true
+
   /asn1/0.2.6:
     resolution: {integrity: sha512-ix/FxPn0MDjeyJ7i/yoHGFt/EX6LyNbxSEhPPXODPL+KB0VPk86UYfL0lMdy+KCnv+fmvIzySwaK5COwqVbWTQ==}
     dependencies:
@@ -4018,6 +4034,16 @@ packages:
       quick-lru: 4.0.1
     dev: true
 
+  /camelcase-keys/7.0.2:
+    resolution: {integrity: sha512-Rjs1H+A9R+Ig+4E/9oyB66UC5Mj9Xq3N//vcLf2WzgdTi/3gUu3Z9KoqmlrEG4VuuLK8wJHofxzdQXz/knhiYg==}
+    engines: {node: '>=12'}
+    dependencies:
+      camelcase: 6.3.0
+      map-obj: 4.3.0
+      quick-lru: 5.1.1
+      type-fest: 1.4.0
+    dev: true
+
   /camelcase/5.3.1:
     resolution: {integrity: sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==}
     engines: {node: '>=6'}
@@ -4163,6 +4189,13 @@ packages:
     engines: {node: '>=6'}
     dev: true
 
+  /clean-stack/4.2.0:
+    resolution: {integrity: sha512-LYv6XPxoyODi36Dp976riBtSY27VmFo+MKqEU9QCCWyTrdEPDog+RWA7xQWHi6Vbp61j5c4cdzzX1NidnwtUWg==}
+    engines: {node: '>=12'}
+    dependencies:
+      escape-string-regexp: 5.0.0
+    dev: true
+
   /clear-module/4.1.2:
     resolution: {integrity: sha512-LWAxzHqdHsAZlPlEyJ2Poz6AIs384mPeqLVCru2p0BrP9G/kVGuhNyZYClLO6cXlnuJjzC8xtsJIuMjKqLXoAw==}
     engines: {node: '>=8'}
@@ -4512,6 +4545,39 @@ packages:
       request: 2.88.2
     dev: true
 
+  /cp-file/9.1.0:
+    resolution: {integrity: sha512-3scnzFj/94eb7y4wyXRWwvzLFaQp87yyfTnChIjlfYrVqp5lVO3E2hIJMeQIltUT0K2ZAB3An1qXcBmwGyvuwA==}
+    engines: {node: '>=10'}
+    dependencies:
+      graceful-fs: 4.2.10
+      make-dir: 3.1.0
+      nested-error-stacks: 2.1.1
+      p-event: 4.2.0
+    dev: true
+
+  /cpy-cli/4.2.0:
+    resolution: {integrity: sha512-b04b+cbdr29CdpREPKw/itrfjO43Ty0Aj7wRM6M6LoE4GJxZJCk9Xp+Eu1IqztkKh3LxIBt1tDplENsa6KYprg==}
+    engines: {node: '>=12.20'}
+    hasBin: true
+    dependencies:
+      cpy: 9.0.1
+      meow: 10.1.5
+    dev: true
+
+  /cpy/9.0.1:
+    resolution: {integrity: sha512-D9U0DR5FjTCN3oMTcFGktanHnAG5l020yvOCR1zKILmAyPP7I/9pl6NFgRbDcmSENtbK1sQLBz1p9HIOlroiNg==}
+    engines: {node: ^12.20.0 || ^14.17.0 || >=16.0.0}
+    dependencies:
+      arrify: 3.0.0
+      cp-file: 9.1.0
+      globby: 13.1.2
+      junk: 4.0.0
+      micromatch: 4.0.5
+      nested-error-stacks: 2.1.1
+      p-filter: 3.0.0
+      p-map: 5.5.0
+    dev: true
+
   /create-require/1.1.1:
     resolution: {integrity: sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==}
     dev: true
@@ -5247,6 +5313,11 @@ packages:
     engines: {node: '>=0.10.0'}
     dev: true
 
+  /decamelize/5.0.1:
+    resolution: {integrity: sha512-VfxadyCECXgQlkoEAjeghAr5gY3Hf+IKjKb+X8tGVDtveCjN+USwprd2q3QXBR9T1+x2DG0XZF5/w+7HAtSaXA==}
+    engines: {node: '>=10'}
+    dev: true
+
   /decimal.js/10.4.1:
     resolution: {integrity: sha512-F29o+vci4DodHYT9UrR5IEbfBw9pE5eSapIJdTqXK5+6hq+t8VRxwQyKlW2i+KDKFkkJQRvFyI/QXD83h8LyQw==}
     dev: true
@@ -5792,6 +5863,11 @@ packages:
     engines: {node: '>=10'}
     dev: true
 
+  /escape-string-regexp/5.0.0:
+    resolution: {integrity: sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==}
+    engines: {node: '>=12'}
+    dev: true
+
   /escodegen/1.14.3:
     resolution: {integrity: sha512-qFcX0XJkdg+PB3xjZZG/wKSuT1PnQWx57+TVSjIMmILd2yC/6ByYElPwJnslDsuWuSAp4AwJGumarAAmJch5Kw==}
     engines: {node: '>=4.0'}
@@ -7080,6 +7156,11 @@ packages:
     engines: {node: '>=8'}
     dev: true
 
+  /indent-string/5.0.0:
+    resolution: {integrity: sha512-m6FAo/spmsW2Ab2fU35JTYwtOKa2yAwXSwgjSv1TJzh4Mh7mC3lzAOVLBprb72XsTrgkEIsl7YrFNAiDiRhIGg==}
+    engines: {node: '>=12'}
+    dev: true
+
   /inflight/1.0.6:
     resolution: {integrity: sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==}
     dependencies:
@@ -8041,6 +8122,11 @@ packages:
       verror: 1.10.0
     dev: true
 
+  /junk/4.0.0:
+    resolution: {integrity: sha512-ojtSU++zLJ3jQG9bAYjg94w+/DOJtRyD7nPaerMFrBhmdVmiV5/exYH5t4uHga4G/95nT6hr1OJoKIFbYbrW5w==}
+    engines: {node: '>=12.20'}
+    dev: true
+
   /keyv/4.5.0:
     resolution: {integrity: sha512-2YvuMsA+jnFGtBareKqgANOEKe1mk3HKiXu2fRmAfyxG0MJAywNhi5ttWA3PMjl4NmpyjZNbFifR2vNjW1znfA==}
     dependencies:
@@ -8427,6 +8513,24 @@ packages:
       fs-monkey: 1.0.3
     dev: true
 
+  /meow/10.1.5:
+    resolution: {integrity: sha512-/d+PQ4GKmGvM9Bee/DPa8z3mXs/pkvJE2KEThngVNOqtmljC6K7NMPxtc2JeZYTmpWb9k/TmxjeL18ez3h7vCw==}
+    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+    dependencies:
+      '@types/minimist': 1.2.2
+      camelcase-keys: 7.0.2
+      decamelize: 5.0.1
+      decamelize-keys: 1.1.0
+      hard-rejection: 2.1.0
+      minimist-options: 4.1.0
+      normalize-package-data: 3.0.3
+      read-pkg-up: 8.0.0
+      redent: 4.0.0
+      trim-newlines: 4.0.2
+      type-fest: 1.4.0
+      yargs-parser: 20.2.9
+    dev: true
+
   /meow/8.1.2:
     resolution: {integrity: sha512-r85E3NdZ+mpYk1C6RjPFEMSE+s1iZMuHtsHAqY0DT3jZczl0diWUZ8g6oU7h0M9cD2EL+PzaYghhCLzR0ZNn5Q==}
     engines: {node: '>=10'}
@@ -8796,6 +8900,10 @@ packages:
     resolution: {integrity: sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==}
     dev: true
 
+  /nested-error-stacks/2.1.1:
+    resolution: {integrity: sha512-9iN1ka/9zmX1ZvLV9ewJYEk9h7RyRRtqdK0woXcqohu8EWIerfPUjYJPg0ULy0UqP7cslmdGc8xKDJcojlKiaw==}
+    dev: true
+
   /netmask/2.0.2:
     resolution: {integrity: sha512-dBpDMdxv9Irdq66304OLfEmQ9tbNRFnFTuZiLo+bD+r332bBmMJ8GBLXklIXXgxd3+v9+KUnZaUR5PJMa75Gsg==}
     engines: {node: '>= 0.4.0'}
@@ -8982,6 +9090,20 @@ packages:
     engines: {node: '>=8'}
     dev: true
 
+  /p-event/4.2.0:
+    resolution: {integrity: sha512-KXatOjCRXXkSePPb1Nbi0p0m+gQAwdlbhi4wQKJPI1HsMQS9g+Sqp2o+QHziPr7eYJyOZet836KoHEVM1mwOrQ==}
+    engines: {node: '>=8'}
+    dependencies:
+      p-timeout: 3.2.0
+    dev: true
+
+  /p-filter/3.0.0:
+    resolution: {integrity: sha512-QtoWLjXAW++uTX67HZQz1dbTpqBfiidsB6VtQUC9iR85S120+s0T5sO6s+B5MLzFcZkrEd/DGMmCjR+f2Qpxwg==}
+    engines: {node: ^12.20.0 || ^14.13.1 || >=16.0.0}
+    dependencies:
+      p-map: 5.5.0
+    dev: true
+
   /p-finally/1.0.0:
     resolution: {integrity: sha512-LICb2p9CB7FS+0eR1oqWnHhp0FljGLZCWBE9aix0Uye9W8LTQPwMTYVGWQWIw9RdQiDg4+epXQODwIYJtSJaow==}
     engines: {node: '>=4'}
@@ -9034,6 +9156,13 @@ packages:
       aggregate-error: 3.1.0
     dev: true
 
+  /p-map/5.5.0:
+    resolution: {integrity: sha512-VFqfGDHlx87K66yZrNdI4YGtD70IRyd+zSvgks6mzHPRNkoKy+9EKP4SFC77/vTTQYmRmti7dvqC+m5jBrBAcg==}
+    engines: {node: '>=12'}
+    dependencies:
+      aggregate-error: 4.0.1
+    dev: true
+
   /p-retry/4.6.2:
     resolution: {integrity: sha512-312Id396EbJdvRONlngUx0NydfrIQ5lsYu0znKVUzVvArzEIt08V1qhtyESbGVd1FGX7UKtiFp5uwKZdM8wIuQ==}
     engines: {node: '>=8'}
@@ -9042,6 +9171,13 @@ packages:
       retry: 0.13.1
     dev: true
 
+  /p-timeout/3.2.0:
+    resolution: {integrity: sha512-rhIwUycgwwKcP9yTOOFK/AKsAopjjCakVqLHePO3CC6Mir1Z99xT+R63jZxAT5lFZLa2inS5h+ZS2GvR99/FBg==}
+    engines: {node: '>=8'}
+    dependencies:
+      p-finally: 1.0.0
+    dev: true
+
   /p-try/2.2.0:
     resolution: {integrity: sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==}
     engines: {node: '>=6'}
@@ -9478,6 +9614,15 @@ packages:
       type-fest: 0.8.1
     dev: true
 
+  /read-pkg-up/8.0.0:
+    resolution: {integrity: sha512-snVCqPczksT0HS2EC+SxUndvSzn6LRCwpfSvLrIfR5BKDQQZMaI6jPRC9dYvYFDRAuFEAnkwww8kBBNE/3VvzQ==}
+    engines: {node: '>=12'}
+    dependencies:
+      find-up: 5.0.0
+      read-pkg: 6.0.0
+      type-fest: 1.4.0
+    dev: true
+
   /read-pkg/5.2.0:
     resolution: {integrity: sha512-Ug69mNOpfvKDAc2Q8DRpMjjzdtrnv9HcSMX+4VsZxD1aZ6ZzrIE7rlzXBtWTyhULSMKg076AW6WR5iZpD0JiOg==}
     engines: {node: '>=8'}
@@ -9488,6 +9633,16 @@ packages:
       type-fest: 0.6.0
     dev: true
 
+  /read-pkg/6.0.0:
+    resolution: {integrity: sha512-X1Fu3dPuk/8ZLsMhEj5f4wFAF0DWoK7qhGJvgaijocXxBmSToKfbFtqbxMO7bVjNA1dmE5huAzjXj/ey86iw9Q==}
+    engines: {node: '>=12'}
+    dependencies:
+      '@types/normalize-package-data': 2.4.1
+      normalize-package-data: 3.0.3
+      parse-json: 5.2.0
+      type-fest: 1.4.0
+    dev: true
+
   /readable-stream/1.1.14:
     resolution: {integrity: sha512-+MeVjFf4L44XUkhM1eYbD8fyEsxcV81pqMSR5gblfcLCHfZvbrqy4/qYHE+/R5HoBUT11WV5O08Cr1n3YXkWVQ==}
     dependencies:
@@ -9540,6 +9695,14 @@ packages:
       strip-indent: 3.0.0
     dev: true
 
+  /redent/4.0.0:
+    resolution: {integrity: sha512-tYkDkVVtYkSVhuQ4zBgfvciymHaeuel+zFKXShfDnFP5SyVEP7qo70Rf1jTOTCx3vGNAbnEi/xFkcfQVMIBWag==}
+    engines: {node: '>=12'}
+    dependencies:
+      indent-string: 5.0.0
+      strip-indent: 4.0.0
+    dev: true
+
   /regexp-tree/0.1.24:
     resolution: {integrity: sha512-s2aEVuLhvnVJW6s/iPgEGK6R+/xngd2jNQ+xy4bXNDKxZKJH6jpPHY6kVeVv1IeLCHgswRj+Kl3ELaDjG6V1iw==}
     hasBin: true
@@ -10342,6 +10505,13 @@ packages:
       min-indent: 1.0.1
     dev: true
 
+  /strip-indent/4.0.0:
+    resolution: {integrity: sha512-mnVSV2l+Zv6BLpSD/8V87CW/y9EmmbYzGCIavsnsI6/nwn26DwffM/yztm30Z/I2DY9wdS3vXVCMnHDgZaVNoA==}
+    engines: {node: '>=12'}
+    dependencies:
+      min-indent: 1.0.1
+    dev: true
+
   /strip-json-comments/3.1.1:
     resolution: {integrity: sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==}
     engines: {node: '>=8'}
@@ -10566,6 +10736,11 @@ packages:
     engines: {node: '>=8'}
     dev: true
 
+  /trim-newlines/4.0.2:
+    resolution: {integrity: sha512-GJtWyq9InR/2HRiLZgpIKv+ufIKrVrvjQWEj7PxAXNc5dwbNJkqhAUoAGgzRmULAnoOM5EIpveYd3J2VeSAIew==}
+    engines: {node: '>=12'}
+    dev: true
+
   /trough/2.1.0:
     resolution: {integrity: sha512-AqTiAOLcj85xS7vQ8QkAV41hPDIJ71XJB4RCUrzo/1GM2CQwhkJGaf9Hgr7BOugMRpgGUrqRg/DrBDl4H40+8g==}
     dev: true
@@ -10704,6 +10879,11 @@ packages:
     engines: {node: '>=8'}
     dev: true
 
+  /type-fest/1.4.0:
+    resolution: {integrity: sha512-yGSza74xk0UG8k+pLh5oeoYirvIiWo5t0/o3zHHAO2tRDiZcxWP7fywNlXhqb6/r6sWvwi+RsyQMWhVLe4BVuA==}
+    engines: {node: '>=10'}
+    dev: true
+
   /type-is/1.6.18:
     resolution: {integrity: sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==}
     engines: {node: '>= 0.6'}

From 60d01856984d0b98a82ec9811ea1163dbe08814e Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Fri, 16 Dec 2022 00:37:37 +0530
Subject: [PATCH 114/129] Fix book link

---
 README.md                  | 2 +-
 packages/mermaid/README.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 059940a02..9a500283c 100644
--- a/README.md
+++ b/README.md
@@ -10,7 +10,7 @@ English | [简体中文](./README.zh-CN.md)
 
 **Thanks to all involved, people committing pull requests, people answering questions! 🙏**
 
-<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
+<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/intro/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
 
 ## About
 
diff --git a/packages/mermaid/README.md b/packages/mermaid/README.md
index 91c2d1640..e6c7db608 100644
--- a/packages/mermaid/README.md
+++ b/packages/mermaid/README.md
@@ -10,7 +10,7 @@ English | [简体中文](./README.zh-CN.md)
 
 **Thanks to all involved, people committing pull requests, people answering questions! 🙏**
 
-<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
+<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/intro/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
 
 ## About
 

From 7855edae6babc14f9de9dd6de070d71e6800ba53 Mon Sep 17 00:00:00 2001
From: Alois Klink <alois@aloisklink.com>
Date: Thu, 15 Dec 2022 20:20:04 +0000
Subject: [PATCH 115/129] perf(er): pre-calculcate er UUID namespace

Pre-calculate the entity-relationship diagram namespace UUID.

This UUID is always constant, so we can pre-calculate it to save a
bit of processing power on the client.

Co-authored-by: "Ashley Engelund (weedySeaDragon @ github)" <ashley.engelund@gmail.com>
Co-authored-by: Sidharth Vinod <sidharthv96@gmail.com>
---
 .../mermaid/src/diagrams/er/erRenderer.js     | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)

diff --git a/packages/mermaid/src/diagrams/er/erRenderer.js b/packages/mermaid/src/diagrams/er/erRenderer.js
index 7a7920160..08b448219 100644
--- a/packages/mermaid/src/diagrams/er/erRenderer.js
+++ b/packages/mermaid/src/diagrams/er/erRenderer.js
@@ -643,11 +643,20 @@ export const draw = function (text, id, _version, diagObj) {
   svg.attr('viewBox', `${svgBounds.x - padding} ${svgBounds.y - padding} ${width} ${height}`);
 }; // draw
 
-/** UUID namespace for ER diagram IDs */
-const MERMAID_ERDIAGRAM_UUID = uuid5(
-  'https://mermaid-js.github.io/mermaid/syntax/entityRelationshipDiagram.html',
-  uuid5.URL
-);
+/**
+ * UUID namespace for ER diagram IDs
+ *
+ * This can be generated via running:
+ *
+ * ```js
+ * const { v5: uuid5 } = await import('uuid');
+ * uuid5(
+ *   'https://mermaid-js.github.io/mermaid/syntax/entityRelationshipDiagram.html',
+ *   uuid5.URL
+ * );
+ * ```
+ */
+const MERMAID_ERDIAGRAM_UUID = '28e9f9db-3c8d-5aa5-9faf-44286ae5937c';
 
 /**
  * Return a unique id based on the given string. Start with the prefix, then a hyphen, then the

From 7670ada9acc552dcec0d6db53c8458c6d16df9ac Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Fri, 16 Dec 2022 21:59:44 +0530
Subject: [PATCH 116/129] Add CNAME

---
 docs/CNAME                      | 1 +
 packages/mermaid/package.json   | 2 +-
 packages/mermaid/src/docs/CNAME | 1 +
 3 files changed, 3 insertions(+), 1 deletion(-)
 create mode 100644 docs/CNAME
 create mode 100644 packages/mermaid/src/docs/CNAME

diff --git a/docs/CNAME b/docs/CNAME
new file mode 100644
index 000000000..878812ee9
--- /dev/null
+++ b/docs/CNAME
@@ -0,0 +1 @@
+mermaid.js.org
\ No newline at end of file
diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index cd809fef1..c3804896e 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -28,7 +28,7 @@
     "docs:build": "rimraf ../../docs && pnpm docs:spellcheck && pnpm docs:code && ts-node-esm src/docs.mts",
     "docs:verify": "pnpm docs:spellcheck && pnpm docs:code && ts-node-esm src/docs.mts --verify",
     "docs:pre:vitepress": "rimraf src/vitepress && pnpm docs:code && ts-node-esm src/docs.mts --vitepress",
-    "docs:build:vitepress": "pnpm docs:pre:vitepress && vitepress build src/vitepress && cpy --flat src/docs/landing/ ./src/vitepress/.vitepress/dist/landing",
+    "docs:build:vitepress": "pnpm docs:pre:vitepress && vitepress build src/vitepress && cpy --flat src/docs/landing/ ./src/vitepress/.vitepress/dist/landing && cpy --flat src/docs/CNAME ./src/vitepress/.vitepress/dist/",
     "docs:dev": "pnpm docs:pre:vitepress && concurrently \"vitepress dev src/vitepress\" \"ts-node-esm src/docs.mts --watch --vitepress\"",
     "docs:serve": "pnpm docs:build:vitepress && vitepress serve src/vitepress",
     "docs:spellcheck": "cspell --config ../../cSpell.json \"src/docs/**/*.md\"",
diff --git a/packages/mermaid/src/docs/CNAME b/packages/mermaid/src/docs/CNAME
new file mode 100644
index 000000000..878812ee9
--- /dev/null
+++ b/packages/mermaid/src/docs/CNAME
@@ -0,0 +1 @@
+mermaid.js.org
\ No newline at end of file

From 1e3d76a0aa154826771a59c6b778a7cdffee097b Mon Sep 17 00:00:00 2001
From: Alois Klink <alois@aloisklink.com>
Date: Fri, 16 Dec 2022 16:31:20 +0000
Subject: [PATCH 117/129] docs(README.zh-CN): fix book image src

Copied from https://github.com/mermaid-js/mermaid/commit/ec026eaf8230d9f97fe4004f8ef0d294ca16a098
---
 README.zh-CN.md                  | 2 +-
 packages/mermaid/README.zh-CN.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.zh-CN.md b/README.zh-CN.md
index 4bdbc4ae7..6b3e28b19 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -10,7 +10,7 @@
 
 **感谢所有参与进来提交 PR，解答疑问的人们! 🙏**
 
-<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/img/book-banner-pre-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
+<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/intro/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
 
 ## 关于 Mermaid
 
diff --git a/packages/mermaid/README.zh-CN.md b/packages/mermaid/README.zh-CN.md
index 0ccef27e4..f34c7a647 100644
--- a/packages/mermaid/README.zh-CN.md
+++ b/packages/mermaid/README.zh-CN.md
@@ -10,7 +10,7 @@
 
 **感谢所有参与进来提交 PR，解答疑问的人们! 🙏**
 
-<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/img/book-banner-pre-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
+<a href="https://mermaid-js.github.io/mermaid/landing/"><img src="https://github.com/mermaid-js/mermaid/blob/master/docs/intro/img/book-banner-post-release.jpg" alt="Explore Mermaid.js in depth, with real-world examples, tips & tricks from the creator... The first official book on Mermaid is available for purchase. Check it out!"></a>
 
 ## 关于 Mermaid
 

From a6ea439ef376d3d46a7ce6960d787d98b95532a4 Mon Sep 17 00:00:00 2001
From: Foo-x <www.sand.x@gmail.com>
Date: Sun, 18 Dec 2022 23:44:14 +0900
Subject: [PATCH 118/129] docs: fix typo

---
 docs/community/newDiagram.md                      | 2 +-
 packages/mermaid/src/docs/community/newDiagram.md | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/community/newDiagram.md b/docs/community/newDiagram.md
index 288af42cd..bb7e2a961 100644
--- a/docs/community/newDiagram.md
+++ b/docs/community/newDiagram.md
@@ -60,7 +60,7 @@ Place the renderer in the diagram folder.
 
 ### Step 3: Detection of the new diagram type
 
-The second thing to do is to add the capability to detect the new new diagram to type to the detectType in utils.js. The detection should return a key for the new diagram type.
+The second thing to do is to add the capability to detect the new diagram to type to the detectType in utils.js. The detection should return a key for the new diagram type.
 [This key will be used to as the aria roledescription](#aria-roledescription), so it should be a word that clearly describes the diagram type.
 For example, if your new diagram use a UML deployment diagram, a good key would be "UMLDeploymentDiagram" because assistive technologies such as a screen reader
 would voice that as "U-M-L Deployment diagram." Another good key would be "deploymentDiagram" because that would be voiced as "Deployment Diagram." A bad key would be "deployment" because that would not sufficiently describe the diagram.
diff --git a/packages/mermaid/src/docs/community/newDiagram.md b/packages/mermaid/src/docs/community/newDiagram.md
index 57a454671..75e17e4c9 100644
--- a/packages/mermaid/src/docs/community/newDiagram.md
+++ b/packages/mermaid/src/docs/community/newDiagram.md
@@ -55,7 +55,7 @@ Place the renderer in the diagram folder.
 
 ### Step 3: Detection of the new diagram type
 
-The second thing to do is to add the capability to detect the new new diagram to type to the detectType in utils.js. The detection should return a key for the new diagram type.
+The second thing to do is to add the capability to detect the new diagram to type to the detectType in utils.js. The detection should return a key for the new diagram type.
 [This key will be used to as the aria roledescription](#aria-roledescription), so it should be a word that clearly describes the diagram type.
 For example, if your new diagram use a UML deployment diagram, a good key would be "UMLDeploymentDiagram" because assistive technologies such as a screen reader
 would voice that as "U-M-L Deployment diagram." Another good key would be "deploymentDiagram" because that would be voiced as "Deployment Diagram." A bad key would be "deployment" because that would not sufficiently describe the diagram.

From e46e918b232c41b85071baffe7ee6e5debbb92ee Mon Sep 17 00:00:00 2001
From: "renovate[bot]" <29139614+renovate[bot]@users.noreply.github.com>
Date: Mon, 19 Dec 2022 01:03:22 +0000
Subject: [PATCH 119/129] chore(deps): update pnpm to v7.18.2

---
 package.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/package.json b/package.json
index 5d3e44494..596cac22b 100644
--- a/package.json
+++ b/package.json
@@ -4,7 +4,7 @@
   "version": "9.3.0-rc1",
   "description": "Markdownish syntax for generating flowcharts, sequence diagrams, class diagrams, gantt charts and git graphs.",
   "type": "module",
-  "packageManager": "pnpm@7.18.1",
+  "packageManager": "pnpm@7.18.2",
   "keywords": [
     "diagram",
     "markdown",

From 8e7dd1d14883a438cf090a12750b72d4d89af4b5 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 19 Dec 2022 13:29:09 +0530
Subject: [PATCH 120/129] fix: Remove basepath from docs

---
 packages/mermaid/src/docs/.vitepress/config.ts         | 4 ++--
 packages/mermaid/src/docs/.vitepress/theme/index.ts    | 2 +-
 packages/mermaid/src/docs/.vitepress/theme/redirect.ts | 4 +++-
 3 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/packages/mermaid/src/docs/.vitepress/config.ts b/packages/mermaid/src/docs/.vitepress/config.ts
index 216541d52..33e930cb8 100644
--- a/packages/mermaid/src/docs/.vitepress/config.ts
+++ b/packages/mermaid/src/docs/.vitepress/config.ts
@@ -14,9 +14,9 @@ export default defineConfig({
   lang: 'en-US',
   title: 'Mermaid',
   description: 'Create diagrams and visualizations using text and code.',
-  base: '/mermaid/',
+  base: '/',
   markdown: allMarkdownTransformers,
-  head: [['link', { rel: 'icon', type: 'image/x-icon', href: '/mermaid/favicon.ico' }]],
+  head: [['link', { rel: 'icon', type: 'image/x-icon', href: '/favicon.ico' }]],
   themeConfig: {
     nav: nav(),
     editLink: {
diff --git a/packages/mermaid/src/docs/.vitepress/theme/index.ts b/packages/mermaid/src/docs/.vitepress/theme/index.ts
index efb065fea..ef929aa5d 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/index.ts
+++ b/packages/mermaid/src/docs/.vitepress/theme/index.ts
@@ -18,7 +18,7 @@ export default {
         if (newPath) {
           console.log(`Redirecting to ${newPath} from ${window.location}`);
           // router.go isn't loading the ID properly.
-          window.location.href = `/mermaid/${newPath}`;
+          window.location.href = `/${newPath}`;
         }
       } catch (e) {}
     };
diff --git a/packages/mermaid/src/docs/.vitepress/theme/redirect.ts b/packages/mermaid/src/docs/.vitepress/theme/redirect.ts
index ca4606be0..b6cfa4de2 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/redirect.ts
+++ b/packages/mermaid/src/docs/.vitepress/theme/redirect.ts
@@ -10,7 +10,9 @@ export interface Redirect {
 const getBaseFile = (link: string): Redirect => {
   const url = new URL(link);
   if (
-    (url.hostname !== 'mermaid-js.github.io' && url.hostname !== 'localhost') ||
+    (url.hostname !== 'mermaid-js.github.io' &&
+      url.hostname !== 'mermaid.js.org' &&
+      url.hostname !== 'localhost') ||
     url.pathname !== '/mermaid/'
   ) {
     throw new Error('Not mermaidjs url');

From fd5780d5a13aa583322105c5f70afdafe28e03d5 Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 19 Dec 2022 13:51:05 +0530
Subject: [PATCH 121/129] fix Redirect

---
 .../mermaid/src/docs/.vitepress/theme/redirect.spec.ts     | 4 +---
 packages/mermaid/src/docs/.vitepress/theme/redirect.ts     | 7 +++----
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/mermaid/src/docs/.vitepress/theme/redirect.spec.ts b/packages/mermaid/src/docs/.vitepress/theme/redirect.spec.ts
index c26364108..6070abee4 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/redirect.spec.ts
+++ b/packages/mermaid/src/docs/.vitepress/theme/redirect.spec.ts
@@ -8,6 +8,7 @@ test.each([
   ['http://localhost:1234/mermaid/#/flowchart.md', 'syntax/flowchart.html'],
   ['http://localhost/mermaid/#/flowchart.md', 'syntax/flowchart.html'],
   ['https://mermaid-js.github.io/mermaid/#/flowchart.md', 'syntax/flowchart.html'],
+  ['https://mermaid.js.org/#/flowchart.md', 'syntax/flowchart.html'],
   ['https://mermaid-js.github.io/mermaid/#/./flowchart', 'syntax/flowchart.html'],
   ['https://mermaid-js.github.io/mermaid/#/flowchart', 'syntax/flowchart.html'],
   ['https://mermaid-js.github.io/mermaid/#flowchart', 'syntax/flowchart.html'],
@@ -31,7 +32,4 @@ test.each([
 test('should throw for invalid URL', () => {
   // Not mermaid domain
   expect(() => getRedirect('https://www.google.com')).toThrowError();
-
-  // Not `/mermaid/` path
-  expect(() => getRedirect('http://localhost/#/flowchart.md')).toThrowError();
 });
diff --git a/packages/mermaid/src/docs/.vitepress/theme/redirect.ts b/packages/mermaid/src/docs/.vitepress/theme/redirect.ts
index b6cfa4de2..58537b0ef 100644
--- a/packages/mermaid/src/docs/.vitepress/theme/redirect.ts
+++ b/packages/mermaid/src/docs/.vitepress/theme/redirect.ts
@@ -10,10 +10,9 @@ export interface Redirect {
 const getBaseFile = (link: string): Redirect => {
   const url = new URL(link);
   if (
-    (url.hostname !== 'mermaid-js.github.io' &&
-      url.hostname !== 'mermaid.js.org' &&
-      url.hostname !== 'localhost') ||
-    url.pathname !== '/mermaid/'
+    url.hostname !== 'mermaid-js.github.io' &&
+    url.hostname !== 'mermaid.js.org' &&
+    url.hostname !== 'localhost'
   ) {
     throw new Error('Not mermaidjs url');
   }

From 81aee3554ea2caba457aa31cf1e93aca4c42b59c Mon Sep 17 00:00:00 2001
From: Sidharth Vinod <sidharthv96@gmail.com>
Date: Mon, 19 Dec 2022 14:26:20 +0530
Subject: [PATCH 122/129] Revert "Add CNAME"

This reverts commit 7670ada9acc552dcec0d6db53c8458c6d16df9ac.
---
 docs/CNAME                      | 1 -
 packages/mermaid/package.json   | 2 +-
 packages/mermaid/src/docs/CNAME | 1 -
 3 files changed, 1 insertion(+), 3 deletions(-)
 delete mode 100644 docs/CNAME
 delete mode 100644 packages/mermaid/src/docs/CNAME

diff --git a/docs/CNAME b/docs/CNAME
deleted file mode 100644
index 878812ee9..000000000
--- a/docs/CNAME
+++ /dev/null
@@ -1 +0,0 @@
-mermaid.js.org
\ No newline at end of file
diff --git a/packages/mermaid/package.json b/packages/mermaid/package.json
index c3804896e..cd809fef1 100644
--- a/packages/mermaid/package.json
+++ b/packages/mermaid/package.json
@@ -28,7 +28,7 @@
     "docs:build": "rimraf ../../docs && pnpm docs:spellcheck && pnpm docs:code && ts-node-esm src/docs.mts",
     "docs:verify": "pnpm docs:spellcheck && pnpm docs:code && ts-node-esm src/docs.mts --verify",
     "docs:pre:vitepress": "rimraf src/vitepress && pnpm docs:code && ts-node-esm src/docs.mts --vitepress",
-    "docs:build:vitepress": "pnpm docs:pre:vitepress && vitepress build src/vitepress && cpy --flat src/docs/landing/ ./src/vitepress/.vitepress/dist/landing && cpy --flat src/docs/CNAME ./src/vitepress/.vitepress/dist/",
+    "docs:build:vitepress": "pnpm docs:pre:vitepress && vitepress build src/vitepress && cpy --flat src/docs/landing/ ./src/vitepress/.vitepress/dist/landing",
     "docs:dev": "pnpm docs:pre:vitepress && concurrently \"vitepress dev src/vitepress\" \"ts-node-esm src/docs.mts --watch --vitepress\"",
     "docs:serve": "pnpm docs:build:vitepress && vitepress serve src/vitepress",
     "docs:spellcheck": "cspell --config ../../cSpell.json \"src/docs/**/*.md\"",
diff --git a/packages/mermaid/src/docs/CNAME b/packages/mermaid/src/docs/CNAME
deleted file mode 100644
index 878812ee9..000000000
--- a/packages/mermaid/src/docs/CNAME
+++ /dev/null
@@ -1 +0,0 @@
-mermaid.js.org
\ No newline at end of file

From 86946c9bfdc97940a388733c4ded4cd9199410d3 Mon Sep 17 00:00:00 2001
From: Frank Mayer <mail@frank-mayer.io>
Date: Mon, 19 Dec 2022 15:38:52 +0100
Subject: [PATCH 123/129] fixed Composition arrow

Composition arrow was displayed as \*-- but should be *--
---
 packages/mermaid/src/docs/syntax/classDiagram.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/mermaid/src/docs/syntax/classDiagram.md b/packages/mermaid/src/docs/syntax/classDiagram.md
index 8cd5796ff..50593f729 100644
--- a/packages/mermaid/src/docs/syntax/classDiagram.md
+++ b/packages/mermaid/src/docs/syntax/classDiagram.md
@@ -172,7 +172,7 @@ There are eight different types of relations defined for classes under UML which
 | Type    | Description   |
 | ------- | ------------- |
 | `<\|--` | Inheritance   |
-| `\*--`  | Composition   |
+| `*--`   | Composition   |
 | `o--`   | Aggregation   |
 | `-->`   | Association   |
 | `--`    | Link (Solid)  |

From fca58f59429da0221c8431b7c2c32441aea6c996 Mon Sep 17 00:00:00 2001
From: steph <steph@huynhicode.dev>
Date: Mon, 19 Dec 2022 17:45:25 -0800
Subject: [PATCH 124/129] remove text and add social icons

---
 docs/book/class.png                           | Bin 34954 -> 0 bytes
 docs/book/cover.jpg                           | Bin 17803 -> 0 bytes
 docs/book/er.png                              | Bin 13419 -> 0 bytes
 docs/book/flowchart.png                       | Bin 14794 -> 0 bytes
 docs/book/gantt.png                           | Bin 43239 -> 0 bytes
 docs/book/index.html                          | 340 ------------------
 docs/book/sequence-diagram.png                | Bin 19823 -> 0 bytes
 docs/book/state.png                           | Bin 15574 -> 0 bytes
 .../mermaid/src/docs/.vitepress/config.ts     |  13 +-
 9 files changed, 4 insertions(+), 349 deletions(-)
 delete mode 100644 docs/book/class.png
 delete mode 100644 docs/book/cover.jpg
 delete mode 100644 docs/book/er.png
 delete mode 100644 docs/book/flowchart.png
 delete mode 100644 docs/book/gantt.png
 delete mode 100644 docs/book/index.html
 delete mode 100644 docs/book/sequence-diagram.png
 delete mode 100644 docs/book/state.png

diff --git a/docs/book/class.png b/docs/book/class.png
deleted file mode 100644
index 5b2f663d86f967ca5d96c5fffca73b6e8efb3ad4..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 34954
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
Lk}Q`n`TTzYoi0Wu

diff --git a/docs/book/cover.jpg b/docs/book/cover.jpg
deleted file mode 100644
index 24f8b13bfb3098917e0f4caed06470b9ed0f8b32..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 17803
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
b{^x}7<a^DwNA^G%h(kBI4SgHy&+7jGSXlCk

diff --git a/docs/book/er.png b/docs/book/er.png
deleted file mode 100644
index e3d8dd7cab662c310680e37dd612f987a9ae489b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 13419
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
QcZx_!PE8grZTjKA0f;sM5dZ)H

diff --git a/docs/book/flowchart.png b/docs/book/flowchart.png
deleted file mode 100644
index 714626b70e398905987bec0c460308fa7a84471f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 14794
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

diff --git a/docs/book/gantt.png b/docs/book/gantt.png
deleted file mode 100644
index 95c8d08a14bc4306426530921fd538b404dfc1da..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 43239
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

diff --git a/docs/book/index.html b/docs/book/index.html
deleted file mode 100644
index 4e3ab79f8..000000000
--- a/docs/book/index.html
+++ /dev/null
@@ -1,340 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <!--
-> **Warning**
-> ## THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. 
-> ## Please edit the corresponding file in [/packages/mermaid/src/docs/book/index.html](../../packages/mermaid/src/docs/book/index.html).--><!--# THIS IS AN AUTOGENERATED FILE. DO NOT EDIT. Please edit the corresponding file in packages/mermaid/src/docs.--><head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
-    <title>The Official Guide to Mermaid.js</title>
-    <meta
-      name="description"
-      content="Landing page for the book The Official Guide to Mermaid.js: Create complex diagrams and beautiful flowcharts easily using text and code"
-    />
-    <meta
-      name="keywords"
-      content="book, guide, mermaid, flowcharts, sequence diagrams, class diagrams, state diagrams, pie charts, Entity Relationship Diagrams, User Journey Diagrams, Requirement Diagrams, Gantt Charts"
-    />
-    <meta name="author" content="Knut Sveidqvist, Ashish Jain" />
-    <link rel="stylesheet" href="https://unpkg.com/tailwindcss@2/dist/tailwind.min.css" />
-    <!--Replace with your tailwind.css once created-->
-    <link href="https://fonts.googleapis.com/css?family=Source+Sans+Pro:400,700" rel="stylesheet" />
-    <!-- Define your gradient here - use online tools to find a gradient matching your branding-->
-    <style>
-      .gradient {
-        background: linear-gradient(90deg, #7557c9 0%, #f4f4f4 100%);
-      }
-      .p-shadow {
-        text-shadow: #7557c9 0px 0px 5px;
-      }
-    </style>
-    <!-- Google Analytics -->
-    <script>
-      // prettier-ignore
-      (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
-    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
-    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
-    })(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
-
-      ga('create', 'UA-153180559-1', 'auto');
-      ga('send', 'pageview');
-    </script>
-    <!-- End Google Analytics -->
-  </head>
-  <body
-    class="leading-normal tracking-normal text-white gradient"
-    style="font-family: 'Source Sans Pro', sans-serif"
-  >
-    <!--Nav-->
-
-    <!--Hero-->
-    <div class="pt-24">
-      <div
-        style=""
-        class="container lg:px-24 max-w-5xl px-4 mx-auto flex flex-wrap flex-col md:flex-row items-center"
-      >
-        <!--Left Col-->
-        <div class="w-full md:w-1/2">
-          <div class="flex flex-col justify-center items-start text-center md:text-left">
-            <div class="flex flex-col items-center">
-              <p class="uppercase tracking-loose w-full p-shadow">MermaidPress</p>
-              <h1 class="my-4 text-5xl font-bold leading-tight p-shadow">
-                The Official Guide to Mermaid.js
-              </h1>
-              <p class="leading-normal text-2xl mb-8 p-shadow">
-                Learn to create complex diagrams and beautiful flowcharts easily using text and code
-                using Mermaid.js.
-              </p>
-              <a
-                href="https://www.amazon.com/Official-Guide-Mermaid-js-beautiful-flowcharts-dp-1801078025/dp/1801078025/ref=mt_other?_encoding=UTF8&amp;me=&amp;qid=1628153965"
-              >
-                <button
-                  style="background: #ffa41c; border: 1px solid #ff8f00"
-                  class="mx-auto lg:mx-0 hover:underline text-black font-bold rounded-full my-6 py-4 px-8 shadow-lg focus:outline-none focus:shadow-outline transform transition hover:scale-105 duration-300 ease-in-out"
-                >
-                  Purchase on Amazon
-                </button>
-              </a>
-            </div>
-          </div>
-        </div>
-        <!--Right Col-->
-        <div class="flex-1 md:w-3/5 py-6 text-center flex justify-end">
-          <img class="z-50" style="max-width: 350px" src="cover.jpg" />
-        </div>
-      </div>
-    </div>
-    <div class="relative -mt-0 lg:-mt-12">
-      <svg
-        viewBox="0 0 1428 174"
-        version="1.1"
-        xmlns="http://www.w3.org/2000/svg"
-        xmlns:xlink="http://www.w3.org/1999/xlink"
-      >
-        <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-          <g transform="translate(-2.000000, 44.000000)" fill="#FFFFFF" fill-rule="nonzero">
-            <path
-              d="M0,0 C90.7283404,0.927527913 147.912752,27.187927 291.910178,59.9119003 C387.908462,81.7278826 543.605069,89.334785 759,82.7326078 C469.336065,156.254352 216.336065,153.6679 0,74.9732496"
-              opacity="0.100000001"
-            ></path>
-            <path
-              d="M100,104.708498 C277.413333,72.2345949 426.147877,52.5246657 546.203633,45.5787101 C666.259389,38.6327546 810.524845,41.7979068 979,55.0741668 C931.069965,56.122511 810.303266,74.8455141 616.699903,111.243176 C423.096539,147.640838 250.863238,145.462612 100,104.708498 Z"
-              opacity="0.100000001"
-            ></path>
-            <path
-              d="M1046,51.6521276 C1130.83045,29.328812 1279.08318,17.607883 1439,40.1656806 L1439,120 C1271.17211,77.9435312 1140.17211,55.1609071 1046,51.6521276 Z"
-              id="Path-4"
-              opacity="0.200000003"
-            ></path>
-          </g>
-          <g transform="translate(-4.000000, 76.000000)" fill="#FFFFFF" fill-rule="nonzero">
-            <path
-              d="M0.457,34.035 C57.086,53.198 98.208,65.809 123.822,71.865 C181.454,85.495 234.295,90.29 272.033,93.459 C311.355,96.759 396.635,95.801 461.025,91.663 C486.76,90.01 518.727,86.372 556.926,80.752 C595.747,74.596 622.372,70.008 636.799,66.991 C663.913,61.324 712.501,49.503 727.605,46.128 C780.47,34.317 818.839,22.532 856.324,15.904 C922.689,4.169 955.676,2.522 1011.185,0.432 C1060.705,1.477 1097.39,3.129 1121.236,5.387 C1161.703,9.219 1208.621,17.821 1235.4,22.304 C1285.855,30.748 1354.351,47.432 1440.886,72.354 L1441.191,104.352 L1.121,104.031 L0.457,34.035 Z"
-            ></path>
-          </g>
-        </g>
-      </svg>
-    </div>
-    <section class="bg-white border-b py-8">
-      <div class="container max-w-5xl mx-auto m-8">
-        <h2 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
-          Get up to speed with using Mermaid diagrams along with real-world examples and expert tips
-          from the authors to facilitate a seamless development workflow
-        </h2>
-        <div class="w-full mb-4">
-          <div class="h-1 mx-auto gradient w-64 opacity-25 my-0 py-0 rounded-t"></div>
-        </div>
-        <div class="flex flex-wrap">
-          <div class="w-full sm:w-1/2 p-6 flex items-center">
-            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
-              Flowcharts is a diagram type that visualizes a process or an algorithm by showing the
-              steps in order, as well as the different paths the execution can take.
-            </p>
-          </div>
-          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
-            <img class="z-50" src="flowchart.png" />
-          </div>
-        </div>
-        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
-          <div class="w-full sm:w-1/2 p-6 mt-6">
-            <img class="z-50 w-full" style="" src="sequence-diagram.png" />
-          </div>
-          <div class="w-full sm:w-1/2 p-6 mt-6">
-            <div class="align-middle flex items-center">
-              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
-                Sequence diagrams lets you model and visualize interactions between different actors
-                or objects in a system, as well as the order of those interactions
-              </p>
-            </div>
-          </div>
-        </div>
-        <div class="flex flex-wrap">
-          <div class="w-full sm:w-1/2 p-6 flex items-center">
-            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
-              A class diagram is a graphical representation that is used to visualize and describe
-              an object-oriented system.
-            </p>
-          </div>
-          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
-            <img class="z-50" style="" src="class.png" />
-          </div>
-        </div>
-        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
-          <div class="w-full sm:w-1/2 p-6 mt-6">
-            <img class="z-50 w-full" style="" src="er.png" />
-          </div>
-          <div class="w-full sm:w-1/2 p-6 mt-6">
-            <div class="align-middle flex items-center">
-              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
-                An entity-relationship diagram is a graphical representation that is used to
-                visualize the different types of entities that exist within a system.
-              </p>
-            </div>
-          </div>
-        </div>
-        <div class="flex flex-wrap">
-          <div class="w-full sm:w-1/2 p-6 flex items-center">
-            <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
-              Use State diagrams to model and document state machines, an abstract way of
-              representing a system or an algorithm.
-            </p>
-          </div>
-          <div class="w-full sm:w-1/2 p-6 flex justify-center items-center">
-            <img class="z-50" style="" src="state.png" />
-          </div>
-        </div>
-        <div class="flex flex-wrap flex-col-reverse sm:flex-row flex justify-center items-center">
-          <div class="w-full sm:w-1/2 p-6 mt-6">
-            <img class="z-50 w-full" style="" src="gantt.png" />
-          </div>
-          <div class="w-full sm:w-1/2 p-6 mt-6">
-            <div class="align-middle flex items-center">
-              <p class="text-3xl text-gray-800 font-normal leading-none mb-3">
-                A Gantt chart is a graphical representation that is used to visualize and describe
-                tasks (events or activities) over time.
-              </p>
-            </div>
-          </div>
-        </div>
-      </div>
-      <p class="text-3xl text-gray-800 font-normal leading-none mt-3 text-center">
-        These were a few of the diagrams supported by Mermaid.
-      </p>
-    </section>
-
-    <section class="bg-gray-100 border-b py-8">
-      <div class="container mx-auto flex flex-wrap max-w-5xl mx-auto m-8 pt-4 pb-12 px-8">
-        <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
-          Book description
-        </h1>
-        <div class="w-full mb-4">
-          <p class="text-black mb-4">
-            Mermaid lets you represent diagrams using text and code which simplifies the maintenance
-            of complex diagrams. This is a great option for developers as they’re more familiar with
-            code, rather than special tools for generating diagrams. Besides, diagrams in code
-            simplify maintenance and ensure that the code is supported by version control systems.
-            In some cases, Mermaid makes refactoring support for name changes possible while also
-            enabling team collaboration for review distribution and updates.
-          </p>
-          <p class="text-black mb-4">
-            Developers working with any system will be able to put their knowledge to work with this
-            practical guide to using Mermaid for documentation. The book is also a great reference
-            for looking up the syntax for specific diagrams when authoring diagrams.
-          </p>
-          <p class="text-black mb-4">
-            You’ll start by getting up to speed with the importance of accurate and visual
-            documentation. Next, the book introduces Mermaid and establishes how to use it to create
-            effective documentation. By using different tools, editors, or a custom documentation
-            platform, you’ll also learn how to use Mermaid syntax for various diagrams. Later
-            chapters cover advanced configuration settings and theme options to manipulate your
-            diagram as per your needs.
-          </p>
-          <p class="text-black mb-4">
-            By the end of this Mermaid book, you’ll have become well-versed with the different types
-            of Mermaid diagrams and how they can be used in your workflows.
-          </p>
-        </div>
-      </div>
-    </section>
-    <section class="bg-white py-8">
-      <div class="container mx-auto px-2 pt-4 pb-12 text-gray-800">
-        <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-gray-800">
-          What you will learn
-        </h1>
-        <div class="w-full mb-4">
-          <div class="h-1 mx-auto gradient w-64 opacity-25 my-0 py-0 rounded-t"></div>
-        </div>
-        <div class="flex flex-col sm:flex-row justify-center items-center pt-12 my-12 sm:my-4">
-          <div class="flex flex-col mx-4 rounded-lg bg-white mt-4 sm:-mt-6 shadow-lg z-10">
-            <div class="flex-1 bg-white rounded-t rounded-b-none overflow-hidden shadow">
-              <ul class="w-full text-base font-bold px-4">
-                <li class="border-b py-4 px-4">
-                  Understand good and bad documentation, and the art of effective documentation
-                </li>
-                <li class="border-b py-4 px-4">
-                  Become well-versed with maintaining complex diagrams with ease
-                </li>
-                <li class="border-b py-4 px-4">
-                  Learn how to set up a custom documentation system
-                </li>
-                <li class="border-b py-4 px-4">
-                  Learn how to implement Mermaid diagrams in your workflows
-                </li>
-                <li class="border-b py-4 px-4">
-                  Understand how to set up themes for a Mermaid diagram for an entire site
-                </li>
-                <li class="border-b py-4 px-4">
-                  Discover how to draw different types of diagrams such as flowcharts, class
-                  diagrams, Gantt charts, and more
-                </li>
-              </ul>
-            </div>
-          </div>
-        </div>
-      </div>
-    </section>
-    <!-- Change the colour #f8fafc to match the previous section colour -->
-    <svg
-      class="wave-top"
-      viewBox="0 0 1439 147"
-      version="1.1"
-      xmlns="http://www.w3.org/2000/svg"
-      xmlns:xlink="http://www.w3.org/1999/xlink"
-    >
-      <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-        <g transform="translate(-1.000000, -14.000000)" fill-rule="nonzero">
-          <g class="wave" fill="#f8fafc">
-            <path
-              d="M1440,84 C1383.555,64.3 1342.555,51.3 1317,45 C1259.5,30.824 1206.707,25.526 1169,22 C1129.711,18.326 1044.426,18.475 980,22 C954.25,23.409 922.25,26.742 884,32 C845.122,37.787 818.455,42.121 804,45 C776.833,50.41 728.136,61.77 713,65 C660.023,76.309 621.544,87.729 584,94 C517.525,105.104 484.525,106.438 429,108 C379.49,106.484 342.823,104.484 319,102 C278.571,97.783 231.737,88.736 205,84 C154.629,75.076 86.296,57.743 0,32 L0,0 L1440,0 L1440,84 Z"
-            ></path>
-          </g>
-          <g transform="translate(1.000000, 15.000000)" fill="#FFFFFF">
-            <g
-              transform="translate(719.500000, 68.500000) rotate(-180.000000) translate(-719.500000, -68.500000) "
-            >
-              <path
-                d="M0,0 C90.7283404,0.927527913 147.912752,27.187927 291.910178,59.9119003 C387.908462,81.7278826 543.605069,89.334785 759,82.7326078 C469.336065,156.254352 216.336065,153.6679 0,74.9732496"
-                opacity="0.100000001"
-              ></path>
-              <path
-                d="M100,104.708498 C277.413333,72.2345949 426.147877,52.5246657 546.203633,45.5787101 C666.259389,38.6327546 810.524845,41.7979068 979,55.0741668 C931.069965,56.122511 810.303266,74.8455141 616.699903,111.243176 C423.096539,147.640838 250.863238,145.462612 100,104.708498 Z"
-                opacity="0.100000001"
-              ></path>
-              <path
-                d="M1046,51.6521276 C1130.83045,29.328812 1279.08318,17.607883 1439,40.1656806 L1439,120 C1271.17211,77.9435312 1140.17211,55.1609071 1046,51.6521276 Z"
-                opacity="0.200000003"
-              ></path>
-            </g>
-          </g>
-        </g>
-      </g>
-    </svg>
-    <section class="container mx-auto text-center py-6 mb-12">
-      <h1 class="w-full my-2 text-5xl font-bold leading-tight text-center text-white p-shadow">
-        Purchase The Official Guide to Mermaid.js
-      </h1>
-      <div class="w-full mb-4">
-        <div class="h-1 mx-auto bg-white w-1/6 opacity-25 my-0 py-0 rounded-t"></div>
-      </div>
-      <h3 class="my-4 text-3xl leading-tight">
-        <p class="mb-4 p-shadow">Written by Knut Sveidqvist and Ashish Jain.</p>
-        <p class="p-shadow">
-          Knut is the creator of Mermaid and both authors are active core team members of the
-          Mermaid open-source project.
-        </p>
-      </h3>
-      <a
-        href="https://www.amazon.com/Official-Guide-Mermaid-js-beautiful-flowcharts-dp-1801078025/dp/1801078025/ref=mt_other?_encoding=UTF8&amp;me=&amp;qid=1628153965"
-      >
-        <button
-          style="background: #ffa41c; border: 1px solid #ff8f00"
-          class="mx-auto lg:mx-0 hover:underline bg-white text-gray-800 font-bold rounded-full my-6 py-4 px-8 shadow-lg focus:outline-none focus:shadow-outline transform transition hover:scale-105 duration-300 ease-in-out"
-        >
-          Purchase Now on Amazon
-        </button>
-      </a>
-    </section>
-    <!--Footer-->
-  </body>
-</html>
diff --git a/docs/book/sequence-diagram.png b/docs/book/sequence-diagram.png
deleted file mode 100644
index 8c51ac1c5d6601960112784757061943d9d6dc8c..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 19823
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%0D)Muw-s
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
Un8|I}2s%m4)78&qol`;+0CsIFnE(I)

diff --git a/docs/book/state.png b/docs/book/state.png
deleted file mode 100644
index 2ef66ea2f1368a71013d9cc74b069f99d8445f8f..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 15574
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
DRc_Wx

diff --git a/packages/mermaid/src/docs/.vitepress/config.ts b/packages/mermaid/src/docs/.vitepress/config.ts
index 707bdf03b..9b5f1547e 100644
--- a/packages/mermaid/src/docs/.vitepress/config.ts
+++ b/packages/mermaid/src/docs/.vitepress/config.ts
@@ -23,10 +23,13 @@ export default defineConfig({
       pattern: 'https://github.com/mermaid-js/mermaid/edit/develop/packages/mermaid/src/docs/:path',
       text: 'Edit this page on GitHub',
     },
-
     sidebar: {
       '/': sidebarAll(),
     },
+    socialLinks: [
+      { icon: 'github', link: 'https://github.com/mermaid-js/mermaid' },
+      { icon: 'slack', link: 'https://mermaid-talk.slack.com' },
+    ],
   },
 });
 
@@ -56,14 +59,6 @@ function nav() {
       text: '💻 Live Editor',
       link: 'https://mermaid.live',
     },
-    {
-      text: 'Slack',
-      link: 'https://mermaid-talk.slack.com',
-    },
-    {
-      text: 'GitHub',
-      link: 'https://github.com/mermaid-js/mermaid',
-    },
   ];
 }
 

From 72d9e872846cf900ee19144aab853e76620314ee Mon Sep 17 00:00:00 2001
From: sidharthv96 <sidharthv96@users.noreply.github.com>
Date: Tue, 20 Dec 2022 05:14:37 +0000
Subject: [PATCH 125/129] Update docs

---
 docs/syntax/classDiagram.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/syntax/classDiagram.md b/docs/syntax/classDiagram.md
index c4fc07732..97032ff56 100644
--- a/docs/syntax/classDiagram.md
+++ b/docs/syntax/classDiagram.md
@@ -267,7 +267,7 @@ There are eight different types of relations defined for classes under UML which
 | Type    | Description   |
 | ------- | ------------- |
 | `<\|--` | Inheritance   |
-| `\*--`  | Composition   |
+| `*--`   | Composition   |
 | `o--`   | Aggregation   |
 | `-->`   | Association   |
 | `--`    | Link (Solid)  |

From 3beb828988e2255c210b0908eb5c70c9a17a511b Mon Sep 17 00:00:00 2001
From: Tom PERRILLAT-COLLOMB <tom.perrillat-collomb@protonmail.com>
Date: Tue, 20 Dec 2022 18:35:03 +0100
Subject: [PATCH 126/129] chore(pr): add task in PR template

---
 .github/pull_request_template.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 41d9c4cff..3574c3599 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -14,4 +14,5 @@ Make sure you
 
 - [ ] :book: have read the [contribution guidelines](https://github.com/mermaid-js/mermaid/blob/develop/CONTRIBUTING.md)
 - [ ] :computer: have added unit/e2e tests (if appropriate)
+- [ ] :notebook: have added documentation (if appropriate)
 - [ ] :bookmark: targeted `develop` branch

From 895c16a79343d94d0a84d6aa2ddd20c1405d90f9 Mon Sep 17 00:00:00 2001
From: Omer Rosenbaum <52040016+Omerr@users.noreply.github.com>
Date: Wed, 21 Dec 2022 10:56:09 +0200
Subject: [PATCH 127/129] Add Swimm to the list of integrations

---
 packages/mermaid/src/docs/misc/integrations.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/mermaid/src/docs/misc/integrations.md b/packages/mermaid/src/docs/misc/integrations.md
index 55d0e5b20..e16375872 100644
--- a/packages/mermaid/src/docs/misc/integrations.md
+++ b/packages/mermaid/src/docs/misc/integrations.md
@@ -15,6 +15,7 @@ They also serve as proof of concept, for the variety of things that can be built
 - [Azure Devops](https://docs.microsoft.com/en-us/azure/devops/project/wiki/wiki-markdown-guidance?view=azure-devops#add-mermaid-diagrams-to-a-wiki-page) (**Native support**)
 - [Tuleap](https://docs.tuleap.org/user-guide/writing-in-tuleap.html#graphs) (**Native support**)
 - [Joplin](https://joplinapp.org) (**Native support**)
+- [Swimm](https://swimm.io) (**Native support**)
 - [Notion](https://notion.so) (**Native support**)
 - [Observable](https://observablehq.com/@observablehq/mermaid) (**Native support**)
 - [Obsidian](https://help.obsidian.md/How+to/Format+your+notes#Diagram) (**Native support**)

From 1da20d7aa539e9291928b627d68cdd66960e647d Mon Sep 17 00:00:00 2001
From: Omer Rosenbaum <omer@swimm.io>
Date: Thu, 22 Dec 2022 11:39:21 +0200
Subject: [PATCH 128/129] Added swimm to cSpell

---
 cSpell.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/cSpell.json b/cSpell.json
index 4e9e4945a..49cb8ada1 100644
--- a/cSpell.json
+++ b/cSpell.json
@@ -83,6 +83,7 @@
     "stylis",
     "substate",
     "sveidqvist",
+    "swimm",
     "techn",
     "teststr",
     "textlength",

From d75f70f8085afc98f273dd733a10a24e2963cf5a Mon Sep 17 00:00:00 2001
From: Omer Rosenbaum <omer@swimm.io>
Date: Thu, 22 Dec 2022 11:41:54 +0200
Subject: [PATCH 129/129] Rebuild the docs -> update integrations with swimm

---
 docs/misc/integrations.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/misc/integrations.md b/docs/misc/integrations.md
index 5f4d87792..50f3237cd 100644
--- a/docs/misc/integrations.md
+++ b/docs/misc/integrations.md
@@ -21,6 +21,7 @@ They also serve as proof of concept, for the variety of things that can be built
 - [Azure Devops](https://docs.microsoft.com/en-us/azure/devops/project/wiki/wiki-markdown-guidance?view=azure-devops#add-mermaid-diagrams-to-a-wiki-page) (**Native support**)
 - [Tuleap](https://docs.tuleap.org/user-guide/writing-in-tuleap.html#graphs) (**Native support**)
 - [Joplin](https://joplinapp.org) (**Native support**)
+- [Swimm](https://swimm.io) (**Native support**)
 - [Notion](https://notion.so) (**Native support**)
 - [Observable](https://observablehq.com/@observablehq/mermaid) (**Native support**)
 - [Obsidian](https://help.obsidian.md/How+to/Format+your+notes#Diagram) (**Native support**)