Inital commit after splitting vom main project

tests/TruncateTest.php

@@ -0,0 +1,111 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tez\Utils\Tests\Str;
+
+use PHPUnit\Framework\TestCase;
+use Tez\Utils\Str\Truncate;
+
+final class TruncateTest extends TestCase
+{
+    // -------------------------------------------------------------------------
+    // Short strings — returned unchanged
+    // -------------------------------------------------------------------------
+
+    public function testShortStringReturnedUnchanged(): void
+    {
+        self::assertSame('Short', Truncate::chars('Short', 20));
+    }
+
+    public function testStringExactlyAtLimitReturnedUnchanged(): void
+    {
+        self::assertSame('12345', Truncate::chars('12345', 5));
+    }
+
+    // -------------------------------------------------------------------------
+    // Word boundary (default)
+    // -------------------------------------------------------------------------
+
+    public function testTruncatesAtWordBoundary(): void
+    {
+        // cut position falls on a space → keep up to the space
+        self::assertSame(
+            'The quick brown fox…',
+            Truncate::chars('The quick brown fox jumps over the lazy dog', 20),
+        );
+    }
+
+    public function testTruncatesBackToLastWordWhenCutIsInsideWord(): void
+    {
+        // limit=15, suffix=1 → cut at 14 chars → 'The quick brow' → trims to 'The quick'
+        self::assertSame('The quick…', Truncate::chars('The quick brown fox', 15));
+    }
+
+    public function testWordBoundaryWithNoSpaceInCutKeepsRawCut(): void
+    {
+        self::assertSame('Hello…', Truncate::chars('Hellothere', 6));
+    }
+
+    // -------------------------------------------------------------------------
+    // Exact cut (wordBoundary = false)
+    // -------------------------------------------------------------------------
+
+    public function testExactCutIgnoresWordBoundary(): void
+    {
+        self::assertSame(
+            'The quick brown fox…',
+            Truncate::chars('The quick brown fox jumps', 20, wordBoundary: false),
+        );
+    }
+
+    public function testExactCutSplitsWord(): void
+    {
+        self::assertSame('The quick bro…', Truncate::chars('The quick brown fox', 14, wordBoundary: false));
+    }
+
+    // -------------------------------------------------------------------------
+    // Custom suffix
+    // -------------------------------------------------------------------------
+
+    public function testCustomSuffix(): void
+    {
+        // suffix=' [...]' (6 chars), limit=22 → cut at 16 → 'The quick brown ' → trims to 'The quick brown'
+        self::assertSame(
+            'The quick brown [...]',
+            Truncate::chars('The quick brown fox jumps', 22, suffix: ' [...]'),
+        );
+    }
+
+    public function testEmptySuffix(): void
+    {
+        self::assertSame('The quick', Truncate::chars('The quick brown fox', 9, suffix: ''));
+    }
+
+    // -------------------------------------------------------------------------
+    // Multibyte
+    // -------------------------------------------------------------------------
+
+    public function testMultibyteCharactersCountedCorrectly(): void
+    {
+        // 'Ärger mit Umlauten' — each char counts as 1 even though ä is multibyte
+        self::assertSame('Ärger…', Truncate::chars('Ärger mit Umlauten', 6));
+    }
+
+    // -------------------------------------------------------------------------
+    // Edge cases / exceptions
+    // -------------------------------------------------------------------------
+
+    public function testThrowsWhenLimitShorterThanSuffix(): void
+    {
+        $this->expectException(\InvalidArgumentException::class);
+
+        Truncate::chars('Hello', 2, suffix: '...');
+    }
+
+    public function testLimitEqualToSuffixLengthReturnsEmptySuffix(): void
+    {
+        // limit=3, suffix='...' (3 chars) → cutLength=0 → '' + '...'
+        self::assertSame('...', Truncate::chars('Hello world', 3, suffix: '...'));
+    }
+}