feat(cat-voices): TokenField and DocumentTokenValueTile

catalyst_voices/apps/voices/lib/widgets/document_builder/document_token_value_widget.dart

@@ -0,0 +1,107 @@
+import 'package:catalyst_voices/widgets/text_field/token_field.dart';
+import 'package:catalyst_voices/widgets/text_field/voices_int_field.dart';
+import 'package:catalyst_voices_models/catalyst_voices_models.dart';
+import 'package:catalyst_voices_shared/catalyst_voices_shared.dart';
+import 'package:flutter/material.dart';
+
+class DocumentTokenValueWidget extends StatefulWidget {
+  final DocumentNodeId id;
+  final String label;
+  final int? value;
+  final Currency currency;
+  final Range<int>? range;
+  final bool isEditMode;
+  final bool isRequired;
+  final ValueChanged<DocumentChange> onChanged;
+
+  const DocumentTokenValueWidget({
+    super.key,
+    required this.id,
+    required this.label,
+    this.value,
+    required this.currency,
+    this.range,
+    this.isEditMode = false,
+    this.isRequired = true,
+    required this.onChanged,
+  });
+
+  @override
+  State<DocumentTokenValueWidget> createState() {
+    return _DocumentTokenValueWidgetState();
+  }
+}
+
+class _DocumentTokenValueWidgetState extends State<DocumentTokenValueWidget> {
+  late final VoicesIntFieldController _controller;
+  late final FocusNode _focusNode;
+
+  @override
+  void initState() {
+    super.initState();
+
+    _controller = VoicesIntFieldController(widget.value);
+    _controller.addListener(_handleControllerChange);
+    _focusNode = FocusNode(canRequestFocus: widget.isEditMode);
+  }
+
+  @override
+  void didUpdateWidget(covariant DocumentTokenValueWidget oldWidget) {
+    super.didUpdateWidget(oldWidget);
+
+    if (widget.value != oldWidget.value) {
+      _controller.value = widget.value;
+    }
+
+    if (widget.isEditMode != oldWidget.isEditMode) {
+      _handleEditModeChanged();
+    }
+  }
+
+  @override
+  void dispose() {
+    _controller.dispose();
+    _focusNode.dispose();
+    super.dispose();
+  }
+
+  @override
+  Widget build(BuildContext context) {
+    var label = widget.label;
+    if (widget.isRequired) {
+      label = '*$label';
+    }
+
+    return TokenField(
+      controller: _controller,
+      focusNode: _focusNode,
+      onFieldSubmitted: _notifyChangeListener,
+      labelText: label,
+      range: widget.range,
+      currency: widget.currency,
+      showHelper: widget.isEditMode,
+      readOnly: !widget.isEditMode,
+      ignorePointers: !widget.isEditMode,
+    );
+  }
+
+  void _handleControllerChange() {
+    final value = _controller.value;
+    _notifyChangeListener(value);
+  }
+
+  void _handleEditModeChanged() {
+    _focusNode.canRequestFocus = widget.isEditMode;
+
+    if (widget.isEditMode) {
+      _focusNode.requestFocus();
+    } else {
+      _focusNode.unfocus();
+    }
+  }
+
+  void _notifyChangeListener(int? value) {
+    final change = DocumentChange(nodeId: widget.id, value: value);
+    widget.onChanged(change);
+  }
+}

catalyst_voices/apps/voices/lib/widgets/text_field/token_field.dart

@@ -0,0 +1,118 @@
+import 'package:catalyst_voices/widgets/widgets.dart';
+import 'package:catalyst_voices_localization/catalyst_voices_localization.dart';
+import 'package:catalyst_voices_models/catalyst_voices_models.dart';
+import 'package:catalyst_voices_shared/catalyst_voices_shared.dart';
+import 'package:flutter/material.dart';
+
+class TokenField extends StatelessWidget {
+  final VoicesIntFieldController? controller;
+  final ValueChanged<int?>? onFieldSubmitted;
+  final ValueChanged<VoicesTextFieldStatus>? onStatusChanged;
+  final String? labelText;
+  final String? errorText;
+  final FocusNode? focusNode;
+  final Range<int>? range;
+  final Currency currency;
+  final bool showHelper;
+  final bool readOnly;
+  final bool? ignorePointers;
+
+  const TokenField({
+    super.key,
+    this.controller,
+    required this.onFieldSubmitted,
+    this.onStatusChanged,
+    this.labelText,
+    this.errorText,
+    this.focusNode,
+    this.range,
+    this.currency = const Currency.ada(),
+    this.showHelper = true,
+    this.readOnly = false,
+    this.ignorePointers,
+  }) : assert(
+          currency == const Currency.ada(),
+          'Only supports ADA at the moment',
+        );
+
+  @override
+  Widget build(BuildContext context) {
+    final range = this.range;
+
+    return VoicesIntField(
+      controller: controller,
+      focusNode: focusNode,
+      decoration: VoicesTextFieldDecoration(
+        labelText: labelText,
+        errorText: errorText,
+        prefixText: currency.symbol,
+        hintText: range != null ? '${range.min}' : null,
+        filled: true,
+        helper: range != null && showHelper
+            ? _Helper(
+                symbol: currency.symbol,
+                range: range,
+              )
+            : null,
+      ),
+      validator: (int? value, text) => _validate(context, value, text),
+      onStatusChanged: onStatusChanged,
+      onFieldSubmitted: onFieldSubmitted,
+      readOnly: readOnly,
+      ignorePointers: ignorePointers,
+    );
+  }
+
+  VoicesTextFieldValidationResult _validate(
+    BuildContext context,
+    int? value,
+    String text,
+  ) {
+    // Value could not be parsed into int.
+    if (value == null && text.isNotEmpty) {
+      final message = context.l10n.errorValidationTokenNotParsed;
+      return VoicesTextFieldValidationResult.error(message);
+    }
+
+    if (value != null && !(range?.contains(value) ?? true)) {
+      // Do not append any text
+      return const VoicesTextFieldValidationResult.error();
+    }
+
+    return const VoicesTextFieldValidationResult.none();
+  }
+}
+
+class _Helper extends StatelessWidget {
+  final String symbol;
+  final Range<int> range;
+
+  const _Helper({
+    required this.symbol,
+    required this.range,
+  });
+
+  @override
+  Widget build(BuildContext context) {
+    // TODO(damian-molinski): Refactor text formatting with smarter syntax
+    return Text.rich(
+      TextSpan(
+        children: [
+          TextSpan(text: context.l10n.requestedAmountShouldBeBetween),
+          const TextSpan(text: ' '),
+          TextSpan(
+            text: '$symbol${range.min}',
+            style: const TextStyle(fontWeight: FontWeight.bold),
+          ),
+          const TextSpan(text: ' '),
+          TextSpan(text: context.l10n.and),
+          const TextSpan(text: ' '),
+          TextSpan(
+            text: '$symbol${range.max}',
+            style: const TextStyle(fontWeight: FontWeight.bold),
+          ),
+        ],
+      ),
+    );
+  }
+}

catalyst_voices/apps/voices/lib/widgets/text_field/voices_int_field.dart

@@ -0,0 +1,35 @@
+import 'package:catalyst_voices/widgets/text_field/voices_num_field.dart';
+import 'package:catalyst_voices_shared/catalyst_voices_shared.dart';
+import 'package:flutter/foundation.dart';
+import 'package:flutter/services.dart';
+
+class VoicesIntFieldController extends VoicesNumFieldController<int> {
+  VoicesIntFieldController([super.value]);
+}
+
+class VoicesIntField extends VoicesNumField<int> {
+  VoicesIntField({
+    super.key,
+    VoicesIntFieldController? super.controller,
+    super.focusNode,
+    super.decoration,
+    super.onChanged,
+    super.validator,
+    super.onStatusChanged,
+    required super.onFieldSubmitted,
+    List<TextInputFormatter>? inputFormatters,
+    super.enabled,
+    super.readOnly,
+    super.ignorePointers,
+  }) : super(
+          codec: const IntCodec(),
+          keyboardType: TextInputType.number,
+          inputFormatters: [
+            FilteringTextInputFormatter.digitsOnly,
+            // Note. int.parse returns incorrect values for bigger Strings.
+            // If more is required use BigInt
+            if (kIsWeb) LengthLimitingTextInputFormatter(16),
+            ...?inputFormatters,
+          ],
+        );
+}