.editorconfig

root = true

[*]
charset = utf-8
end_of_line = crlf
insert_final_newline = true
trim_trailing_whitespace = true
indent_style = space
indent_size = 4

[*.{json,yml,yaml,csproj,props,targets,slnx,xml}]
indent_size = 2

[*.md]
trim_trailing_whitespace = false

[*.cs]
# --- Language conventions ---
csharp_using_directive_placement = outside_namespace:warning
csharp_style_namespace_declarations = file_scoped:warning
dotnet_sort_system_directives_first = true
dotnet_separate_import_directive_groups = false

dotnet_style_qualification_for_field = false:suggestion
dotnet_style_qualification_for_property = false:suggestion
dotnet_style_qualification_for_method = false:suggestion
dotnet_style_qualification_for_event = false:suggestion

dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
dotnet_style_predefined_type_for_member_access = true:suggestion

csharp_style_var_for_built_in_types = true:silent
csharp_style_var_when_type_is_apparent = true:silent
csharp_style_var_elsewhere = true:silent

csharp_prefer_braces = true:silent
csharp_style_expression_bodied_methods = true:silent
csharp_style_expression_bodied_properties = true:silent

dotnet_style_object_initializer = true:suggestion
dotnet_style_collection_initializer = true:suggestion
dotnet_style_prefer_conditional_expression_over_assignment = true:silent
dotnet_style_null_propagation = true:suggestion
dotnet_style_coalesce_expression = true:suggestion

# --- Naming: interfaces start with I ---
dotnet_naming_rule.interfaces_should_begin_with_i.severity = warning
dotnet_naming_rule.interfaces_should_begin_with_i.symbols = interface_symbol
dotnet_naming_rule.interfaces_should_begin_with_i.style = begins_with_i
dotnet_naming_symbols.interface_symbol.applicable_kinds = interface
dotnet_naming_style.begins_with_i.required_prefix = I
dotnet_naming_style.begins_with_i.capitalization = pascal_case

# --- Analyzer severities ---
# Cache JsonSerializerOptions instances (we enforce this in the request pipeline).
dotnet_diagnostic.CA1869.severity = warning
# ConfigureAwait: this is a library; we use ConfigureAwait(false) in the pipeline,
# but do not want noise on every await in samples/models.
dotnet_diagnostic.CA2007.severity = none
# The public surface intentionally mirrors Yandex Music's own naming. The following
# "identifier suffix/keyword" rules produce noise for a thin API binding.
dotnet_diagnostic.CA1711.severity = none
dotnet_diagnostic.CA1710.severity = none
dotnet_diagnostic.CA1716.severity = none
dotnet_diagnostic.CA1720.severity = none
# Prefer file-scoped namespaces, but do not fail the build on legacy block-scoped files.
dotnet_diagnostic.IDE0161.severity = suggestion
# Modernization hint (ObjectDisposedException.ThrowIf) — keep as suggestion to preserve
# correct null-flow narrowing at explicit guards.
dotnet_diagnostic.CA1513.severity = suggestion

[tests/**.cs]
dotnet_diagnostic.CS1591.severity = none
dotnet_diagnostic.CA1707.severity = none