2.5.4

Author: StefH

CHANGELOG.md

@@ -1,7 +1,6 @@
-# 2.5.4 (TBD)
-- Fix String.Split to correctly handle multi-character separators (e.g., `"<br />"` now splits on the whole string instead of each character) [bug]
-- Add String.First helper to get the first element from an array/collection [enhancement]
-- Add String.Last helper to get the last element from an array/collection [enhancement]
+# 2.5.4 (21 December 2025)
+- [#135](https://github.com/Handlebars-Net/Handlebars.Net.Helpers/pull/135) - Add String.First/Last helpers and fix Split for multi-char separators [enhancement] contributed by [ablyler](https://github.com/ablyler)
+- [#130](https://github.com/Handlebars-Net/Handlebars.Net.Helpers/issues/130) - Conflict Between Truncate Helpers Prevents Usage Without Prefix [bug]
 
 # 2.5.3 (13 September 2025)
 - [#132](https://github.com/Handlebars-Net/Handlebars.Net.Helpers/pull/132) - Humanizer Truncate should always be used as &quot;Humanizer.Truncate&quot; [bug] contributed by [StefH](https://github.com/StefH)

Generate-ReleaseNotes.cmd

@@ -1,5 +1,5 @@
 rem https://github.com/StefH/GitHubReleaseNotes
 
-SET version=2.5.3
+SET version=2.5.4
 
 GitHubReleaseNotes --output CHANGELOG.md --skip-empty-releases --exclude-labels question invalid documentation duplicate --version %version% --token %GH_TOKEN%

src/Directory.Build.props

@@ -5,7 +5,7 @@
 
   <PropertyGroup>
     <TargetFrameworks>net451;net452;net46;netstandard1.3;netstandard2.0;netstandard2.1;net6.0;net8.0</TargetFrameworks>
-    <VersionPrefix>2.5.3</VersionPrefix>
+    <VersionPrefix>2.5.4</VersionPrefix>
     <LangVersion>12</LangVersion>
     <Nullable>enable</Nullable>
     <Copyright>Copyright © 2020-2025 Stef Heyenrath</Copyright>

test/Handlebars.Net.Helpers.Tests/Handlebars.Net.Helpers.Tests.csproj

@@ -18,7 +18,7 @@
             <PrivateAssets>all</PrivateAssets>
             <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
         </PackageReference>
-        <PackageReference Include="CultureAwareTesting.xUnit" Version="0.0.1" />
+        <PackageReference Include="CultureAwareTesting.xUnit" Version="0.0.1.1" />
         <PackageReference Include="FluentAssertions" Version="5.10.3" />
         <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" />
         <PackageReference Include="Moq" Version="4.17.2" />

test/Handlebars.Net.Helpers.Tests/Helpers/StringHelpersTests.cs

@@ -127,6 +127,42 @@ public void Ellipsis(string value, int length, string expected)
         result.Should().Be(expected);
     }
 
+    [Fact]
+    public void First_ReturnsFirstElement()
+    {
+        // Arrange
+        var values = new object[] { "first", "second", "third" };
+
+        // Act
+        var result = _sut.First(values);
+
+        // Assert
+        result.Should().Be("first");
+    }
+
+    [Fact]
+    public void First_ReturnsNullForEmptyCollection()
+    {
+        // Arrange
+        var values = new object[0];
+
+        // Act
+        var result = _sut.First(values);
+
+        // Assert
+        result.Should().BeNull();
+    }
+
+    [Fact]
+    public void First_ThrowsForNullCollection()
+    {
+        // Act
+        Action action = () => _sut.First(null!);
+
+        // Assert
+        action.Should().Throw<ArgumentNullException>();
+    }
+
     [Theory]
     [InlineData("Hello &amp; World", "Hello & World")]
     [InlineData("1 &lt; 2 &gt; 0", "1 < 2 > 0")]
@@ -613,42 +649,6 @@ public void Split(string value, string separator, string[] expected)
         result.Should().BeEquivalentTo(expected);
     }
 
-    [Fact]
-    public void First_ReturnsFirstElement()
-    {
-        // Arrange
-        var values = new object[] { "first", "second", "third" };
-
-        // Act
-        var result = _sut.First(values);
-
-        // Assert
-        result.Should().Be("first");
-    }
-
-    [Fact]
-    public void First_ReturnsNullForEmptyCollection()
-    {
-        // Arrange
-        var values = Array.Empty<object>();
-
-        // Act
-        var result = _sut.First(values);
-
-        // Assert
-        result.Should().BeNull();
-    }
-
-    [Fact]
-    public void First_ThrowsForNullCollection()
-    {
-        // Act
-        Action action = () => _sut.First(null!);
-
-        // Assert
-        action.Should().Throw<ArgumentNullException>();
-    }
-
     [Fact]
     public void Last_ReturnsLastElement()
     {
@@ -666,7 +666,7 @@ public void Last_ReturnsLastElement()
     public void Last_ReturnsNullForEmptyCollection()
     {
         // Arrange
-        var values = Array.Empty<object>();
+        var values = new object[0];
 
         // Act
         var result = _sut.Last(values);