From e99e16190e5f9023c29786e2452dc8b37881772c Mon Sep 17 00:00:00 2001
From: Owen Voke <development@voke.dev>
Date: Mon, 11 May 2026 14:59:38 +0100
Subject: [PATCH] feat: add support for GraphQL language

---
 src/Highlighter.php                           |  2 +
 src/Languages/Graphql/GraphqlLanguage.php     | 73 +++++++++++++++++
 .../Patterns/GraphqlCommentPattern.php        | 35 ++++++++
 .../Patterns/GraphqlDirectivePattern.php      | 26 ++++++
 .../Graphql/Patterns/GraphqlFieldPattern.php  | 26 ++++++
 .../Patterns/GraphqlKeywordPattern.php        | 26 ++++++
 .../Patterns/GraphqlLiteralPattern.php        | 26 ++++++
 .../Graphql/Patterns/GraphqlNumberPattern.php | 26 ++++++
 .../Patterns/GraphqlPunctuationPattern.php    | 27 +++++++
 .../Graphql/Patterns/GraphqlStringPattern.php | 26 ++++++
 .../Patterns/GraphqlVariablePattern.php       | 26 ++++++
 tests/Bench/Fixtures/graphql.txt              | 40 +++++++++
 tests/Bench/HighlighterBench.php              |  1 +
 .../Languages/Graphql/GraphqlLanguageTest.php | 81 +++++++++++++++++++
 14 files changed, 441 insertions(+)
 create mode 100644 src/Languages/Graphql/GraphqlLanguage.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlCommentPattern.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlDirectivePattern.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlFieldPattern.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlKeywordPattern.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlLiteralPattern.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlNumberPattern.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlPunctuationPattern.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlStringPattern.php
 create mode 100644 src/Languages/Graphql/Patterns/GraphqlVariablePattern.php
 create mode 100644 tests/Bench/Fixtures/graphql.txt
 create mode 100644 tests/Languages/Graphql/GraphqlLanguageTest.php

diff --git a/src/Highlighter.php b/src/Highlighter.php
index fc154e6..56e6bb8 100644
--- a/src/Highlighter.php
+++ b/src/Highlighter.php
@@ -17,6 +17,7 @@
 use Tempest\Highlight\Languages\DotEnv\DotEnvLanguage;
 use Tempest\Highlight\Languages\Ellison\EllisonLanguage;
 use Tempest\Highlight\Languages\Gdscript\GdscriptLanguage;
+use Tempest\Highlight\Languages\Graphql\GraphqlLanguage;
 use Tempest\Highlight\Languages\Html\HtmlLanguage;
 use Tempest\Highlight\Languages\Ini\IniLanguage;
 use Tempest\Highlight\Languages\JavaScript\JavaScriptLanguage;
@@ -69,6 +70,7 @@ public function __construct(private readonly Theme $theme = new CssTheme())
             ->addLanguage(new DockerfileLanguage())
             ->addLanguage(new EllisonLanguage())
             ->addLanguage(new GdscriptLanguage())
+            ->addLanguage(new GraphqlLanguage())
             ->addLanguage(new HtmlLanguage())
             ->addLanguage(new JavaScriptLanguage())
             ->addLanguage(new JsonLanguage())
diff --git a/src/Languages/Graphql/GraphqlLanguage.php b/src/Languages/Graphql/GraphqlLanguage.php
new file mode 100644
index 0000000..3cdc132
--- /dev/null
+++ b/src/Languages/Graphql/GraphqlLanguage.php
@@ -0,0 +1,73 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql;
+
+use Override;
+use Tempest\Highlight\Languages\Base\BaseLanguage;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlCommentPattern;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlDirectivePattern;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlFieldPattern;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlKeywordPattern;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlLiteralPattern;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlNumberPattern;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlPunctuationPattern;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlStringPattern;
+use Tempest\Highlight\Languages\Graphql\Patterns\GraphqlVariablePattern;
+
+class GraphqlLanguage extends BaseLanguage
+{
+    public function getName(): string
+    {
+        return 'graphql';
+    }
+
+    public function getAliases(): array
+    {
+        return ['gql'];
+    }
+
+    #[Override]
+    public function getInjections(): array
+    {
+        return [
+            ...parent::getInjections(),
+        ];
+    }
+
+    #[Override]
+    public function getPatterns(): array
+    {
+        return [
+            ...parent::getPatterns(),
+
+            // Comments
+            new GraphqlCommentPattern(),
+
+            // Strings
+            new GraphqlStringPattern(),
+
+            // Keywords: query, mutation, type, etc.
+            new GraphqlKeywordPattern(),
+
+            // Literals: true, false, null, and Types like String, Int
+            new GraphqlLiteralPattern(),
+
+            // Variables: $id
+            new GraphqlVariablePattern(),
+
+            // Directives: @deprecated
+            new GraphqlDirectivePattern(),
+
+            // Numbers
+            new GraphqlNumberPattern(),
+
+            // Symbols/Fields: name followed by a colon
+            new GraphqlFieldPattern(),
+
+            // Punctuation: !, (, ), :, =, [, ], {, |, } and ...
+            new GraphqlPunctuationPattern(),
+        ];
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlCommentPattern.php b/src/Languages/Graphql/Patterns/GraphqlCommentPattern.php
new file mode 100644
index 0000000..fc94fb6
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlCommentPattern.php
@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: '# Comment', output: '# Comment')]
+#[PatternTest(input: '"""Comment"""', output: '"""Comment"""')]
+#[PatternTest(
+    input: '"""
+    Comment
+    """',
+    output: '"""
+    Comment
+    """'
+)]
+final class GraphqlCommentPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '(?<match>#.*|"""[\s\S]*?""")';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::COMMENT;
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlDirectivePattern.php b/src/Languages/Graphql/Patterns/GraphqlDirectivePattern.php
new file mode 100644
index 0000000..056c72b
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlDirectivePattern.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: '@deprecated', output: '@deprecated')]
+final class GraphqlDirectivePattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '(?<match>@\w+)';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::ATTRIBUTE;
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlFieldPattern.php b/src/Languages/Graphql/Patterns/GraphqlFieldPattern.php
new file mode 100644
index 0000000..184fbf2
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlFieldPattern.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: 'test: ID!', output: 'test')]
+final class GraphqlFieldPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '(?<match>[_A-Za-z][_0-9A-Za-z]*)(?=\s*:)';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::PROPERTY;
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlKeywordPattern.php b/src/Languages/Graphql/Patterns/GraphqlKeywordPattern.php
new file mode 100644
index 0000000..008d756
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlKeywordPattern.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: 'type Test {}', output: 'type')]
+final class GraphqlKeywordPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '(?<match>\b(query|mutation|subscription|input|schema|implements|type|interface|union|scalar|fragment|enum|on)\b)';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::KEYWORD;
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlLiteralPattern.php b/src/Languages/Graphql/Patterns/GraphqlLiteralPattern.php
new file mode 100644
index 0000000..7fdffe7
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlLiteralPattern.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: 'isActive: Boolean!', output: 'Boolean')]
+final class GraphqlLiteralPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '(?<match>\b(true|false|null|ID|ID!|String|Float|Int|Boolean)\b)';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::TYPE;
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlNumberPattern.php b/src/Languages/Graphql/Patterns/GraphqlNumberPattern.php
new file mode 100644
index 0000000..54aeb0b
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlNumberPattern.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: 'isActive: 12.345', output: '12.345')]
+final class GraphqlNumberPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '(?<match>\b\d+(\.\d+)?)';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::NUMBER;
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlPunctuationPattern.php b/src/Languages/Graphql/Patterns/GraphqlPunctuationPattern.php
new file mode 100644
index 0000000..df07b61
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlPunctuationPattern.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: '... on User', output: '...')]
+#[PatternTest(input: 'id: ID!', output: [':', '!'])]
+final class GraphqlPunctuationPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '(?<match>\.{3}|[!():=\[\]{|}]|(?<!\.)\.(?!\.))';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::OPERATOR;
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlStringPattern.php b/src/Languages/Graphql/Patterns/GraphqlStringPattern.php
new file mode 100644
index 0000000..92ee0f7
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlStringPattern.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: 'isActive: "Test string"', output: 'Test string')]
+final class GraphqlStringPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '"(?<match>([^"\\\\]|\\\\.)*)"';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::VALUE;
+    }
+}
diff --git a/src/Languages/Graphql/Patterns/GraphqlVariablePattern.php b/src/Languages/Graphql/Patterns/GraphqlVariablePattern.php
new file mode 100644
index 0000000..af1bc8b
--- /dev/null
+++ b/src/Languages/Graphql/Patterns/GraphqlVariablePattern.php
@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Graphql\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+#[PatternTest(input: 'test: $test', output: '$test')]
+final class GraphqlVariablePattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '(?<match>\$[\w]+)';
+    }
+
+    public function getTokenType(): TokenTypeEnum
+    {
+        return TokenTypeEnum::VARIABLE;
+    }
+}
diff --git a/tests/Bench/Fixtures/graphql.txt b/tests/Bench/Fixtures/graphql.txt
new file mode 100644
index 0000000..a71f966
--- /dev/null
+++ b/tests/Bench/Fixtures/graphql.txt
@@ -0,0 +1,40 @@
+# Query users by name
+query UsersByName($name: String!) {
+  users($name: $name) {
+    id
+  }
+}
+
+# ======
+# Schema
+# ======
+
+"""
+A user
+"""
+type User {
+  id: ID!
+  name: String!
+}
+
+type Query {
+  """
+  Query users by name.
+  """
+  users(name: String): [User!]!
+  """
+  Query a user by ID.
+  """
+  user(id: ID!): User
+}
+
+type Mutation {
+  """
+  Create a user
+  """
+  createUser(input: CreateUserInput!): User
+}
+
+input CreateUserInput {
+    name: String!
+}
\ No newline at end of file
diff --git a/tests/Bench/HighlighterBench.php b/tests/Bench/HighlighterBench.php
index 397d321..8abe8a8 100644
--- a/tests/Bench/HighlighterBench.php
+++ b/tests/Bench/HighlighterBench.php
@@ -27,6 +27,7 @@ final class HighlighterBench
         'dotenv' => 'dotenv.txt',
         'ellison' => 'ellison.txt',
         'gdscript' => 'gdscript.txt',
+        'graphql' => 'graphql.txt',
         'html' => 'html.txt',
         'ini' => 'ini.txt',
         'javascript' => 'javascript.txt',
diff --git a/tests/Languages/Graphql/GraphqlLanguageTest.php b/tests/Languages/Graphql/GraphqlLanguageTest.php
new file mode 100644
index 0000000..d09c5f9
--- /dev/null
+++ b/tests/Languages/Graphql/GraphqlLanguageTest.php
@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Tests\Languages\Graphql;
+
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\TestCase;
+use Tempest\Highlight\Highlighter;
+
+class GraphqlLanguageTest extends TestCase
+{
+    #[DataProvider('provide_highlighting_cases')]
+    public function test_highlighting(string $content, string $expected)
+    {
+        $highlighter = new Highlighter();
+
+        $this->assertSame(
+            trim($expected),
+            trim($highlighter->parse($content, 'graphql'))
+        );
+    }
+
+    public static function provide_highlighting_cases(): iterable
+    {
+        return [
+            // Test Keywords & Types
+            [
+                'query GetUser { user { id } }',
+                '<span class="hl-keyword">query</span> GetUser <span class="hl-operator">{</span> user <span class="hl-operator">{</span> id <span class="hl-operator">}</span> <span class="hl-operator">}</span>',
+            ],
+            // Test Literals & Built-in Types
+            [
+                'scalar Custom String Boolean',
+                '<span class="hl-keyword">scalar</span> Custom <span class="hl-type">String</span> <span class="hl-type">Boolean</span>',
+            ],
+            // Test Variables
+            [
+                'query($id: ID!)',
+                '<span class="hl-keyword">query</span><span class="hl-operator">(</span><span class="hl-variable">$id</span><span class="hl-operator">:</span> <span class="hl-type">ID</span><span class="hl-operator">!</span><span class="hl-operator">)</span>',
+            ],
+            // Test Fields (Symbols)
+            [
+                '{ user(name: "Test") }',
+                '<span class="hl-operator">{</span> user<span class="hl-operator">(</span><span class="hl-property">name</span><span class="hl-operator">:</span> &quot;<span class="hl-value">Test</span>&quot;<span class="hl-operator">)</span> <span class="hl-operator">}</span>',
+            ],
+            // Test Directives
+            [
+                'field @deprecated',
+                'field <span class="hl-attribute">@deprecated</span>',
+            ],
+            // Test Comments
+            [
+                '# This is a comment',
+                '<span class="hl-comment"># This is a comment</span>',
+            ],
+            [
+                '"""
+    Multi-line
+    Comment
+    """
+    type User { id: ID }',
+                '<span class="hl-comment">&quot;&quot;&quot;
+    Multi-line
+    Comment
+    &quot;&quot;&quot;</span>
+    <span class="hl-keyword">type</span> User <span class="hl-operator">{</span> <span class="hl-property">id</span><span class="hl-operator">:</span> <span class="hl-type">ID</span> <span class="hl-operator">}</span>',
+            ],
+            // Test Numbers
+            [
+                'offset: 10, price: 1.99',
+                '<span class="hl-property">offset</span><span class="hl-operator">:</span> <span class="hl-number">10</span>, <span class="hl-property">price</span><span class="hl-operator">:</span> <span class="hl-number">1.99</span>',
+            ],
+            // Test Fragments and Spread
+            [
+                '...UserFragment',
+                '<span class="hl-operator">...</span>UserFragment',
+            ],
+        ];
+    }
+}