Add parser

Author: Neol3108

src/.gitkeep

@@ -0,0 +1,84 @@
+<?php
+
+namespace Recoded\WordPressBlockParser;
+
+use Generator;
+use IteratorAggregate;
+use LogicException;
+use Recoded\WordPressBlockParser\Blocks\Block;
+use Recoded\WordPressBlockParser\Blocks\SelfClosingBlock;
+use Recoded\WordPressBlockParser\Tokens\BlockClosing;
+use Recoded\WordPressBlockParser\Tokens\BlockOpening;
+use Recoded\WordPressBlockParser\Tokens\SelfClosingBlock as SelfClosingBlockToken;
+
+/**
+ * @implements \IteratorAggregate<int, \Recoded\WordPressBlockParser\Blocks\Block|\Recoded\WordPressBlockParser\Blocks\SelfClosingBlock>
+ */
+final class BlockParser implements IteratorAggregate
+{
+    private Tokenizer $tokenizer;
+
+    private int $stackDepth = 0;
+
+    /**
+     * Create a new BlockParser instance.
+     *
+     * @param string $content
+     * @return void
+     */
+    public function __construct(
+        public readonly string $content,
+    ) {
+        $this->tokenizer = Tokenizer::create($content);
+    }
+
+    /**
+     * Create a new parser from content string.
+     *
+     * @param string $content
+     * @return self
+     */
+    public static function create(string $content): self
+    {
+        return new self($content);
+    }
+
+    /**
+     * Iterate over the blocks.
+     *
+     * @return \Generator<int, \Recoded\WordPressBlockParser\Blocks\Block|\Recoded\WordPressBlockParser\Blocks\SelfClosingBlock>
+     */
+    public function getIterator(): Generator
+    {
+        $opening = null;
+
+        foreach ($this->tokenizer as $token) {
+            if ($token instanceof SelfClosingBlockToken && $this->stackDepth === 0) {
+                yield new SelfClosingBlock(
+                    namespace: $token->namespace,
+                    name: $token->name,
+                    attributes: $token->attributes,
+                );
+            } elseif ($token instanceof BlockOpening && $this->stackDepth++ === 0) {
+                $opening = $token;
+            } elseif ($token instanceof BlockClosing && --$this->stackDepth === 0) {
+                if ($opening === null || $opening->namespace !== $token->namespace || $opening->name !== $token->name) {
+                    throw new LogicException('Closing token does not correspond with opening');
+                }
+
+                $openedAt = $opening->startsAt + $opening->length;
+
+                yield new Block(
+                    namespace: $opening->namespace,
+                    name: $opening->name,
+                    attributes: $opening->attributes,
+                    content: substr(
+                        $this->content,
+                        $openedAt,
+                        $token->startsAt - $openedAt,
+                    ),
+                );
+            }
+        }
+    }
+}

src/BlockParser.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace Recoded\WordPressBlockParser\Blocks;
+
+final class Block
+{
+    /**
+     * Create new Block instance.
+     *
+     * @param string $namespace
+     * @param string $name
+     * @param array<string, mixed> $attributes
+     * @param string $content
+     * @return void
+     */
+    public function __construct(
+        public readonly string $namespace,
+        public readonly string $name,
+        public readonly array $attributes,
+        public readonly string $content,
+    ) {
+        //
+    }
+}

src/Blocks/Block.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace Recoded\WordPressBlockParser\Blocks;
+
+final class SelfClosingBlock
+{
+    /**
+     * Create new SelfClosingBlock instance.
+     *
+     * @param string $namespace
+     * @param string $name
+     * @param array<string, mixed> $attributes
+     * @return void
+     */
+    public function __construct(
+        public readonly string $namespace,
+        public readonly string $name,
+        public readonly array $attributes,
+    ) {
+        //
+    }
+}

src/Blocks/SelfClosingBlock.php

@@ -4,12 +4,12 @@
 
 use Generator;
 use IteratorAggregate;
-use Recoded\WordPressBlockParser\Value\BlockClosing;
-use Recoded\WordPressBlockParser\Value\BlockOpening;
-use Recoded\WordPressBlockParser\Value\SelfClosingBlock;
+use Recoded\WordPressBlockParser\Tokens\BlockClosing;
+use Recoded\WordPressBlockParser\Tokens\BlockOpening;
+use Recoded\WordPressBlockParser\Tokens\SelfClosingBlock;
 
 /**
- * @implements \IteratorAggregate<int, \Recoded\WordPressBlockParser\Value\Token>
+ * @implements \IteratorAggregate<int, \Recoded\WordPressBlockParser\Tokens\Token>
  */
 final class Tokenizer implements IteratorAggregate
 {

src/Tokenizer.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Recoded\WordPressBlockParser\Value;
+namespace Recoded\WordPressBlockParser\Tokens;
 
 final class BlockClosing extends Token
 {

src/Value/BlockClosing.php renamed to src/Tokens/BlockClosing.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Recoded\WordPressBlockParser\Value;
+namespace Recoded\WordPressBlockParser\Tokens;
 
 final class BlockOpening extends Token
 {

src/Value/BlockOpening.php renamed to src/Tokens/BlockOpening.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Recoded\WordPressBlockParser\Value;
+namespace Recoded\WordPressBlockParser\Tokens;
 
 final class SelfClosingBlock extends Token
 {

src/Value/SelfClosingBlock.php renamed to src/Tokens/SelfClosingBlock.php

@@ -1,6 +1,6 @@
 <?php
 
-namespace Recoded\WordPressBlockParser\Value;
+namespace Recoded\WordPressBlockParser\Tokens;
 
 abstract class Token
 {