Lists can load the documents their reference fields point to

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: rayliverified

lib/src/api/mixins.dart

@@ -1395,6 +1395,12 @@ mixin QueryableMixin {
   @JsonKey(defaultValue: QueryPaging.scroll)
   QueryPaging paging = QueryPaging.scroll;
 
+  /// Reference fields whose documents load with the results: each result's
+  /// field then holds the referenced document (with its `id`), e.g.
+  /// `${item.author.name}`. The collection comes from the schema.
+  @JsonKey(defaultValue: [])
+  List<String> loadRelated = [];
+
   /// Whether the query operation is going to be restrictive.
   /// This pertains to Firestore's indexing rules.
   bool get restrictedIndexing => useCloudDatabase;

lib/src/api/models/action/load_from_cloud_storage_action.g.dart

@@ -58,9 +58,11 @@ void main() {
     );
     expect(list.toJson().containsKey('paging'), isFalse);
     list.paging = QueryPaging.button;
+    list.loadRelated = ['author'];
     final ListViewNode listBack = ListViewNode.fromJson(
       jsonDecode(jsonEncode(list.toJson())) as Map,
     );
     expect(listBack.paging, QueryPaging.button);
+    expect(listBack.loadRelated, ['author']);
   });
 }