release: 5.5.0

CHANGELOG.md

@@ -1,3 +1,49 @@
+## 5.5.0
+
+**Namespaces**
+
+Split your translations into different files. Each file represents a namespace:
+
+```
+i18n/
+  widgets/
+    - widgets.i18n.json
+    - widgets_fr.i18n.json
+  dialogs/
+    - dialogs.i18n.json
+    - dialogs_fr.i18n.json
+```
+
+**Interfaces**
+
+Create common super classes for different nodes. This allows for more type safety. Instead of `List<dynamic>`, we can have `List<PageData>`
+
+```json
+{
+  "pages": [
+    {
+      "title": "E2E encryption",
+      "content": "Your data is safe!"
+    },
+    {
+      "title": "Sync",
+      "content": "Synchronize all your devices!"
+    }
+  ]
+}
+```
+
+With the generated mixin:
+
+```dart
+mixin PageData {
+  String get title;
+  String get content;
+}
+```
+
+See updated README for further information about those features.
+
 ## 5.4.0
 
 - feat: add default plural resolvers for Spanish, French and Italian (Thanks to @SimoneBressan)

README.md

@@ -70,7 +70,7 @@ It is recommended to add `fast_i18n` to `dev_dependencies`.
 ```yaml
 dev_dependencies:
   build_runner: any
-  fast_i18n: 5.4.0
+  fast_i18n: 5.5.0
 ```
 
 **Step 2: Create JSON files**
@@ -322,6 +322,20 @@ i18n/
 - dialogs_fr.i18n.json
 ```
 
+You can also use different folders. Only file names matters!
+
+```
+i18n/
+  widgets/
+    - widgets.i18n.json
+    - widgets_fr.i18n.json
+  dialogs/
+    - dialogs.i18n.json
+    - dialogs_fr.i18n.json
+```
+
+Now access the translations:
+
 ```dart
 // t.<namespace>.<path>
 String a = t.widgets.welcomeCard.title;
@@ -432,8 +446,8 @@ Often, multiple maps have the same structure. You can create a common super clas
 ```
 
 Here we know that all objects inside `whatsNew` have the same attributes.
-We also know that `firstPage` and all children in `pages` have common attributes.
-Let's create 2 interface `PageData` and `NewsData`.
+We also know that `firstPage` and all children of `pages` have common attributes.
+Let's create 2 interfaces `PageData` and `NewsData`.
 
 ```yaml
 # File: build.yaml
@@ -488,15 +502,15 @@ mixin PageData {
 
 Config|Type|Description
 ---|---|---
-`paths`|`List<String>`|List of paths, this interface will be applied; `.*` is allowed at the end
+`paths`|`List<String>`|List of paths; Use `.*` to target all children of a node (non-recursive)
 `attributes`|`List<String>`|List of attributes
 
 Mode|Description
 ---|---
 single path|Syntax: `<interface>: <path>`; attributes will be detected automatically
 `paths` only|For multiple nodes; Attributes will be detected automatically
 `attributes` only|All nodes satisfying `attributes` will get the interface.
-both|Specified nodes will get the interface containing the specified attributes
+both|Specified nodes will get the interface with the specified attributes
 
 ### ➤ Locale Enum
 

pubspec.lock

@@ -135,7 +135,7 @@ packages:
     source: hosted
     version: "4.0.0"
   collection:
-    dependency: transitive
+    dependency: "direct main"
     description:
       name: collection
       url: "https://pub.dartlang.org"

pubspec.yaml

@@ -1,6 +1,6 @@
 name: fast_i18n
 description: Localization / Internationalization (i18n) solution. Use JSON or YAML files to create typesafe translations via source generation.
-version: 5.4.0
+version: 5.5.0
 homepage: https://github.com/Tienisto/flutter-fast-i18n
 publish_to: https://pub.dev
 
@@ -11,6 +11,7 @@ dependencies:
   flutter:
     sdk: flutter
   build: ^2.1.1
+  collection: ^1.15.0
   glob: ^2.0.2
   yaml: ^3.1.0