Merge branch 'master' into feat-3555

felangel · Oct 4, 2024 · b36f0ee · b36f0ee
2 parents 8a836cc + f951eef
commit b36f0ee
Show file tree

Hide file tree

Showing 144 changed files with 4,960 additions and 4,330 deletions.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -62,59 +62,6 @@ If you wish to add translations, ensure the locale is included in the [locales l
 
 Refer to [this pull request](https://github.com/felangel/bloc/pull/4084) for an example.
 
-### Tips
-
-Here are a few tips when contributing to the documentation:
-
-- We use [docsify](https://docsify.js.org) for document rendering. Refer to the docsify documentation for more context/examples regarding the syntax, usage, and capabilities.
-- We prefer to reference real files in GitHub rather than creating snippets (some old examples make use of snippets but we are slowly migrating away).
-  This is to keep the docs in sync if we modify the tutorial.
-  - If the code changes but the tutorial doesn't get updated, we also get out of sync. To avoid this, you might add a section linking to a specific commit/version that reflects the state of the tutorial at the time you write the doc.
-
-## Pull requests
-
-To make PRs more readable, please provide this checklist to the PR description
-so other contributors can easily see what's already done.
-
-```text
-- [ ] README
-- [ ] Cover page
-- [ ] Sidebar
-- Introduction
-  - [ ] Getting Started
-  - [ ] Why Bloc?
-- Core Concepts
-  - [ ] bloc
-  - [ ] flutter_bloc
-- [ ] Architecture
-- [ ] Testing
-- [ ] Naming Conventions
-- [ ] FAQs
-- Tutorials
-  - Flutter
-    - [ ] Counter
-    - [ ] Timer
-    - [ ] Infinite List
-    - [ ] Login
-    - [ ] Weather
-    - [ ] Todos
-    - [ ] Firebase Login
-    - [ ] Firestore Todos
-  - AngularDart
-    - [ ] Counter
-  - Flutter + AngularDart
-    - [ ] Github Search
-- Recipes
-  - Flutter
-    - [ ] Show SnackBar
-    - [ ] Navigation
-    - [ ] Bloc Access
-- Tools
-  - Extensions
-    - [ ] IntelliJ
-    - [ ] VSCode
-```
-
 ## Adding an example
 
 Examples live in the `examples` folder.

diff --git a/README.md b/README.md
@@ -37,26 +37,26 @@ Our top sponsors are shown below! [[Become a Sponsor](https://github.com/sponsor
 <table style="background-color: white; border: 1px solid black">
     <tbody>
         <tr>
+            <td align="center" style="border: 1px solid black">
+                <a href="https://shorebird.dev"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/shorebird.png" width="225"/></a>
+            </td>
             <td align="center" style="border: 1px solid black">
                 <a href="https://www.monterail.com/services/flutter-development/?utm_source=bloc&utm_medium=logo&utm_campaign=flutter"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/monterail.png" width="225"/></a>
             </td>
             <td align="center" style="border: 1px solid black">
                 <a href="https://getstream.io/chat/flutter/tutorial/?utm_source=Github&utm_medium=Github_Repo_Content_Ad&utm_content=Developer&utm_campaign=Github_Jan2022_FlutterChat&utm_term=bloc"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/stream.png" width="225"/></a>
             </td>
+        </tr>
+        <tr>
             <td align="center" style="border: 1px solid black">
                 <a href="https://www.miquido.com/flutter-development-company/?utm_source=github&utm_medium=sponsorship&utm_campaign=bloc-silver-tier&utm_term=flutter-development-company&utm_content=miquido-logo"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/miquido.png" width="225"/></a>
             </td>
-        </tr>
-        <tr>
             <td align="center" style="border: 1px solid black">
                 <a href="https://bit.ly/parabeac_flutterbloc"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/parabeac.png" width="225"/></a>
             </td>
             <td align="center" style="border: 1px solid black">
                 <a href="https://www.netguru.com/services/flutter-app-development?utm_campaign=%5BS%5D%5BMob%5D%20Flutter&utm_source=github&utm_medium=sponsorship&utm_term=bloclibrary"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/netguru.png" width="225"/></a>
             </td>
-            <td align="center" style="border: 1px solid black">
-                <a href="https://www.porada.app/"><img src="https://raw.githubusercontent.com/felangel/bloc/master/assets/sponsors/porada.png" width="225"/></a>
-            </td>            
         </tr>
     </tbody>
 </table>

diff --git a/analysis_options.yaml b/analysis_options.yaml
@@ -93,6 +93,7 @@ linter:
     - lines_longer_than_80_chars
     - literal_only_boolean_expressions
     - matching_super_parameters
+    - missing_code_block_language_in_doc_comment
     - missing_whitespace_between_adjacent_strings
     - no_adjacent_strings_in_list
     - no_default_cases

diff --git a/assets/sponsors/shorebird.png b/assets/sponsors/shorebird.png
diff --git a/bricks/flutter_bloc_feature/CHANGELOG.md b/bricks/flutter_bloc_feature/CHANGELOG.md
@@ -1,3 +1,7 @@
+# 0.3.2
+
+- deps: upgrade to mason v0.1.0-dev.57
+
 # 0.3.1
 
 - chore: update copyright year

diff --git a/bricks/flutter_bloc_feature/brick.yaml b/bricks/flutter_bloc_feature/brick.yaml
@@ -1,10 +1,10 @@
 name: flutter_bloc_feature
 description: Generate a new Flutter feature with bloc. Built for the bloc state management library.
 repository: https://github.com/felangel/bloc/tree/master/bricks/flutter_bloc_feature
-version: 0.3.1
+version: 0.3.2
 
 environment:
-  mason: ">=0.1.0-dev.40 <0.1.0"
+  mason: ">=0.1.0-dev.57 <0.1.0"
 
 vars:
   name:

diff --git a/bricks/flutter_bloc_feature/hooks/pubspec.yaml b/bricks/flutter_bloc_feature/hooks/pubspec.yaml
@@ -4,5 +4,5 @@ environment:
   sdk: ">=2.15.0 <3.0.0"
 
 dependencies:
-  mason: ^0.1.0-dev.40
+  mason: ^0.1.0-dev.57
   path: ^1.8.2
diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs
@@ -58,6 +58,12 @@ const locales = {
 	ar: {
 		label: 'العربية',
 		lang: 'ar',
+		dir: 'rtl',
+	},
+	fa: {
+		label: 'فارسی',
+		lang: 'fa',
+		dir: 'rtl',
 	},
 };
 
@@ -103,66 +109,123 @@ export default defineConfig({
 			sidebar: [
 				{
 					label: 'Introduction',
+					translations: {
+						'zh-CN': '介绍',
+						fa: 'مقدمه',
+					},
 					items: [
 						{
 							label: 'Getting Started',
 							link: '/getting-started/',
+							translations: {
+								'zh-CN': '快速入门',
+								fa: 'شروع شدن',
+							},
 						},
 						{
 							label: 'Why Bloc?',
 							link: '/why-bloc/',
+							translations: {
+								'zh-CN': '为什么用 Bloc?',
+								fa: 'چرا Bloc؟',
+							},
 						},
 						{
 							label: 'Bloc Concepts',
 							link: '/bloc-concepts/',
+							translations: {
+								'zh-CN': 'Bloc 核心概念',
+								fa: 'مفاهیم Bloc',
+							},
 						},
 						{
 							label: 'Flutter Bloc Concepts',
 							link: '/flutter-bloc-concepts/',
+							translations: {
+								'zh-CN': 'Flutter Bloc 核心概念',
+								fa: 'مفاهیم بلوک فلاتر',
+							},
 						},
 						{
 							label: 'Architecture',
 							link: '/architecture/',
+							translations: {
+								fa: 'معماری',
+							},
+						},
+						{
+							label: 'Modeling State',
+							link: '/modeling-state/',
+							translations: {
+								fa: 'وضعیت (State) مدل سازی',
+							},
 						},
 						{
 							label: 'Testing',
 							link: '/testing/',
+							translations: {
+								fa: 'آزمایش کردن',
+							},
 						},
 						{
 							label: 'Naming Conventions',
 							link: '/naming-conventions/',
+							translations: {
+								fa: 'قراردادهای نامگذاری',
+							},
 						},
 						{
 							label: 'FAQs',
 							link: '/faqs/',
+							translations: {
+								fa: 'سوالات متداول',
+							},
 						},
 						{
 							label: 'Migration Guide',
 							link: '/migration/',
+							translations: {
+								fa: 'راهنمای مهاجرت',
+							},
 						},
 					],
 				},
 				{
 					label: 'Tutorials',
+					translations: {
+						fa: 'آموزش ها',
+					},
 					autogenerate: {
 						directory: 'tutorials',
 					},
 				},
 				{
 					label: 'Tools',
+					translations: {
+						fa: 'ابزار',
+					},
 					items: [
 						{
 							label: 'IntelliJ Plugin',
 							link: 'https://plugins.jetbrains.com/plugin/12129-bloc',
+							translations: {
+								fa: 'پلاگین IntelliJ',
+							},
 						},
 						{
 							label: 'VSCode Extension',
 							link: 'https://marketplace.visualstudio.com/items?itemName=FelixAngelov.bloc',
+							translations: {
+								fa: 'پلاگین VSCode',
+							},
 						},
 					],
 				},
 				{
 					label: 'Reference',
+					translations: {
+						fa: 'مرجع',
+					},
 					items: [
 						{
 							label: 'angular_bloc',