Dynamic data 2 - Auto UI

ci/scripts/CopyBetweenNugetFeeds.ps1

@@ -23,6 +23,8 @@ $packages = @(
     [pscustomobject]@{ Package = "DotVVM.HotReload.Owin"; Directory = "Tools/HotReload/Owin"; Type = "standard" },
     [pscustomobject]@{ Package = "DotVVM.DynamicData"; Directory = "DynamicData/DynamicData"; Type = "standard" },
     [pscustomobject]@{ Package = "DotVVM.DynamicData.Annotations"; Directory = "DynamicData/Annotations"; Type = "standard" },
+    [pscustomobject]@{ Package = "DotVVM.AutoUI"; Directory = "AutoUI/Core"; Type = "standard" },
+    [pscustomobject]@{ Package = "DotVVM.AutoUI.Annotations"; Directory = "AutoUI/Annotations"; Type = "standard" },
     [pscustomobject]@{ Package = "DotVVM.Tracing.ApplicationInsights"; Directory = "Tracing/ApplicationInsights"; Type = "standard" },
     [pscustomobject]@{ Package = "DotVVM.Tracing.ApplicationInsights.AspNetCore"; Directory = "Tracing/ApplicationInsights.AspNetCore"; Type = "standard" },
     [pscustomobject]@{ Package = "DotVVM.Tracing.ApplicationInsights.Owin"; Directory = "Tracing/ApplicationInsights.Owin"; Type = "standard" }

ci/scripts/publish.ps1

@@ -155,6 +155,8 @@ $packages = @(
     [pscustomobject]@{ Package = "DotVVM.Testing"; Directory = "Framework/Testing" },
     [pscustomobject]@{ Package = "DotVVM.DynamicData"; Directory = "DynamicData/DynamicData" },
     [pscustomobject]@{ Package = "DotVVM.DynamicData.Annotations"; Directory = "DynamicData/Annotations" },
+    [pscustomobject]@{ Package = "DotVVM.AutoUI"; Directory = "AutoUI/Core" },
+    [pscustomobject]@{ Package = "DotVVM.AutoUI.Annotations"; Directory = "AutoUI/Annotations" },
     [pscustomobject]@{ Package = "DotVVM.Tracing.ApplicationInsights"; Directory = "Tracing/ApplicationInsights" },
     [pscustomobject]@{ Package = "DotVVM.Tracing.ApplicationInsights.AspNetCore"; Directory = "Tracing/ApplicationInsights.AspNetCore" },
     [pscustomobject]@{ Package = "DotVVM.Tracing.ApplicationInsights.Owin"; Directory = "Tracing/ApplicationInsights.Owin" }

src/AutoUI/Annotations/AuthenticationMode.cs

@@ -0,0 +1,8 @@
+namespace DotVVM.AutoUI.Annotations;
+
+public enum AuthenticationMode
+{
+    Any = 0,
+    Authenticated = 1,
+    NonAuthenticated = 2
+}

src/AutoUI/Annotations/ComboBoxSettingsAttribute.cs

@@ -0,0 +1,33 @@
+using System;
+
+namespace DotVVM.AutoUI.Annotations
+{
+    /// <summary>
+    /// Defines the settings for the ComboBox form editor provider.
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Property)]
+    public class ComboBoxSettingsAttribute : Attribute
+    {
+
+        /// <summary>
+        /// Gets or sets the name of the property to be displayed.
+        /// </summary>
+        public string DisplayMember { get; set; }
+
+        /// <summary>
+        /// Gets or sets the name of the property to be used as selected value.
+        /// </summary>
+        public string ValueMember { get; set; }
+
+        /// <summary>
+        /// Gets or sets the binding expression for the list of items.
+        /// </summary>
+        public string DataSourceBinding { get; set; }
+
+        /// <summary>
+        /// Gets or sets the text on the empty item. If null or empty, the empty item will not be included.
+        /// </summary>
+        public string EmptyItemText { get; set; }
+
+    }
+}

src/AutoUI/Annotations/DotVVM.AutoUI.Annotations.csproj

@@ -0,0 +1,24 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFrameworks>$(DefaultTargetFrameworks)</TargetFrameworks>
+    <AssemblyOriginatorKeyFile>dotvvmwizard.snk</AssemblyOriginatorKeyFile>
+    <SignAssembly>true</SignAssembly>
+    <PublicSign Condition=" '$(OS)' != 'Windows_NT' ">true</PublicSign>
+    <PackageId>DotVVM.AutoUI.Annotations</PackageId>
+    <Description>Annotation attributes for DotVVM AutoUI.</Description>
+    <PackageProjectUrl>https://www.dotvvm.com/docs/3.0/pages/community-add-ons/dotvvm-dynamic-data</PackageProjectUrl>
+    <PackageTags>($PackageTags);autoui;annotations;metadata;ui generation</PackageTags>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+  </PropertyGroup>
+  <PropertyGroup Condition=" '$(TargetFramework)' == 'netstandard2.1' ">
+    <NoWarn>1701;1702;1591</NoWarn>
+  </PropertyGroup>
+  <ItemGroup Condition=" '$(TargetFramework)' == 'net472' ">
+    <Reference Include="System" />
+    <Reference Include="Microsoft.CSharp" />
+    <Reference Include="System.ComponentModel.DataAnnotations" />
+  </ItemGroup>
+  <ItemGroup>
+    <ProjectReference Include="..\..\Framework\Core\DotVVM.Core.csproj" />
+  </ItemGroup>
+</Project>

src/AutoUI/Annotations/EnabledAttribute.cs

@@ -0,0 +1,37 @@
+using System;
+
+namespace DotVVM.AutoUI.Annotations;
+
+/// <summary>
+/// Indicates under which conditions the auto-generated field should be enable (i.e. editable) to the user.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property, AllowMultiple = true)]
+public class EnabledAttribute : Attribute, IConditionalFieldAttribute
+{
+
+    /// <summary>
+    /// Gets or sets a name of the view or an expression that specifies for which views the field should be editable.
+    /// You can use ! (NOT), &amp; (AND) and | (OR) operators.
+    /// Examples:
+    /// - Insert            // editable only in the Insert view
+    /// - Insert | Edit     // editable in Insert or Edit views
+    /// - !Insert &amp; !Edit   // editable in all views except for Insert and Edit
+    /// </summary>
+    public string ViewNames { get; set; }
+
+    /// <summary>
+    /// Gets or sets a name of the role or an expression that specifies for which roles the field should be editable.
+    /// You can use ! (NOT), &amp; (AND) and | (OR) operators.
+    /// Examples:
+    /// - Admin                   // editable only for the Admin role
+    /// - Admin | Contributor     // editable for Admin or Contributor roles
+    /// - !Admin &amp; !Contributor   // editable for all roles except for Admin or Contributor roles
+    /// </summary>
+    public string Roles { get; set; }
+
+    /// <summary>
+    /// Gets or sets whether the field should be editable for authenticated or non-authenticated users, or null for both kinds (default behavior).
+    /// </summary>
+    public AuthenticationMode IsAuthenticated { get; set; }
+
+}

src/AutoUI/Annotations/IConditionalFieldAttribute.cs

@@ -0,0 +1,8 @@
+namespace DotVVM.AutoUI.Annotations;
+
+public interface IConditionalFieldAttribute
+{
+    string ViewNames { get; set; }
+    string Roles { get; set; }
+    AuthenticationMode IsAuthenticated { get; set; }
+}

src/AutoUI/Annotations/ISelectionProvider.cs

@@ -0,0 +1,17 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using DotVVM.Framework.ViewModel;
+
+namespace DotVVM.AutoUI.Annotations;
+
+public interface ISelectionProvider<TItem>
+{
+    [AllowStaticCommand]
+    Task<List<TItem>> GetSelectorItems();
+}
+
+public interface ISelectionProvider<TItem, TParam>
+{
+    [AllowStaticCommand]
+    Task<List<TItem>> GetSelectorItems(TParam parameter);
+}

src/AutoUI/Annotations/IViewContext.cs

@@ -0,0 +1,20 @@
+namespace DotVVM.AutoUI.Annotations
+{
+    /// <summary>
+    /// Provides information about the context in which the field is being rendered.
+    /// </summary>
+    public interface IViewContext
+    {
+
+        /// <summary>
+        /// Gets the name of the current view.
+        /// </summary>
+        string ViewName { get; }
+
+        /// <summary>
+        /// Gets the name of the current field group.
+        /// </summary>
+        string GroupName { get; }
+
+    }
+}

src/AutoUI/Annotations/Selection.cs

@@ -0,0 +1,15 @@
+namespace DotVVM.AutoUI.Annotations;
+
+public abstract record Selection
+{
+    public string DisplayName { get; set; }
+
+    private protected abstract void SorryWeCannotAllowYouToInheritThisClass();
+}
+
+public abstract record Selection<TKey> : Selection
+{
+    public TKey Value { get; set; }
+
+    private protected override void SorryWeCannotAllowYouToInheritThisClass() => throw new System.NotImplementedException("Mischief managed.");
+}

src/AutoUI/Annotations/SelectionAttribute.cs

@@ -0,0 +1,14 @@
+using System;
+
+namespace DotVVM.AutoUI.Annotations;
+
+[AttributeUsage(AttributeTargets.Property, AllowMultiple = false)]
+public class SelectionAttribute : System.Attribute
+{
+    public Type PropertyType { get; }
+
+    public SelectionAttribute(Type propertyType)
+    {
+        PropertyType = propertyType;
+    }
+}

src/AutoUI/Annotations/StyleAttribute.cs

@@ -0,0 +1,38 @@
+using System;
+
+namespace DotVVM.AutoUI.Annotations
+{
+    /// <summary>
+    /// Defines the CSS classes applied to the field.
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Property)]
+    public class StyleAttribute : Attribute
+    {
+
+        /// <summary>
+        /// Gets or sets the CSS class applied to the container of the form control (e.g. table cell which contains the TextBox control) for this field.
+        /// </summary>
+        public string FormControlContainerCssClass { get; set; }
+
+        /// <summary>
+        /// Gets or sets the CSS class applied to the row in the form (e.g. table row which contains the label and the TextBox control) for this field.
+        /// </summary>
+        public string FormRowCssClass { get; set; }
+
+        /// <summary>
+        /// Gets or sets the CSS class applied to the control in the form.
+        /// </summary>
+        public string FormControlCssClass { get; set; }
+
+        /// <summary>
+        /// Gets or sets the CSS class applied to the GridView table cell for this field.
+        /// </summary>
+        public string GridCellCssClass { get; set; }
+
+        /// <summary>
+        /// Gets or sets the CSS class applied to the GridView table header cell for this field.
+        /// </summary>
+        public string GridHeaderCellCssClass { get; set; }
+
+    }
+}

src/AutoUI/Annotations/VisibleAttribute.cs

@@ -0,0 +1,37 @@
+using System;
+
+namespace DotVVM.AutoUI.Annotations;
+
+/// <summary>
+/// Indicates under which conditions the auto-generated field should be visible to the user.
+/// </summary>
+[AttributeUsage(AttributeTargets.Property, AllowMultiple = true)]
+public class VisibleAttribute : Attribute, IConditionalFieldAttribute
+{
+
+    /// <summary>
+    /// Gets or sets a name of the view or an expression that specifies for which views the field should be visible.
+    /// You can use ! (NOT), &amp; (AND) and | (OR) operators.
+    /// Examples:
+    /// - Insert            // visible only in the Insert view
+    /// - Insert | Edit     // visible in Insert or Edit views
+    /// - !Insert &amp; !Edit   // visible in all views except for Insert and Edit
+    /// </summary>
+    public string ViewNames { get; set; }
+
+    /// <summary>
+    /// Gets or sets a name of the role or an expression that specifies for which roles the field should be visible.
+    /// You can use ! (NOT), &amp; (AND) and | (OR) operators.
+    /// Examples:
+    /// - Admin                   // visible only for the Admin role
+    /// - Admin | Contributor     // visible for Admin or Contributor roles
+    /// - !Admin &amp; !Contributor   // visible for all roles except for Admin or Contributor roles
+    /// </summary>
+    public string Roles { get; set; }
+
+    /// <summary>
+    /// Gets or sets whether the field should be visible for authenticated or non-authenticated users, or null for both kinds (default behavior).
+    /// </summary>
+    public AuthenticationMode IsAuthenticated { get; set; }
+
+}

src/AutoUI/Core/AutoUIContext.cs

@@ -0,0 +1,91 @@
+using System;
+using System.Collections.Concurrent;
+using System.Collections.Generic;
+using System.Linq.Expressions;
+using System.Text;
+using DotVVM.AutoUI.Annotations;
+using DotVVM.AutoUI.Configuration;
+using DotVVM.AutoUI.Metadata;
+using DotVVM.Framework.Binding;
+using DotVVM.Framework.Binding.Expressions;
+using DotVVM.Framework.Binding.Properties;
+using DotVVM.Framework.Compilation.ControlTree;
+using DotVVM.Framework.ViewModel.Validation;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace DotVVM.AutoUI
+{
+    public class AutoUIContext
+    {
+        public DataContextStack DataContextStack { get; }
+        public IServiceProvider Services { get; }
+
+        public IViewModelValidationMetadataProvider ValidationMetadataProvider { get; }
+
+        public IPropertyDisplayMetadataProvider PropertyDisplayMetadataProvider { get; }
+        public AutoUIConfiguration AutoUiConfiguration { get; }
+
+        public Type EntityType => DataContextStack.DataContextType;
+
+        public string? ViewName { get; set; }
+
+        public string? GroupName { get; set; }
+
+        public BindingCompilationService BindingService { get; }
+
+        public AutoUIContext(DataContextStack dataContextStack, IServiceProvider services)
+        {
+            DataContextStack = dataContextStack;
+            Services = services;
+
+            ValidationMetadataProvider = services.GetRequiredService<IViewModelValidationMetadataProvider>();
+            PropertyDisplayMetadataProvider = services.GetRequiredService<IPropertyDisplayMetadataProvider>();
+            AutoUiConfiguration = services.GetRequiredService<AutoUIConfiguration>();
+            BindingService = services.GetRequiredService<BindingCompilationService>();
+        }
+
+        public IValueBinding CreateValueBinding(PropertyDisplayMetadata property)
+        {
+            if (property.ValueBinding is not null)
+                return property.ValueBinding;
+
+            if (property.PropertyInfo is null)
+                throw new ArgumentException("property.PropertyInfo is null => cannot create value binding for this property");
+
+            var s = this.BindingService;
+            return s.Cache.CreateCachedBinding("AutoUI-Value", new object?[] { property.PropertyInfo, DataContextStack }, () => {
+                var _this = Expression.Parameter(DataContextStack.DataContextType, "_this").AddParameterAnnotation(new BindingParameterAnnotation(DataContextStack));
+                var expr = Expression.Property(_this, property.PropertyInfo);
+                return (IValueBinding)BindingService.CreateBinding(typeof(ValueBindingExpression<>), new object[] {
+                    DataContextStack,
+                    new ParsedExpressionBindingProperty(expr)
+                });
+            });
+        }
+
+        public IValueBinding CreateValueBinding(string expression, params Type[] nestedDataContextTypes)
+        {
+            var dataContextStack = CreateDataContextStack(DataContextStack, nestedDataContextTypes);
+
+            return BindingService.Cache.CreateValueBinding(expression, dataContextStack);
+        }
+
+        private DataContextStack CreateDataContextStack(DataContextStack dataContextStack, Type[] nestedDataContextTypes)
+        {
+            foreach (var type in nestedDataContextTypes)
+            {
+                dataContextStack = DataContextStack.Create(type, dataContextStack, dataContextStack.NamespaceImports, dataContextStack.ExtensionParameters);
+            }
+            return dataContextStack;
+        }
+
+        public IViewContext CreateViewContext()
+        {
+            return new ViewContext()
+            {
+                ViewName = ViewName,
+                GroupName = GroupName
+            };
+        }
+    }
+}