Allowing collection to be created passing null

src/Concerns/BaseData.php

@@ -80,7 +80,7 @@ public static function pipeline(): DataPipeline
  ->through(CastPropertiesDataPipe::class);
  }
 
- public static function collection(Enumerable|array|AbstractPaginator|Paginator|AbstractCursorPaginator|CursorPaginator|DataCollection $items): DataCollection|CursorPaginatedDataCollection|PaginatedDataCollection
+ public static function collection(Enumerable|array|AbstractPaginator|Paginator|AbstractCursorPaginator|CursorPaginator|DataCollection|null $items): DataCollection|CursorPaginatedDataCollection|PaginatedDataCollection
  {
  if ($items instanceof Paginator || $items instanceof AbstractPaginator) {
  return new (static::$_paginatedCollectionClass)(static::class, $items);

src/Contracts/BaseData.php

@@ -28,7 +28,7 @@ public static function withoutMagicalCreationFrom(mixed ...$payloads): static;
  *
  * @return ($items is \Illuminate\Pagination\AbstractCursorPaginator|\Illuminate\Pagination\CursorPaginator ? \Spatie\LaravelData\CursorPaginatedDataCollection<array-key, static> : ($items is \Illuminate\Pagination\Paginator|\Illuminate\Pagination\AbstractPaginator ? \Spatie\LaravelData\PaginatedDataCollection<array-key, static> : \Spatie\LaravelData\DataCollection<array-key, static>))
  */
- public static function collection(Enumerable|array|AbstractPaginator|Paginator|AbstractCursorPaginator|CursorPaginator|DataCollection $items): DataCollection|CursorPaginatedDataCollection|PaginatedDataCollection;
+ public static function collection(Enumerable|array|AbstractPaginator|Paginator|AbstractCursorPaginator|CursorPaginator|DataCollection|null $items): DataCollection|CursorPaginatedDataCollection|PaginatedDataCollection;
 
  public static function normalizers(): array;
 

src/DataCollection.php

@@ -45,9 +45,9 @@ class DataCollection implements DataCollectable, ArrayAccess
  */
  public function __construct(
  public readonly string $dataClass,
- Enumerable|array|DataCollection $items
+ Enumerable|array|DataCollection|null $items
  ) {
- if (is_array($items)) {
+ if (is_array($items) || is_null($items)) {
  $items = new Collection($items);
  }
 

tests/DataCollectionTest.php

@@ -529,3 +529,10 @@ function (string $operation, array $arguments, array $expected) {
  expect($invaded->_except)->toBeEmpty();
  expect($invaded->_wrap)->toBeNull();
 });
+
+it('can create an empty collection passing null', function () {
+ $collection = SimpleData::collection(null);
+
+ expect($collection)->toBeInstanceOf(DataCollection::class);
+ expect($collection->toJson())->toBe('[]');
+});