Merge pull request yajra#3253 from tusharnain/docblock-improvements

yajra · web-flow · commit c4af0b1840b4 · 2025-10-03T11:22:44.000+08:00
chore: improve datatables() helper docblock for better return type clarity
diff --git a/src/helper.php b/src/helper.php
@@ -6,7 +6,7 @@
      * Or return the factory if source is not set.
      *
      * @param  \Illuminate\Contracts\Database\Query\Builder|\Illuminate\Contracts\Database\Eloquent\Builder|\Illuminate\Support\Collection|array|null  $source
-     * @return \Yajra\DataTables\DataTables|\Yajra\DataTables\DataTableAbstract
+     * @return ($source is null ? \Yajra\DataTables\DataTables : \Yajra\DataTables\DataTableAbstract)
      *
      * @throws \Yajra\DataTables\Exceptions\Exception
      */

Original file line number	Diff line number	Diff line change
`@@ -6,7 +6,7 @@`
`6`	`6`	`* Or return the factory if source is not set.`
`7`	`7`	`*`
`8`	`8`	`* @param \Illuminate\Contracts\Database\Query\Builder\|\Illuminate\Contracts\Database\Eloquent\Builder\|\Illuminate\Support\Collection\|array\|null $source`
`9`		`- * @return \Yajra\DataTables\DataTables\|\Yajra\DataTables\DataTableAbstract`
	`9`	`+ * @return ($source is null ? \Yajra\DataTables\DataTables : \Yajra\DataTables\DataTableAbstract)`
`10`	`10`	`*`
`11`	`11`	`* @throws \Yajra\DataTables\Exceptions\Exception`
`12`	`12`	`*/`