Fix docblock (#45171)

* fix

* fix

Author: michaelnabil230

src/Illuminate/Support/Stringable.php

@@ -363,7 +363,7 @@ public function kebab()
     /**
      * Return the length of the given string.
      *
-     * @param  string  $encoding
+     * @param  string|null  $encoding
      * @return int
      */
     public function length($encoding = null)
@@ -502,7 +502,7 @@ public function padRight($length, $pad = ' ')
      * Parse a Class@method style callback into class and method.
      *
      * @param  string|null  $default
-     * @return array
+     * @return array<int, string|null>
      */
     public function parseCallback($default = null)
     {
@@ -523,7 +523,7 @@ public function pipe(callable $callback)
     /**
      * Get the plural form of an English word.
      *
-     * @param  int  $count
+     * @param  int|array|\Countable  $count
      * @return static
      */
     public function plural($count = 2)
@@ -534,7 +534,7 @@ public function plural($count = 2)
     /**
      * Pluralize the last word of an English, studly caps case string.
      *
-     * @param  int  $count
+     * @param  int|array|\Countable  $count
      * @return static
      */
     public function pluralStudly($count = 2)
@@ -556,7 +556,7 @@ public function prepend(...$values)
     /**
      * Remove any occurrence of the given string in the subject.
      *
-     * @param  string|array<string>  $search
+     * @param  string|iterable<string>  $search
      * @param  bool  $caseSensitive
      * @return static
      */
@@ -739,11 +739,12 @@ public function singular()
      *
      * @param  string  $separator
      * @param  string|null  $language
+     * @param  array<string, string>  $dictionary
      * @return static
      */
-    public function slug($separator = '-', $language = 'en')
+    public function slug($separator = '-', $language = 'en', $dictionary = ['@' => 'at'])
     {
-        return new static(Str::slug($this->value, $separator, $language));
+        return new static(Str::slug($this->value, $separator, $language, $dictionary));
     }
 
     /**
@@ -794,13 +795,13 @@ public function substr($start, $length = null)
      * Returns the number of substring occurrences.
      *
      * @param  string  $needle
-     * @param  int|null  $offset
+     * @param  int  $offset
      * @param  int|null  $length
      * @return int
      */
-    public function substrCount($needle, $offset = null, $length = null)
+    public function substrCount($needle, $offset = 0, $length = null)
     {
-        return Str::substrCount($this->value, $needle, $offset ?? 0, $length);
+        return Str::substrCount($this->value, $needle, $offset, $length);
     }
 
     /**
@@ -1057,11 +1058,12 @@ public function words($words = 100, $end = '...')
     /**
      * Get the number of words a string contains.
      *
+     * @param  string|null  $characters
      * @return int
      */
-    public function wordCount()
+    public function wordCount($characters = null)
     {
-        return str_word_count($this->value);
+        return Str::wordCount($this->value, $characters);
     }
 
     /**