Merge pull request #22 from TimeWarpEngineering/Cramer/2025-07-31/filename-rule

Refactor analyzer IDs and remove HelloWorld generator

Author: StevenTCramer

.editorconfig

@@ -274,10 +274,8 @@ dotnet_naming_style.local_function_style.capitalization = pascal_case
 
 # dotnet_diagnostic options
 dotnet_diagnostic.CS1591.severity = none
-dotnet_diagnostic.TW0001.severity = suggestion
-dotnet_diagnostic.TWD001.severity = warning
-dotnet_diagnostic.TW0003.severity = none  # Set to warning/error to enforce kebab-case file naming
-dotnet_diagnostic.TW0003.excluded_files = *.g.cs;*.Generated.cs;*.generated.cs;*.designer.cs;*.Designer.cs;Directory.Build.props;Directory.Build.targets;Directory.Packages.props;AssemblyInfo.cs;*.AssemblyAttributes.cs;AnalyzerReleases.Shipped.md;AnalyzerReleases.Unshipped.md
+dotnet_diagnostic.TWA001.severity = none  # Set to warning/error to enforce kebab-case file naming
+dotnet_diagnostic.TWA001.excluded_files = *.g.cs;*.Generated.cs;*.generated.cs;*.designer.cs;*.Designer.cs;*.razor.cs;Directory.Build.props;Directory.Build.targets;Directory.Packages.props;AssemblyInfo.cs;*.AssemblyAttributes.cs;AnalyzerReleases.Shipped.md;AnalyzerReleases.Unshipped.md
 
 #### Analyzer settings ####
 dotnet_code_quality.null_check_validation_methods = NotNull

Directory.Build.props

@@ -5,7 +5,7 @@
     <Authors>Steven T. Cramer</Authors>
     <Product>TimeWarp.SourceGenerators</Product>
     <PackageId>TimeWarp.SourceGenerators</PackageId>
-    <PackageVersion>1.0.0-beta.3</PackageVersion>
+    <PackageVersion>1.0.0-beta.4</PackageVersion>
     <PackageProjectUrl>https://timewarpengineering.github.io/timewarp-source-generators/</PackageProjectUrl>
     <PackageTags>TimeWarp; Source Generator;SourceGenerators; Delegate</PackageTags>
     <PackageIcon>logo.png</PackageIcon>

documentation/developer/conceptual/analyzer-release-tracking.md

@@ -71,9 +71,9 @@ AnalyzerReleases.Unshipped.md:
 ### New Rules
 Rule ID | Category | Severity | Notes
 --------|----------|----------|-------
-TW0001 | SourceGenerator | Info | HelloWorldGenerator
-TW0002 | SourceGenerator | Info | MarkdownDocsGenerator  
-TW0003 | Naming | Info | FileNameRuleAnalyzer, disabled by default
+TWG001 | SourceGenerator | Info | MarkdownDocsGenerator  
+TWA001 | Naming | Info | FileNameRuleAnalyzer, disabled by default
+TWA002 | Documentation | Info | XmlDocsToMarkdownAnalyzer
 
 AnalyzerReleases.Shipped.md:
 ## Release 1.0

documentation/developer/reference/analyzers/file-name-rule-analyzer.md

@@ -1,12 +1,12 @@
-# FileNameRuleAnalyzer (TW0003)
+# FileNameRuleAnalyzer (TWA001)
 
 ## Overview
 
 The FileNameRuleAnalyzer enforces kebab-case naming conventions for C# source files. This analyzer helps maintain consistent file naming across projects that prefer kebab-case (e.g., `my-component.cs`) over traditional PascalCase.
 
 ## Rule Details
 
-- **Rule ID**: TW0003
+- **Rule ID**: TWA001
 - **Category**: Naming
 - **Default Severity**: Info (disabled by default)
 - **Message**: File '{0}' should use kebab-case naming convention (e.g., 'my-file.cs')
@@ -41,25 +41,26 @@ The analyzer is disabled by default to avoid breaking existing projects. To enab
 
 ```ini
 # Enable with warning severity
-dotnet_diagnostic.TW0003.severity = warning
+dotnet_diagnostic.TWA001.severity = warning
 
 # Or as an error to fail builds
-dotnet_diagnostic.TW0003.severity = error
+dotnet_diagnostic.TWA001.severity = error
 
 # Or as a suggestion for gentle nudging
-dotnet_diagnostic.TW0003.severity = suggestion
+dotnet_diagnostic.TWA001.severity = suggestion
 ```
 
 ### Exception Patterns
 
 Configure files that should be excluded from the rule:
 
 ```ini
-dotnet_diagnostic.TW0003.excluded_files = *.g.cs;*.Generated.cs;GlobalUsings.cs;Program.cs;Startup.cs
+dotnet_diagnostic.TWA001.excluded_files = *.g.cs;*.Generated.cs;GlobalUsings.cs;Program.cs;Startup.cs
 ```
 
 Default exceptions include:
 - Generated files (`*.g.cs`, `*.Generated.cs`, `*.designer.cs`)
+- Razor component code-behind files (`*.razor.cs`) - must match their `.razor` file names
 - Build files (`Directory.Build.props`, `Directory.Build.targets`, `Directory.Packages.props`)
 - Assembly metadata (`AssemblyInfo.cs`)
 - Analyzer tracking files (`AnalyzerReleases.Shipped.md`, `AnalyzerReleases.Unshipped.md`)
@@ -87,10 +88,10 @@ In your root `.editorconfig`:
 ```ini
 [*.cs]
 # Enable kebab-case file naming for all C# files
-dotnet_diagnostic.TW0003.severity = warning
+dotnet_diagnostic.TWA001.severity = warning
 
 # But allow exceptions for specific patterns
-dotnet_diagnostic.TW0003.excluded_files = *.g.cs;*.Generated.cs;*.designer.cs;Program.cs;Startup.cs;GlobalUsings.cs;AssemblyInfo.cs
+dotnet_diagnostic.TWA001.excluded_files = *.g.cs;*.Generated.cs;*.designer.cs;Program.cs;Startup.cs;GlobalUsings.cs;AssemblyInfo.cs
 ```
 
 ### Gradual Adoption
@@ -99,29 +100,29 @@ For existing projects, start with suggestion severity:
 
 ```ini
 [*.cs]
-dotnet_diagnostic.TW0003.severity = suggestion
+dotnet_diagnostic.TWA001.severity = suggestion
 
 # Only enforce in new feature folders
 [Features/**.cs]
-dotnet_diagnostic.TW0003.severity = warning
+dotnet_diagnostic.TWA001.severity = warning
 ```
 
 ## Suppressing Violations
 
 For specific files that need exceptions beyond the configured patterns:
 
 ```csharp
-#pragma warning disable TW0003 // File name should use kebab-case
+#pragma warning disable TWA001 // File name should use kebab-case
 // File: LegacyAPIClient.cs
-#pragma warning restore TW0003
+#pragma warning restore TWA001
 ```
 
 Or in the project file:
 
 ```xml
 <ItemGroup>
   <Compile Update="LegacyAPIClient.cs">
-    <AnalyzerSuppression>TW0003</AnalyzerSuppression>
+    <AnalyzerSuppression>TWA001</AnalyzerSuppression>
   </Compile>
 </ItemGroup>
 ```

documentation/developer/reference/analyzers/overview.md

@@ -2,11 +2,11 @@
 
 ## Available Analyzers
 
-### TW0003 - File Name Rule Analyzer
+### TWA001 - File Name Rule Analyzer
 
 Enforces kebab-case naming convention for C# source files.
 
-- **Rule ID**: TW0003
+- **Rule ID**: TWA001
 - **Category**: Naming  
 - **Default Severity**: Info (disabled)
 - **Configuration**: `.editorconfig`
@@ -19,10 +19,10 @@ All analyzers are configured through `.editorconfig`:
 
 ```ini
 # Enable an analyzer
-dotnet_diagnostic.TW0003.severity = warning
+dotnet_diagnostic.TWA001.severity = warning
 
 # Configure exceptions
-dotnet_diagnostic.TW0003.excluded_files = *.g.cs;*.Generated.cs
+dotnet_diagnostic.TWA001.excluded_files = *.g.cs;*.Generated.cs
 ```
 
 ## Analyzer Categories
@@ -34,15 +34,15 @@ dotnet_diagnostic.TW0003.excluded_files = *.g.cs;*.Generated.cs
 
 1. **File-level pragma**:
    ```csharp
-   #pragma warning disable TW0003
+   #pragma warning disable TWA001
    ```
 
 2. **Project-wide**:
    ```xml
-   <NoWarn>TW0003</NoWarn>
+   <NoWarn>TWA001</NoWarn>
    ```
 
 3. **EditorConfig**:
    ```ini
-   dotnet_diagnostic.TW0003.severity = none
+   dotnet_diagnostic.TWA001.severity = none
    ```

documentation/developer/reference/source-generators/overview.md

@@ -2,15 +2,7 @@
 
 ## Available Source Generators
 
-### HelloWorldGenerator (TW0001)
-
-A simple demonstration source generator that creates a static class with a hello message.
-
-- **Generated File**: `HelloWorld.g.cs`
-- **Namespace**: `TimeWarp.Generated`
-- **Diagnostic**: Info message when loaded
-
-### MarkdownDocsGenerator (TW0002)
+### MarkdownDocsGenerator (TWG001)
 
 Generates XML documentation from markdown files for C# classes.
 

documentation/overview.md

@@ -14,11 +14,10 @@ Technical documentation for developers using or contributing to the project.
 ## What's Included
 
 ### Source Generators
-- **HelloWorldGenerator** - Example generator
 - **MarkdownDocsGenerator** - Generates markdown from XML docs
 
 ### Analyzers
-- **TW0003** - File name kebab-case enforcement
+- **TWA001** - File name kebab-case enforcement
 
 ## Configuration
 

source/timewarp-source-generators/AnalyzerReleases.Unshipped.md

@@ -2,7 +2,6 @@
 
 Rule ID | Category | Severity | Notes
 --------|----------|----------|-------
-TW0001 | SourceGenerator | Info | HelloWorldGenerator
-TW0002 | SourceGenerator | Info | MarkdownDocsGenerator - Enhanced to support kebab-case file matching
-TW0003 | Naming | Info | FileNameRuleAnalyzer, disabled by default
-TW0004 | Documentation | Info | XmlDocsToMarkdownAnalyzer
+TWG001 | SourceGenerator | Info | MarkdownDocsGenerator - Enhanced to support kebab-case file matching
+TWA001 | Naming | Info | FileNameRuleAnalyzer, disabled by default
+TWA002 | Documentation | Info | XmlDocsToMarkdownAnalyzer

source/timewarp-source-generators/file-name-rule-analyzer.cs

@@ -3,7 +3,7 @@ namespace TimeWarp.SourceGenerators;
 [Generator]
 public class FileNameRuleAnalyzer : IIncrementalGenerator
 {
-  public const string DiagnosticId = "TW0003";
+  public const string DiagnosticId = "TWA001";
   private const string Category = "Naming";
 
   private static readonly DiagnosticDescriptor Rule = new(
@@ -27,6 +27,7 @@ public class FileNameRuleAnalyzer : IIncrementalGenerator
     "*.generated.cs",
     "*.designer.cs",
     "*.Designer.cs",
+    "*.razor.cs",  // Razor component code-behind files must match their .razor file names
     "Directory.Build.props",
     "Directory.Build.targets",
     "Directory.Packages.props",
@@ -98,7 +99,7 @@ private string[] GetConfiguredExceptions(AnalyzerConfigOptionsProvider configOpt
 
     // Try to get configured exceptions from .editorconfig
     if (options.TryGetValue(
-      "dotnet_diagnostic.TW0003.excluded_files", 
+      "dotnet_diagnostic.TWA001.excluded_files", 
       out string? configuredExceptions) && !string.IsNullOrEmpty(configuredExceptions))
     {
       // Split by semicolon and trim whitespace