feat: 5430 - "producer provided" icon for nutrients and 4 product fields

packages/smooth_app/lib/generic_lib/widgets/smooth_text_form_field.dart

@@ -21,6 +21,7 @@ class SmoothTextFormField extends StatefulWidget {
     required this.hintText,
     this.hintTextFontSize,
     this.prefixIcon,
+    this.suffixIcon,
     this.textInputType,
     this.onChanged,
     this.onFieldSubmitted,
@@ -34,6 +35,7 @@ class SmoothTextFormField extends StatefulWidget {
   final TextEditingController? controller;
   final String hintText;
   final Widget? prefixIcon;
+  final Widget? suffixIcon;
   final bool? enabled;
   final TextInputAction? textInputAction;
   final String? Function(String?)? validator;
@@ -121,18 +123,19 @@ class _SmoothTextFormFieldState extends State<SmoothTextFormField> {
             width: 5.0,
           ),
         ),
-        suffixIcon: widget.type == TextFieldTypes.PASSWORD
-            ? IconButton(
-                tooltip: appLocalization.show_password,
-                splashRadius: 10.0,
-                onPressed: () => setState(() {
-                  _obscureText = !_obscureText;
-                }),
-                icon: _obscureText
-                    ? const Icon(Icons.visibility_off)
-                    : const Icon(Icons.visibility),
-              )
-            : null,
+        suffixIcon: widget.suffixIcon ??
+            (widget.type == TextFieldTypes.PASSWORD
+                ? IconButton(
+                    tooltip: appLocalization.show_password,
+                    splashRadius: 10.0,
+                    onPressed: () => setState(() {
+                      _obscureText = !_obscureText;
+                    }),
+                    icon: _obscureText
+                        ? const Icon(Icons.visibility_off)
+                        : const Icon(Icons.visibility),
+                  )
+                : null),
         errorMaxLines: 2,
       ),
     );

packages/smooth_app/lib/pages/input/smooth_autocomplete_text_field.dart

@@ -19,6 +19,7 @@ class SmoothAutocompleteTextField extends StatefulWidget {
     required this.manager,
     this.minLengthForSuggestions = 1,
     this.allowEmojis = true,
+    this.suffixIcon,
   });
 
   final FocusNode focusNode;
@@ -29,6 +30,7 @@ class SmoothAutocompleteTextField extends StatefulWidget {
   final int minLengthForSuggestions;
   final AutocompleteManager? manager;
   final bool allowEmojis;
+  final Widget? suffixIcon;
 
   @override
   State<SmoothAutocompleteTextField> createState() =>
@@ -82,6 +84,7 @@ class _SmoothAutocompleteTextFieldState
             FilteringTextInputFormatter.deny(TextHelper.emojiRegex),
         ],
         decoration: InputDecoration(
+          suffixIcon: widget.suffixIcon,
           filled: true,
           border: const OutlineInputBorder(
             borderRadius: ANGULAR_BORDER_RADIUS,

packages/smooth_app/lib/pages/product/add_basic_details_page.dart

@@ -18,6 +18,7 @@ import 'package:smooth_app/pages/product/common/product_buttons.dart';
 import 'package:smooth_app/pages/product/common/product_refresher.dart';
 import 'package:smooth_app/pages/product/may_exit_page_helper.dart';
 import 'package:smooth_app/pages/product/multilingual_helper.dart';
+import 'package:smooth_app/pages/product/owner_field_info.dart';
 import 'package:smooth_app/pages/text_field_helper.dart';
 import 'package:smooth_app/query/product_query.dart';
 import 'package:smooth_app/widgets/smooth_scaffold.dart';
@@ -99,7 +100,7 @@ class _AddBasicDetailsPageState extends State<AddBasicDetailsPage> {
           appBar: buildEditProductAppBar(
             context: context,
             title: appLocalizations.basic_details,
-            product: widget.product,
+            product: _product,
           ),
           body: Form(
             key: _formKey,
@@ -142,6 +143,9 @@ class _AddBasicDetailsPageState extends State<AddBasicDetailsPage> {
                               Widget? child) {
                             if (_multilingualHelper.isMonolingual()) {
                               return SmoothTextFormField(
+                                suffixIcon: _getOwnerFieldIcon(
+                                  ProductField.NAME,
+                                ),
                                 controller: _productNameController,
                                 type: TextFieldTypes.PLAIN_TEXT,
                                 hintText: appLocalizations.product_name,
@@ -164,6 +168,11 @@ class _AddBasicDetailsPageState extends State<AddBasicDetailsPage> {
                                     Padding(
                                       padding: const EdgeInsets.all(8.0),
                                       child: SmoothTextFormField(
+                                        suffixIcon: _getOwnerFieldIcon(
+                                          ProductField.NAME_IN_LANGUAGES,
+                                          language: _multilingualHelper
+                                              .getCurrentLanguage(),
+                                        ),
                                         controller: _productNameController,
                                         type: TextFieldTypes.PLAIN_TEXT,
                                         hintText: appLocalizations.product_name,
@@ -197,6 +206,9 @@ class _AddBasicDetailsPageState extends State<AddBasicDetailsPage> {
                             allowEmojis: false,
                             hintText: appLocalizations.brand_name,
                             constraints: constraints,
+                            suffixIcon: _getOwnerFieldIcon(
+                              ProductField.BRANDS,
+                            ),
                             manager: AutocompleteManager(
                               TaxonomyNameAutocompleter(
                                 taxonomyNames: <TaxonomyName>[
@@ -208,18 +220,26 @@ class _AddBasicDetailsPageState extends State<AddBasicDetailsPage> {
                                 limit: 25,
                                 fuzziness: Fuzziness.none,
                                 uriHelper: ProductQuery.getUriProductHelper(
-                                  productType: widget.product.productType,
+                                  productType: _product.productType,
                                 ),
                               ),
                             ),
                           ),
                         ),
                         SizedBox(height: _heightSpace),
                         SmoothTextFormField(
+                          suffixIcon: _getOwnerFieldIcon(
+                            ProductField.QUANTITY,
+                          ),
                           controller: _weightController,
                           type: TextFieldTypes.PLAIN_TEXT,
                           hintText: appLocalizations.quantity,
                         ),
+                        if (_hasOwnerField())
+                          const Padding(
+                            padding: EdgeInsets.only(top: LARGE_SPACE),
+                            child: Card(child: OwnerFieldInfo()),
+                          ),
                         // in order to be able to scroll suggestions
                         SizedBox(height: MediaQuery.sizeOf(context).height),
                       ],
@@ -332,4 +352,41 @@ class _AddBasicDetailsPageState extends State<AddBasicDetailsPage> {
     }
     return result;
   }
+
+  Widget? _getOwnerFieldIcon(
+    final ProductField productField, {
+    final OpenFoodFactsLanguage? language,
+  }) =>
+      _isOwnerField(productField, language: language)
+          ? const Icon(OwnerFieldInfo.ownerFieldIconData)
+          : null;
+
+  bool _hasOwnerField() {
+    if (_multilingualHelper.isMonolingual()) {
+      if (_isOwnerField(ProductField.NAME)) {
+        return true;
+      }
+    } else {
+      if (_isOwnerField(
+        ProductField.NAME_IN_LANGUAGES,
+        language: _multilingualHelper.getCurrentLanguage(),
+      )) {
+        return true;
+      }
+    }
+    return _isOwnerField(ProductField.BRANDS) ||
+        _isOwnerField(ProductField.QUANTITY);
+  }
+
+  bool _isOwnerField(
+    final ProductField productField, {
+    final OpenFoodFactsLanguage? language,
+  }) =>
+      _product.getOwnerFieldTimestamp(
+        OwnerField.productField(
+          productField,
+          language ?? ProductQuery.getLanguage(),
+        ),
+      ) !=
+      null;
 }

packages/smooth_app/lib/pages/product/nutrition_page_loaded.dart

@@ -20,8 +20,10 @@ import 'package:smooth_app/pages/product/may_exit_page_helper.dart';
 import 'package:smooth_app/pages/product/nutrition_add_nutrient_button.dart';
 import 'package:smooth_app/pages/product/nutrition_container.dart';
 import 'package:smooth_app/pages/product/ordered_nutrients_cache.dart';
+import 'package:smooth_app/pages/product/owner_field_info.dart';
 import 'package:smooth_app/pages/product/simple_input_number_field.dart';
 import 'package:smooth_app/pages/text_field_helper.dart';
+import 'package:smooth_app/query/product_query.dart';
 import 'package:smooth_app/widgets/smooth_scaffold.dart';
 import 'package:smooth_app/widgets/will_pop_scope.dart';
 
@@ -130,6 +132,9 @@ class _NutritionPageLoadedState extends State<NutritionPageLoaded>
     children.add(_switchNoNutrition(appLocalizations));
 
     if (!_nutritionContainer.noNutritionData) {
+      final Iterable<OrderedNutrient> displayableNutrients =
+          _nutritionContainer.getDisplayableNutrients();
+
       children.add(
         Padding(
           padding: const EdgeInsets.symmetric(vertical: MEDIUM_SPACE),
@@ -140,12 +145,13 @@ class _NutritionPageLoadedState extends State<NutritionPageLoaded>
           ),
         ),
       );
+      if (_hasOwnerField(displayableNutrients)) {
+        children.add(const OwnerFieldInfo());
+      }
+
       children.add(_getServingField(appLocalizations));
       children.add(_getServingSwitch(appLocalizations));
 
-      final Iterable<OrderedNutrient> displayableNutrients =
-          _nutritionContainer.getDisplayableNutrients();
-
       if (_focusNodes.length != displayableNutrients.length) {
         _focusNodes.clear();
         _focusNodes.addAll(
@@ -177,6 +183,7 @@ class _NutritionPageLoadedState extends State<NutritionPageLoaded>
               _decimalNumberFormat,
               orderedNutrient,
               i,
+              upToDateProduct,
             ),
           ),
         );
@@ -225,6 +232,30 @@ class _NutritionPageLoadedState extends State<NutritionPageLoaded>
     );
   }
 
+  bool _hasOwnerField(
+    final Iterable<OrderedNutrient> displayableNutrients,
+  ) {
+    if (upToDateProduct.getOwnerFieldTimestamp(
+          OwnerField.productField(
+            ProductField.SERVING_SIZE,
+            ProductQuery.getLanguage(),
+          ),
+        ) !=
+        null) {
+      return true;
+    }
+    for (final OrderedNutrient orderedNutrient in displayableNutrients) {
+      final Nutrient nutrient = _getNutrient(orderedNutrient);
+      if (upToDateProduct.getOwnerFieldTimestamp(
+            OwnerField.nutrient(nutrient),
+          ) !=
+          null) {
+        return true;
+      }
+    }
+    return false;
+  }
+
   Widget _getServingField(final AppLocalizations appLocalizations) {
     final String value = _nutritionContainer.servingSize;
 
@@ -245,6 +276,15 @@ class _NutritionPageLoadedState extends State<NutritionPageLoaded>
             decoration: InputDecoration(
               enabledBorder: const UnderlineInputBorder(),
               labelText: appLocalizations.nutrition_page_serving_size,
+              suffixIcon: widget.product.getOwnerFieldTimestamp(
+                        OwnerField.productField(
+                          ProductField.SERVING_SIZE,
+                          ProductQuery.getLanguage(),
+                        ),
+                      ) ==
+                      null
+                  ? null
+                  : const Icon(OwnerFieldInfo.ownerFieldIconData),
             ),
             textInputAction: TextInputAction.next,
             onFieldSubmitted: (_) {
@@ -442,12 +482,14 @@ class _NutrientRow extends StatelessWidget {
     this.decimalNumberFormat,
     this.orderedNutrient,
     this.position,
+    this.product,
   );
 
   final NutritionContainer nutritionContainer;
   final NumberFormat decimalNumberFormat;
   final OrderedNutrient orderedNutrient;
   final int position;
+  final Product product;
 
   @override
   Widget build(BuildContext context) {
@@ -465,6 +507,7 @@ class _NutrientRow extends StatelessWidget {
               decimalNumberFormat,
               orderedNutrient,
               position,
+              product,
             ),
           ),
         ),
@@ -492,11 +535,13 @@ class _NutrientValueCell extends StatelessWidget {
     this.decimalNumberFormat,
     this.orderedNutrient,
     this.position,
+    this.product,
   );
 
   final NumberFormat decimalNumberFormat;
   final OrderedNutrient orderedNutrient;
   final int position;
+  final Product product;
 
   @override
   Widget build(BuildContext context) {
@@ -507,6 +552,7 @@ class _NutrientValueCell extends StatelessWidget {
     final TextEditingControllerWithHistory controller =
         context.watch<TextEditingControllerWithHistory>();
     final bool isLast = position == focusNodes.length - 1;
+    final Nutrient? nutrient = orderedNutrient.nutrient;
 
     return TextFormField(
       controller: controller,
@@ -515,6 +561,11 @@ class _NutrientValueCell extends StatelessWidget {
       decoration: InputDecoration(
         enabledBorder: const UnderlineInputBorder(),
         labelText: orderedNutrient.name,
+        suffixIcon: nutrient == null ||
+                product.getOwnerFieldTimestamp(OwnerField.nutrient(nutrient)) ==
+                    null
+            ? null
+            : const Icon(OwnerFieldInfo.ownerFieldIconData),
       ),
       keyboardType: const TextInputType.numberWithOptions(
         signed: false,

packages/smooth_app/lib/pages/product/owner_field_info.dart

@@ -0,0 +1,24 @@
+import 'package:flutter/material.dart';
+
+/// Standard info tile about "owner fields".
+class OwnerFieldInfo extends StatelessWidget {
+  const OwnerFieldInfo({super.key});
+
+  /// Icon to display when the product field value is "producer provided".
+  static const IconData ownerFieldIconData = Icons.factory;
+
+  @override
+  Widget build(BuildContext context) {
+    final bool dark = Theme.of(context).brightness == Brightness.dark;
+    final Color? darkGrey = Colors.grey[700];
+    final Color? lightGrey = Colors.grey[300];
+    return ListTile(
+      tileColor: dark ? darkGrey : lightGrey,
+      leading: const Icon(ownerFieldIconData),
+      // TODO(monsieurtanuki): localize
+      title: const Text('Producer provided values'),
+      subtitle: const Text(
+          'With that logo we highlight data provided by the producer, and that may not be editable.'),
+    );
+  }
+}