Merge branch 'master' into feat-3555

felangel · Oct 14, 2023 · dcf9cbb · dcf9cbb
2 parents 97baf15 + fe9c463
commit dcf9cbb
Show file tree

Hide file tree

Showing 48 changed files with 220 additions and 185 deletions.
diff --git a/README.md b/README.md
@@ -16,7 +16,7 @@
 
 ---
 
-A predictable state management library that helps implement the [BLoC design pattern](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc).
+A predictable state management library that helps implement the BLoC design pattern.
 
 | Package                                                                                    | Pub                                                                                                                  |
 | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |

diff --git a/analysis_options.yaml b/analysis_options.yaml
@@ -81,15 +81,13 @@ linter:
     - implicit_call_tearoffs
     - implicit_reopen
     - invalid_case_patterns
-    - iterable_contains_unrelated_type
     - join_return_with_assignment
     - leading_newlines_in_multiline_strings
     - library_annotations
     - library_names
     - library_prefixes
     - library_private_types_in_public_api
     - lines_longer_than_80_chars
-    - list_remove_unrelated_type
     - literal_only_boolean_expressions
     - missing_whitespace_between_adjacent_strings
     - no_adjacent_strings_in_list

diff --git a/docs/_snippets/core_concepts/counter_cubit_on_change_usage_output.sh.md b/docs/_snippets/core_concepts/counter_cubit_on_change_usage_output.sh.md
@@ -1,4 +1,4 @@
 ```sh
-Change { currentState: 0, nextState: 1 }
 CounterCubit Change { currentState: 0, nextState: 1 }
+Change { currentState: 0, nextState: 1 }
 ```
diff --git a/docs/_snippets/core_concepts/simple_bloc_observer_on_event_output.sh.md b/docs/_snippets/core_concepts/simple_bloc_observer_on_event_output.sh.md
@@ -1,8 +1,8 @@
 ```sh
-Increment
 CounterBloc Increment
-Transition { currentState: 0, event: Increment, nextState: 1 }
+Increment
 CounterBloc Transition { currentState: 0, event: Increment, nextState: 1 }
-Change { currentState: 0, nextState: 1 }
+Transition { currentState: 0, event: Increment, nextState: 1 }
 CounterBloc Change { currentState: 0, nextState: 1 }
+Change { currentState: 0, nextState: 1 }
 ```
diff --git a/docs/_snippets/core_concepts/simple_bloc_observer_on_transition_output.sh.md b/docs/_snippets/core_concepts/simple_bloc_observer_on_transition_output.sh.md
@@ -1,6 +1,6 @@
 ```sh
-Transition { currentState: 0, event: Increment, nextState: 1 }
 CounterBloc Transition { currentState: 0, event: Increment, nextState: 1 }
-Change { currentState: 0, nextState: 1 }
+Transition { currentState: 0, event: Increment, nextState: 1 }
 CounterBloc Change { currentState: 0, nextState: 1 }
+Change { currentState: 0, nextState: 1 }
 ```
diff --git a/docs/az/README.md b/docs/az/README.md
@@ -11,7 +11,7 @@
 
 ---
 
-[BLoC design pattern](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc)-i həyata keçirməyə kömək edən gözlənilən vəziyyətin idarə edilməsi kitabxanası.
+BLoC design pattern-i həyata keçirməyə kömək edən gözlənilən vəziyyətin idarə edilməsi kitabxanası.
 
 | Paketlər                                                                           | Pub                                                                                                    |
 | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |

diff --git a/docs/coreconcepts.md b/docs/coreconcepts.md
@@ -130,7 +130,7 @@ The above snippet would then output:
 
 [script](_snippets/core_concepts/counter_cubit_on_change_usage_output.sh.md ':include')
 
-?> **Note**: The internal `onChange` override is called first, followed by `onChange` in `BlocObserver`.
+?> **Note**: The internal `onChange` override is called first, which calls `super.onChange` notifying the `onChange` in the `BlocObserver`.
 
 ?> 💡 **Tip**: In `BlocObserver` we have access to the `Cubit` instance in addition to the `Change` itself.
 

diff --git a/docs/cs/README.md b/docs/cs/README.md
@@ -11,7 +11,7 @@
 
 ---
 
-Prediktivní knihovna pro state management, která pomáhá implementovat [návrhový vzor BLoC](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc).
+Prediktivní knihovna pro state management, která pomáhá implementovat návrhový vzor BLoC.
 
 | Balíček                                                                            | Pub                                                                                                    |
 | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
@@ -70,7 +70,7 @@ V rámci této dokumentace se budeme držet originálního názvu `Bloc` (čti _
                 <a href="https://bloclibrary.dev/#/cs/fluttercountertutorial">
                     <img src="https://bloclibrary.dev/assets/gifs/flutter_counter.gif" width="200"/>
                 </a>
-            </td>            
+            </td>
             <td style="text-align: center">
                 <a href="https://bloclibrary.dev/#/cs/flutterinfinitelisttutorial">
                     <img src="https://bloclibrary.dev/assets/gifs/flutter_infinite_list.gif" width="200"/>

diff --git a/docs/de-de/README.md b/docs/de-de/README.md
@@ -11,7 +11,7 @@
 
 ---
 
-Eine vorhersagbare Zustandsverwaltungsbibliothek, die bei der Implementierung des [BLoC-Entwurfsmusters](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc) hilft.
+Eine vorhersagbare Zustandsverwaltungsbibliothek, die bei der Implementierung des BLoC-Entwurfsmusters hilft.
 
 | Paket                                                                              | Pub                                                                                                    |
 | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
@@ -68,7 +68,7 @@ Das Ziel dieser Bibliothek ist es, eine erleichterte Trennung von _Präsentation
                 <a href="https://bloclibrary.dev/#/fluttercountertutorial">
                     <img src="https://bloclibrary.dev/assets/gifs/flutter_counter.gif" width="200"/>
                 </a>
-            </td>            
+            </td>
             <td style="text-align: center">
                 <a href="https://bloclibrary.dev/#/flutterinfinitelisttutorial">
                     <img src="https://bloclibrary.dev/assets/gifs/flutter_infinite_list.gif" width="200"/>

diff --git a/docs/es/README.md b/docs/es/README.md
@@ -11,7 +11,7 @@
 
 ---
 
-Una librería de administración de estado predecible que ayuda a implementar el [patrón de diseño BLoC](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc).
+Una librería de administración de estado predecible que ayuda a implementar el patrón de diseño BLoC.
 
 | Package                                                                            | Pub                                                                                                    |
 | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |

diff --git a/docs/fluttertodostutorial.md b/docs/fluttertodostutorial.md
@@ -13,7 +13,7 @@
 - [BlocObserver](/coreconcepts?id=blocobserver) to observe state changes.
 - [BlocProvider](/flutterbloccoreconcepts?id=blocprovider), a Flutter widget which provides a bloc to its children.
 - [BlocBuilder](/flutterbloccoreconcepts?id=blocbuilder), a Flutter widget that handles building the widget in response to new states.
-- [BlocListener](/flutterbloccoreconcepts?id=bloclistener), a Flutter widget that handlers performing side effects in response to state changes.
+- [BlocListener](/flutterbloccoreconcepts?id=bloclistener), a Flutter widget that handles performing side effects in response to state changes.
 - [RepositoryProvider](/flutterbloccoreconcepts?id=repositoryprovider), a Flutter widget to provide a repository to its children.
 - [Equatable](/faqs?id=when-to-use-equatable) to prevent unnecessary rebuilds.
 - [MultiBlocListener](/flutterbloccoreconcepts?id=multibloclistener), a Flutter widget that reduces nesting when using multiple BlocListeners.

diff --git a/docs/fr/README.md b/docs/fr/README.md
@@ -11,7 +11,7 @@
 
 ---
 
-Une librairie pour gérer le state de notre application en implémentant le [paterne BLoC](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc).
+Une librairie pour gérer le state de notre application en implémentant le paterne BLoC.
 
 | Package                                                                            | Pub                                                                                                    |
 | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
@@ -68,7 +68,7 @@ Le but de cette architecte est de facilité la séparation entre _présentation_
                 <a href="https://bloclibrary.dev/#/fluttercountertutorial">
                     <img src="https://bloclibrary.dev/assets/gifs/flutter_counter.gif" width="200"/>
                 </a>
-            </td>            
+            </td>
             <td style="text-align: center">
                 <a href="https://bloclibrary.dev/#/flutterinfinitelisttutorial">
                     <img src="https://bloclibrary.dev/assets/gifs/flutter_infinite_list.gif" width="200"/>

diff --git a/docs/gettingstarted.md b/docs/gettingstarted.md
@@ -44,6 +44,6 @@ For a Flutter application we can import `flutter_bloc`.
 
 [main.dart](_snippets/getting_started/flutter_bloc_main.dart.md ':include')
 
-For an AngularDart application we can import angular_bloc.
+For an AngularDart application we can import `angular_bloc`.
 
 [main.dart](_snippets/getting_started/angular_bloc_main.dart.md ':include')
diff --git a/docs/jp/README.md b/docs/jp/README.md
@@ -16,7 +16,7 @@
 
 ---
 
-A predictable state management library that helps implement the [BLoC design pattern](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc).
+A predictable state management library that helps implement the BLoC design pattern.
 
 | Package                                                                                    | Pub                                                                                                                  |
 | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |

diff --git a/docs/ko-kr/README.md b/docs/ko-kr/README.md
@@ -16,7 +16,7 @@
 
 ---
 
-A predictable state management library that helps implement the [BLoC design pattern](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc).
+A predictable state management library that helps implement the BLoC design pattern.
 
 | Package                                                                                    | Pub                                                                                                                  |
 | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |

diff --git a/docs/pt-br/README.md b/docs/pt-br/README.md
@@ -11,7 +11,7 @@
 
 ---
 
-Uma biblioteca previsível de gerenciamento de estado que ajuda a implementar o [padrão de projeto BLoC](https://www.didierboelens.com/2018/08/reactive-programming---streams---bloc).
+Uma biblioteca previsível de gerenciamento de estado que ajuda a implementar o padrão de projeto BLoC.
 
 | Package                                                                            | Pub                                                                                                    |
 | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
@@ -69,7 +69,7 @@ O objetivo dessa biblioteca é tornar fácil separar _apresentação_ da _lógic
                 <a href="https://bloclibrary.dev/#/fluttercountertutorial">
                     <img src="https://bloclibrary.dev/assets/gifs/flutter_counter.gif" width="200"/>
                 </a>
-            </td>            
+            </td>
             <td style="text-align: center">
                 <a href="https://bloclibrary.dev/#/flutterinfinitelisttutorial">
                     <img src="https://bloclibrary.dev/assets/gifs/flutter_infinite_list.gif" width="200"/>

diff --git a/docs/pt-br/gettingstarted.md b/docs/pt-br/gettingstarted.md
@@ -4,46 +4,46 @@
 
 ## Visão geral
 
-O Bloc consiste em vários packages disponíveis no pub:
+O Bloc consiste em vários pacotes disponíveis no pub:
 
-- [bloc](https://pub.dev/packages/bloc) - Package principal para o bloc
+- [bloc](https://pub.dev/packages/bloc) - Biblioteca principal do bloc
 - [flutter_bloc](https://pub.dev/packages/flutter_bloc) - Poderosos Widgets para Flutter desenvolvidos para trabalhar com bloc e construir aplicações mobile rápidas e reativas.
 - [angular_bloc](https://pub.dev/packages/angular_bloc) - Poderosos Componentes para Angular desenvolvidos para trabalhar com bloc e construir aplicações web rápidas e reativas.
 - [hydrated_bloc](https://pub.dev/packages/hydrated_bloc) - Uma extensão da biblioteca de gerenciamento de estado bloc que persiste e restaura automaticamente os estados do bloc.
 - [replay_bloc](https://pub.dev/packages/replay_bloc) - Uma extensão da biblioteca de gerenciamento de estado bloc que adiciona suporte para desfazer e refazer.
 
 ## Instalação
 
-A primeira coisa que precisamos fazer é adicionar o package bloc como uma dependência no `pubspec.yaml`.
+Para uma aplicação [Dart](https://dart.dev/), precisamos adicionar o pacote `bloc` ao nosso `pubspec.yaml` como uma dependência.
 
 [pubspec.yaml](../_snippets/getting_started/bloc_pubspec.yaml.md ':include')
 
-Para uma aplicação [Flutter](https://flutter.dev/), também é necessário adicionar o package flutter_bloc como uma dependência no `pubspec.yaml`.
+Para uma aplicação [Flutter](https://flutter.dev/), precisamos adicionar o pacote `flutter_bloc` ao nosso `pubspec.yaml` como uma dependência.
 
 [pubspec.yaml](../_snippets/getting_started/flutter_bloc_pubspec.yaml.md ':include')
 
-Para uma aplicação [AngularDart](https://angulardart.dev/), também é necessário adicionar o package angular_bloc como uma dependência no `pubspec.yaml`.
+Para uma aplicação [AngularDart](https://angulardart.dev/), precisamos adicionar o pacote `angular_bloc` ao nosso `pubspec.yaml` como uma dependência.
 
 [pubspec.yaml](../_snippets/getting_started/angular_bloc_pubspec.yaml.md ':include')
 
-Agora precisamos instalar o bloc.
+Em seguida, precisamos instalar o bloc.
 
-!> Execute os comandos abaixo no mesmo diretório em que se encontra o arquivo `pubspec.yaml`.
+!> Certifique-se de executar o seguinte comando no mesmo diretório do arquivo `pubspec.yaml`.
 
-- Para projetos Dart ou AngularDart execute `pub get`
+- Para Dart ou AngularDart execute `pub get`
 
-- Para projetos Flutter execute `flutter packages get`
+- Para Flutter, execute `flutter packages get`
 
 ## Importações
 
-Agora que instalamos o bloc, podemos criar o arquivo `main.dart` e importar o bloc.
+Agora que instalamos o bloc com sucesso, podemos criar nosso `main.dart` e importar `bloc`.
 
 [main.dart](../_snippets/getting_started/bloc_main.dart.md ':include')
 
-Para uma aplicação Flutter também podemos importar o flutter_bloc.
+Para uma aplicação Flutter podemos importar `flutter_bloc`.
 
 [main.dart](../_snippets/getting_started/flutter_bloc_main.dart.md ':include')
 
-Para uma aplicação AngularDart também podemos importar o angular_bloc.
+Para uma aplicação AngularDart podemos importar `angular_bloc`.
 
 [main.dart](../_snippets/getting_started/angular_bloc_main.dart.md ':include')