Enable antiforgery token metadata by default

README.md

@@ -38,7 +38,6 @@ Register the toolkit and select the HTMX version used by the application:
 ```csharp
 builder.Services.AddHtmxToolkit(options =>
 {
-    options.IncludeAntiforgeryToken = true;
     options.UseHtmxV2(config =>
     {
         config.DefaultSwapStyle = HtmxSwap.OuterHtml;
@@ -660,7 +659,6 @@ The version-specific callback exposes only settings supported by the selected HT
 ```csharp
 builder.Services.AddHtmxToolkit(options =>
 {
-    options.IncludeAntiforgeryToken = true;
     options.UseHtmxV2(config =>
     {
         config.DefaultSwapStyle = HtmxSwap.OuterHtml;
@@ -756,9 +754,21 @@ responses, configure `NoSwap` as shown in the HTMX 4.x example above.
 ## Toolkit Script
 
 The toolkit script provides antiforgery support and HTMX compatibility behavior.
-If you have enabled **Antiforgery** token generation in the configuration
-(`IncludeAntiforgeryToken = true`), include it to ensure the token is present in form
-parameters or headers and refreshed in a timely manner.
+Antiforgery metadata generation is enabled by default. Include the script to ensure the
+token is added to non-GET request form parameters or headers and refreshed in a timely manner.
+
+Sending the token does not enable server-side validation by itself. Configure antiforgery
+validation for the corresponding ASP.NET Core endpoints as appropriate.
+
+To disable antiforgery metadata generation—for example, when the application handles
+antiforgery separately or does not issue unsafe HTMX requests—set the option to `false`:
+
+```csharp
+builder.Services.AddHtmxToolkit(options =>
+{
+    options.IncludeAntiforgeryToken = false;
+});
+```
 
 To do this, you can directly include the contents of the script file on the page:
 

src/Ramstack.HtmxToolkit/HtmxToolkitOptions.cs

@@ -29,8 +29,9 @@ public HtmxConfig HtmxConfig
 
     /// <summary>
     /// Gets or sets a value indicating whether antiforgery request metadata is rendered by the configuration tag helper.
+    /// Defaults to <see langword="true"/>.
     /// </summary>
-    public bool IncludeAntiforgeryToken { get; set; }
+    public bool IncludeAntiforgeryToken { get; set; } = true;
 
     /// <summary>
     /// Gets the HTMX major version used for version-sensitive generated markup.

tests/Ramstack.HtmxToolkit.Tests/HtmxConfigTagHelperTests.cs

@@ -313,11 +313,11 @@ public async Task ProcessAsync_EscapesHtmlSensitiveCharacters()
     }
 
     [Test]
-    public async Task ProcessAsync_IncludeAntiforgeryToken_RendersDataAttributes()
+    public async Task ProcessAsync_AntiforgeryEnabledByDefault_RendersDataAttributes()
     {
         var antiforgery = new StubAntiforgery();
         var httpContext = new DefaultHttpContext();
-        var options = new HtmxToolkitOptions { IncludeAntiforgeryToken = true };
+        var options = new HtmxToolkitOptions();
         var helper = CreateHelper(options, antiforgery);
         helper.ViewContext = new ViewContext { HttpContext = httpContext };
 
@@ -341,7 +341,7 @@ public async Task ProcessAsync_AntiforgeryDisabled_DoesNotRequestOrRenderTokens(
         var antiforgery = new StubAntiforgery();
         var output = TestHelper.CreateTagHelperOutput();
 
-        await CreateHelper(new HtmxToolkitOptions(), antiforgery)
+        await CreateHelper(new HtmxToolkitOptions { IncludeAntiforgeryToken = false }, antiforgery)
             .ProcessAsync(TestHelper.CreateTagHelperContext(), output);
 
         Assert.Multiple(() =>
@@ -362,7 +362,10 @@ await CreateHelper(new HtmxToolkitOptions(), antiforgery)
     }
 
     private static HtmxConfigTagHelper CreateHelper(HtmxToolkitOptions options, IAntiforgery? antiforgery = null) =>
-        new(antiforgery ?? new StubAntiforgery(), Options.Create(options));
+        new(antiforgery ?? new StubAntiforgery(), Options.Create(options))
+        {
+            ViewContext = new ViewContext { HttpContext = new DefaultHttpContext() }
+        };
 
     private static string GetContent(TagHelperOutput output) =>
         output.Attributes["content"]!.Value!.ToString()!;

tests/Ramstack.HtmxToolkit.Tests/HtmxToolkitOptionsTests.cs

@@ -147,7 +147,7 @@ public void AddHtmxToolkit_WithoutConfiguration_ExposesDefaultOptions()
         {
             Assert.That(options.TargetVersion, Is.EqualTo(HtmxTargetVersion.V2));
             Assert.That(options.HtmxConfig, Is.TypeOf<HtmxV2Config>());
-            Assert.That(options.IncludeAntiforgeryToken, Is.False);
+            Assert.That(options.IncludeAntiforgeryToken, Is.True);
         });
     }
 }