feat: add DesignTokensTests to validate tokens.css presence and content for ShellDocs.Tokens project

Author: Shewart

shelldocs.slnx

@@ -8,6 +8,7 @@
     <Project Path="src/ShellDocs.Core/ShellDocs.Core.csproj" />
     <Project Path="src/ShellDocs.Markdown/ShellDocs.Markdown.csproj" />
     <Project Path="src/ShellDocs.Templates/ShellDocs.Templates.csproj" />
+    <Project Path="src/ShellDocs.Tokens/ShellDocs.Tokens.csproj" />
   </Folder>
   <Folder Name="/tests/">
     <Project Path="tests/ShellDocs.Tests/ShellDocs.Tests.csproj" />

tests/ShellDocs.Tests/DesignTokensTests.cs

@@ -0,0 +1,83 @@
+using System.Reflection;
+using Xunit;
+
+namespace ShellDocs.Tests;
+
+/* The Tokens RCL ships one static asset: tokens.css. If anyone renames the
+   file, changes the package id, or accidentally drops the file from the
+   build, these tests fail loud before it hits a consumer. */
+public class DesignTokensTests
+{
+    private static string LoadTokensCss()
+    {
+        // MSBuild copies the RCL's static web assets into a predictable location
+        // under the test project's output. Walk up from the test assembly to find
+        // the package's wwwroot/tokens.css.
+        var testAssembly = Assembly.GetExecutingAssembly().Location;
+        var testDir = Path.GetDirectoryName(testAssembly)!;
+
+        // Traverse the well-known static-web-asset path emitted by the Razor SDK.
+        var candidates = new[]
+        {
+            Path.Combine(testDir, "wwwroot", "_content", "ShellDocs.Tokens", "tokens.css"),
+            Path.Combine(testDir, "..", "..", "..", "..", "..", "src", "ShellDocs.Tokens", "wwwroot", "tokens.css")
+        };
+        foreach (var c in candidates)
+        {
+            var full = Path.GetFullPath(c);
+            if (File.Exists(full)) return File.ReadAllText(full);
+        }
+        throw new FileNotFoundException(
+            $"tokens.css not found — checked: {string.Join(", ", candidates.Select(Path.GetFullPath))}");
+    }
+
+    [Fact]
+    public void TokensFile_Exists_AndIsNonEmpty()
+    {
+        var css = LoadTokensCss();
+        Assert.NotEmpty(css);
+        Assert.True(css.Length > 500, "tokens.css looks unexpectedly small");
+    }
+
+    [Theory]
+    [InlineData("--background")]
+    [InlineData("--foreground")]
+    [InlineData("--primary")]
+    [InlineData("--muted")]
+    [InlineData("--accent")]
+    [InlineData("--border")]
+    [InlineData("--radius")]
+    [InlineData("--sidebar-width")]
+    [InlineData("--header-height")]
+    [InlineData("--font-sans")]
+    [InlineData("--font-mono")]
+    [InlineData("--info")]
+    [InlineData("--warning")]
+    [InlineData("--error")]
+    [InlineData("--success")]
+    public void TokensFile_DefinesStableToken(string token)
+    {
+        var css = LoadTokensCss();
+        Assert.Contains(token + ":", css);
+    }
+
+    [Fact]
+    public void TokensFile_DefinesLightAndDarkRoots()
+    {
+        var css = LoadTokensCss();
+        Assert.Contains(":root {", css);
+        Assert.Contains(":root.dark {", css);
+    }
+
+    [Fact]
+    public void TokensFile_DarkRoot_OverridesBackground()
+    {
+        // Both blocks must redefine --background so the .dark class actually flips it.
+        var css = LoadTokensCss();
+        var darkStart = css.IndexOf(":root.dark {", StringComparison.Ordinal);
+        Assert.True(darkStart > 0);
+        var darkBlock = css.Substring(darkStart);
+        Assert.Contains("--background:", darkBlock);
+        Assert.Contains("--foreground:", darkBlock);
+    }
+}

tests/ShellDocs.Tests/ShellDocs.Tests.csproj

@@ -10,6 +10,7 @@
     <ProjectReference Include="..\..\src\ShellDocs.Markdown\ShellDocs.Markdown.csproj" />
     <ProjectReference Include="..\..\src\ShellDocs.Components\ShellDocs.Components.csproj" />
     <ProjectReference Include="..\..\src\ShellDocs.Templates\ShellDocs.Templates.csproj" />
+    <ProjectReference Include="..\..\src\ShellDocs.Tokens\ShellDocs.Tokens.csproj" />
   </ItemGroup>
 
   <ItemGroup>