Async input

.fvm/fvm_config.json

@@ -1,4 +1,3 @@
 {
-  "flutterSdkVersion": "3.13.3",
-  "flavors": {}
+  "flutterSdkVersion": "3.13.3"
 }

.fvm/release

@@ -0,0 +1 @@
+3.13.3

.fvm/version

@@ -0,0 +1 @@
+3.13.3

.fvm/versions/3.13.3

@@ -0,0 +1 @@
+C:/Users/nymsa/fvm/versions/3.13.3

.fvmrc

@@ -0,0 +1,3 @@
+{
+  "flutter": "3.13.3"
+}

.github/workflows/ci.yaml

@@ -11,7 +11,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Configure FVM
-        uses: kuhnroyal/flutter-fvm-config-action@v1
+        uses: kuhnroyal/flutter-fvm-config-action@v2
         id: fvm-config-action
         with:
           path: ".fvm/fvm_config.json"

.github/workflows/storybook.yaml

@@ -36,7 +36,7 @@ jobs:
       - uses: actions/checkout@v4
 
       - name: Configure FVM
-        uses: kuhnroyal/flutter-fvm-config-action@v1
+        uses: kuhnroyal/flutter-fvm-config-action@v2
         with:
           path: ".fvm/fvm_config.json"
 
@@ -57,14 +57,14 @@ jobs:
         run: flutter build web --base-href "/glade_forms/"
 
       - name: Setup Pages
-        uses: actions/configure-pages@v3
+        uses: actions/configure-pages@v4
 
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v2
+        uses: actions/upload-pages-artifact@v3
         with:
           # Upload entire repository
           path: "storybook/build/web/"
 
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v2
+        uses: actions/deploy-pages@v4

.gitignore

@@ -6,6 +6,7 @@
 melos_my_project.iml
 .vscode/*
 !.vscode/tasks.json
+!.vscode/launch.json
 !.vscode/settings.json
 
 .packages

.vscode/launch.json

@@ -0,0 +1,22 @@
+{
+  // Use IntelliSense to learn about possible attributes.
+  // Hover to view descriptions of existing attributes.
+  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "storybook",
+      "cwd": "storybook",
+      "request": "launch",
+      "type": "dart",
+      "program": "lib/main.dart"
+    },
+    {
+      "name": "storybook (profile)",
+      "cwd": "storybook",
+      "request": "launch",
+      "type": "dart",
+      "flutterMode": "profile"
+    }
+  ]
+}

.vscode/settings.json

@@ -1,4 +1,5 @@
 {
-    "dart.flutterSdkPath": ".fvm/flutter_sdk",
-    "dart.lineLength": 120,
+  "dart.flutterSdkPath": ".fvm\\versions\\3.13.3",
+  "dart.lineLength": 120,
+  "yaml.schemaStore.enable": false
 }

TODO.md

@@ -0,0 +1,10 @@
+GladeModel = sync verze
+    - Pouze SYNC inputy
+    - Podpora default TextFieldu
+AsyncGladeModel
+    - ASYNC inicializace
+    - SYNC i ASYNC inputy
+    - Podpora pro GladeAsyncTextField
+    - Validace async
+    - IsValid async
+    - Translate async

glade_forms/README.md

@@ -26,6 +26,7 @@ A universal way to define form validators with support of translations.
     - [Edit multiple inputs at once](#edit-multiple-inputs-at-once)
   - [Dependencies](#dependencies)
   - [Controlling other inputs](#controlling-other-inputs)
+  - [Asynchronous form](#asynchronous-form)
   - [Translation](#translation)
   - [Converters](#converters)
   - [Debugging](#debugging)
@@ -73,7 +74,7 @@ Then use `GladeFormBuilder`
 and connect the model to standard Flutter form and it's inputs like this:
 
 ```dart
-GladeFormBuilder(
+GladeFormBuilder.create(
   create: (context) => _Model(),
   builder: (context, model) => Form(
     autovalidateMode: AutovalidateMode.onUserInteraction,
@@ -312,6 +313,103 @@ onChange: (info, dependencies) {
 
 ![two-way-inputs-example](https://raw.githubusercontent.com/netglade/glade_forms/main/glade_forms/doc/two-way-dependencies.gif)
 
+### Asynchronous form
+
+When the default data for the form are for example fetched from external API you can use `GladeModelAsync` like this:
+
+```dart
+Future<String> _fetchName() {
+  return Future.delayed(const Duration(seconds: 2), () => 'John Doe');
+}
+class _Model extends GladeModelAsync {
+  late StringInput name;
+  late GladeInput<int> age;
+  late StringInput email;
+  late GladeInput<bool> vip;
+  @override
+  List<GladeInput<Object?>> get inputs => [name, age, email, vip];
+  _Model();
+  @override
+  Future<void> initializeAsync() async {
+    final nameValue = await _fetchName();
+    name = GladeInput.stringInput(inputKey: 'name', value: nameValue);
+    age = GladeInput.intInput(value: 0, inputKey: 'age');
+    email = GladeInput.stringInput(validator: (validator) => (validator..isEmail()).build(), inputKey: 'email');
+    vip = GladeInput.create(
+      validator: (v) => (v..notNull()).build(),
+      value: false,
+      inputKey: 'vip',
+      dependencies: () => [name],
+      onChangeAsync: (info, dependencies) async {
+        final nameInput = dependencies.byKey<String?>('name');
+        final fetchedName = await _fetchName();
+        groupEdit(() {
+          nameInput.value = fetchedName;
+        });
+      },
+    );
+    await super.initializeAsync();
+  }
+}
+```
+
+Then use `GladeFormBuilder` and connect the model to standard Flutter form and it's inputs like this:
+
+```dart
+GladeFormBuilder.create(
+  create: (context) => _Model(),
+  builder: (context, model, _) => Padding(
+    padding: const EdgeInsets.all(32),
+    child: Form(
+      autovalidateMode: AutovalidateMode.onUserInteraction,
+      child: Column(
+        children: [
+          if (model.isChanging) const LinearProgressIndicator(color: Colors.red, backgroundColor: Colors.grey),
+          TextFormField(
+            controller: model.name.controller,
+            validator: model.name.textFormFieldInputValidator,
+            onChanged: model.name.updateValueWithString,
+            decoration: const InputDecoration(labelText: 'Name'),
+            readOnly: model.isChanging,
+          ),
+          TextFormField(
+            controller: model.age.controller,
+            validator: model.age.textFormFieldInputValidator,
+            onChanged: model.age.updateValueWithString,
+            decoration: const InputDecoration(labelText: 'Age'),
+            readOnly: model.isChanging,
+          ),
+          TextFormField(
+            controller: model.email.controller,
+            validator: model.email.textFormFieldInputValidator,
+            onChanged: model.email.updateValueWithString,
+            decoration: const InputDecoration(labelText: 'Email'),
+            readOnly: model.isChanging,
+          ),
+          CheckboxListTile(
+            value: model.vip.value,
+            title: Row(
+              children: [
+                const Text('VIP Content '),
+                if (model.isChanging) const Text('isChanging', style: TextStyle(color: Colors.red)),
+              ],
+            ),
+            onChanged: (v) => model.vip.value = v ?? false,
+          ),
+          const SizedBox(height: 10),
+          ElevatedButton(
+            onPressed: model.isValid
+                ? () => ScaffoldMessenger.of(context).showSnackBar(const SnackBar(content: Text('Saved')))
+                : null,
+            child: const Text('Save'),
+          ),
+        ],
+      ),
+    ),
+  ),
+),
+```
+
 ### Translation
 
 Each validation error (and conversion error if any) can be translated. Provide `translateError` function which accepts:

glade_forms/analysis_options.yaml

@@ -3,5 +3,7 @@ include: package:netglade_analysis/lints.yaml
 dart_code_metrics:
   extends:
     - package:netglade_analysis/dcm.yaml
+  rules:
+    - prefer-correct-callback-field-name: false
   pubspec-rules:
     prefer-publish-to-none: false