Define descendant relationship on Entry model

src/Entries/Entry.php

@@ -6,6 +6,7 @@
 use Illuminate\Support\Carbon;
 use Statamic\Contracts\Entries\Entry as EntryContract;
 use Statamic\Entries\Entry as FileEntry;
+use Statamic\Entries\EntryCollection;
 use Statamic\Facades\Blink;
 use Statamic\Facades\Entry as EntryFacade;
 
@@ -201,6 +202,19 @@ public function makeLocalization($site)
             ->data($this->data());
     }
 
+    public function directDescendants()
+    {
+        return Blink::once('entry-descendants-'.$this->id(), function () {
+            return new EntryCollection($this
+                ->model()
+                ->descendants()
+                ->get()
+                ->map(fn ($model) => static::fromModel($model))
+                ->keyBy
+                ->locale());
+        });
+    }
+
     public function getDataColumnMappings(Model $model)
     {
         if (! config('statamic.eloquent-driver.entries.map_data_to_columns', false)) {

src/Entries/EntryModel.php

@@ -11,6 +11,8 @@ class EntryModel extends BaseModel
 
     protected $table = 'entries';
 
+    protected $with = ['descendants'];
+
     protected $casts = [
         'date'      => 'datetime',
         'data'      => 'json',
@@ -27,6 +29,11 @@ public function origin()
         return $this->belongsTo(static::class);
     }
 
+    public function descendants()
+    {
+        return $this->hasMany(static::class, 'origin_id');
+    }
+
     public function parent()
     {
         return $this->belongsTo(static::class, 'data->parent');

tests/Entries/EntryTest.php

@@ -195,7 +195,7 @@ public function it_propagates_updating_origin_data_to_descendent_models()
                 'roo' => 'rar',
             ]);
 
-        $return = $entry->save();
+        $entry->save();
 
         $this->assertNull($entry->descendants()->get('fr')->model()->data['too'] ?? null);
         $this->assertNull($entry->descendants()->get('de')->model()->data['too'] ?? null);