بناء عناصر FormField مخصصة

// يستقبل الباني حالة FormFieldState الحية ويُعيد Widget.
// field.value        — القيمة الحالية من النوع T
// field.errorText    — null إذا كان صالحاً، سلسلة نصية إذا كان غير صالح
// field.didChange(newValue) — استدعِها لتحديث القيمة وإطلاق إعادة البناء
Widget Function(FormFieldState<T> field)

class StarRatingFormField extends FormField<int> {
  StarRatingFormField({
    super.key,
    int initialValue = 0,
    super.onSaved,          // FormFieldSetter<int>? — يُستدعى بواسطة Form.save()
    super.validator,        // FormFieldValidator<int>? — يُستدعى بواسطة Form.validate()
    super.autovalidateMode,
  }) : super(
          initialValue: initialValue,
          builder: (FormFieldState<int> field) {
            return Column(
              crossAxisAlignment: CrossAxisAlignment.start,
              children: [
                Row(
                  mainAxisSize: MainAxisSize.min,
                  children: List.generate(5, (index) {
                    final starNumber = index + 1;
                    return IconButton(
                      icon: Icon(
                        starNumber <= (field.value ?? 0)
                            ? Icons.star
                            : Icons.star_border,
                        color: Colors.amber,
                      ),
                      onPressed: () => field.didChange(starNumber),
                    );
                  }),
                ),
                // عرض خطأ التحقق أسفل النجوم
                if (field.hasError)
                  Padding(
                    padding: const EdgeInsets.only(left: 12, top: 4),
                    child: Text(
                      field.errorText!,
                      style: TextStyle(
                        color: Theme.of(field.context).colorScheme.error,
                        fontSize: 12,
                      ),
                    ),
                  ),
              ],
            );
          },
        );
}

class ReviewForm extends StatefulWidget {
  const ReviewForm({super.key});

  @override
  State<ReviewForm> createState() => _ReviewFormState();
}

class _ReviewFormState extends State<ReviewForm> {
  final _formKey = GlobalKey<FormState>();
  int _savedRating = 0;

  void _submit() {
    if (_formKey.currentState!.validate()) {
      _formKey.currentState!.save();
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('التقييم المحفوظ: $_savedRating نجوم')),
      );
    }
  }

  @override
  Widget build(BuildContext context) {
    return Form(
      key: _formKey,
      child: Column(
        crossAxisAlignment: CrossAxisAlignment.start,
        children: [
          const Text('قيّم هذا المنتج'),
          StarRatingFormField(
            validator: (value) {
              if (value == null || value == 0) {
                return 'الرجاء اختيار نجمة واحدة على الأقل.';
              }
              return null; // صالح
            },
            onSaved: (value) => _savedRating = value ?? 0,
          ),
          const SizedBox(height: 16),
          ElevatedButton(
            onPressed: _submit,
            child: const Text('إرسال'),
          ),
        ],
      ),
    );
  }
}