test: generate gherkin test relevant to configure

.gitignore

@@ -122,3 +122,4 @@ docs/.*
 .vscode/tasks.json
 .vscode/launch.json
 devtools_options.yaml
+test/features/*_test.dart

build.yaml

@@ -6,6 +6,6 @@ targets:
       - lib/**
       - $package$
     builders:
-      pdf_signature|prune_unused_steps:
+      pdf_signature:
         generate_for:
           - test/features/**

test/features/app_preferences.feature

@@ -0,0 +1,61 @@
+Feature: App preferences
+
+  As a user
+  I want to configure app preferences such as theme and language
+  So that the app matches my personal and regional needs, and remembers them next time
+
+  Scenario Outline: Choose a theme and apply it immediately
+    Given the settings screen is open
+    When the user selects the "<theme>" theme
+    Then the app UI updates to use the "<theme>" theme
+    And the preference {theme} is saved as {"<theme>"}
+
+    Examples:
+      | theme  |
+      | light  |
+      | dark   |
+      | system |
+
+  Scenario Outline: Choose a language and apply it immediately
+    Given the settings screen is open
+    When the user selects a supported language "<language>"
+    Then all visible texts are displayed in "<language>"
+    And the preference {language} is saved as {"<language>"}
+
+    Examples:
+      | language |
+      | en       |
+      | zh-TW    |
+      | es       |
+
+  Scenario Outline: Remember preferences across app restarts
+    Given the user previously set theme {"<theme>"} and language {"<language>"}
+    When the app launches
+    Then the app UI theme is {"<theme>"}
+    And the app language is {"<language>"}
+
+    Examples:
+      | theme  | language |
+      | dark   | en       |
+      | light  | zh-TW    |
+      | system | es       |
+
+  Scenario: Follow system appearance when theme is set to system
+    Given the user selects the "system" theme
+    And the OS appearance switches to dark mode
+    When the app is resumed or returns to foreground
+    Then the app UI updates to use the "dark" theme
+
+  Scenario: Reset preferences to defaults
+    Given the user has theme {"dark"} and language {"es"} saved
+    When the user taps "Reset to defaults"
+    Then the theme is set to {"system"}
+    And the language is set to the device locale
+    And both preferences are saved
+
+  Scenario: Ignore invalid stored values and fall back safely
+    Given stored preferences contain theme {"sepia"} and language {"xx"}
+    When the app launches
+    Then the theme falls back to {"system"}
+    And the language falls back to the device locale
+    And invalid values are replaced with valid defaults in storage

test/features/step/all_visible_texts_are_displayed_in.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: all visible texts are displayed in "<language>"
+Future<void> allVisibleTextsAreDisplayedIn(
+    WidgetTester tester, dynamic language) async {
+  throw UnimplementedError();
+}

test/features/step/both_preferences_are_saved.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: both preferences are saved
+Future<void> bothPreferencesAreSaved(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/invalid_values_are_replaced_with_valid_defaults_in_storage.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: invalid values are replaced with valid defaults in storage
+Future<void> invalidValuesAreReplacedWithValidDefaultsInStorage(
+    WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/stored_preferences_contain_theme_and_language.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: stored preferences contain theme {"sepia"} and language {"xx"}
+Future<void> storedPreferencesContainThemeAndLanguage(
+    WidgetTester tester, String param1, String param2) async {
+  throw UnimplementedError();
+}

test/features/step/the_app_is_resumed_or_returns_to_foreground.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the app is resumed or returns to foreground
+Future<void> theAppIsResumedOrReturnsToForeground(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/the_app_language_is.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the app language is {"<language>"}
+Future<void> theAppLanguageIs(
+    WidgetTester tester, String param1, dynamic language) async {
+  throw UnimplementedError();
+}

test/features/step/the_app_launches.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the app launches
+Future<void> theAppLaunches(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/the_app_ui_theme_is.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the app UI theme is {"<theme>"}
+Future<void> theAppUiThemeIs(
+    WidgetTester tester, String param1, dynamic theme) async {
+  throw UnimplementedError();
+}

test/features/step/the_app_ui_updates_to_use_the_dark_theme.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the app UI updates to use the "dark" theme
+Future<void> theAppUiUpdatesToUseTheDarkTheme(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/the_app_ui_updates_to_use_the_theme.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the app UI updates to use the "<theme>" theme
+Future<void> theAppUiUpdatesToUseTheTheme(
+    WidgetTester tester, dynamic theme) async {
+  throw UnimplementedError();
+}

test/features/step/the_language_falls_back_to_the_device_locale.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the language falls back to the device locale
+Future<void> theLanguageFallsBackToTheDeviceLocale(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/the_language_is_set_to_the_device_locale.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the language is set to the device locale
+Future<void> theLanguageIsSetToTheDeviceLocale(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/the_os_appearance_switches_to_dark_mode.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the OS appearance switches to dark mode
+Future<void> theOsAppearanceSwitchesToDarkMode(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/the_preference_is_saved_as.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the preference {language} is saved as {"<language>"}
+Future<void> thePreferenceIsSavedAs(WidgetTester tester, dynamic param1,
+    String param2, dynamic language) async {
+  throw UnimplementedError();
+}

test/features/step/the_settings_screen_is_open.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the settings screen is open
+Future<void> theSettingsScreenIsOpen(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/the_theme_falls_back_to.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the theme falls back to {"system"}
+Future<void> theThemeFallsBackTo(WidgetTester tester, String param1) async {
+  throw UnimplementedError();
+}

test/features/step/the_theme_is_set_to.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the theme is set to {"system"}
+Future<void> theThemeIsSetTo(WidgetTester tester, String param1) async {
+  throw UnimplementedError();
+}

test/features/step/the_user_has_theme_and_language_saved.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the user has theme {"dark"} and language {"es"} saved
+Future<void> theUserHasThemeAndLanguageSaved(
+    WidgetTester tester, String param1, String param2) async {
+  throw UnimplementedError();
+}

test/features/step/the_user_previously_set_theme_and_language.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the user previously set theme {"<theme>"} and language {"<language>"}
+Future<void> theUserPreviouslySetThemeAndLanguage(WidgetTester tester,
+    String param1, String param2, dynamic theme, dynamic language) async {
+  throw UnimplementedError();
+}

test/features/step/the_user_selects_a_supported_language.dart

@@ -0,0 +1,7 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the user selects a supported language "<language>"
+Future<void> theUserSelectsASupportedLanguage(
+    WidgetTester tester, dynamic language) async {
+  throw UnimplementedError();
+}

test/features/step/the_user_selects_the_system_theme.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the user selects the "system" theme
+Future<void> theUserSelectsTheSystemTheme(WidgetTester tester) async {
+  throw UnimplementedError();
+}

test/features/step/the_user_selects_the_theme.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the user selects the "<theme>" theme
+Future<void> theUserSelectsTheTheme(WidgetTester tester, dynamic theme) async {
+  throw UnimplementedError();
+}

test/features/step/the_user_taps_reset_to_defaults.dart

@@ -0,0 +1,6 @@
+import 'package:flutter_test/flutter_test.dart';
+
+/// Usage: the user taps "Reset to defaults"
+Future<void> theUserTapsResetToDefaults(WidgetTester tester) async {
+  throw UnimplementedError();
+}