Add global 'f' alias for FormatterBuilder

Register a class alias that maps 'f' to FormatterBuilder, auto-loaded
via Composer's files directive. This provides a concise entry point for
building formatter chains (e.g., f::create()->mask(...)) without
requiring an explicit use statement, simplifying usage in consumer code
and aligning the README examples with the new convention.

Assisted-by: Claude Code (Claude Opus 4.6)

Author: henriquemoody

.gitattributes

@@ -1,4 +1,5 @@
 /* export-ignore
+/aliases.php -export-ignore
 /composer.json -export-ignore
 /src -export-ignore
 /LICENSE -export-ignore

README.md

@@ -26,8 +26,6 @@ composer require respect/string-formatter
 You can use individual formatters directly or chain multiple formatters together using the `FormatterBuilder`:
 
 ```php
-use Respect\StringFormatter\FormatterBuilder as f;
-
 echo f::create()
     ->mask('7-12')
     ->pattern('#### #### #### ####')

aliases.php

@@ -0,0 +1,19 @@
+<?php
+
+/*
+ * SPDX-License-Identifier: MIT
+ * SPDX-FileCopyrightText: (c) Respect Project Contributors
+ * SPDX-FileContributor: Alexandre Gomes Gaigalas <alganet@gmail.com>
+ * SPDX-FileContributor: Andy Wendt <andy@awendt.com>
+ * SPDX-FileContributor: Graham Campbell <graham@mineuk.com>
+ * SPDX-FileContributor: Henrique Moody <henriquemoody@gmail.com>
+ * SPDX-FileContributor: Nick Lombard <github@jigsoft.co.za>
+ */
+
+declare(strict_types=1);
+
+use Respect\StringFormatter\FormatterBuilder;
+
+if (!class_exists('f')) {
+    class_alias(FormatterBuilder::class, 'f');
+}

composer.json

@@ -24,7 +24,8 @@
     "autoload": {
         "psr-4": {
             "Respect\\StringFormatter\\": "src/"
-        }
+        },
+        "files": ["aliases.php"]
     },
     "autoload-dev": {
         "psr-4": {