First Commit

vendor/league/commonmark/src/Normalizer/SlugNormalizer.php

@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+/*
+ * This file is part of the league/commonmark package.
+ *
+ * (c) Colin O'Dell <colinodell@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace League\CommonMark\Normalizer;
+
+use League\Config\ConfigurationAwareInterface;
+use League\Config\ConfigurationInterface;
+
+/**
+ * Creates URL-friendly strings based on the given string input
+ */
+final class SlugNormalizer implements TextNormalizerInterface, ConfigurationAwareInterface
+{
+    /** @psalm-allow-private-mutation */
+    private int $defaultMaxLength = 255;
+
+    public function setConfiguration(ConfigurationInterface $configuration): void
+    {
+        $this->defaultMaxLength = $configuration->get('slug_normalizer/max_length');
+    }
+
+    /**
+     * {@inheritDoc}
+     *
+     * @psalm-immutable
+     */
+    public function normalize(string $text, array $context = []): string
+    {
+        // Add any requested prefix
+        $slug = ($context['prefix'] ?? '') . $text;
+        // Trim whitespace
+        $slug = \trim($slug);
+        // Convert to lowercase
+        $slug = \mb_strtolower($slug, 'UTF-8');
+        // Try replacing whitespace with a dash
+        $slug = \preg_replace('/\s+/u', '-', $slug) ?? $slug;
+        // Try removing characters other than letters, numbers, and marks.
+        $slug = \preg_replace('/[^\p{L}\p{Nd}\p{Nl}\p{M}-]+/u', '', $slug) ?? $slug;
+        // Trim to requested length if given
+        if ($length = $context['length'] ?? $this->defaultMaxLength) {
+            $slug = \mb_substr($slug, 0, $length, 'UTF-8');
+        }
+
+        // @phpstan-ignore-next-line Because it thinks mb_substr() returns false on PHP 7.4
+        return $slug;
+    }
+}