[matt-edmondson]

Fixes #143

What changed

• SourceFileTemplateExtensions.AddSourceFile used to write the template's attributes first, through AddTemplate, and then the namespace and the usings. A file-level attribute can only be global (assembly: / module:), so any file that set both Attributes and Usings failed to compile: CS1529 with no namespace, and CS0246 with one, because the attribute sat outside the namespace the usings were declared in.
• When the file has attributes, it now writes the usings, then the attributes followed by a blank line, then the namespace. This is the only layout in which the attribute resolves through the file's own usings.
• A file with no attributes renders exactly as before, so the golden output and the existing ASourceFileWritesItsPreambleThenItsTypes test are unchanged.
• Documentation and comments still come first in both layouts. I added a <remarks> explaining the ordering.
• I did not add the optional rejection of Keywords on a file template. That would be a behaviour change beyond this bug.

Tests

• Two new tests in TemplateTests: ASourceFileWritesItsGlobalAttributesAfterItsUsingsAndBeforeItsNamespace and ASourceFileWithNoNamespaceWritesItsGlobalAttributesAfterItsUsings.
• With the fix reverted, both tests fail.
• I compiled both rendered layouts in a scratch net10.0 class library. Both build cleanly.
• The full suite passes (225/225, net10.0).

---

Generated by Claude Code

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud