Skip to content

Commit b006118

Browse files
committed
docs: genericParameters macro
1 parent 448dd6a commit b006118

File tree

3 files changed

+16
-2
lines changed

3 files changed

+16
-2
lines changed

packages/stream_feed_flutter_core/lib/src/bloc/feed_bloc.dart

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,8 +6,8 @@ import 'package:stream_feed_flutter_core/src/extensions.dart';
66

77
/// The generic version of feedBloc
88
///
9-
///{@macro feedBloc}
10-
9+
/// {@macro feedBloc}
10+
/// {@macro genericParameters}
1111
class GenericFeedBloc<A, Ob, T, Or> {
1212
GenericFeedBloc({required this.client, this.analyticsClient});
1313

packages/stream_feed_flutter_core/lib/src/flat_feed_core.dart

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ import 'package:stream_feed_flutter_core/stream_feed_flutter_core.dart';
1010
/// The generic version of [FlatFeedCore]
1111
///
1212
///{@macro flatFeedCore}
13+
///{@macro genericParameters}
1314
class GenericFlatFeedCore<A, Ob, T, Or> extends StatefulWidget {
1415
///{@macro flatFeedCore}
1516
const GenericFlatFeedCore({

packages/stream_feed_flutter_core/lib/src/typedefs.dart

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -163,4 +163,17 @@ typedef FeedProvider = GenericFeedProvider<User, String, String, String>;
163163
/// FeedProvider.of(context).bloc.onRemoveChildReaction()
164164
/// ```
165165
/// {@endtemplate}
166+
///
167+
/// {@template genericParameters}
168+
/// The generic parameters can be of the following type:
169+
/// A = [actor] can be an User, or a String
170+
/// Ob = [object] can a String, or a CollectionEntry
171+
/// T = [target] can be a String or an Activity
172+
/// Or = [origin] can be a String or a Reaction or an User
173+
///
174+
/// To avoid potential runtime errors
175+
/// make sure they are the same across the app if
176+
/// you go the route of using Generic* classes
177+
///
178+
/// {@endtemplate}
166179
typedef FeedBloc = GenericFeedBloc<User, String, String, String>;

0 commit comments

Comments
 (0)