// У WPF/Avalonia StyledProperty:
public static readonly StyledProperty<Point> MousePositionProperty = ...

public Point MousePosition
{
    get => GetValue(MousePositionProperty);  // Читання зі сховища
    set => SetValue(MousePositionProperty, value);  // Запис у сховище
}

// Проблема: MousePosition змінюється 60+ разів на секунду (при русі миші)
// Кожна зміна = запис у сховище + PropertyChanged event + можлива інвалідація Layout/Render

public class MyControl : Control
{
    // Backing field — звичайне поле класу
    private Point _mousePosition;
    
    // DirectProperty — без сховища
    public static readonly DirectProperty<MyControl, Point> MousePositionProperty =
        AvaloniaProperty.RegisterDirect<MyControl, Point>(
            nameof(MousePosition),
            o => o._mousePosition,           // Getter delegate
            (o, v) => o._mousePosition = v   // Setter delegate
        );
    
    public Point MousePosition
    {
        get => _mousePosition;
        set => SetAndRaise(MousePositionProperty, ref _mousePosition, value);
    }
}

// Avalonia.Controls.Button
public class Button : ContentControl
{
    public static readonly StyledProperty<object?> ContentProperty =
        ContentControl.ContentProperty.AddOwner<Button>();
    
    public object? Content
    {
        get => GetValue(ContentProperty);
        set => SetValue(ContentProperty, value);
    }
}

// Avalonia.Controls.Control
public class Control : InputElement
{
    private Rect _bounds;
    
    public static readonly DirectProperty<Control, Rect> BoundsProperty =
        AvaloniaProperty.RegisterDirect<Control, Rect>(
            nameof(Bounds),
            o => o._bounds
        );
    
    public Rect Bounds
    {
        get => _bounds;
        private set => SetAndRaise(BoundsProperty, ref _bounds, value);
    }
}

<!-- Avalonia XAML -->
<Window xmlns="https://github.com/avaloniaui"
        FontSize="16">  <!-- Inherited value -->
    
    <Window.Styles>
        <Style Selector="Button">
            <Setter Property="Background" Value="Blue"/>  <!-- Style value -->
        </Style>
    </Window.Styles>
    
    <StackPanel Spacing="10" Margin="20">
        <!-- Кнопка 1: Style value (Blue) -->
        <Button Content="Стиль"/>
        
        <!-- Кнопка 2: Local value (Red) перемагає Style -->
        <Button Content="Локальне" Background="Red"/>
        
        <!-- Кнопка 3: FontSize успадковується від Window (16) -->
        <Button Content="Успадкований шрифт"/>
    </StackPanel>
</Window>

<!-- WPF та Avalonia — однаковий XAML -->
<Grid>
    <Button Grid.Row="0" Grid.Column="1" Content="Кнопка"/>
    <TextBlock Grid.Row="1" Grid.Column="0" Text="Текст"/>
</Grid>

// ContentControl визначає ContentProperty
public class ContentControl : TemplatedControl
{
    public static readonly StyledProperty<object?> ContentProperty =
        AvaloniaProperty.Register<ContentControl, object?>(
            nameof(Content)
        );
    
    public object? Content
    {
        get => GetValue(ContentProperty);
        set => SetValue(ContentProperty, value);
    }
}

// Button "додає себе як власника" ContentProperty
public class Button : ContentControl
{
    // AddOwner створює нову StyledProperty<object?> для Button
    public static readonly StyledProperty<object?> ContentProperty =
        ContentControl.ContentProperty.AddOwner<Button>();
    
    // Тепер Button.ContentProperty та ContentControl.ContentProperty
    // вказують на ту саму властивість у системі
}

public class MyButton : Button
{
    // Перевизначаємо default value для Content
    public static readonly StyledProperty<object?> ContentProperty =
        Button.ContentProperty.AddOwner<MyButton>(
            new StyledPropertyMetadata<object?>(
                defaultValue: "Click Me!"  // Новий default
            )
        );
}

using Avalonia;
using Avalonia.Controls;
using Avalonia.Media;

public class RatingControl : Control
{
    // StyledProperty для рейтингу (0-5)
    public static readonly StyledProperty<int> RatingProperty =
        AvaloniaProperty.Register<RatingControl, int>(
            nameof(Rating),
            defaultValue: 0,
            validate: ValidateRating,
            coerce: CoerceRating
        );
    
    public int Rating
    {
        get => GetValue(RatingProperty);
        set => SetValue(RatingProperty, value);
    }
    
    // Validation: рейтинг має бути від 0 до 5
    private static bool ValidateRating(int value)
    {
        return value >= 0 && value <= 5;
    }
    
    // Coercion: обмежуємо значення діапазоном
    private static int CoerceRating(AvaloniaObject sender, int value)
    {
        return Math.Clamp(value, 0, 5);
    }
    
    // PropertyChanged callback
    static RatingControl()
    {
        RatingProperty.Changed.AddClassHandler<RatingControl>(
            (control, args) =>
            {
                // Реакція на зміну рейтингу
                control.InvalidateVisual(); // Перемалювати контрол
            }
        );
    }
}

public class InteractiveControl : Control
{
    // Backing field
    private bool _isHovered;
    
    // DirectProperty — без сховища
    public static readonly DirectProperty<InteractiveControl, bool> IsHoveredProperty =
        AvaloniaProperty.RegisterDirect<InteractiveControl, bool>(
            nameof(IsHovered),
            o => o._isHovered
        );
    
    public bool IsHovered
    {
        get => _isHovered;
        private set => SetAndRaise(IsHoveredProperty, ref _isHovered, value);
    }
    
    protected override void OnPointerEntered(PointerEventArgs e)
    {
        base.OnPointerEntered(e);
        IsHovered = true;  // Часта зміна — DirectProperty ефективніший
    }
    
    protected override void OnPointerExited(PointerEventArgs e)
    {
        base.OnPointerExited(e);
        IsHovered = false;
    }
}

public class Annotations
{
    // AttachedProperty для тексту підказки
    public static readonly AttachedProperty<string?> HintProperty =
        AvaloniaProperty.RegisterAttached<Annotations, Control, string?>(
            "Hint",
            defaultValue: null
        );
    
    public static void SetHint(Control element, string? value)
    {
        element.SetValue(HintProperty, value);
    }
    
    public static string? GetHint(Control element)
    {
        return element.GetValue(HintProperty);
    }
}

<Window xmlns:local="using:MyApp">
    <StackPanel Spacing="10" Margin="20">
        <TextBox local:Annotations.Hint="Введіть ваше ім'я"/>
        <Button local:Annotations.Hint="Натисніть для відправки" Content="Відправити"/>
    </StackPanel>
</Window>