[2.x] Support passing code as attribute to Blade component

docs/laravel.mdx

@@ -143,3 +143,45 @@ Str::markdown($markdown, extensions: [
     new PhikiExtension(Theme::GithubLight, resolve(Phiki::class)),
 ]);
 ```
+
+## Blade component
+
+If you want to highlight code inside of a Blade view, Phiki provides a Blade component that you can use.
+
+```blade
+<x-phiki::code grammar="php" theme="github-light">
+echo "Hello, world!";
+</x-phiki::code>
+```
+
+This will highlight the code block using the `Grammar::Php` grammar and the `Theme::GithubLight` theme.
+
+### Enabling the gutter
+
+To enable the gutter, add the `gutter` attribute to the component.
+
+```blade
+<x-phiki::code grammar="php" theme="github-light" gutter>
+echo "Hello, world!";
+</x-phiki::code>
+```
+
+### Changing the starting line number
+
+To change the starting line number, add the `starting-line` attribute to the component.
+
+```blade
+<x-phiki::code grammar="php" theme="github-light" gutter :starting-line="5">
+echo "Hello, world!";
+</x-phiki::code>
+```
+
+### Passing code as an attribute
+
+Since Laravel trims whitespace from the slot of a Blade component, you can also pass the code to the component using the `code` attribute.
+
+```blade
+<x-phiki::code grammar="php" theme="github-light" :code="$myCodeVariable" />
+```
+
+This is especially useful if you want to highlight code that is stored in a variable or preserve trailing and leading whitespace.

src/Adapters/Laravel/Components/Code.php

@@ -14,6 +14,7 @@ class Code extends Component
     public function __construct(
         public string|Grammar $grammar,
         public string|array|Theme $theme,
+        public ?string $code = null,
         public bool $gutter = false,
         public int $startingLine = 1,
     ) {}
@@ -24,7 +25,7 @@ public function __construct(
     public function render(): string
     {
         return <<<'BLADE'
-        {!! \Phiki\Adapters\Laravel\Facades\Phiki::codeToHtml($slot->__toString(), $grammar, $theme)->withGutter($gutter)->startingLine($startingLine) !!}
+        {!! \Phiki\Adapters\Laravel\Facades\Phiki::codeToHtml($code ?? $slot->__toString(), $grammar, $theme)->withGutter($gutter)->startingLine($startingLine) !!}
         BLADE;
     }
 }

tests/.pest/snapshots/Adapters/Laravel/Components/CodeTest/it_can_accept_code_through_an_attribute.snap

@@ -0,0 +1,2 @@
+<pre class="phiki language-php github-light" data-language="php" style="background-color: #fff;color: #24292e;"><code><span class="line"><span class="token" style="color: #d73a49;">&lt;</span><span class="token" style="color: #d73a49;">?</span><span class="token" style="color: #005cc5;">php</span><span class="token"> </span><span class="token" style="color: #005cc5;">echo</span><span class="token"> </span><span class="token" style="color: #032f62;">&#039;</span><span class="token" style="color: #032f62;">Hello, world!</span><span class="token" style="color: #032f62;">&#039;</span><span class="token">;</span><span class="token">
+</span></span></code></pre>

tests/Adapters/Laravel/Components/CodeTest.php

@@ -31,3 +31,13 @@
 
     expect($output)->toContain('10</span>');
 });
+
+it('can accept code through an attribute', function () {
+    $output = Blade::render(<<<'BLADE'
+    <x-phiki::code grammar="php" theme="github-light" :$code />
+    BLADE, [
+        'code' => "<?php echo 'Hello, world!';",
+    ]);
+
+    expect($output)->toMatchSnapshot();
+});