[12.x] add generics to array types for Schema Grammars

src/Illuminate/Database/Schema/Grammars/Grammar.php

@@ -169,7 +169,7 @@ public function compileForeignKeys($schema, $table)
      *
      * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
      * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
+     * @return list<string>|string
      */
     public function compileRenameColumn(Blueprint $blueprint, Fluent $command)
     {
@@ -185,7 +185,7 @@ public function compileRenameColumn(Blueprint $blueprint, Fluent $command)
      *
      * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
      * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
+     * @return list<string>|string
      *
      * @throws \RuntimeException
      */
@@ -427,8 +427,8 @@ protected function hasCommand(Blueprint $blueprint, $name)
      * Add a prefix to an array of values.
      *
      * @param  string  $prefix
-     * @param  array  $values
-     * @return array
+     * @param  array<string>  $values
+     * @return array<string>
      */
     public function prefixArray($prefix, array $values)
     {

src/Illuminate/Database/Schema/Grammars/MariaDbGrammar.php

@@ -7,13 +7,7 @@
 
 class MariaDbGrammar extends MySqlGrammar
 {
-    /**
-     * Compile a rename column command.
-     *
-     * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
-     * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
-     */
+    /** @inheritDoc */
     public function compileRenameColumn(Blueprint $blueprint, Fluent $command)
     {
         if (version_compare($this->connection->getServerVersion(), '10.5.2', '<')) {

src/Illuminate/Database/Schema/Grammars/MySqlGrammar.php

@@ -331,13 +331,7 @@ public function compileAutoIncrementStartingValues(Blueprint $blueprint, Fluent
         }
     }
 
-    /**
-     * Compile a rename column command.
-     *
-     * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
-     * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
-     */
+    /** @inheritDoc */
     public function compileRenameColumn(Blueprint $blueprint, Fluent $command)
     {
         $isMaria = $this->connection->isMaria();
@@ -396,13 +390,7 @@ protected function compileLegacyRenameColumn(Blueprint $blueprint, Fluent $comma
         );
     }
 
-    /**
-     * Compile a change column command into a series of SQL statements.
-     *
-     * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
-     * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
-     */
+    /** @inheritDoc */
     public function compileChange(Blueprint $blueprint, Fluent $command)
     {
         $column = $command->column;
@@ -650,7 +638,7 @@ public function compileRenameIndex(Blueprint $blueprint, Fluent $command)
     /**
      * Compile the SQL needed to drop all tables.
      *
-     * @param  array  $tables
+     * @param  array<string>  $tables
      * @return string
      */
     public function compileDropAllTables($tables)
@@ -661,7 +649,7 @@ public function compileDropAllTables($tables)
     /**
      * Compile the SQL needed to drop all views.
      *
-     * @param  array  $views
+     * @param  array<string>  $views
      * @return string
      */
     public function compileDropAllViews($views)
@@ -707,8 +695,8 @@ public function compileTableComment(Blueprint $blueprint, Fluent $command)
     /**
      * Quote-escape the given tables, views, or types.
      *
-     * @param  array  $names
-     * @return array
+     * @param  array<string>  $names
+     * @return array<string>
      */
     public function escapeNames($names)
     {

src/Illuminate/Database/Schema/Grammars/PostgresGrammar.php

@@ -277,13 +277,7 @@ public function compileAutoIncrementStartingValues(Blueprint $blueprint, Fluent
         }
     }
 
-    /**
-     * Compile a change column command into a series of SQL statements.
-     *
-     * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
-     * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
-     */
+    /** @inheritDoc */
     public function compileChange(Blueprint $blueprint, Fluent $command)
     {
         $column = $command->column;
@@ -465,7 +459,7 @@ public function compileDropIfExists(Blueprint $blueprint, Fluent $command)
     /**
      * Compile the SQL needed to drop all tables.
      *
-     * @param  array  $tables
+     * @param  array<string>  $tables
      * @return string
      */
     public function compileDropAllTables($tables)
@@ -476,7 +470,7 @@ public function compileDropAllTables($tables)
     /**
      * Compile the SQL needed to drop all views.
      *
-     * @param  array  $views
+     * @param  array<string>  $views
      * @return string
      */
     public function compileDropAllViews($views)
@@ -487,7 +481,7 @@ public function compileDropAllViews($views)
     /**
      * Compile the SQL needed to drop all types.
      *
-     * @param  array  $types
+     * @param  array<string>  $types
      * @return string
      */
     public function compileDropAllTypes($types)
@@ -498,7 +492,7 @@ public function compileDropAllTypes($types)
     /**
      * Compile the SQL needed to drop all domains.
      *
-     * @param  array  $domains
+     * @param  array<string>  $domains
      * @return string
      */
     public function compileDropAllDomains($domains)
@@ -684,8 +678,8 @@ public function compileTableComment(Blueprint $blueprint, Fluent $command)
     /**
      * Quote-escape the given tables, views, or types.
      *
-     * @param  array  $names
-     * @return array
+     * @param  array<string>  $names
+     * @return array<string>
      */
     public function escapeNames($names)
     {
@@ -1231,7 +1225,7 @@ protected function modifyStoredAs(Blueprint $blueprint, Fluent $column)
      *
      * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
      * @param  \Illuminate\Support\Fluent  $column
-     * @return string|array|null
+     * @return string|list<string>|null
      */
     protected function modifyGeneratedAs(Blueprint $blueprint, Fluent $column)
     {

src/Illuminate/Database/Schema/Grammars/SQLiteGrammar.php

@@ -319,7 +319,7 @@ public function compileAdd(Blueprint $blueprint, Fluent $command)
      *
      * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
      * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
+     * @return list<string>|string
      */
     public function compileAlter(Blueprint $blueprint, Fluent $command)
     {
@@ -370,13 +370,7 @@ public function compileAlter(Blueprint $blueprint, Fluent $command)
         ], $indexes, [$foreignKeyConstraintsEnabled ? $this->compileEnableForeignKeyConstraints() : null]));
     }
 
-    /**
-     * Compile a change column command into a series of SQL statements.
-     *
-     * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
-     * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
-     */
+    /** @inheritDoc */
     public function compileChange(Blueprint $blueprint, Fluent $command)
     {
         // Handled on table alteration...
@@ -526,7 +520,7 @@ public function compileRebuild($schema = null)
      *
      * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
      * @param  \Illuminate\Support\Fluent  $command
-     * @return array|null
+     * @return list<string>|null
      */
     public function compileDropColumn(Blueprint $blueprint, Fluent $command)
     {

src/Illuminate/Database/Schema/Grammars/SqlServerGrammar.php

@@ -226,13 +226,7 @@ public function compileAdd(Blueprint $blueprint, Fluent $command)
         );
     }
 
-    /**
-     * Compile a rename column command.
-     *
-     * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
-     * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
-     */
+    /** @inheritDoc */
     public function compileRenameColumn(Blueprint $blueprint, Fluent $command)
     {
         return sprintf("sp_rename %s, %s, N'COLUMN'",
@@ -241,13 +235,7 @@ public function compileRenameColumn(Blueprint $blueprint, Fluent $command)
         );
     }
 
-    /**
-     * Compile a change column command into a series of SQL statements.
-     *
-     * @param  \Illuminate\Database\Schema\Blueprint  $blueprint
-     * @param  \Illuminate\Support\Fluent  $command
-     * @return array|string
-     */
+    /** @inheritDoc */
     public function compileChange(Blueprint $blueprint, Fluent $command)
     {
         return [
@@ -1033,7 +1021,7 @@ protected function modifyPersisted(Blueprint $blueprint, Fluent $column)
     /**
      * Quote the given string literal.
      *
-     * @param  string|array  $value
+     * @param  string|array<string>  $value
      * @return string
      */
     public function quoteString($value)