feat(documentator)!: Markdown Document mutations (#180)

Further improvements of #179. Added mutation concept and few useful mutations:

- `FootnotesPrefix` - Adds unique prefix for all footnotes.
- `FootnotesRemove` - Removes all footnotes.
- `Move` - Changes path and updates all relative links.
- `ReferencesInline` - Inlines all references.
- `ReferencesPrefix` - Adds unique prefix for all references.

packages/documentator/src/Markdown/Contracts/Mutation.php

@@ -0,0 +1,14 @@
+<?php declare(strict_types = 1);
+
+namespace LastDragon_ru\LaraASP\Documentator\Markdown\Contracts;
+
+use LastDragon_ru\LaraASP\Documentator\Markdown\Document;
+use LastDragon_ru\LaraASP\Documentator\Markdown\Location\Location;
+use League\CommonMark\Node\Block\Document as DocumentNode;
+
+interface Mutation {
+    /**
+     * @return array<array-key, array{Location, ?string}>
+     */
+    public function __invoke(Document $document, DocumentNode $node): array;
+}

packages/documentator/src/Markdown/Data/BlockPadding.php

@@ -0,0 +1,22 @@
+<?php declare(strict_types = 1);
+
+namespace LastDragon_ru\LaraASP\Documentator\Markdown\Data;
+
+use Override;
+
+/**
+ * @internal
+ * @implements Value<int>
+ */
+readonly class BlockPadding implements Value {
+    public function __construct(
+        private int $value,
+    ) {
+        // empty
+    }
+
+    #[Override]
+    public function get(): mixed {
+        return $this->value;
+    }
+}

packages/documentator/src/Markdown/Data/Length.php

@@ -0,0 +1,22 @@
+<?php declare(strict_types = 1);
+
+namespace LastDragon_ru\LaraASP\Documentator\Markdown\Data;
+
+use Override;
+
+/**
+ * @internal
+ * @implements Value<int>
+ */
+readonly class Length implements Value {
+    public function __construct(
+        private int $value,
+    ) {
+        // empty
+    }
+
+    #[Override]
+    public function get(): mixed {
+        return $this->value;
+    }
+}