Upgrade framework

vendor/league/commonmark/src/Delimiter/Delimiter.php

@@ -0,0 +1,134 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js)
+ *  - (c) John MacFarlane
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace League\CommonMark\Delimiter;
+
+use League\CommonMark\Node\Inline\AbstractStringContainer;
+
+final class Delimiter implements DelimiterInterface
+{
+    /** @psalm-readonly */
+    private string $char;
+
+    /** @psalm-readonly-allow-private-mutation */
+    private int $length;
+
+    /** @psalm-readonly */
+    private int $originalLength;
+
+    /** @psalm-readonly */
+    private AbstractStringContainer $inlineNode;
+
+    /** @psalm-readonly-allow-private-mutation */
+    private ?DelimiterInterface $previous = null;
+
+    /** @psalm-readonly-allow-private-mutation */
+    private ?DelimiterInterface $next = null;
+
+    /** @psalm-readonly */
+    private bool $canOpen;
+
+    /** @psalm-readonly */
+    private bool $canClose;
+
+    /** @psalm-readonly-allow-private-mutation */
+    private bool $active;
+
+    /** @psalm-readonly */
+    private ?int $index = null;
+
+    public function __construct(string $char, int $numDelims, AbstractStringContainer $node, bool $canOpen, bool $canClose, ?int $index = null)
+    {
+        $this->char           = $char;
+        $this->length         = $numDelims;
+        $this->originalLength = $numDelims;
+        $this->inlineNode     = $node;
+        $this->canOpen        = $canOpen;
+        $this->canClose       = $canClose;
+        $this->active         = true;
+        $this->index          = $index;
+    }
+
+    public function canClose(): bool
+    {
+        return $this->canClose;
+    }
+
+    public function canOpen(): bool
+    {
+        return $this->canOpen;
+    }
+
+    public function isActive(): bool
+    {
+        return $this->active;
+    }
+
+    public function setActive(bool $active): void
+    {
+        $this->active = $active;
+    }
+
+    public function getChar(): string
+    {
+        return $this->char;
+    }
+
+    public function getIndex(): ?int
+    {
+        return $this->index;
+    }
+
+    public function getNext(): ?DelimiterInterface
+    {
+        return $this->next;
+    }
+
+    public function setNext(?DelimiterInterface $next): void
+    {
+        $this->next = $next;
+    }
+
+    public function getLength(): int
+    {
+        return $this->length;
+    }
+
+    public function setLength(int $length): void
+    {
+        $this->length = $length;
+    }
+
+    public function getOriginalLength(): int
+    {
+        return $this->originalLength;
+    }
+
+    public function getInlineNode(): AbstractStringContainer
+    {
+        return $this->inlineNode;
+    }
+
+    public function getPrevious(): ?DelimiterInterface
+    {
+        return $this->previous;
+    }
+
+    public function setPrevious(?DelimiterInterface $previous): void
+    {
+        $this->previous = $previous;
+    }
+}

vendor/league/commonmark/src/Delimiter/DelimiterInterface.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js)
+ *  - (c) John MacFarlane
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace League\CommonMark\Delimiter;
+
+use League\CommonMark\Node\Inline\AbstractStringContainer;
+
+interface DelimiterInterface
+{
+    public function canClose(): bool;
+
+    public function canOpen(): bool;
+
+    public function isActive(): bool;
+
+    public function setActive(bool $active): void;
+
+    public function getChar(): string;
+
+    public function getIndex(): ?int;
+
+    public function getNext(): ?DelimiterInterface;
+
+    public function setNext(?DelimiterInterface $next): void;
+
+    public function getLength(): int;
+
+    public function setLength(int $length): void;
+
+    public function getOriginalLength(): int;
+
+    public function getInlineNode(): AbstractStringContainer;
+
+    public function getPrevious(): ?DelimiterInterface;
+
+    public function setPrevious(?DelimiterInterface $previous): void;
+}

vendor/league/commonmark/src/Delimiter/DelimiterParser.php

@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace League\CommonMark\Delimiter;
+
+use League\CommonMark\Delimiter\Processor\DelimiterProcessorCollection;
+use League\CommonMark\Delimiter\Processor\DelimiterProcessorInterface;
+use League\CommonMark\Node\Inline\Text;
+use League\CommonMark\Parser\Inline\InlineParserInterface;
+use League\CommonMark\Parser\Inline\InlineParserMatch;
+use League\CommonMark\Parser\InlineParserContext;
+use League\CommonMark\Util\RegexHelper;
+
+/**
+ * Delimiter parsing is implemented as an Inline Parser with the lowest-possible priority
+ *
+ * @internal
+ */
+final class DelimiterParser implements InlineParserInterface
+{
+    private DelimiterProcessorCollection $collection;
+
+    public function __construct(DelimiterProcessorCollection $collection)
+    {
+        $this->collection = $collection;
+    }
+
+    public function getMatchDefinition(): InlineParserMatch
+    {
+        return InlineParserMatch::oneOf(...$this->collection->getDelimiterCharacters());
+    }
+
+    public function parse(InlineParserContext $inlineContext): bool
+    {
+        $character = $inlineContext->getFullMatch();
+        $numDelims = 0;
+        $cursor    = $inlineContext->getCursor();
+        $processor = $this->collection->getDelimiterProcessor($character);
+
+        if ($processor === null) {
+            throw new \LogicException('Delimiter processor should never be null here');
+        }
+
+        $charBefore = $cursor->peek(-1);
+        if ($charBefore === null) {
+            $charBefore = "\n";
+        }
+
+        while ($cursor->peek($numDelims) === $character) {
+            ++$numDelims;
+        }
+
+        if ($numDelims < $processor->getMinLength()) {
+            return false;
+        }
+
+        $cursor->advanceBy($numDelims);
+
+        $charAfter = $cursor->getCurrentCharacter();
+        if ($charAfter === null) {
+            $charAfter = "\n";
+        }
+
+        [$canOpen, $canClose] = self::determineCanOpenOrClose($charBefore, $charAfter, $character, $processor);
+
+        $node = new Text(\str_repeat($character, $numDelims), [
+            'delim' => true,
+        ]);
+        $inlineContext->getContainer()->appendChild($node);
+
+        // Add entry to stack to this opener
+        if ($canOpen || $canClose) {
+            $delimiter = new Delimiter($character, $numDelims, $node, $canOpen, $canClose);
+            $inlineContext->getDelimiterStack()->push($delimiter);
+        }
+
+        return true;
+    }
+
+    /**
+     * @return bool[]
+     */
+    private static function determineCanOpenOrClose(string $charBefore, string $charAfter, string $character, DelimiterProcessorInterface $delimiterProcessor): array
+    {
+        $afterIsWhitespace   = \preg_match(RegexHelper::REGEX_UNICODE_WHITESPACE_CHAR, $charAfter);
+        $afterIsPunctuation  = \preg_match(RegexHelper::REGEX_PUNCTUATION, $charAfter);
+        $beforeIsWhitespace  = \preg_match(RegexHelper::REGEX_UNICODE_WHITESPACE_CHAR, $charBefore);
+        $beforeIsPunctuation = \preg_match(RegexHelper::REGEX_PUNCTUATION, $charBefore);
+
+        $leftFlanking  = ! $afterIsWhitespace && (! $afterIsPunctuation || $beforeIsWhitespace || $beforeIsPunctuation);
+        $rightFlanking = ! $beforeIsWhitespace && (! $beforeIsPunctuation || $afterIsWhitespace || $afterIsPunctuation);
+
+        if ($character === '_') {
+            $canOpen  = $leftFlanking && (! $rightFlanking || $beforeIsPunctuation);
+            $canClose = $rightFlanking && (! $leftFlanking || $afterIsPunctuation);
+        } else {
+            $canOpen  = $leftFlanking && $character === $delimiterProcessor->getOpeningCharacter();
+            $canClose = $rightFlanking && $character === $delimiterProcessor->getClosingCharacter();
+        }
+
+        return [$canOpen, $canClose];
+    }
+}

vendor/league/commonmark/src/Delimiter/DelimiterStack.php

@@ -0,0 +1,214 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js)
+ *  - (c) John MacFarlane
+ *
+ * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java)
+ *  - (c) Atlassian Pty Ltd
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace League\CommonMark\Delimiter;
+
+use League\CommonMark\Delimiter\Processor\DelimiterProcessorCollection;
+use League\CommonMark\Node\Inline\AdjacentTextMerger;
+
+final class DelimiterStack
+{
+    /** @psalm-readonly-allow-private-mutation */
+    private ?DelimiterInterface $top = null;
+
+    public function push(DelimiterInterface $newDelimiter): void
+    {
+        $newDelimiter->setPrevious($this->top);
+
+        if ($this->top !== null) {
+            $this->top->setNext($newDelimiter);
+        }
+
+        $this->top = $newDelimiter;
+    }
+
+    private function findEarliest(?DelimiterInterface $stackBottom = null): ?DelimiterInterface
+    {
+        $delimiter = $this->top;
+        while ($delimiter !== null && $delimiter->getPrevious() !== $stackBottom) {
+            $delimiter = $delimiter->getPrevious();
+        }
+
+        return $delimiter;
+    }
+
+    public function removeDelimiter(DelimiterInterface $delimiter): void
+    {
+        if ($delimiter->getPrevious() !== null) {
+            /** @psalm-suppress PossiblyNullReference */
+            $delimiter->getPrevious()->setNext($delimiter->getNext());
+        }
+
+        if ($delimiter->getNext() === null) {
+            // top of stack
+            $this->top = $delimiter->getPrevious();
+        } else {
+            /** @psalm-suppress PossiblyNullReference */
+            $delimiter->getNext()->setPrevious($delimiter->getPrevious());
+        }
+    }
+
+    private function removeDelimiterAndNode(DelimiterInterface $delimiter): void
+    {
+        $delimiter->getInlineNode()->detach();
+        $this->removeDelimiter($delimiter);
+    }
+
+    private function removeDelimitersBetween(DelimiterInterface $opener, DelimiterInterface $closer): void
+    {
+        $delimiter = $closer->getPrevious();
+        while ($delimiter !== null && $delimiter !== $opener) {
+            $previous = $delimiter->getPrevious();
+            $this->removeDelimiter($delimiter);
+            $delimiter = $previous;
+        }
+    }
+
+    public function removeAll(?DelimiterInterface $stackBottom = null): void
+    {
+        while ($this->top && $this->top !== $stackBottom) {
+            $this->removeDelimiter($this->top);
+        }
+    }
+
+    public function removeEarlierMatches(string $character): void
+    {
+        $opener = $this->top;
+        while ($opener !== null) {
+            if ($opener->getChar() === $character) {
+                $opener->setActive(false);
+            }
+
+            $opener = $opener->getPrevious();
+        }
+    }
+
+    /**
+     * @param string|string[] $characters
+     */
+    public function searchByCharacter($characters): ?DelimiterInterface
+    {
+        if (! \is_array($characters)) {
+            $characters = [$characters];
+        }
+
+        $opener = $this->top;
+        while ($opener !== null) {
+            if (\in_array($opener->getChar(), $characters, true)) {
+                break;
+            }
+
+            $opener = $opener->getPrevious();
+        }
+
+        return $opener;
+    }
+
+    public function processDelimiters(?DelimiterInterface $stackBottom, DelimiterProcessorCollection $processors): void
+    {
+        $openersBottom = [];
+
+        // Find first closer above stackBottom
+        $closer = $this->findEarliest($stackBottom);
+
+        // Move forward, looking for closers, and handling each
+        while ($closer !== null) {
+            $delimiterChar = $closer->getChar();
+
+            $delimiterProcessor = $processors->getDelimiterProcessor($delimiterChar);
+            if (! $closer->canClose() || $delimiterProcessor === null) {
+                $closer = $closer->getNext();
+                continue;
+            }
+
+            $openingDelimiterChar = $delimiterProcessor->getOpeningCharacter();
+
+            $useDelims            = 0;
+            $openerFound          = false;
+            $potentialOpenerFound = false;
+            $opener               = $closer->getPrevious();
+            while ($opener !== null && $opener !== $stackBottom && $opener !== ($openersBottom[$delimiterChar] ?? null)) {
+                if ($opener->canOpen() && $opener->getChar() === $openingDelimiterChar) {
+                    $potentialOpenerFound = true;
+                    $useDelims            = $delimiterProcessor->getDelimiterUse($opener, $closer);
+                    if ($useDelims > 0) {
+                        $openerFound = true;
+                        break;
+                    }
+                }
+
+                $opener = $opener->getPrevious();
+            }
+
+            if (! $openerFound) {
+                if (! $potentialOpenerFound) {
+                    // Only do this when we didn't even have a potential
+                    // opener (one that matches the character and can open).
+                    // If an opener was rejected because of the number of
+                    // delimiters (e.g. because of the "multiple of 3"
+                    // Set lower bound for future searches for openersrule),
+                    // we want to consider it next time because the number
+                    // of delimiters can change as we continue processing.
+                    $openersBottom[$delimiterChar] = $closer->getPrevious();
+                    if (! $closer->canOpen()) {
+                        // We can remove a closer that can't be an opener,
+                        // once we've seen there's no matching opener.
+                        $this->removeDelimiter($closer);
+                    }
+                }
+
+                $closer = $closer->getNext();
+                continue;
+            }
+
+            \assert($opener !== null);
+
+            $openerNode = $opener->getInlineNode();
+            $closerNode = $closer->getInlineNode();
+
+            // Remove number of used delimiters from stack and inline nodes.
+            $opener->setLength($opener->getLength() - $useDelims);
+            $closer->setLength($closer->getLength() - $useDelims);
+
+            $openerNode->setLiteral(\substr($openerNode->getLiteral(), 0, -$useDelims));
+            $closerNode->setLiteral(\substr($closerNode->getLiteral(), 0, -$useDelims));
+
+            $this->removeDelimitersBetween($opener, $closer);
+            // The delimiter processor can re-parent the nodes between opener and closer,
+            // so make sure they're contiguous already. Exclusive because we want to keep opener/closer themselves.
+            AdjacentTextMerger::mergeTextNodesBetweenExclusive($openerNode, $closerNode);
+            $delimiterProcessor->process($openerNode, $closerNode, $useDelims);
+
+            // No delimiter characters left to process, so we can remove delimiter and the now empty node.
+            if ($opener->getLength() === 0) {
+                $this->removeDelimiterAndNode($opener);
+            }
+
+            // phpcs:disable SlevomatCodingStandard.ControlStructures.EarlyExit.EarlyExitNotUsed
+            if ($closer->getLength() === 0) {
+                $next = $closer->getNext();
+                $this->removeDelimiterAndNode($closer);
+                $closer = $next;
+            }
+        }
+
+        // Remove all delimiters
+        $this->removeAll($stackBottom);
+    }
+}

vendor/league/commonmark/src/Delimiter/Processor/DelimiterProcessorCollection.php

@@ -0,0 +1,87 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js)
+ *  - (c) John MacFarlane
+ *
+ * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java)
+ *  - (c) Atlassian Pty Ltd
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace League\CommonMark\Delimiter\Processor;
+
+final class DelimiterProcessorCollection implements DelimiterProcessorCollectionInterface
+{
+    /**
+     * @var array<string,DelimiterProcessorInterface>|DelimiterProcessorInterface[]
+     *
+     * @psalm-readonly-allow-private-mutation
+     */
+    private array $processorsByChar = [];
+
+    public function add(DelimiterProcessorInterface $processor): void
+    {
+        $opening = $processor->getOpeningCharacter();
+        $closing = $processor->getClosingCharacter();
+
+        if ($opening === $closing) {
+            $old = $this->processorsByChar[$opening] ?? null;
+            if ($old !== null && $old->getOpeningCharacter() === $old->getClosingCharacter()) {
+                $this->addStaggeredDelimiterProcessorForChar($opening, $old, $processor);
+            } else {
+                $this->addDelimiterProcessorForChar($opening, $processor);
+            }
+        } else {
+            $this->addDelimiterProcessorForChar($opening, $processor);
+            $this->addDelimiterProcessorForChar($closing, $processor);
+        }
+    }
+
+    public function getDelimiterProcessor(string $char): ?DelimiterProcessorInterface
+    {
+        return $this->processorsByChar[$char] ?? null;
+    }
+
+    /**
+     * @return string[]
+     */
+    public function getDelimiterCharacters(): array
+    {
+        return \array_keys($this->processorsByChar);
+    }
+
+    private function addDelimiterProcessorForChar(string $delimiterChar, DelimiterProcessorInterface $processor): void
+    {
+        if (isset($this->processorsByChar[$delimiterChar])) {
+            throw new \InvalidArgumentException(\sprintf('Delim processor for character "%s" already exists', $processor->getOpeningCharacter()));
+        }
+
+        $this->processorsByChar[$delimiterChar] = $processor;
+    }
+
+    private function addStaggeredDelimiterProcessorForChar(string $opening, DelimiterProcessorInterface $old, DelimiterProcessorInterface $new): void
+    {
+        if ($old instanceof StaggeredDelimiterProcessor) {
+            $s = $old;
+        } else {
+            $s = new StaggeredDelimiterProcessor($opening, $old);
+        }
+
+        $s->add($new);
+        $this->processorsByChar[$opening] = $s;
+    }
+
+    public function count(): int
+    {
+        return \count($this->processorsByChar);
+    }
+}

vendor/league/commonmark/src/Delimiter/Processor/DelimiterProcessorCollectionInterface.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js)
+ *  - (c) John MacFarlane
+ *
+ * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java)
+ *  - (c) Atlassian Pty Ltd
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace League\CommonMark\Delimiter\Processor;
+
+interface DelimiterProcessorCollectionInterface extends \Countable
+{
+    /**
+     * Add the given delim processor to the collection
+     *
+     * @param DelimiterProcessorInterface $processor The delim processor to add
+     *
+     * @throws \InvalidArgumentException Exception will be thrown if attempting to add multiple processors for the same character
+     */
+    public function add(DelimiterProcessorInterface $processor): void;
+
+    /**
+     * Returns the delim processor which handles the given character if one exists
+     */
+    public function getDelimiterProcessor(string $char): ?DelimiterProcessorInterface;
+
+    /**
+     * Returns an array of delimiter characters who have associated processors
+     *
+     * @return string[]
+     */
+    public function getDelimiterCharacters(): array;
+}

vendor/league/commonmark/src/Delimiter/Processor/DelimiterProcessorInterface.php

@@ -0,0 +1,78 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * Original code based on the CommonMark JS reference parser (https://bitly.com/commonmark-js)
+ *  - (c) John MacFarlane
+ *
+ * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java)
+ *  - (c) Atlassian Pty Ltd
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace League\CommonMark\Delimiter\Processor;
+
+use League\CommonMark\Delimiter\DelimiterInterface;
+use League\CommonMark\Node\Inline\AbstractStringContainer;
+
+/**
+ * Interface for a delimiter processor
+ */
+interface DelimiterProcessorInterface
+{
+    /**
+     * Returns the character that marks the beginning of a delimited node.
+     *
+     * This must not clash with any other processors being added to the environment.
+     */
+    public function getOpeningCharacter(): string;
+
+    /**
+     * Returns the character that marks the ending of a delimited node.
+     *
+     * This must not clash with any other processors being added to the environment.
+     *
+     * Note that for a symmetric delimiter such as "*", this is the same as the opening.
+     */
+    public function getClosingCharacter(): string;
+
+    /**
+     * Minimum number of delimiter characters that are needed to active this.
+     *
+     * Must be at least 1.
+     */
+    public function getMinLength(): int;
+
+    /**
+     * Determine how many (if any) of the delimiter characters should be used.
+     *
+     * This allows implementations to decide how many characters to be used
+     * based on the properties of the delimiter runs. An implementation can also
+     * return 0 when it doesn't want to allow this particular combination of
+     * delimiter runs.
+     *
+     * @param DelimiterInterface $opener The opening delimiter run
+     * @param DelimiterInterface $closer The closing delimiter run
+     */
+    public function getDelimiterUse(DelimiterInterface $opener, DelimiterInterface $closer): int;
+
+    /**
+     * Process the matched delimiters, e.g. by wrapping the nodes between opener
+     * and closer in a new node, or appending a new node after the opener.
+     *
+     * Note that removal of the delimiter from the delimiter nodes and detaching
+     * them is done by the caller.
+     *
+     * @param AbstractStringContainer $opener       The node that contained the opening delimiter
+     * @param AbstractStringContainer $closer       The node that contained the closing delimiter
+     * @param int                     $delimiterUse The number of delimiters that were used
+     */
+    public function process(AbstractStringContainer $opener, AbstractStringContainer $closer, int $delimiterUse): void;
+}

vendor/league/commonmark/src/Delimiter/Processor/StaggeredDelimiterProcessor.php

@@ -0,0 +1,108 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * Additional emphasis processing code based on commonmark-java (https://github.com/atlassian/commonmark-java)
+ *  - (c) Atlassian Pty Ltd
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace League\CommonMark\Delimiter\Processor;
+
+use League\CommonMark\Delimiter\DelimiterInterface;
+use League\CommonMark\Node\Inline\AbstractStringContainer;
+
+/**
+ * An implementation of DelimiterProcessorInterface that dispatches all calls to two or more other DelimiterProcessors
+ * depending on the length of the delimiter run. All child DelimiterProcessors must have different minimum
+ * lengths. A given delimiter run is dispatched to the child with the largest acceptable minimum length. If no
+ * child is applicable, the one with the largest minimum length is chosen.
+ *
+ * @internal
+ */
+final class StaggeredDelimiterProcessor implements DelimiterProcessorInterface
+{
+    /** @psalm-readonly */
+    private string $delimiterChar;
+
+    /** @psalm-readonly-allow-private-mutation */
+    private int $minLength = 0;
+
+    /**
+     * @var array<int, DelimiterProcessorInterface>|DelimiterProcessorInterface[]
+     *
+     * @psalm-readonly-allow-private-mutation
+     */
+    private array $processors = []; // keyed by minLength in reverse order
+
+    public function __construct(string $char, DelimiterProcessorInterface $processor)
+    {
+        $this->delimiterChar = $char;
+        $this->add($processor);
+    }
+
+    public function getOpeningCharacter(): string
+    {
+        return $this->delimiterChar;
+    }
+
+    public function getClosingCharacter(): string
+    {
+        return $this->delimiterChar;
+    }
+
+    public function getMinLength(): int
+    {
+        return $this->minLength;
+    }
+
+    /**
+     * Adds the given processor to this staggered delimiter processor
+     */
+    public function add(DelimiterProcessorInterface $processor): void
+    {
+        $len = $processor->getMinLength();
+
+        if (isset($this->processors[$len])) {
+            throw new \InvalidArgumentException(\sprintf('Cannot add two delimiter processors for char "%s" and minimum length %d', $this->delimiterChar, $len));
+        }
+
+        $this->processors[$len] = $processor;
+        \krsort($this->processors);
+
+        $this->minLength = \min($this->minLength, $len);
+    }
+
+    public function getDelimiterUse(DelimiterInterface $opener, DelimiterInterface $closer): int
+    {
+        return $this->findProcessor($opener->getLength())->getDelimiterUse($opener, $closer);
+    }
+
+    public function process(AbstractStringContainer $opener, AbstractStringContainer $closer, int $delimiterUse): void
+    {
+        $this->findProcessor($delimiterUse)->process($opener, $closer, $delimiterUse);
+    }
+
+    private function findProcessor(int $len): DelimiterProcessorInterface
+    {
+        // Find the "longest" processor which can handle this length
+        foreach ($this->processors as $processor) {
+            if ($processor->getMinLength() <= $len) {
+                return $processor;
+            }
+        }
+
+        // Just use the first one in our list
+        $first = \reset($this->processors);
+        \assert($first instanceof DelimiterProcessorInterface);
+
+        return $first;
+    }
+}