feat: Naming::headline(), the words of a name as Str::headline() writes them

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- `Naming::headline()`, the words of a name with a capital each, as Laravel's `Str::headline()` writes them, for the packages that label a role or a binding source from its class name
+
 ## [0.1.0] - 2026-10-12
 
 A first version for the framework's next release to build on; 1.0.0 comes with that release.

src/Support/Naming.php

@@ -38,6 +38,25 @@ public static function kebab(string $value): string
         return self::snake($value, '-');
     }
 
+    /**
+     * The value as words with a capital each, as Laravel's Str::headline()
+     * writes it: `EventManager`, `event_manager` and `event-manager` give
+     * `Event Manager`.
+     */
+    public static function headline(string $value): string
+    {
+        $words = mb_split('\s+', $value) ?: [$value];
+        $title = static fn (string $word): string => mb_convert_case($word, MB_CASE_TITLE, 'UTF-8');
+
+        $parts = count($words) > 1
+            ? array_map($title, $words)
+            : array_map($title, preg_split('/(?=\p{Lu})/u', implode('_', $words), -1, PREG_SPLIT_NO_EMPTY) ?: []);
+
+        $collapsed = str_replace(['-', '_', ' '], '_', implode('_', $parts));
+
+        return implode(' ', array_filter(explode('_', $collapsed)));
+    }
+
     /**
      * The class name without its namespace.
      */

tests/Unit/NamingTest.php

@@ -33,6 +33,10 @@
     expect(Naming::kebab($name))->toBe(Str::kebab($name));
 })->with('names');
 
+it('writes headlines as Str::headline() does', function (string $name): void {
+    expect(Naming::headline($name))->toBe(Str::headline($name));
+})->with('names')->with(['kebab-case' => 'event-manager', 'snake with digits' => 'event_manager_2', 'several words' => 'Event manager role', 'empty' => '']);
+
 it('strips the namespace as class_basename() does', function (): void {
     expect(Naming::classBasename('App\\Cms\\PostTypes\\Book'))->toBe(class_basename('App\\Cms\\PostTypes\\Book'))
         ->and(Naming::classBasename('Book'))->toBe('Book');