Make internal types used by MAUI Toolkit public

src/Controls/src/Core/ICornerElement.cs

@@ -1,9 +1,18 @@
-#nullable disable
-namespace Microsoft.Maui.Controls
+namespace Microsoft.Maui.Controls;
+
+/// <summary>
+/// Defines properties for elements that can have rounded corners.
+/// </summary>
+/// <remarks>
+/// This interface is implemented by UI elements that support corner radius customization,
+/// allowing for consistent styling of corners across different controls.
+/// </remarks>
+public interface ICornerElement
 {
-	interface ICornerElement
-	{
-		//note to implementor: implement this property publicly
-		CornerRadius CornerRadius { get; }
-	}
-}
+	/// <summary>
+	/// Gets the radius for the corners of the element.
+	/// </summary>
+	/// <value>A <see cref="CornerRadius"/> value that specifies the radius for each corner of the element. The default value depends on the implementing control.</value>
+	/// <remarks>Implementors should implement this property publicly.</remarks>
+	CornerRadius CornerRadius { get; }
+}

src/Controls/src/Core/ILineHeightElement.cs

@@ -1,13 +1,25 @@
-#nullable disable
-using System.ComponentModel;
+namespace Microsoft.Maui.Controls;
 
-namespace Microsoft.Maui.Controls.Internals
+/// <summary>
+/// Defines properties and methods for elements that support line height customization.
+/// </summary>
+/// <remarks>
+/// This interface is implemented by UI elements that need to control the spacing between lines of text,
+/// providing consistent line height behavior across different text-based controls.
+/// </remarks>
+public interface ILineHeightElement
 {
-	[EditorBrowsable(EditorBrowsableState.Never)]
-	interface ILineHeightElement
-	{
-		double LineHeight { get; }
+	/// <summary>
+	/// Gets the line height for text displayed by this element.
+	/// </summary>
+	/// <value>A multiplier that determines the spacing between lines of text. A value of 1.0 represents standard line height.</value>
+	double LineHeight { get; }
 
-		void OnLineHeightChanged(double oldValue, double newValue);
-	}
-}
+	/// <summary>
+	/// Called when the <see cref="LineHeight"/> property changes.
+	/// </summary>
+	/// <param name="oldValue">The old value of the property.</param>
+	/// <param name="newValue">The new value of the property.</param>
+	/// <remarks>Implementors should implement this method explicitly.</remarks>
+	void OnLineHeightChanged(double oldValue, double newValue);
+}

src/Controls/src/Core/ILineHeightElementInternal.cs

@@ -0,0 +1,15 @@
+#nullable disable
+using System;
+using System.ComponentModel;
+
+namespace Microsoft.Maui.Controls.Internals
+{
+	[EditorBrowsable(EditorBrowsableState.Never)]
+	[Obsolete("This interface is obsolete and will be removed in a future version. Use Microsoft.Maui.Controls.ILineHeightElement instead.")]
+	interface ILineHeightElement
+	{
+		double LineHeight { get; }
+
+		void OnLineHeightChanged(double oldValue, double newValue);
+	}
+}

src/Controls/src/Core/ITextAlignmentElement.cs

@@ -1,14 +1,33 @@
-#nullable disable
-namespace Microsoft.Maui.Controls
+namespace Microsoft.Maui.Controls;
+
+/// <summary>
+/// Defines properties and methods for elements that support text alignment.
+/// </summary>
+/// <remarks>
+/// This interface is implemented by UI elements that need to control the horizontal and vertical 
+/// alignment of displayed text.
+/// </remarks>
+public interface ITextAlignmentElement
 {
-	interface ITextAlignmentElement
-	{
-		//note to implementor: implement the properties publicly
-		TextAlignment HorizontalTextAlignment { get; }
+	/// <summary>
+	/// Gets the horizontal alignment of the text.
+	/// </summary>
+	/// <value>A <see cref="TextAlignment"/> value that specifies how the text is horizontally aligned. The default value depends on the implementing control.</value>
+	/// <remarks>Implementors should implement this property publicly.</remarks>
+	TextAlignment HorizontalTextAlignment { get; }
 
-		TextAlignment VerticalTextAlignment { get; }
+	/// <summary>
+	/// Gets the vertical alignment of the text.
+	/// </summary>
+	/// <value>A <see cref="TextAlignment"/> value that specifies how the text is vertically aligned. The default value depends on the implementing control.</value>
+	/// <remarks>Implementors should implement this property publicly.</remarks>
+	TextAlignment VerticalTextAlignment { get; }
 
-		//note to implementor: but implement the methods explicitly
-		void OnHorizontalTextAlignmentPropertyChanged(TextAlignment oldValue, TextAlignment newValue);
-	}
-}
+	/// <summary>
+	/// Called when the <see cref="HorizontalTextAlignment"/> property changes.
+	/// </summary>
+	/// <param name="oldValue">The old value of the property.</param>
+	/// <param name="newValue">The new value of the property.</param>
+	/// <remarks>Implementors should implement this method explicitly.</remarks>
+	void OnHorizontalTextAlignmentPropertyChanged(TextAlignment oldValue, TextAlignment newValue);
+}

src/Controls/src/Core/ITextElement.cs

@@ -1,27 +1,64 @@
 #nullable disable
-using System;
-using Microsoft.Maui.Controls.Internals;
 using Microsoft.Maui.Graphics;
 
-namespace Microsoft.Maui.Controls
+namespace Microsoft.Maui.Controls;
+
+/// <summary>
+/// Defines properties and methods for elements that display text.
+/// </summary>
+/// <remarks>
+/// This interface is implemented by UI elements that can display text and allows consistent 
+/// text styling and formatting across different controls.
+/// </remarks>
+public interface ITextElement
 {
-	interface ITextElement
-	{
-		//note to implementor: implement this property publicly
-		Color TextColor { get; }
+	/// <summary>
+	/// Gets the color of the text.
+	/// </summary>
+	/// <value>The <see cref="Color"/> of the text. The default value depends on the implementing control.</value>
+	/// <remarks>Implementors should implement this property publicly.</remarks>
+	Color TextColor { get; }
 
-		//note to implementor: but implement this method explicitly
-		void OnTextColorPropertyChanged(Color oldValue, Color newValue);
+	/// <summary>
+	/// Called when the <see cref="TextColor"/> property changes.
+	/// </summary>
+	/// <param name="oldValue">The old value of the property.</param>
+	/// <param name="newValue">The new value of the property.</param>
+	/// <remarks>Implementors should implement this method explicitly.</remarks>
+	void OnTextColorPropertyChanged(Color oldValue, Color newValue);
 
-		double CharacterSpacing { get; }
+	/// <summary>
+	/// Gets the character spacing.
+	/// </summary>
+	/// <value>The spacing between characters in the text, in device-independent units. The default is 0.</value>
+	double CharacterSpacing { get; }
 
-		//note to implementor: but implement these methods explicitly
-		void OnCharacterSpacingPropertyChanged(double oldValue, double newValue);
+	/// <summary>
+	/// Called when the <see cref="CharacterSpacing"/> property changes.
+	/// </summary>
+	/// <param name="oldValue">The old value of the property.</param>
+	/// <param name="newValue">The new value of the property.</param>
+	/// <remarks>Implementors should implement this method explicitly.</remarks>
+	void OnCharacterSpacingPropertyChanged(double oldValue, double newValue);
 
-		TextTransform TextTransform { get; set; }
+	/// <summary>
+	/// Gets or sets the text transformation.
+	/// </summary>
+	/// <value>A <see cref="TextTransform"/> value that indicates how the text is transformed. The default is <see cref="TextTransform.None"/>.</value>
+	TextTransform TextTransform { get; set; }
 
-		void OnTextTransformChanged(TextTransform oldValue, TextTransform newValue);
+	/// <summary>
+	/// Called when the <see cref="TextTransform"/> property changes.
+	/// </summary>
+	/// <param name="oldValue">The old value of the property.</param>
+	/// <param name="newValue">The new value of the property.</param>
+	void OnTextTransformChanged(TextTransform oldValue, TextTransform newValue);
 
-		string UpdateFormsText(string original, TextTransform transform);
-	}
-}
+	/// <summary>
+	/// Updates the text according to the specified transformation.
+	/// </summary>
+	/// <param name="original">The original text to transform.</param>
+	/// <param name="transform">The transformation to apply.</param>
+	/// <returns>The transformed text.</returns>
+	string UpdateFormsText(string original, TextTransform transform);
+}

src/Controls/src/Core/Properties/AssemblyInfo.cs

@@ -128,7 +128,7 @@
 [assembly: StyleProperty("visibility", typeof(VisualElement), nameof(VisualElement.IsVisibleProperty), Inherited = true)]
 [assembly: StyleProperty("width", typeof(VisualElement), nameof(VisualElement.WidthRequestProperty))]
 [assembly: StyleProperty("letter-spacing", typeof(ITextElement), nameof(TextElement.CharacterSpacingProperty), Inherited = true)]
-[assembly: StyleProperty("line-height", typeof(ILineHeightElement), nameof(LineHeightElement.LineHeightProperty), Inherited = true)]
+[assembly: StyleProperty("line-height", typeof(Microsoft.Maui.Controls.ILineHeightElement), nameof(LineHeightElement.LineHeightProperty), Inherited = true)]
 
 //flex
 [assembly: StyleProperty("align-content", typeof(FlexLayout), nameof(FlexLayout.AlignContentProperty))]

src/Controls/src/Core/PublicAPI/net-android/PublicAPI.Unshipped.txt

@@ -23,7 +23,25 @@ Microsoft.Maui.Controls.DatePicker.MaximumDate.get -> System.DateTime?
 Microsoft.Maui.Controls.DatePicker.MinimumDate.get -> System.DateTime?
 Microsoft.Maui.Controls.HybridWebView.InvokeJavaScriptAsync(string! methodName, object?[]? paramValues = null, System.Text.Json.Serialization.Metadata.JsonTypeInfo?[]? paramJsonTypeInfos = null) -> System.Threading.Tasks.Task!
 Microsoft.Maui.Controls.HybridWebView.SetInvokeJavaScriptTarget<T>(T! target) -> void
+Microsoft.Maui.Controls.ICornerElement
+Microsoft.Maui.Controls.ICornerElement.CornerRadius.get -> Microsoft.Maui.CornerRadius
+Microsoft.Maui.Controls.ILineHeightElement
+Microsoft.Maui.Controls.ILineHeightElement.LineHeight.get -> double
+Microsoft.Maui.Controls.ILineHeightElement.OnLineHeightChanged(double oldValue, double newValue) -> void
 Microsoft.Maui.Controls.Internals.TextTransformUtilities
+Microsoft.Maui.Controls.ITextAlignmentElement
+Microsoft.Maui.Controls.ITextAlignmentElement.HorizontalTextAlignment.get -> Microsoft.Maui.TextAlignment
+Microsoft.Maui.Controls.ITextAlignmentElement.OnHorizontalTextAlignmentPropertyChanged(Microsoft.Maui.TextAlignment oldValue, Microsoft.Maui.TextAlignment newValue) -> void
+Microsoft.Maui.Controls.ITextAlignmentElement.VerticalTextAlignment.get -> Microsoft.Maui.TextAlignment
+Microsoft.Maui.Controls.ITextElement
+Microsoft.Maui.Controls.ITextElement.CharacterSpacing.get -> double
+Microsoft.Maui.Controls.ITextElement.OnCharacterSpacingPropertyChanged(double oldValue, double newValue) -> void
+Microsoft.Maui.Controls.ITextElement.OnTextTransformChanged(Microsoft.Maui.TextTransform oldValue, Microsoft.Maui.TextTransform newValue) -> void
+Microsoft.Maui.Controls.ITextElement.TextTransform.get -> Microsoft.Maui.TextTransform
+Microsoft.Maui.Controls.ITextElement.TextTransform.set -> void
+~Microsoft.Maui.Controls.ITextElement.OnTextColorPropertyChanged(Microsoft.Maui.Graphics.Color oldValue, Microsoft.Maui.Graphics.Color newValue) -> void
+~Microsoft.Maui.Controls.ITextElement.TextColor.get -> Microsoft.Maui.Graphics.Color
+~Microsoft.Maui.Controls.ITextElement.UpdateFormsText(string original, Microsoft.Maui.TextTransform transform) -> string
 Microsoft.Maui.Controls.ShadowTypeConverter
 Microsoft.Maui.Controls.ShadowTypeConverter.ShadowTypeConverter() -> void
 Microsoft.Maui.Controls.StyleableElement.Style.get -> Microsoft.Maui.Controls.Style?

src/Controls/src/Core/PublicAPI/net-ios/PublicAPI.Unshipped.txt

@@ -105,6 +105,24 @@ static Microsoft.Maui.Controls.ViewExtensions.TranslateToAsync(this Microsoft.Ma
 *REMOVED*~Microsoft.Maui.Controls.NavigableElement.StyleClass.set -> void
 Microsoft.Maui.Controls.HybridWebView.InvokeJavaScriptAsync(string! methodName, object?[]? paramValues = null, System.Text.Json.Serialization.Metadata.JsonTypeInfo?[]? paramJsonTypeInfos = null) -> System.Threading.Tasks.Task!
 Microsoft.Maui.Controls.HybridWebView.SetInvokeJavaScriptTarget<T>(T! target) -> void
+Microsoft.Maui.Controls.ICornerElement
+Microsoft.Maui.Controls.ICornerElement.CornerRadius.get -> Microsoft.Maui.CornerRadius
+Microsoft.Maui.Controls.ILineHeightElement
+Microsoft.Maui.Controls.ILineHeightElement.LineHeight.get -> double
+Microsoft.Maui.Controls.ILineHeightElement.OnLineHeightChanged(double oldValue, double newValue) -> void
+Microsoft.Maui.Controls.ITextAlignmentElement
+Microsoft.Maui.Controls.ITextAlignmentElement.HorizontalTextAlignment.get -> Microsoft.Maui.TextAlignment
+Microsoft.Maui.Controls.ITextAlignmentElement.OnHorizontalTextAlignmentPropertyChanged(Microsoft.Maui.TextAlignment oldValue, Microsoft.Maui.TextAlignment newValue) -> void
+Microsoft.Maui.Controls.ITextAlignmentElement.VerticalTextAlignment.get -> Microsoft.Maui.TextAlignment
+Microsoft.Maui.Controls.ITextElement
+Microsoft.Maui.Controls.ITextElement.CharacterSpacing.get -> double
+Microsoft.Maui.Controls.ITextElement.OnCharacterSpacingPropertyChanged(double oldValue, double newValue) -> void
+Microsoft.Maui.Controls.ITextElement.OnTextTransformChanged(Microsoft.Maui.TextTransform oldValue, Microsoft.Maui.TextTransform newValue) -> void
+Microsoft.Maui.Controls.ITextElement.TextTransform.get -> Microsoft.Maui.TextTransform
+Microsoft.Maui.Controls.ITextElement.TextTransform.set -> void
+~Microsoft.Maui.Controls.ITextElement.OnTextColorPropertyChanged(Microsoft.Maui.Graphics.Color oldValue, Microsoft.Maui.Graphics.Color newValue) -> void
+~Microsoft.Maui.Controls.ITextElement.TextColor.get -> Microsoft.Maui.Graphics.Color
+~Microsoft.Maui.Controls.ITextElement.UpdateFormsText(string original, Microsoft.Maui.TextTransform transform) -> string
 ~Microsoft.Maui.Controls.ResourceDictionary.SetAndCreateSource<T>(System.Uri value) -> void
 ~Microsoft.Maui.Controls.WebViewProcessTerminatedEventArgs.PlatformArgs.get -> Microsoft.Maui.Controls.PlatformWebViewProcessTerminatedEventArgs
 ~Microsoft.Maui.Controls.Xaml.IXamlTypeResolver.Resolve(string qualifiedTypeName, System.IServiceProvider serviceProvider = null, bool expandToExtension = true) -> System.Type

src/Controls/src/Core/PublicAPI/net-maccatalyst/PublicAPI.Unshipped.txt

@@ -105,6 +105,24 @@ static Microsoft.Maui.Controls.ViewExtensions.TranslateToAsync(this Microsoft.Ma
 *REMOVED*~Microsoft.Maui.Controls.NavigableElement.StyleClass.set -> void
 Microsoft.Maui.Controls.HybridWebView.InvokeJavaScriptAsync(string! methodName, object?[]? paramValues = null, System.Text.Json.Serialization.Metadata.JsonTypeInfo?[]? paramJsonTypeInfos = null) -> System.Threading.Tasks.Task!
 Microsoft.Maui.Controls.HybridWebView.SetInvokeJavaScriptTarget<T>(T! target) -> void
+Microsoft.Maui.Controls.ICornerElement
+Microsoft.Maui.Controls.ICornerElement.CornerRadius.get -> Microsoft.Maui.CornerRadius
+Microsoft.Maui.Controls.ILineHeightElement
+Microsoft.Maui.Controls.ILineHeightElement.LineHeight.get -> double
+Microsoft.Maui.Controls.ILineHeightElement.OnLineHeightChanged(double oldValue, double newValue) -> void
+Microsoft.Maui.Controls.ITextAlignmentElement
+Microsoft.Maui.Controls.ITextAlignmentElement.HorizontalTextAlignment.get -> Microsoft.Maui.TextAlignment
+Microsoft.Maui.Controls.ITextAlignmentElement.OnHorizontalTextAlignmentPropertyChanged(Microsoft.Maui.TextAlignment oldValue, Microsoft.Maui.TextAlignment newValue) -> void
+Microsoft.Maui.Controls.ITextAlignmentElement.VerticalTextAlignment.get -> Microsoft.Maui.TextAlignment
+Microsoft.Maui.Controls.ITextElement
+Microsoft.Maui.Controls.ITextElement.CharacterSpacing.get -> double
+Microsoft.Maui.Controls.ITextElement.OnCharacterSpacingPropertyChanged(double oldValue, double newValue) -> void
+Microsoft.Maui.Controls.ITextElement.OnTextTransformChanged(Microsoft.Maui.TextTransform oldValue, Microsoft.Maui.TextTransform newValue) -> void
+Microsoft.Maui.Controls.ITextElement.TextTransform.get -> Microsoft.Maui.TextTransform
+Microsoft.Maui.Controls.ITextElement.TextTransform.set -> void
+~Microsoft.Maui.Controls.ITextElement.OnTextColorPropertyChanged(Microsoft.Maui.Graphics.Color oldValue, Microsoft.Maui.Graphics.Color newValue) -> void
+~Microsoft.Maui.Controls.ITextElement.TextColor.get -> Microsoft.Maui.Graphics.Color
+~Microsoft.Maui.Controls.ITextElement.UpdateFormsText(string original, Microsoft.Maui.TextTransform transform) -> string
 ~Microsoft.Maui.Controls.ResourceDictionary.SetAndCreateSource<T>(System.Uri value) -> void
 ~Microsoft.Maui.Controls.Internals.TypedBindingBase.UpdateSourceEventName.set -> void
 ~Microsoft.Maui.Controls.Xaml.IXamlTypeResolver.Resolve(string qualifiedTypeName, System.IServiceProvider serviceProvider = null, bool expandToExtension = true) -> System.Type

src/Controls/src/Core/PublicAPI/net-tizen/PublicAPI.Unshipped.txt

@@ -23,7 +23,25 @@ Microsoft.Maui.Controls.DatePicker.MaximumDate.get -> System.DateTime?
 Microsoft.Maui.Controls.DatePicker.MinimumDate.get -> System.DateTime?
 Microsoft.Maui.Controls.HybridWebView.InvokeJavaScriptAsync(string! methodName, object?[]? paramValues = null, System.Text.Json.Serialization.Metadata.JsonTypeInfo?[]? paramJsonTypeInfos = null) -> System.Threading.Tasks.Task!
 Microsoft.Maui.Controls.HybridWebView.SetInvokeJavaScriptTarget<T>(T! target) -> void
+Microsoft.Maui.Controls.ICornerElement
+Microsoft.Maui.Controls.ICornerElement.CornerRadius.get -> Microsoft.Maui.CornerRadius
+Microsoft.Maui.Controls.ILineHeightElement
+Microsoft.Maui.Controls.ILineHeightElement.LineHeight.get -> double
+Microsoft.Maui.Controls.ILineHeightElement.OnLineHeightChanged(double oldValue, double newValue) -> void
 Microsoft.Maui.Controls.Internals.TextTransformUtilities
+Microsoft.Maui.Controls.ITextAlignmentElement
+Microsoft.Maui.Controls.ITextAlignmentElement.HorizontalTextAlignment.get -> Microsoft.Maui.TextAlignment
+Microsoft.Maui.Controls.ITextAlignmentElement.OnHorizontalTextAlignmentPropertyChanged(Microsoft.Maui.TextAlignment oldValue, Microsoft.Maui.TextAlignment newValue) -> void
+Microsoft.Maui.Controls.ITextAlignmentElement.VerticalTextAlignment.get -> Microsoft.Maui.TextAlignment
+Microsoft.Maui.Controls.ITextElement
+Microsoft.Maui.Controls.ITextElement.CharacterSpacing.get -> double
+Microsoft.Maui.Controls.ITextElement.OnCharacterSpacingPropertyChanged(double oldValue, double newValue) -> void
+Microsoft.Maui.Controls.ITextElement.OnTextTransformChanged(Microsoft.Maui.TextTransform oldValue, Microsoft.Maui.TextTransform newValue) -> void
+Microsoft.Maui.Controls.ITextElement.TextTransform.get -> Microsoft.Maui.TextTransform
+Microsoft.Maui.Controls.ITextElement.TextTransform.set -> void
+~Microsoft.Maui.Controls.ITextElement.OnTextColorPropertyChanged(Microsoft.Maui.Graphics.Color oldValue, Microsoft.Maui.Graphics.Color newValue) -> void
+~Microsoft.Maui.Controls.ITextElement.TextColor.get -> Microsoft.Maui.Graphics.Color
+~Microsoft.Maui.Controls.ITextElement.UpdateFormsText(string original, Microsoft.Maui.TextTransform transform) -> string
 Microsoft.Maui.Controls.ShadowTypeConverter
 Microsoft.Maui.Controls.ShadowTypeConverter.ShadowTypeConverter() -> void
 Microsoft.Maui.Controls.StyleableElement.Style.get -> Microsoft.Maui.Controls.Style?