AIRoutine.CodeStyle.Analyzers 1.4.0

AIRoutine.CodeStyle.Analyzers

Roslyn-based C# code analyzers for strict code style enforcement with IDE integration.

Rules

ACS0001: No Hardcoded Strings

Detects hardcoded strings in files matching these patterns:

• *ViewModel.cs
• *Service.cs
• *Handler.cs

Allowed Exceptions

Example

// Bad - ACS0001
public class UserViewModel
{
    public string Title => "Welcome";  // Error
}

// Good
public class UserViewModel
{
    private const string DefaultTitle = "Welcome";  // OK
    public string Title => _localizer["WelcomeTitle"];  // OK
}

ACS0002: No Static Calls

Enforces dependency injection by forbidding static method calls on non-framework types.

Allowed

• System.* namespace (Console, Math, Path, etc.)
• Microsoft.* namespace
• Windows.* namespace
• Testing frameworks (Xunit, NUnit, Moq, etc.)
• Extension methods
• Enum values
• Calls to same type (factory methods)

Example

// Bad - ACS0002
public class OrderService
{
    public string Process() => MyHelper.Calculate();  // Error
}

// Good
public class OrderService
{
    private readonly IHelper _helper;
    public OrderService(IHelper helper) => _helper = helper;
    public string Process() => _helper.Calculate();  // OK (DI)
    public string GetPath() => Path.Combine("a", "b");  // OK (System)
}

ACS0003: No Hardcoded Colors

Detects hardcoded colors in C# code. Colors should be defined in ResourceDictionary.

Detected Patterns

• Colors.Red, Colors.Blue, etc.
• Color.FromArgb(...), Color.FromRgb(...)
• new SolidColorBrush(Colors.*)
• Color.Parse("#FFFFFF")
• ColorHelper.FromArgb(...)

Example

// Bad - ACS0003
public Color GetColor() => Colors.Red;  // Error
public Color Custom() => Color.FromArgb(255, 100, 150, 200);  // Error

// Good
public Color GetColor() => (Color)Application.Current.Resources["PrimaryColor"];

ACS0012: No ICommand Properties

Forbids direct ICommand property declarations in ViewModel/Model classes. Commands must be defined using the [UnoCommand] attribute on methods instead.

Detected Patterns

• public ICommand MyCommand { get; }
• public IRelayCommand Command { get; }
• public AsyncRelayCommand SaveCommand { get; }
• Any property implementing System.Windows.Input.ICommand

Applies To

Classes ending with:

• *ViewModel (MVVM pattern)
• *Model (MVUX pattern)

Example

// Bad - ACS0012
public class MainViewModel
{
    public ICommand SaveCommand { get; }  // Error
}

// Good
public class MainViewModel
{
    [UnoCommand]
    public void Save() { }  // OK - generates command automatically
}

ACS0013: No Forbidden Command Attributes

Forbids command attributes from other frameworks. Only [UnoCommand] is allowed.

Forbidden Attributes

• [RelayCommand] (CommunityToolkit.Mvvm)
• [AsyncRelayCommand] (CommunityToolkit.Mvvm)
• [Command] (various frameworks)
• [AsyncCommand]
• [DelegateCommand] (Prism)
• [ReactiveCommand] (ReactiveUI)

Example

// Bad - ACS0013
public class MainViewModel
{
    [RelayCommand]  // Error - use [UnoCommand] instead
    public void Save() { }
}

// Good
public class MainViewModel
{
    [UnoCommand]  // OK
    public void Save() { }
}

ACS0014: C# Markup Spacing Values

Validates that spacing values in C# Markup (.Padding(), .Margin(), .Spacing()) use consistent values from the design system scale.

Default Allowed Values

0, 2, 4, 8, 12, 16, 20, 24, 32, 48, 64

Configuration

# .editorconfig or .globalconfig
dotnet_diagnostic.ACS0014.allowed_spacing_values = 0,4,8,16,24,32,48

Example

// Bad - ACS0014
new Grid()
    .Padding(16, 12, 16, 12)  // OK - 16 and 12 are in default scale
    .Margin(15)               // Error - 15 is not in scale

// Good
new Grid()
    .Padding(16)              // OK
    .Margin(8, 16, 8, 16)     // OK

ACS0015: C# Markup Style Required

Ensures UI controls in C# Markup have explicit Style assignments for consistent theming.

Applies To

Common UI controls: Button, TextBlock, TextBox, ListView, ComboBox, Border, etc.

Example

// Bad - ACS0015
new TextBlock()
    .Text("Hello");  // Error - missing Style

// Good
new TextBlock()
    .Style(x => x.StaticResource("BodyTextBlockStyle"))
    .Text("Hello");

ACS0016: C# Markup AutomationId Format

Validates that AutomationId values follow a consistent naming pattern for test automation.

Required Pattern

PageName.ControlType.Purpose or PageName.Purpose

Examples: LoginPage.Button.Submit, SettingsPage.Username, MainPage.Root

Example

// Bad - ACS0016
.AutomationProperties(ap => ap.AutomationId("submit"))  // Error
.AutomationProperties(ap => ap.AutomationId("btn_submit"))  // Error

// Good
.AutomationProperties(ap => ap.AutomationId("LoginPage.Button.Submit"))  // OK
.AutomationProperties(ap => ap.AutomationId("FooterPage.Root"))  // OK

Installation

<PackageReference Include="AIRoutine.CodeStyle.Analyzers" Version="1.1.0" PrivateAssets="all" />

IDE Integration

These analyzers provide real-time feedback in Visual Studio, VS Code, and Rider:

• Squiggly underlines for violations
• Error messages in Error List / Problems panel
• Build failures for violations (Severity: Error)

Code Fixes

All rules include automatic code fixes accessible via the light bulb menu (Ctrl+.):