Add support and document custom aliases (#119)

Author: ryangjchandler

docs/custom-grammars.mdx

@@ -49,3 +49,16 @@ $html = (new Phiki)
     ->codeToHtml('Your code here...', 'my-language', Theme::GithubLight)
     ->toString();
 ```
+
+## Aliasing
+
+If you wish to register custom aliases for a grammar that has already been registered, you can do so by calling the `Phiki::alias()` method.
+
+```php
+(new Phiki)
+    ->alias('my-php', Grammar::Php)
+    ->codeToHtml('<?php echo "Hello, World!"; ?>', 'my-php', Theme::GithubLight)
+    ->toString();
+```
+
+This will allow you to use `my-php` as an alias for the built-in PHP grammar.

src/Adapters/Laravel/Facades/Phiki.php

@@ -12,6 +12,7 @@
  * @method static \Phiki\Environment environment()
  * @method static \Phiki\Phiki extend(\Phiki\Contracts\ExtensionInterface $extension)
  * @method static \Phiki\Phiki grammar(string $name, string|\Phiki\Grammar\ParsedGrammar $pathOrGrammar)
+ * @method static \Phiki\Phiki alias(string $alias, string | \Phiki\Grammar\Grammar $for)
  * @method static \Phiki\Phiki theme(string $name, string|\Phiki\Theme\ParsedTheme $pathOrTheme)
  * @method static \Phiki\Phiki cache(\Psr\SimpleCache\CacheInterface $cache)
  *

src/Phiki.php

@@ -83,6 +83,13 @@ public function grammar(string $name, string|ParsedGrammar $pathOrGrammar): stat
         return $this;
     }
 
+    public function alias(string $alias, string | Grammar $for): static
+    {
+        $this->environment->grammars->alias($alias, $for instanceof Grammar ? $for->value : $for);
+
+        return $this;
+    }
+
     public function theme(string $name, string|ParsedTheme $pathOrTheme): static
     {
         $this->environment->themes->register($name, $pathOrTheme);

tests/Unit/PhikiTest.php

@@ -55,3 +55,9 @@ function add(int|float $a, int|float $b): int|float {
 it('accepts a theme enum member', function () {
     expect((new Phiki)->codeToHtml('echo $a;', Grammar::Php, Theme::GithubDark))->__toString()->toBeString();
 });
+
+it('can alias a grammar', function () {
+    $phiki = (new Phiki)->alias('my-php', Grammar::Php);
+
+    expect($phiki->codeToHtml('echo $a;', 'my-php', Theme::GithubDark))->__toString()->toBeString();
+});