.editorconfig

root=true

[*]
indent_style=space
indent_size=2
end_of_line=lf
charset=utf-8-bom
trim_trailing_whitespace=true
insert_final_newline=true

# ReSharper properties
resharper_blank_lines_between_using_groups=1

# Project files
[*.{csproj,sln}]
indent_style = unset
indent_size=unset
end_of_line = unset
charset = unset
trim_trailing_whitespace = unset
insert_final_newline = unset

# Code files
[*.cs]
indent_style=tab
indent_size=tab
tab_width=4

[*.cshtml]
indent_style=space
indent_size=2

[*.{cs,cshtml}]
#### .NET Coding Conventions ####

# Organize usings
dotnet_sort_system_directives_first=true
dotnet_separate_import_directive_groups=true

# this. and Me. preferences
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

# Language keywords vs BCL types preferences
dotnet_style_predefined_type_for_locals_parameters_members=true:suggestion
dotnet_style_predefined_type_for_member_access=true:suggestion

# Code quality
dotnet_style_readonly_field=true:suggestion
dotnet_code_quality_unused_parameters=non_public:suggestion

# Expression-level preferences
dotnet_style_object_initializer=true:suggestion
dotnet_style_collection_initializer=true:suggestion
dotnet_style_explicit_tuple_names=true:suggestion
dotnet_style_coalesce_expression=true:suggestion
dotnet_style_null_propagation=true:suggestion
dotnet_style_prefer_is_null_check_over_reference_equality_method=true:suggestion
dotnet_style_prefer_inferred_tuple_names=true:suggestion
dotnet_style_prefer_inferred_anonymous_type_member_names=true:suggestion
dotnet_style_prefer_auto_properties=true:suggestion
dotnet_style_prefer_conditional_expression_over_assignment=true:refactoring
dotnet_style_prefer_conditional_expression_over_return=true:refactoring
csharp_prefer_simple_default_expression=true:suggestion

#### C# Coding Conventions ####

# Types: use keywords instead of BCL types, and permit var only when the type is clear
csharp_style_var_for_built_in_types=false:suggestion
csharp_style_var_when_type_is_apparent=false:none
csharp_style_var_elsewhere=false:suggestion

# Expression-bodied members
csharp_style_expression_bodied_methods=true:refactoring
csharp_style_expression_bodied_constructors=true:refactoring
csharp_style_expression_bodied_operators=true:refactoring
csharp_style_expression_bodied_properties=true:refactoring
csharp_style_expression_bodied_indexers=true:refactoring
csharp_style_expression_bodied_accessors=true:refactoring
csharp_style_expression_bodied_lambdas=true:refactoring
csharp_style_expression_bodied_local_functions=true:refactoring

# Pattern matching
csharp_style_pattern_matching_over_is_with_cast_check=true:suggestion
csharp_style_pattern_matching_over_as_with_null_check=true:suggestion
csharp_style_inlined_variable_declaration=true:suggestion

# Null checking preferences
csharp_style_throw_expression=true:suggestion
csharp_style_conditional_delegate_call=true:suggestion

# Other features
csharp_style_prefer_index_operator=false:none
csharp_style_prefer_range_operator=false:none
csharp_style_pattern_local_over_anonymous_function=false:none

#### C# Formatting Rules ####

# New line preferences
csharp_new_line_before_open_brace=all
csharp_new_line_before_else=true
csharp_new_line_before_catch=true
csharp_new_line_before_finally=true
csharp_new_line_before_members_in_object_initializers=true
csharp_new_line_before_members_in_anonymous_types=true
csharp_new_line_within_query_expression_clauses=true

# Indentation preferences
csharp_indent_block_contents=true
csharp_indent_braces=false
csharp_indent_case_contents=true
csharp_indent_switch_labels=true
csharp_indent_labels=one_less_than_current

# Code style defaults
csharp_using_directive_placement=outside_namespace:suggestion
csharp_prefer_braces=true:refactoring
csharp_preserve_single_line_blocks=true:none
csharp_preserve_single_line_statements=false:none
csharp_prefer_static_local_function=true:suggestion
csharp_prefer_simple_using_statement=false:none
csharp_style_prefer_switch_expression=true:suggestion

# Space preferences
csharp_space_after_cast=false
csharp_space_after_colon_in_inheritance_clause=true
csharp_space_after_comma=true
csharp_space_after_dot=false
csharp_space_after_keywords_in_control_flow_statements=true
csharp_space_after_semicolon_in_for_statement=true
csharp_space_around_binary_operators=before_and_after
csharp_space_around_declaration_statements=do_not_ignore
csharp_space_before_colon_in_inheritance_clause=true
csharp_space_before_comma=false
csharp_space_before_dot=false
csharp_space_before_open_square_brackets=false
csharp_space_before_semicolon_in_for_statement=false
csharp_space_between_empty_square_brackets=false
csharp_space_between_method_call_empty_parameter_list_parentheses=false
csharp_space_between_method_call_name_and_opening_parenthesis=false
csharp_space_between_method_call_parameter_list_parentheses=false
csharp_space_between_method_declaration_empty_parameter_list_parentheses=false
csharp_space_between_method_declaration_name_and_open_parenthesis=false
csharp_space_between_method_declaration_parameter_list_parentheses=false
csharp_space_between_parentheses=false
csharp_space_between_square_brackets=false

#### Naming styles ####

# name all constant fields using PascalCase
dotnet_naming_rule.constant_fields_should_be_pascal_case.severity=suggestion
dotnet_naming_rule.constant_fields_should_be_pascal_case.symbols=constant_fields
dotnet_naming_rule.constant_fields_should_be_pascal_case.style=pascal_case_style
dotnet_naming_symbols.constant_fields.applicable_kinds=field
dotnet_naming_symbols.constant_fields.required_modifiers=const
dotnet_naming_style.pascal_case_style.capitalization=pascal_case

# static fields should have s_ prefix
dotnet_naming_rule.static_fields_should_have_prefix.severity=suggestion
dotnet_naming_rule.static_fields_should_have_prefix.symbols=static_fields
dotnet_naming_rule.static_fields_should_have_prefix.style=static_prefix_style
dotnet_naming_symbols.static_fields.applicable_kinds=field
dotnet_naming_symbols.static_fields.required_modifiers=static
dotnet_naming_symbols.static_fields.applicable_accessibilities=private, internal, private_protected
# dotnet_naming_style.static_prefix_style.required_prefix = s_
# dotnet_naming_style.static_prefix_style.capitalization = camel_case

# internal and private fields should be _camelCase
dotnet_naming_rule.camel_case_for_private_internal_fields.severity=suggestion
dotnet_naming_rule.camel_case_for_private_internal_fields.symbols=private_internal_fields
dotnet_naming_rule.camel_case_for_private_internal_fields.style=camel_case_underscore_style

dotnet_naming_symbols.private_internal_fields.applicable_kinds=field
dotnet_naming_symbols.private_internal_fields.applicable_accessibilities=private, internal

dotnet_naming_style.camel_case_underscore_style.required_prefix=_
dotnet_naming_style.camel_case_underscore_style.capitalization=camel_case

# Analyzers
dotnet_code_quality.ca1802.api_surface=private, internal

# ReSharper properties
resharper_place_accessorholder_attribute_on_same_line=false

[*.{asm,inc}]
indent_size=8

[CMakeLists.txt]
indent_size=2

[*.cmd]
indent_size=2

[*.{xml,config,*proj,nuspec,props,resx,targets,yml,tasks}]
indent_size=2

[*.json]
indent_size=2

[*.{ps1,psm1}]
indent_size=4

[*.sh]
indent_size=4
end_of_line=lf

[*.md]
max_line_length=off
trim_trailing_whitespace=false

[package.json]
charset=utf-8