Add interfaces for Gutenberg blocks parsing

CHANGELOG.md

@@ -5,6 +5,8 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [[*next-version*]] - YYYY-MM-DD
+### Added
+- Interfaces for Gutenberg blocks parsing.
 
 ## [0.1.0-alpha1] - 2021-03-05
 Initial version.

src/Gutenberg/BlockInterface.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WpOop\WordPress\Gutenberg;
+
+/**
+ * The interface for Gutenberg block data.
+ */
+interface BlockInterface
+{
+    /**
+     * Returns name of the block, such as 'core/paragraph'.
+     */
+    public function getBlockName(): string;
+
+    /**
+     * Returns block attributes.
+     * @return array<string, mixed>
+     */
+    public function getAttributes(): array;
+
+    /**
+     * Returns inner blocks (for example, used in the Columns block).
+     * @return BlockInterface[]
+     */
+    public function getInnerBlocks(): array;
+
+    /**
+     * Returns resultant HTML.
+     */
+    public function getInnerHtml(): string;
+
+    /**
+     * Returns list of string fragments and null markers where inner blocks were found.
+     * @return array<?string>
+     */
+    public function getInnerContent(): array;
+}

src/Gutenberg/BlockParserInterface.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+namespace WpOop\WordPress\Gutenberg;
+
+/**
+ * The interface for parsing Gutenberg blocks.
+ */
+interface BlockParserInterface
+{
+    /**
+     * @param string $postContent Content of a WP post (e.g. WP_Post post_content).
+     * @return BlockInterface[]
+     */
+    public function parseBlock(string $postContent): array;
+}