add alignment

Author: vu le

lib/framework/data_context.dart

@@ -445,14 +445,23 @@ class Formatter with Invokable {
       'prettyDateTime': (input) => InvokablePrimitive.prettyDateTime(input),
       'prettyCurrency': (input) => InvokablePrimitive.prettyCurrency(input),
       'prettyDuration': (input) =>
-          InvokablePrimitive.prettyDuration(input, locale: locale)
+          InvokablePrimitive.prettyDuration(input, locale: locale),
+      'pluralize': pluralize
     };
   }
 
   @override
   Map<String, Function> setters() {
     return {};
   }
+
+  String pluralize(String singularText, int? count, [pluralText]) {
+    count ??= 1;
+    if (count <= 1) {
+      return singularText;
+    }
+    return pluralText ?? '${singularText}s';
+  }
 }
 
 class UserInfo with Invokable {

lib/framework/widget/widget.dart

@@ -27,13 +27,22 @@ abstract class WidgetState<W extends HasController> extends BaseWidgetState<W> {
         return const SizedBox.shrink();
       }
       Widget rtn = buildWidget(context);
+
+      // wrap inside Align if specified
+      if ((widget.controller as WidgetController).alignToParent != null) {
+        rtn = Align(
+            alignment: (widget.controller as WidgetController).alignToParent!,
+            child: rtn);
+      }
+
       if ((widget.controller as WidgetController).expanded == true) {
         /// Important notes:
         /// 1. If the Column/Row is scrollable, putting Expanded on the child will cause layout exception
         /// 2. If Column/Row is inside a parent without height/width constraint, it will collapse its size.
         ///    So if we put Expanded on the Column's child, layout exception will occur
         rtn = Expanded(child: rtn);
       }
+
       return rtn;
     }
     throw LanguageError("Wrong usage of widget controller!");

lib/widget/helpers/controllers.dart

@@ -12,6 +12,9 @@ abstract class WidgetController extends Controller {
   bool visible = true;
   String? id; // do we need this?
 
+  // wrap widget inside an Align widget
+  Alignment? alignToParent;
+
   // optional label/labelHint for use in Forms
   String? label;
   String? description;
@@ -30,6 +33,7 @@ abstract class WidgetController extends Controller {
     return {
       'expanded': (value) => expanded = Utils.getBool(value, fallback: false),
       'visible': (value) => visible = Utils.getBool(value, fallback: true),
+      'alignToParent': (value) => alignToParent = Utils.getAlignment(value),
       'label': (value) => label = Utils.optionalString(value),
       'description': (value) => description = Utils.optionalString(value),
       'labelHint': (value) => labelHint = Utils.optionalString(value),