Added Str::deduplicate (#700)

Co-authored-by: Deeka Wong <8337659+huangdijia@users.noreply.github.com>

output/Hyperf/Stringable/Str.php

@@ -27,6 +27,15 @@ public static function createUuidsNormally()
     {
     }
 
+    /**
+     * Replace consecutive instances of a given character with a single character in the given string.
+     *
+     * @return string
+     */
+    public static function deduplicate(string $string, string $character = ' ')
+    {
+    }
+
     /**
      * Converts GitHub flavored Markdown into HTML.
      *

output/Hyperf/Stringable/Stringable.php

@@ -13,6 +13,15 @@
 
 class Stringable
 {
+    /**
+     * Replace consecutive instances of a given character with a single character.
+     *
+     * @return static
+     */
+    public function deduplicate(string $character = ' ')
+    {
+    }
+
     /**
      * Convert GitHub flavored Markdown into HTML.
      *

src/StrMixin.php

@@ -35,6 +35,11 @@ public function createUuidsUsing()
         return fn (?callable $factory = null) => UuidContainer::$uuidFactory = $factory;
     }
 
+    public static function deduplicate()
+    {
+        return fn (string $string, string $character = ' ') => preg_replace('/' . preg_quote($character, '/') . '+/u', $character, $string);
+    }
+
     public function inlineMarkdown()
     {
         return function ($string, array $options = []) {

src/StringableMixin.php

@@ -21,6 +21,12 @@
  */
 class StringableMixin
 {
+    public function deduplicate()
+    {
+        /* @phpstan-ignore-next-line */
+        return fn (string $character = ' ') => new static(Str::deduplicate($this->value, $character));
+    }
+
     public function inlineMarkdown()
     {
         /* @phpstan-ignore-next-line */