From 6717ceb00631be6c0739148ecb5a0fdfee75ef03 Mon Sep 17 00:00:00 2001
From: Bryan Helmkamp <bryan@brynary.com>
Date: Tue, 17 Mar 2026 09:43:14 -0400
Subject: [PATCH] Add fabro language for syntax highlighting in docs

Register a separate Shiki grammar so ```fabro code blocks get
DOT syntax highlighting alongside the existing ```dot blocks.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 docs/docs.json            |   2 +-
 docs/languages/fabro.json | 100 ++++++++++++++++++++++++++++++++++++++
 2 files changed, 101 insertions(+), 1 deletion(-)
 create mode 100644 docs/languages/fabro.json

diff --git a/docs/docs.json b/docs/docs.json
index 973d5e51b..1aabfcb28 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -332,7 +332,7 @@
   "styling": {
     "codeblocks": {
       "languages": {
-        "custom": ["/languages/dot.json"]
+        "custom": ["/languages/dot.json", "/languages/fabro.json"]
       }
     }
   },
diff --git a/docs/languages/fabro.json b/docs/languages/fabro.json
new file mode 100644
index 000000000..d8cabf1cb
--- /dev/null
+++ b/docs/languages/fabro.json
@@ -0,0 +1,100 @@
+{
+  "name": "fabro",
+  "scopeName": "source.dot",
+  "fileTypes": ["dot", "DOT", "gv", "fabro"],
+  "firstLineMatch": "digraph.*",
+  "patterns": [
+    {
+      "match": " ?(digraph)[ \\t]+([A-Za-z0-9]+) ?(\\{)",
+      "captures": {
+        "1": { "name": "storage.type.dot" },
+        "2": { "name": "variable.other.dot" },
+        "3": { "name": "punctuation.section.dot" }
+      }
+    },
+    {
+      "match": "(<|-)(>|-)",
+      "name": "keyword.operator.dot"
+    },
+    {
+      "match": "\\b(node|edge|graph|digraph|subgraph|strict)\\b",
+      "name": "storage.type.dot"
+    },
+    {
+      "match": "\\b(bottomlabel|color|comment|distortion|fillcolor|fixedsize|fontcolor|fontname|fontsize|group|height|label|layer|orientation|peripheries|regular|shape|shapefile|sides|skew|style|toplabel|URL|width|z)\\b",
+      "name": "support.constant.attribute.node.dot"
+    },
+    {
+      "match": "\\b(arrowhead|arrowsize|arrowtail|color|comment|constraint|decorate|dir|fontcolor|fontname|fontsize|headlabel|headport|headURL|label|labelangle|labeldistance|labelfloat|labelcolor|labelfontname|labelfontsize|layer|lhead|ltail|minlen|samehead|sametail|splines|style|taillabel|tailport|tailURL|weight)\\b",
+      "name": "support.constant.attribute.edge.dot"
+    },
+    {
+      "match": "\\b(bgcolor|center|clusterrank|color|comment|compound|concentrate|fillcolor|fontname|fontpath|fontsize|label|labeljust|labelloc|layers|margin|mclimit|nodesep|nslimit|nslimit1|ordering|orientation|page|pagedir|quantum|rank|rankdir|ranksep|ratio|remincross|rotate|samplepoints|searchsize|size|style|URL)\\b",
+      "name": "support.constant.attribute.graph.dot"
+    },
+    {
+      "match": "\\b(box|polygon|ellipse|circle|point|egg|triangle|plaintext|diamond|trapezium|parallelogram|house|pentagon|hexagon|septagon|octagon|doublecircle|doubleoctagon|tripleoctagon|invtriangle|invtrapezium|invhouse|Mdiamond|Msquare|Mcircle|rect|rectangle|none|note|tab|folder|box3d|component|max|min|same)\\b",
+      "name": "variable.other.dot"
+    },
+    {
+      "begin": "\"",
+      "beginCaptures": {
+        "0": { "name": "punctuation.definition.string.begin.dot" }
+      },
+      "end": "\"",
+      "endCaptures": {
+        "0": { "name": "punctuation.definition.string.end.dot" }
+      },
+      "name": "string.quoted.double.dot",
+      "patterns": [
+        {
+          "match": "\\\\.",
+          "name": "constant.character.escape.dot"
+        }
+      ]
+    },
+    {
+      "begin": "(^[ \\t]+)?(?=//)",
+      "beginCaptures": {
+        "1": { "name": "punctuation.whitespace.comment.leading.dot" }
+      },
+      "end": "(?!\\G)",
+      "patterns": [
+        {
+          "begin": "//",
+          "beginCaptures": {
+            "0": { "name": "punctuation.definition.comment.dot" }
+          },
+          "end": "\\n",
+          "name": "comment.line.double-slash.dot"
+        }
+      ]
+    },
+    {
+      "begin": "(^[ \\t]+)?(?=#)",
+      "beginCaptures": {
+        "1": { "name": "punctuation.whitespace.comment.leading.dot" }
+      },
+      "end": "(?!\\G)",
+      "patterns": [
+        {
+          "begin": "#",
+          "beginCaptures": {
+            "0": { "name": "punctuation.definition.comment.dot" }
+          },
+          "end": "\\n",
+          "name": "comment.line.number-sign.dot"
+        }
+      ]
+    },
+    {
+      "begin": "/\\*",
+      "captures": {
+        "0": { "name": "punctuation.definition.comment.dot" }
+      },
+      "end": "\\*/",
+      "name": "comment.block.dot"
+    }
+  ],
+  "repository": {}
+}