From d97fba6afa152913b82ac510ff46ae370b8cfb69 Mon Sep 17 00:00:00 2001
From: eas4ai <shawn.payments@gmail.com>
Date: Mon, 19 Oct 2026 20:15:55 -0400
Subject: [PATCH 1/2] Add TOML syntax highlighting

---
 src/Highlighter.php                           |   2 +
 .../Toml/Patterns/TomlBooleanPattern.php      |  25 ++++
 .../Toml/Patterns/TomlCommentPattern.php      |  25 ++++
 .../Toml/Patterns/TomlDateTimePattern.php     |  25 ++++
 .../Toml/Patterns/TomlKeyPattern.php          |  27 ++++
 .../Toml/Patterns/TomlNumberPattern.php       |  27 ++++
 .../Toml/Patterns/TomlOperatorPattern.php     |  25 ++++
 .../Toml/Patterns/TomlStringPattern.php       |  27 ++++
 .../Toml/Patterns/TomlTablePattern.php        |  27 ++++
 src/Languages/Toml/TomlLanguage.php           |  40 ++++++
 tests/Bench/Fixtures/toml.txt                 |  23 ++++
 tests/Bench/HighlighterBench.php              |   1 +
 tests/Languages/Toml/TomlLanguageTest.php     | 116 ++++++++++++++++++
 13 files changed, 390 insertions(+)
 create mode 100644 src/Languages/Toml/Patterns/TomlBooleanPattern.php
 create mode 100644 src/Languages/Toml/Patterns/TomlCommentPattern.php
 create mode 100644 src/Languages/Toml/Patterns/TomlDateTimePattern.php
 create mode 100644 src/Languages/Toml/Patterns/TomlKeyPattern.php
 create mode 100644 src/Languages/Toml/Patterns/TomlNumberPattern.php
 create mode 100644 src/Languages/Toml/Patterns/TomlOperatorPattern.php
 create mode 100644 src/Languages/Toml/Patterns/TomlStringPattern.php
 create mode 100644 src/Languages/Toml/Patterns/TomlTablePattern.php
 create mode 100644 src/Languages/Toml/TomlLanguage.php
 create mode 100644 tests/Bench/Fixtures/toml.txt
 create mode 100644 tests/Languages/Toml/TomlLanguageTest.php

diff --git a/src/Highlighter.php b/src/Highlighter.php
index 843cf5b6..3dbc5141 100644
--- a/src/Highlighter.php
+++ b/src/Highlighter.php
@@ -36,6 +36,7 @@
 use Tempest\Highlight\Languages\Terminal\TerminalLanguage;
 use Tempest\Highlight\Languages\Terraform\TerraformLanguage;
 use Tempest\Highlight\Languages\Text\TextLanguage;
+use Tempest\Highlight\Languages\Toml\TomlLanguage;
 use Tempest\Highlight\Languages\Tsx\TsxLanguage;
 use Tempest\Highlight\Languages\Twig\TwigLanguage;
 use Tempest\Highlight\Languages\TypeScript\TypeScriptLanguage;
@@ -94,6 +95,7 @@ public function __construct(
             ->addLanguage(new TerminalLanguage())
             ->addLanguage(new TextLanguage())
             ->addLanguage(new TerraformLanguage())
+            ->addLanguage(new TomlLanguage())
             ->addLanguage(new TypeScriptLanguage())
             ->addLanguage(new XmlLanguage())
             ->addLanguage(new YamlLanguage())
diff --git a/src/Languages/Toml/Patterns/TomlBooleanPattern.php b/src/Languages/Toml/Patterns/TomlBooleanPattern.php
new file mode 100644
index 00000000..39c627b0
--- /dev/null
+++ b/src/Languages/Toml/Patterns/TomlBooleanPattern.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\Tokens\TokenType;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+final class TomlBooleanPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '/(?<![A-Za-z0-9_-])(?<match>true|false)(?![A-Za-z0-9_-])/';
+    }
+
+    public function getTokenType(): TokenType
+    {
+        return TokenTypeEnum::LITERAL;
+    }
+}
diff --git a/src/Languages/Toml/Patterns/TomlCommentPattern.php b/src/Languages/Toml/Patterns/TomlCommentPattern.php
new file mode 100644
index 00000000..51fd626d
--- /dev/null
+++ b/src/Languages/Toml/Patterns/TomlCommentPattern.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\Tokens\TokenType;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+final class TomlCommentPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '/(?<match>#[^\r\n]*)/';
+    }
+
+    public function getTokenType(): TokenType
+    {
+        return TokenTypeEnum::COMMENT;
+    }
+}
diff --git a/src/Languages/Toml/Patterns/TomlDateTimePattern.php b/src/Languages/Toml/Patterns/TomlDateTimePattern.php
new file mode 100644
index 00000000..09139351
--- /dev/null
+++ b/src/Languages/Toml/Patterns/TomlDateTimePattern.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\Tokens\TokenType;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+final class TomlDateTimePattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '/(?<![A-Za-z0-9_-])(?<match>(?:\d{4}-\d{2}-\d{2}(?:[Tt ]\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:[Zz]|[+-]\d{2}:\d{2})?)?|\d{2}:\d{2}:\d{2}(?:\.\d+)?))(?![A-Za-z0-9_-])/';
+    }
+
+    public function getTokenType(): TokenType
+    {
+        return TokenTypeEnum::VALUE;
+    }
+}
diff --git a/src/Languages/Toml/Patterns/TomlKeyPattern.php b/src/Languages/Toml/Patterns/TomlKeyPattern.php
new file mode 100644
index 00000000..afff89d7
--- /dev/null
+++ b/src/Languages/Toml/Patterns/TomlKeyPattern.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\Tokens\TokenType;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+final class TomlKeyPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return <<<'REGEX'
+/(?:^[\t ]*|(?<=[{,])[\t ]*)(?<match>(?:"(?:\\(?:["\\bfnrt]|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})|[^"\\\r\n])*"|'[^'\r\n]*'|[A-Za-z0-9_-]+)(?:[\t ]*\.[\t ]*(?:"(?:\\(?:["\\bfnrt]|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})|[^"\\\r\n])*"|'[^'\r\n]*'|[A-Za-z0-9_-]+))*)(?=[\t ]*=)/m
+REGEX;
+    }
+
+    public function getTokenType(): TokenType
+    {
+        return TokenTypeEnum::PROPERTY;
+    }
+}
diff --git a/src/Languages/Toml/Patterns/TomlNumberPattern.php b/src/Languages/Toml/Patterns/TomlNumberPattern.php
new file mode 100644
index 00000000..a8a2b90b
--- /dev/null
+++ b/src/Languages/Toml/Patterns/TomlNumberPattern.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\Tokens\TokenType;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+final class TomlNumberPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return <<<'REGEX'
+/(?<![A-Za-z0-9_.-])(?<match>[+-]?(?:inf|nan)|0x[0-9A-Fa-f](?:_?[0-9A-Fa-f])*|0o[0-7](?:_?[0-7])*|0b[01](?:_?[01])*|[+-]?(?:\d(?:_?\d)*\.\d(?:_?\d)*(?:[eE][+-]?\d(?:_?\d)*)?|\d(?:_?\d)*[eE][+-]?\d(?:_?\d)*|\d(?:_?\d)*))(?![A-Za-z0-9_.-])/
+REGEX;
+    }
+
+    public function getTokenType(): TokenType
+    {
+        return TokenTypeEnum::NUMBER;
+    }
+}
diff --git a/src/Languages/Toml/Patterns/TomlOperatorPattern.php b/src/Languages/Toml/Patterns/TomlOperatorPattern.php
new file mode 100644
index 00000000..dd3d826b
--- /dev/null
+++ b/src/Languages/Toml/Patterns/TomlOperatorPattern.php
@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\Tokens\TokenType;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+final class TomlOperatorPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return '/(?<match>\[\[|\]\]|\[|\]|\{|\}|=|,)/';
+    }
+
+    public function getTokenType(): TokenType
+    {
+        return TokenTypeEnum::OPERATOR;
+    }
+}
diff --git a/src/Languages/Toml/Patterns/TomlStringPattern.php b/src/Languages/Toml/Patterns/TomlStringPattern.php
new file mode 100644
index 00000000..232801b9
--- /dev/null
+++ b/src/Languages/Toml/Patterns/TomlStringPattern.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\Tokens\TokenType;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+final class TomlStringPattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return <<<'REGEX'
+/(?<match>"""(?:\\[\s\S]|"{1,2}(?!")|[^"\\])*"""|'''(?:'{1,2}(?!')|[^'])*'''|"(?:\\(?:["\\bfnrt]|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})|[^"\\\r\n])*"|'[^'\r\n]*')/
+REGEX;
+    }
+
+    public function getTokenType(): TokenType
+    {
+        return TokenTypeEnum::VALUE;
+    }
+}
diff --git a/src/Languages/Toml/Patterns/TomlTablePattern.php b/src/Languages/Toml/Patterns/TomlTablePattern.php
new file mode 100644
index 00000000..f7144c1b
--- /dev/null
+++ b/src/Languages/Toml/Patterns/TomlTablePattern.php
@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml\Patterns;
+
+use Tempest\Highlight\IsPattern;
+use Tempest\Highlight\Pattern;
+use Tempest\Highlight\Tokens\TokenType;
+use Tempest\Highlight\Tokens\TokenTypeEnum;
+
+final class TomlTablePattern implements Pattern
+{
+    use IsPattern;
+
+    public function getPattern(): string
+    {
+        return <<<'REGEX'
+/^[\t ]*\[{1,2}[\t ]*(?<match>(?:"(?:\\(?:["\\bfnrt]|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})|[^"\\\r\n])*"|'[^'\r\n]*'|[A-Za-z0-9_-]+)(?:[\t ]*\.[\t ]*(?:"(?:\\(?:["\\bfnrt]|u[0-9A-Fa-f]{4}|U[0-9A-Fa-f]{8})|[^"\\\r\n])*"|'[^'\r\n]*'|[A-Za-z0-9_-]+))*)(?=[\t ]*\]{1,2})/m
+REGEX;
+    }
+
+    public function getTokenType(): TokenType
+    {
+        return TokenTypeEnum::TYPE;
+    }
+}
diff --git a/src/Languages/Toml/TomlLanguage.php b/src/Languages/Toml/TomlLanguage.php
new file mode 100644
index 00000000..45ffea52
--- /dev/null
+++ b/src/Languages/Toml/TomlLanguage.php
@@ -0,0 +1,40 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Languages\Toml;
+
+use Override;
+use Tempest\Highlight\Languages\Base\BaseLanguage;
+use Tempest\Highlight\Languages\Toml\Patterns\TomlBooleanPattern;
+use Tempest\Highlight\Languages\Toml\Patterns\TomlCommentPattern;
+use Tempest\Highlight\Languages\Toml\Patterns\TomlDateTimePattern;
+use Tempest\Highlight\Languages\Toml\Patterns\TomlKeyPattern;
+use Tempest\Highlight\Languages\Toml\Patterns\TomlNumberPattern;
+use Tempest\Highlight\Languages\Toml\Patterns\TomlOperatorPattern;
+use Tempest\Highlight\Languages\Toml\Patterns\TomlStringPattern;
+use Tempest\Highlight\Languages\Toml\Patterns\TomlTablePattern;
+
+final class TomlLanguage extends BaseLanguage
+{
+    public function getName(): string
+    {
+        return 'toml';
+    }
+
+    #[Override]
+    public function getPatterns(): array
+    {
+        return [
+            ...parent::getPatterns(),
+            new TomlKeyPattern(),
+            new TomlTablePattern(),
+            new TomlStringPattern(),
+            new TomlDateTimePattern(),
+            new TomlNumberPattern(),
+            new TomlBooleanPattern(),
+            new TomlCommentPattern(),
+            new TomlOperatorPattern(),
+        ];
+    }
+}
diff --git a/tests/Bench/Fixtures/toml.txt b/tests/Bench/Fixtures/toml.txt
new file mode 100644
index 00000000..5c4dc04e
--- /dev/null
+++ b/tests/Bench/Fixtures/toml.txt
@@ -0,0 +1,23 @@
+# Application settings
+title = "Nightly Service"
+"site owner" = 'Operations'
+enabled = true
+ports = [8000, 8001, 8002]
+ratio = 6.626e-34
+mask = 0xFF_EC_DE_5E
+released = 2026-10-19T03:45:00Z
+alarm = 07:30:00
+description = """A multiline
+service description."""
+
+[database.primary]
+host = "db.internal"
+credentials = { user = "service", retries = 3 }
+
+[[servers]]
+name = "api-01"
+roles = ["web", "worker"]
+
+[[servers]]
+name = "api-02"
+roles = ["web"]
diff --git a/tests/Bench/HighlighterBench.php b/tests/Bench/HighlighterBench.php
index 154b03c3..728130b4 100644
--- a/tests/Bench/HighlighterBench.php
+++ b/tests/Bench/HighlighterBench.php
@@ -44,6 +44,7 @@ final class HighlighterBench
         'swift' => 'swift.txt',
         'terminal' => 'terminal.txt',
         'terraform' => 'terraform.txt',
+        'toml' => 'toml.txt',
         'typescript' => 'typescript.txt',
         'txt' => 'text.txt',
         'twig' => 'twig.txt',
diff --git a/tests/Languages/Toml/TomlLanguageTest.php b/tests/Languages/Toml/TomlLanguageTest.php
new file mode 100644
index 00000000..7bd0405f
--- /dev/null
+++ b/tests/Languages/Toml/TomlLanguageTest.php
@@ -0,0 +1,116 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Highlight\Tests\Languages\Toml;
+
+use PHPUnit\Framework\Attributes\DataProvider;
+use PHPUnit\Framework\Attributes\Test;
+use PHPUnit\Framework\TestCase;
+use Tempest\Highlight\Highlighter;
+use Tempest\Highlight\Languages\Toml\TomlLanguage;
+use Tempest\Highlight\Tests\Bench\HighlighterBench;
+
+final class TomlLanguageTest extends TestCase
+{
+    #[Test]
+    public function it_registers_the_language_name(): void
+    {
+        $highlighter = new Highlighter();
+
+        $this->assertContains('toml', $highlighter->getSupportedLanguageNames());
+
+        $highlighter->parse('', 'toml');
+
+        $this->assertInstanceOf(TomlLanguage::class, $highlighter->getCurrentLanguage());
+    }
+
+    #[Test]
+    public function it_escapes_html_and_strips_reserved_markers(): void
+    {
+        $source = "title = \"<&copy;> ❷img src=x onerror=alert(1)❸ ❶❹❿\"\r\n"
+            . "script = \"<script>alert('x')</script>\"\r"
+            . "enabled = true\r\n";
+
+        $highlighted = (new Highlighter())->parse($source, 'toml');
+        $renderedSource = html_entity_decode(strip_tags($highlighted), ENT_QUOTES | ENT_HTML5);
+
+        $expectedSource = str_replace(["\r\n", "\r"], "\n", str_replace(['❶', '❷', '❸', '❹', '❿'], '', $source));
+
+        $this->assertSame($expectedSource, $renderedSource);
+        $this->assertStringNotContainsString('<script>', $highlighted);
+        $this->assertStringNotContainsString('<img', $highlighted);
+        $this->assertStringContainsString('&lt;script&gt;', $highlighted);
+        $this->assertStringContainsString('&amp;copy;', $highlighted);
+    }
+
+    #[Test]
+    #[DataProvider('provide_it_highlights_representative_syntax_cases')]
+    public function it_highlights_representative_syntax(string $source, string $expected): void
+    {
+        $highlighted = (new Highlighter())->parse($source, 'toml');
+
+        $this->assertStringContainsString($expected, $highlighted);
+    }
+
+    public static function provide_it_highlights_representative_syntax_cases(): iterable
+    {
+        yield 'comment' => ['# Server settings', '<span class="hl-comment"># Server settings</span>'];
+        yield 'bare key' => ['title = "TOML"', '<span class="hl-property">title</span>'];
+        yield 'quoted key' => ['"site title" = "TOML"', '<span class="hl-property">&quot;site title&quot;</span>'];
+        yield 'dotted key' => ['fruit.physical.color = "orange"', '<span class="hl-property">fruit.physical.color</span>'];
+        yield 'standard table' => ['[database]', '<span class="hl-type">database</span>'];
+        yield 'array of tables' => ['[[products]]', '<span class="hl-type">products</span>'];
+        yield 'basic string' => ['name = "TOML\nExample"', '<span class="hl-value">&quot;TOML\nExample&quot;</span>'];
+        yield 'literal string' => ["path = 'C:\\Users'", '<span class="hl-value">\'C:\\Users\'</span>'];
+        yield 'multiline basic string' => ["text = \"\"\"first\nsecond\"\"\"", '<span class="hl-value">&quot;&quot;&quot;first'];
+        yield 'multiline literal string' => ["text = '''first\nsecond'''", '<span class="hl-value">\'\'\'first'];
+        yield 'decimal integer' => ['answer = 42', '<span class="hl-number">42</span>'];
+        yield 'hexadecimal integer' => ['color = 0xDEAD_BEEF', '<span class="hl-number">0xDEAD_BEEF</span>'];
+        yield 'octal integer' => ['mask = 0o755', '<span class="hl-number">0o755</span>'];
+        yield 'binary integer' => ['bits = 0b1101', '<span class="hl-number">0b1101</span>'];
+        yield 'float' => ['ratio = 6.626e-34', '<span class="hl-number">6.626e-34</span>'];
+        yield 'special float' => ['limit = +inf', '<span class="hl-number">+inf</span>'];
+        yield 'boolean' => ['enabled = true', '<span class="hl-literal">true</span>'];
+        yield 'offset date time' => ['created = 1979-05-27T07:32:00Z', '<span class="hl-value">1979-05-27T07:32:00Z</span>'];
+        yield 'local date time' => ['created = 1979-05-27T07:32:00', '<span class="hl-value">1979-05-27T07:32:00</span>'];
+        yield 'local date' => ['birthday = 1979-05-27', '<span class="hl-value">1979-05-27</span>'];
+        yield 'local time' => ['alarm = 07:32:00', '<span class="hl-value">07:32:00</span>'];
+        yield 'array delimiters' => ['ports = [8000, 8001]', '<span class="hl-operator">[</span>'];
+        yield 'inline table delimiters' => ['point = { x = 1, y = 2 }', '<span class="hl-operator">{</span>'];
+        yield 'key-value separator' => ['title = "TOML"', '<span class="hl-operator">=</span>'];
+        yield 'collection separator' => ['ports = [8000, 8001]', '<span class="hl-operator">,</span>'];
+    }
+
+    #[Test]
+    public function it_has_non_empty_a_non_empty_benchmark_fixture(): void
+    {
+        $this->assertSame('toml.txt', HighlighterBench::LANGUAGES['toml'] ?? null);
+
+        foreach ([__DIR__ . '/../../Bench/Fixtures/toml.txt'] as $fixture) {
+            $this->assertFileExists($fixture);
+            $this->assertNotSame('', trim((string) file_get_contents($fixture)));
+        }
+    }
+
+    #[Test]
+    #[DataProvider('provide_it_avoids_pcre_errors_for_unterminated_input_cases')]
+    public function it_avoids_pcre_errors_for_unterminated_input(string $source): void
+    {
+        foreach ((new TomlLanguage())->getPatterns() as $pattern) {
+            preg_match('//', '');
+
+            $pattern->match($source);
+
+            $this->assertSame(PREG_NO_ERROR, preg_last_error(), $pattern::class . ': ' . preg_last_error_msg());
+        }
+    }
+
+    public static function provide_it_avoids_pcre_errors_for_unterminated_input_cases(): iterable
+    {
+        yield 'basic string' => ['value = "' . str_repeat('a', 1_000)];
+        yield 'multiline basic string' => ['value = """' . str_repeat('a', 1_000)];
+        yield 'array' => ['value = [' . str_repeat('1,', 500)];
+        yield 'inline table' => ['value = { key = "' . str_repeat('a', 1_000)];
+    }
+}

From ed0db06f2249d570059154c0242539d800ec2721 Mon Sep 17 00:00:00 2001
From: eas4ai <shawn.payments@gmail.com>
Date: Tue, 20 Oct 2026 06:28:32 -0400
Subject: [PATCH 2/2] Add TOML pattern tests

---
 src/Languages/Toml/Patterns/TomlBooleanPattern.php  | 3 +++
 src/Languages/Toml/Patterns/TomlCommentPattern.php  | 2 ++
 src/Languages/Toml/Patterns/TomlDateTimePattern.php | 3 +++
 src/Languages/Toml/Patterns/TomlKeyPattern.php      | 3 +++
 src/Languages/Toml/Patterns/TomlNumberPattern.php   | 4 ++++
 src/Languages/Toml/Patterns/TomlOperatorPattern.php | 3 +++
 src/Languages/Toml/Patterns/TomlStringPattern.php   | 3 +++
 src/Languages/Toml/Patterns/TomlTablePattern.php    | 3 +++
 8 files changed, 24 insertions(+)

diff --git a/src/Languages/Toml/Patterns/TomlBooleanPattern.php b/src/Languages/Toml/Patterns/TomlBooleanPattern.php
index 39c627b0..850e531b 100644
--- a/src/Languages/Toml/Patterns/TomlBooleanPattern.php
+++ b/src/Languages/Toml/Patterns/TomlBooleanPattern.php
@@ -6,9 +6,12 @@
 
 use Tempest\Highlight\IsPattern;
 use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
 use Tempest\Highlight\Tokens\TokenType;
 use Tempest\Highlight\Tokens\TokenTypeEnum;
 
+#[PatternTest(input: 'enabled = true', output: 'true')]
+#[PatternTest(input: 'enabled = false', output: 'false')]
 final class TomlBooleanPattern implements Pattern
 {
     use IsPattern;
diff --git a/src/Languages/Toml/Patterns/TomlCommentPattern.php b/src/Languages/Toml/Patterns/TomlCommentPattern.php
index 51fd626d..63c655a9 100644
--- a/src/Languages/Toml/Patterns/TomlCommentPattern.php
+++ b/src/Languages/Toml/Patterns/TomlCommentPattern.php
@@ -6,9 +6,11 @@
 
 use Tempest\Highlight\IsPattern;
 use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
 use Tempest\Highlight\Tokens\TokenType;
 use Tempest\Highlight\Tokens\TokenTypeEnum;
 
+#[PatternTest(input: '# Server settings', output: '# Server settings')]
 final class TomlCommentPattern implements Pattern
 {
     use IsPattern;
diff --git a/src/Languages/Toml/Patterns/TomlDateTimePattern.php b/src/Languages/Toml/Patterns/TomlDateTimePattern.php
index 09139351..65baa7fc 100644
--- a/src/Languages/Toml/Patterns/TomlDateTimePattern.php
+++ b/src/Languages/Toml/Patterns/TomlDateTimePattern.php
@@ -6,9 +6,12 @@
 
 use Tempest\Highlight\IsPattern;
 use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
 use Tempest\Highlight\Tokens\TokenType;
 use Tempest\Highlight\Tokens\TokenTypeEnum;
 
+#[PatternTest(input: 'created = 1979-05-27T07:32:00Z', output: '1979-05-27T07:32:00Z')]
+#[PatternTest(input: 'alarm = 07:32:00', output: '07:32:00')]
 final class TomlDateTimePattern implements Pattern
 {
     use IsPattern;
diff --git a/src/Languages/Toml/Patterns/TomlKeyPattern.php b/src/Languages/Toml/Patterns/TomlKeyPattern.php
index afff89d7..0f19991c 100644
--- a/src/Languages/Toml/Patterns/TomlKeyPattern.php
+++ b/src/Languages/Toml/Patterns/TomlKeyPattern.php
@@ -6,9 +6,12 @@
 
 use Tempest\Highlight\IsPattern;
 use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
 use Tempest\Highlight\Tokens\TokenType;
 use Tempest\Highlight\Tokens\TokenTypeEnum;
 
+#[PatternTest(input: 'title = "TOML"', output: 'title')]
+#[PatternTest(input: 'fruit.physical.color = "orange"', output: 'fruit.physical.color')]
 final class TomlKeyPattern implements Pattern
 {
     use IsPattern;
diff --git a/src/Languages/Toml/Patterns/TomlNumberPattern.php b/src/Languages/Toml/Patterns/TomlNumberPattern.php
index a8a2b90b..e4b63b10 100644
--- a/src/Languages/Toml/Patterns/TomlNumberPattern.php
+++ b/src/Languages/Toml/Patterns/TomlNumberPattern.php
@@ -6,9 +6,13 @@
 
 use Tempest\Highlight\IsPattern;
 use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
 use Tempest\Highlight\Tokens\TokenType;
 use Tempest\Highlight\Tokens\TokenTypeEnum;
 
+#[PatternTest(input: 'answer = 42', output: '42')]
+#[PatternTest(input: 'color = 0xDEAD_BEEF', output: '0xDEAD_BEEF')]
+#[PatternTest(input: 'limit = +inf', output: '+inf')]
 final class TomlNumberPattern implements Pattern
 {
     use IsPattern;
diff --git a/src/Languages/Toml/Patterns/TomlOperatorPattern.php b/src/Languages/Toml/Patterns/TomlOperatorPattern.php
index dd3d826b..51a204ec 100644
--- a/src/Languages/Toml/Patterns/TomlOperatorPattern.php
+++ b/src/Languages/Toml/Patterns/TomlOperatorPattern.php
@@ -6,9 +6,12 @@
 
 use Tempest\Highlight\IsPattern;
 use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
 use Tempest\Highlight\Tokens\TokenType;
 use Tempest\Highlight\Tokens\TokenTypeEnum;
 
+#[PatternTest(input: 'ports = [8000, 8001]', output: '=')]
+#[PatternTest(input: '[[products]]', output: '[[')]
 final class TomlOperatorPattern implements Pattern
 {
     use IsPattern;
diff --git a/src/Languages/Toml/Patterns/TomlStringPattern.php b/src/Languages/Toml/Patterns/TomlStringPattern.php
index 232801b9..a6d79fd8 100644
--- a/src/Languages/Toml/Patterns/TomlStringPattern.php
+++ b/src/Languages/Toml/Patterns/TomlStringPattern.php
@@ -6,9 +6,12 @@
 
 use Tempest\Highlight\IsPattern;
 use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
 use Tempest\Highlight\Tokens\TokenType;
 use Tempest\Highlight\Tokens\TokenTypeEnum;
 
+#[PatternTest(input: 'name = "TOML"', output: '"TOML"')]
+#[PatternTest(input: 'path = \'C:\\Users\'', output: '\'C:\\Users\'')]
 final class TomlStringPattern implements Pattern
 {
     use IsPattern;
diff --git a/src/Languages/Toml/Patterns/TomlTablePattern.php b/src/Languages/Toml/Patterns/TomlTablePattern.php
index f7144c1b..86c4c357 100644
--- a/src/Languages/Toml/Patterns/TomlTablePattern.php
+++ b/src/Languages/Toml/Patterns/TomlTablePattern.php
@@ -6,9 +6,12 @@
 
 use Tempest\Highlight\IsPattern;
 use Tempest\Highlight\Pattern;
+use Tempest\Highlight\PatternTest;
 use Tempest\Highlight\Tokens\TokenType;
 use Tempest\Highlight\Tokens\TokenTypeEnum;
 
+#[PatternTest(input: '[database]', output: 'database')]
+#[PatternTest(input: '[[products]]', output: 'products')]
 final class TomlTablePattern implements Pattern
 {
     use IsPattern;