src
├── CommonMark
│   ├── CommonMarkConverter.php
│   └── Parser.php
├── Languages
│   ├── Hashemi
│   │   ├── HashemiLanguage.php
│   │   ├── Injections
│   │   │   └── JsonInjection.php
│   │   └── Patterns
│   │       ├── HmBuiltinPattern.php
│   │       ├── HmDoubleQuoteValuePattern.php
│   │       ├── HmFunctionCallPattern.php
│   │       ├── HmKeywordPattern.php
│   │       ├── HmMultilineCommentPattern.php
│   │       ├── HmNumberPattern.php
│   │       ├── HmOperatorPattern.php
│   │       ├── HmSinglelineCommentPattern.php
│   │       └── HmTripleDoubleQuoteStringPattern.php
├── Themes
│   ├── DefaultTheme.php
│   └── ThemeManager.php
└── Tokens
    ├── GroupTokens.php
    ├── TokenAnalyzer.php
    └── TokenValidator.php

در این بخش به برسی یک مثال مهم از شیوه تشخیص و هایلایت کردن الگو‌ها (Patterns) مشخص شده در هر کدام از بخش‌های یک زبان می‌پردازیم. به مثال زیر از پیاده‌سازی هایلایت کردن namespace ها در php دقت کنید:

use Tempest\Highlight\IsPattern;
use Tempest\Highlight\Pattern;
use Tempest\Highlight\Tokens\TokenType;

final readonly class NamespacePattern implements Pattern
{
    use IsPattern;

    public function getPattern(): string
    {
        return 'namespace (?<match>[\w\\\\]+)';
    }

    public function getTokenType(): TokenType
    {
        return TokenType::TYPE;
    }
}

• در مثال بالا یک الگوی جدید با نام NamespacePattern ایجاد شده است که مسئول هایلایت کردن namespace ها می‌باشد. همانطور که مشاهده می‌کنید در تابع getPattern یک عبارت باقاعده return شده است که نمایانگر انتخاب‌گر آن ساختار خاص (در اینجا namespace ها) در کد می‌باشد. همچنین در تابع getTokenType یک Enum از نوع TokenType برگردانده می‌شود. در هر بخش مقدار TokenType ای که باید در این ساختار return کنید به شما معرفی می‌شود.
• این Regex‌ ها باید شامل یک گروه با نام match باشند که به این صورت نوشته می‌شود: (?<match>…). این گروه نمایانگر بخشی از کد است که در واقع هایلایت خواهد شد.

توجه داشته باشید که هر الگو باید یک گروه تطبیق (Capture Group) نام‌گذاری‌شده در Regex داشته باشد که نام آن "match" باشد. هسته هایلایتر محتوایی که درون این گروه تطبیق پیدا کرده است را هایلایت خواهد کرد.

برای مثال، این regex namespace (?<match>[\w\\\\]+) می‌گوید که هر خطی که با کلمه namespace شروع شود باید در نظر گرفته شود، اما تنها بخشی که درون گروه نام‌گذاری‌شده (?<match>…) قرار دارد هایلایت می‌شود اما خود واژه namespace چون در گروه match در نظر گرفته نشده است هایلایت نخواهد شد.

ساختار کامنت‌های چند‌خطی در زبان برنامه‌نویسی آقای هاشمی مطابق با مستندات این زبان، مانند بسیاری از زبان های دیگر به صورت زیر می‌باشد:

/*
in teke az code pardazesh nakhahad shod   
*/

/**  
 * baraye neveshtan e mostanadat  
 */

شما باید کلاس HmMultilineCommentPattern را به صورت زیر در فایلی با همین نام پیاده‌سازی کنید تا کد هایلایتر بتواند کامنت‌های چندخطی را با استفاده از TokenType مربوط به کامنت یعنی COMMENT رنگی کند.

<?php

declare(strict_types=1);

namespace Tempest\Highlight\Languages\Hashemi\Patterns;

use Tempest\Highlight\IsPattern;
use Tempest\Highlight\Pattern;
use Tempest\Highlight\Tokens\TokenTypeEnum;

final readonly class HmMultilineCommentPattern implements Pattern
{
    use IsPattern;

    public function getPattern(): string
    {
        return ""; // TODO: Implement
    }

    public function getTokenType(): TokenTypeEnum
    {
        return TokenTypeEnum::TYPE; // TODO: Implement
    }
}

در نهایت در صورتی که کد شما به درستی کار کند، باید مطابق تصویر زیر بخش مربوط به کامنت‌های چند‌خطی را به درستی هایلایت کند.

رشته‌های چندخطی در زبان برنامه‌نویسی آقای هاشمی به صورت TripleDoubleQuote ( """ """ ) مورد استفاده قرار می‌گیرند. شما باید هایلایتر این مورد را به صورتی پیاده‌سازی کنید که محتوای درون این سه‌تایی‌های علامت نقل‌قول به صورت درستی هایلایت شوند.

bebin azinja() {
  matn_toolani = """شعر از مولانا
خنک آن قمار بازی که بباخت آنچه بودش
بنماند هیچش الا هوس قمار دیگر
  """;
  bechap(matn_toolani); 
}

• مثالی از رشته‌ها در زبان هاشمی

شما باید کلاس HmTripleDoubleQuoteStringPattern را به صورت زیر در فایلی با همین نام پیاده‌سازی کنید تا کد هایلایتر بتواند رشته‌های بلند مختلف را با استفاده از TokenType مربوط به آن یعنی VALUE رنگی کند.

<?php

declare(strict_types=1);

namespace Tempest\Highlight\Languages\Hashemi\Patterns;

use Tempest\Highlight\IsPattern;
use Tempest\Highlight\Pattern;
use Tempest\Highlight\Tokens\TokenTypeEnum;

final readonly class HmTripleDoubleQuoteStringPattern implements Pattern
{
    use IsPattern;

    public function getPattern(): string
    {
        return ""; // TODO: Implement
    }

    public function getTokenType(): TokenTypeEnum
    {
        return TokenTypeEnum::TYPE; // TODO: Implement
    }
}

در نهایت در صورتی که کد شما به درستی کار کند، باید مطابق تصویر زیر بخش مربوط به استفاده از رشته‌های بلند را به درستی هایلایت کند.