From 6aeeab4dc5a5786a516b60dea29cdc81ed67b8f5 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Fri, 17 Jul 2026 09:27:22 +0000
Subject: [PATCH 1/3] fix(docs): resolve Mermaid rendering issue in kramdown

The custom script in `docs/_includes/head-custom.html` was incorrectly
looking for a child `<code>` element inside `.language-mermaid` elements.
However, Kramdown directly applies the `language-mermaid` class to the
`<code>` element itself. This commit updates the script to check if the
element is a `CODE` tag, and if so, it replaces its parent `<pre>`
element with a `<div class="mermaid">` element containing the raw diagram
code.

Also adds `.gitignore` exclusions for `docs/_site/` and `node_modules/`
to prevent pre-commit hooks from failing on generated files.

Co-authored-by: lostcontrol <983305+lostcontrol@users.noreply.github.com>
---
 .bundle/config                  |  2 ++
 .gitignore                      |  4 ++++
 docs/.bundle/config             |  2 ++
 docs/Gemfile                    |  2 ++
 docs/_includes/head-custom.html | 12 ++++++++----
 5 files changed, 18 insertions(+), 4 deletions(-)
 create mode 100644 .bundle/config
 create mode 100644 docs/.bundle/config
 create mode 100644 docs/Gemfile

diff --git a/.bundle/config b/.bundle/config
new file mode 100644
index 0000000..2369228
--- /dev/null
+++ b/.bundle/config
@@ -0,0 +1,2 @@
+---
+BUNDLE_PATH: "vendor/bundle"
diff --git a/.gitignore b/.gitignore
index ea5b175..2ef561e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -61,3 +61,7 @@ config.ini.local
 
 # Backup
 backup.txt
+docs/vendor/
+node_modules/
+Gemfile.lock
+docs/_site/
diff --git a/docs/.bundle/config b/docs/.bundle/config
new file mode 100644
index 0000000..2369228
--- /dev/null
+++ b/docs/.bundle/config
@@ -0,0 +1,2 @@
+---
+BUNDLE_PATH: "vendor/bundle"
diff --git a/docs/Gemfile b/docs/Gemfile
new file mode 100644
index 0000000..37f5eaa
--- /dev/null
+++ b/docs/Gemfile
@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gem 'github-pages', group: :jekyll_plugins
diff --git a/docs/_includes/head-custom.html b/docs/_includes/head-custom.html
index b6fdac7..4b65776 100644
--- a/docs/_includes/head-custom.html
+++ b/docs/_includes/head-custom.html
@@ -4,10 +4,14 @@
   document.addEventListener("DOMContentLoaded", async function() {
     const elements = document.querySelectorAll('.language-mermaid');
     elements.forEach(el => {
-      const codeBlock = el.querySelector('code');
-      if (codeBlock) {
-        el.textContent = codeBlock.textContent;
-        el.classList.add('mermaid');
+      if (el.tagName === 'CODE') {
+        const pre = el.parentElement;
+        if (pre && pre.tagName === 'PRE') {
+          const mermaidDiv = document.createElement('div');
+          mermaidDiv.className = 'mermaid';
+          mermaidDiv.textContent = el.textContent;
+          pre.replaceWith(mermaidDiv);
+        }
       }
     });
     await mermaid.run({

From 1d73cd684c5dc36e1d8c1ffaf921a067cf5df902 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Fri, 17 Jul 2026 09:49:44 +0000
Subject: [PATCH 2/3] fix(docs): resolve Mermaid rendering issue in kramdown

The custom script in `docs/_includes/head-custom.html` was incorrectly
looking for a child `<code>` element inside `.language-mermaid` elements.
However, Kramdown directly applies the `language-mermaid` class to the
`<code>` element itself. This commit updates the script to check if the
element is a `CODE` tag, and if so, it replaces its parent `<pre>`
element with a `<div class="mermaid">` element containing the raw diagram
code.

Also adds `.gitignore` exclusions for `docs/_site/` and `node_modules/`
to prevent pre-commit hooks from failing on generated files, and removes
accidental `.bundle/config` inclusions.

Co-authored-by: lostcontrol <983305+lostcontrol@users.noreply.github.com>
---
 .bundle/config      | 2 --
 docs/.bundle/config | 2 --
 2 files changed, 4 deletions(-)
 delete mode 100644 .bundle/config
 delete mode 100644 docs/.bundle/config

diff --git a/.bundle/config b/.bundle/config
deleted file mode 100644
index 2369228..0000000
--- a/.bundle/config
+++ /dev/null
@@ -1,2 +0,0 @@
----
-BUNDLE_PATH: "vendor/bundle"
diff --git a/docs/.bundle/config b/docs/.bundle/config
deleted file mode 100644
index 2369228..0000000
--- a/docs/.bundle/config
+++ /dev/null
@@ -1,2 +0,0 @@
----
-BUNDLE_PATH: "vendor/bundle"

From 81e0bb2a43948430609c5f9c41d3fd9fe216d6d5 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Fri, 17 Jul 2026 10:38:53 +0000
Subject: [PATCH 3/3] fix(docs): resolve Mermaid rendering issue in kramdown

The custom script in `docs/_includes/head-custom.html` was incorrectly
looking for a child `<code>` element inside `.language-mermaid` elements.
However, Kramdown directly applies the `language-mermaid` class to the
`<code>` element itself. This commit updates the script to check if the
element is a `CODE` tag, and if so, it replaces its parent `<pre>`
element with a `<div class="mermaid">` element containing the raw diagram
code.

Co-authored-by: lostcontrol <983305+lostcontrol@users.noreply.github.com>
---
 .gitignore   | 4 ----
 docs/Gemfile | 2 --
 2 files changed, 6 deletions(-)
 delete mode 100644 docs/Gemfile

diff --git a/.gitignore b/.gitignore
index 2ef561e..ea5b175 100644
--- a/.gitignore
+++ b/.gitignore
@@ -61,7 +61,3 @@ config.ini.local
 
 # Backup
 backup.txt
-docs/vendor/
-node_modules/
-Gemfile.lock
-docs/_site/
diff --git a/docs/Gemfile b/docs/Gemfile
deleted file mode 100644
index 37f5eaa..0000000
--- a/docs/Gemfile
+++ /dev/null
@@ -1,2 +0,0 @@
-source 'https://rubygems.org'
-gem 'github-pages', group: :jekyll_plugins