feat(cat-voices): parse missing document properties, add validation

catalyst_voices/apps/voices/lib/common/ext/document_property_schema_ext.dart

@@ -0,0 +1,10 @@
+import 'package:catalyst_voices/common/ext/string_ext.dart';
+import 'package:catalyst_voices_models/catalyst_voices_models.dart';
+
+extension DocumentPropertySchemaExt on DocumentPropertySchema {
+  // TODO(dtscalac): convert to markdown
+  String get formattedDescription {
+    final string = description?.data;
+    return (string ?? '').starred(isEnabled: isRequired);
+  }
+}

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

@@ -5,21 +5,15 @@ import 'package:catalyst_voices_models/catalyst_voices_models.dart';
 import 'package:flutter/material.dart';
 
 class AgreementConfirmationWidget extends StatefulWidget {
-  final bool? value;
-  final AgreementConfirmationDefinition definition;
-  final DocumentNodeId nodeId;
-  final String description;
-  final String title;
+  final DocumentValueProperty<bool> property;
+  final DocumentAgreementConfirmationSchema schema;
   final bool isEditMode;
   final ValueChanged<DocumentChange> onChanged;
 
   const AgreementConfirmationWidget({
     super.key,
-    required this.value,
-    required this.definition,
-    required this.nodeId,
-    required this.description,
-    required this.title,
+    required this.property,
+    required this.schema,
     required this.isEditMode,
     required this.onChanged,
   });
@@ -34,11 +28,12 @@ class _DocumentCheckboxBuilderWidgetState
   late bool _initialValue;
   late bool _currentEditValue;
 
-  DocumentNodeId get _nodeId => widget.nodeId;
+  DocumentNodeId get _nodeId => widget.schema.nodeId;
 
-  MarkdownData get _description => MarkdownData(widget.description);
+  MarkdownData get _description =>
+      widget.schema.description ?? MarkdownData.empty;
 
-  bool get _defaultValue => widget.definition.defaultValue;
+  bool get _defaultValue => widget.schema.defaultValue ?? false;
 
   @override
   void initState() {
@@ -55,7 +50,7 @@ class _DocumentCheckboxBuilderWidgetState
       _currentEditValue = _initialValue;
     }
 
-    if (oldWidget.value != widget.value) {
+    if (oldWidget.property.value != widget.property.value) {
       _setInitialValues();
     }
   }
@@ -96,15 +91,15 @@ class _DocumentCheckboxBuilderWidgetState
     });
 
     widget.onChanged(
-      DocumentChange(
+      DocumentValueChange(
         nodeId: _nodeId,
         value: _currentEditValue,
       ),
     );
   }
 
   void _setInitialValues() {
-    _initialValue = widget.value ?? _defaultValue;
+    _initialValue = widget.property.value ?? _defaultValue;
     _currentEditValue = _initialValue;
   }
 }

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

@@ -7,16 +7,18 @@ import 'package:catalyst_voices_view_models/catalyst_voices_view_models.dart';
 import 'package:flutter/material.dart';
 
 class DocumentTokenValueWidget extends StatefulWidget {
-  final DocumentProperty<int> property;
+  final DocumentValueProperty<int> property;
+  final DocumentIntegerSchema schema;
   final Currency currency;
   final bool isEditMode;
   final ValueChanged<DocumentChange> onChanged;
 
   const DocumentTokenValueWidget({
     super.key,
     required this.property,
+    required this.schema,
     required this.currency,
-    this.isEditMode = false,
+    required this.isEditMode,
     required this.onChanged,
   });
 
@@ -61,8 +63,8 @@ class _DocumentTokenValueWidgetState extends State<DocumentTokenValueWidget> {
 
   @override
   Widget build(BuildContext context) {
-    final schema = widget.property.schema;
-    final label = schema.title ?? '';
+    final schema = widget.schema;
+    final label = schema.title;
 
     return TokenField(
       controller: _controller,
@@ -94,17 +96,16 @@ class _DocumentTokenValueWidgetState extends State<DocumentTokenValueWidget> {
   }
 
   void _notifyChangeListener(int? value) {
-    final change = DocumentChange(
-      nodeId: widget.property.schema.nodeId,
+    final change = DocumentValueChange(
+      nodeId: widget.schema.nodeId,
       value: value,
     );
 
     widget.onChanged(change);
   }
 
   VoicesTextFieldValidationResult _validate(int? value, String text) {
-    final schema = widget.property.schema;
-    final result = schema.validatePropertyValue(value);
+    final result = widget.schema.validate(value);
     if (result.isValid) {
       return const VoicesTextFieldValidationResult.none();
     } else {

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

@@ -1,24 +1,24 @@
 import 'dart:async';
 
 import 'package:catalyst_voices/common/codecs/markdown_codec.dart';
-import 'package:catalyst_voices/common/ext/document_property_ext.dart';
+import 'package:catalyst_voices/common/ext/document_property_schema_ext.dart';
 import 'package:catalyst_voices/widgets/rich_text/voices_rich_text.dart';
 import 'package:catalyst_voices_models/catalyst_voices_models.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_quill/flutter_quill.dart' as quill;
 
 class MultilineTextEntryMarkdownWidget extends StatefulWidget {
-  final DocumentProperty<String> property;
+  final DocumentValueProperty<String> property;
+  final DocumentMultiLineTextEntryMarkdownSchema schema;
   final ValueChanged<DocumentChange> onChanged;
   final bool isEditMode;
-  final bool isRequired;
 
   const MultilineTextEntryMarkdownWidget({
     super.key,
     required this.property,
+    required this.schema,
     required this.onChanged,
     required this.isEditMode,
-    required this.isRequired,
   });
 
   @override
@@ -36,15 +36,14 @@ class _MultilineTextEntryMarkdownWidgetState
   StreamSubscription<quill.DocChange>? _documentChangeSub;
   quill.Document? _preEditDocument;
 
-  String get _description => widget.property.formattedDescription;
-  int? get _maxLength => widget.property.schema.strLengthRange?.max;
-  String? get _value => widget.property.value;
+  String get _description => widget.schema.formattedDescription;
+  int? get _maxLength => widget.schema.strLengthRange?.max;
 
   @override
   void initState() {
     super.initState();
 
-    _controller = _buildController(value: _value);
+    _controller = _buildController(value: widget.property.value);
     _controller.addListener(_onControllerChanged);
 
     _focus = VoicesRichTextFocusNode();
@@ -63,7 +62,7 @@ class _MultilineTextEntryMarkdownWidgetState
 
     if (widget.property.value != oldWidget.property.value) {
       _controller.dispose();
-      _controller = _buildController(value: _value);
+      _controller = _buildController(value: widget.property.value);
       _controller.addListener(_onControllerChanged);
     }
   }
@@ -134,8 +133,8 @@ class _MultilineTextEntryMarkdownWidgetState
     final delta = _controller.document.toDelta();
     final markdownData = markdown.decoder.convert(delta);
     widget.onChanged(
-      DocumentChange(
-        nodeId: widget.property.schema.nodeId,
+      DocumentValueChange(
+        nodeId: widget.schema.nodeId,
         value: markdownData.data,
       ),
     );

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

@@ -1,18 +1,20 @@
-import 'package:catalyst_voices/common/ext/document_property_ext.dart';
+import 'package:catalyst_voices/common/ext/document_property_schema_ext.dart';
 import 'package:catalyst_voices/widgets/widgets.dart';
 import 'package:catalyst_voices_models/catalyst_voices_models.dart';
 import 'package:catalyst_voices_view_models/catalyst_voices_view_models.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
 
 class SimpleTextEntryWidget extends StatefulWidget {
-  final DocumentProperty<String> property;
+  final DocumentValueProperty<String> property;
+  final DocumentStringSchema schema;
   final bool isEditMode;
   final ValueChanged<DocumentChange> onChanged;
 
   const SimpleTextEntryWidget({
     super.key,
     required this.property,
+    required this.schema,
     required this.isEditMode,
     required this.onChanged,
   });
@@ -25,10 +27,9 @@ class _SimpleTextEntryWidgetState extends State<SimpleTextEntryWidget> {
   late final TextEditingController _controller;
   late final FocusNode _focusNode;
 
-  String get _description => widget.property.formattedDescription;
-  int? get _maxLength => widget.property.schema.strLengthRange?.max;
-  bool get _resizable =>
-      widget.property.schema.definition is MultiLineTextEntryDefinition;
+  String get _description => widget.schema.formattedDescription;
+  int? get _maxLength => widget.schema.strLengthRange?.max;
+  bool get _resizable => widget.schema is DocumentMultiLineTextEntrySchema;
 
   @override
   void initState() {
@@ -81,7 +82,7 @@ class _SimpleTextEntryWidgetState extends State<SimpleTextEntryWidget> {
           validator: _validate,
           enabled: widget.isEditMode,
           // TODO(LynxLynxx): check if this is right after schema is finalized
-          hintText: widget.property.schema.defaultValue,
+          hintText: widget.schema.defaultValue,
           resizable: _resizable,
           maxLength: _maxLength,
         ),
@@ -108,8 +109,8 @@ class _SimpleTextEntryWidgetState extends State<SimpleTextEntryWidget> {
   }
 
   void _notifyChangeListener(String? value) {
-    final change = DocumentChange(
-      nodeId: widget.property.schema.nodeId,
+    final change = DocumentValueChange(
+      nodeId: widget.schema.nodeId,
       value: value,
     );
 
@@ -120,8 +121,8 @@ class _SimpleTextEntryWidgetState extends State<SimpleTextEntryWidget> {
     if (!widget.isEditMode) {
       return const VoicesTextFieldValidationResult.none();
     }
-    final schema = widget.property.schema;
-    final result = schema.validatePropertyValue(value);
+    final schema = widget.schema;
+    final result = schema.validate(value);
     if (result.isValid) {
       return const VoicesTextFieldValidationResult.none();
     } else {

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

@@ -5,22 +5,16 @@ import 'package:flutter/material.dart';
 class SingleDropdownSelectionWidget extends StatefulWidget {
   final String value;
   final List<String> items;
-  final DropDownSingleSelectDefinition definition;
-  final DocumentNodeId nodeId;
-  final String title;
+  final DocumentDropDownSingleSelectSchema schema;
   final bool isEditMode;
-  final bool isRequired;
   final ValueChanged<DocumentChange> onChanged;
 
   const SingleDropdownSelectionWidget({
     super.key,
     required this.value,
     required this.items,
-    required this.definition,
-    required this.nodeId,
-    required this.title,
+    required this.schema,
     required this.isEditMode,
-    required this.isRequired,
     required this.onChanged,
   });
 
@@ -76,7 +70,7 @@ class _SingleDropdownSelectionWidgetState
       crossAxisAlignment: CrossAxisAlignment.stretch,
       children: [
         Text(
-          widget.title,
+          widget.schema.title,
           style: Theme.of(context).textTheme.titleSmall,
         ),
         const SizedBox(height: 8),
@@ -85,7 +79,11 @@ class _SingleDropdownSelectionWidgetState
           items: _dropdownMenuEntries,
           enabled: widget.isEditMode,
           onSelected: (val) {
-            widget.onChanged(DocumentChange(nodeId: widget.nodeId, value: val));
+            final change = DocumentValueChange(
+              nodeId: widget.schema.nodeId,
+              value: val,
+            );
+            widget.onChanged(change);
           },
           initialValue: widget.value,
         ),

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

@@ -81,7 +81,8 @@ class _SingleGroupedTagSelectorWidgetState
     setState(() {
       _selection = value;
 
-      final change = DocumentChange(nodeId: widget.id, value: value);
+      // TODO(dtscalac): this should update children properties, not the parent
+      final change = DocumentValueChange(nodeId: widget.id, value: value);
       widget.onChanged(change);
     });
   }

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

@@ -1,18 +1,20 @@
-import 'package:catalyst_voices/common/ext/document_property_ext.dart';
+import 'package:catalyst_voices/common/ext/document_property_schema_ext.dart';
 import 'package:catalyst_voices/widgets/text_field/voices_https_text_field.dart';
 import 'package:catalyst_voices/widgets/widgets.dart';
 import 'package:catalyst_voices_models/catalyst_voices_models.dart';
 import 'package:catalyst_voices_view_models/catalyst_voices_view_models.dart';
 import 'package:flutter/material.dart';
 
 class SingleLineHttpsUrlWidget extends StatefulWidget {
-  final DocumentProperty<String> property;
+  final DocumentValueProperty<String> property;
+  final DocumentStringSchema schema;
   final bool isEditMode;
   final ValueChanged<DocumentChange> onChanged;
 
   const SingleLineHttpsUrlWidget({
     super.key,
     required this.property,
+    required this.schema,
     required this.isEditMode,
     required this.onChanged,
   });
@@ -26,7 +28,7 @@ class _SingleLineHttpsUrlWidgetState extends State<SingleLineHttpsUrlWidget> {
   late final TextEditingController _textEditingController;
   late final FocusNode _focusNode;
 
-  String get _description => widget.property.formattedDescription;
+  String get _description => widget.schema.formattedDescription;
 
   @override
   void initState() {
@@ -89,8 +91,8 @@ class _SingleLineHttpsUrlWidgetState extends State<SingleLineHttpsUrlWidget> {
   }
 
   void _notifyChangeListener(String? value) {
-    final change = DocumentChange(
-      nodeId: widget.property.schema.nodeId,
+    final change = DocumentValueChange(
+      nodeId: widget.schema.nodeId,
       value: value,
     );
 
@@ -101,8 +103,8 @@ class _SingleLineHttpsUrlWidgetState extends State<SingleLineHttpsUrlWidget> {
     if (value == null || value.isEmpty) {
       return const VoicesTextFieldValidationResult.none();
     }
-    final schema = widget.property.schema;
-    final result = schema.validatePropertyValue(value);
+    final schema = widget.schema;
+    final result = schema.validate(value);
     if (result.isValid) {
       return const VoicesTextFieldValidationResult.success();
     } else {