Standar New Version

README.md

@@ -50,6 +50,7 @@ To whom we thank for supporting making programming easier.
 - [Alejandro Diaz](https://github.com/alejandrodiazpinilla) (Readme And Icon)
 - [Frank Sepulveda](https://github.com/socieboy) (Ordinal Texts)
 - [Ngô Quốc Đạt](https://github.com/datlechin) (Vietnamese Language)
+- [Mustafa Yusuf Özcan](https://github.com/mustafayusufozcan) (Turkish Language)
 
 ## License
 This project is under the [MIT License](https://choosealicense.com/licenses/mit/).

config/spell-number.php

@@ -7,8 +7,8 @@
     | Global Configuration for Number to Words Conversion.
     |--------------------------------------------------------------------------
     |
-    | See https://rmunate.github.io/SpellNumber/
-    | Define a global configuration to make the translation of values to words easier and faster.
+    | Visit https://rmunate.github.io/SpellNumber/ for detailed documentation.
+    | Define a global configuration to facilitate and expedite the translation of values to words.
     |
     */
 
@@ -20,27 +20,11 @@
         |--------------------------------------------------------------------------
         |
         | Define the language over which values will be translated to words.
-        | Remember that you only have the following options available:
-        | 'de', 'en', 'es', 'fa', 'fr', 'hi', 'it', 'pl', 'pt', 'ro'.
         |
         */
 
         'locale' => 'en',
 
-        /*
-        |--------------------------------------------------------------------------
-        | Try using a "locale" not listed in the previous option.
-        |--------------------------------------------------------------------------
-        |
-        | If you want to use an option different from those previously listed,
-        | you must set the following indicator to true, so that the conversion to the supplied
-        | location can be attempted. To list possible additional options to use with the package,
-        | you can run the function SpellNumber::getAllLocales();
-        |
-        */
-
-        'specific_locale' => false,
-
         /*
         |--------------------------------------------------------------------------
         | Define the Currency.
@@ -83,11 +67,14 @@
 
     /*
     |--------------------------------------------------------------------------
-    | Sometimes you need to replace certain things in the number to words outputs.
+    | Global Output Replacements
     |--------------------------------------------------------------------------
     |
-    | If so, it's very easy to do.
-    | Use the structure of an associative array to apply these replacements to your outputs.
+    | If you need to make any replacements to the translation output, which is common
+    | in cases with abbreviated numbers or other language contractions, you can
+    | easily do so here through an associative array.
+    |
+    | Remember that the main index should match the locale you are using.
     |
     */
 
@@ -97,19 +84,4 @@
         // ],
     ],
 
-    /*
-    |--------------------------------------------------------------------------
-    | Encountered a specific adjustment in the number to words output?.
-    |--------------------------------------------------------------------------
-    |
-    | Here, you have the option to adjust whatever you need, the best part!
-    | This adjustment will apply to all your number to words outputs.
-    |
-    */
-
-    'callback_output' => function ($data) {
-        // Your logic here...
-
-        return $data->getWords();
-    },
-];
+];

src/Bases/BaseSpellNumber.php

@@ -6,7 +6,7 @@
 use Rmunate\Utilities\Validator\SpellNumberValidator;
 
 abstract class BaseSpellNumber
-{
+{   
     /**
      * Creates an instance of the child class with the provided value for conversion.
      *
@@ -17,7 +17,7 @@ abstract class BaseSpellNumber
      *
      * @return static An instance of the child class.
      */
-    public static function value($value)
+    public static function value(mixed $value)
     {
         $type = SpellNumberValidator::check('mixed', $value)->result();
 
@@ -33,7 +33,7 @@ public static function value($value)
      *
      * @return static An instance of the child class.
      */
-    public static function integer($value)
+    public static function integer(int $value)
     {
         SpellNumberValidator::check('integer', $value)->result();
 
@@ -49,13 +49,37 @@ public static function integer($value)
      *
      * @return static An instance of the child class.
      */
-    public static function float($value)
+    public static function float(string|float $value)
     {
         SpellNumberValidator::check('double', $value)->result();
 
         return new static($value, 'double');
     }
 
+    /**
+     * Creates an instance of the child class with the provided text value for conversion.
+     *
+     * @param string $text The text value to be processed.
+     *
+     * @return static An instance of the child class configured for text processing.
+     */
+    public static function text(string $text)
+    {
+        return new static($text, 'text');
+    }
+
+    /**
+     * Creates an instance of the child class with the provided date value for conversion.
+     *
+     * @param string $date The date value to be processed.
+     *
+     * @return static An instance of the child class configured for date processing.
+     */
+    public static function date(string $date)
+    {
+        return new static($date, 'date');
+    }
+
     /**
      * Returns the list of available premises according to PHP.
      *
@@ -93,24 +117,42 @@ public static function getAvailableLanguages()
     }
 
     /**
-     * DEPRECATED - Delete Method Soon
-     * Retrieves a list of all available locales supported by the NumberFormatter class.
+     * This method allows querying the constants existing within SpellNumber
+     * along with their values for use in the package.
      *
-     * @return array An array containing all available locales.
-     */
-    public static function getLocales()
-    {
-        return self::getAvailableLocales();
-    }
-
-    /**
-     * DEPRECATED - Delete Method Soon
-     * Retrieves a list of all available TimeZones by the NumberFormatter class.
+     * @param string|null $category The optional category of constants to retrieve.
      *
-     * @return array An array containing all available locales.
+     * @return mixed
      */
-    public static function getLanguages()
+    public static function getConstants(?string $category = null)
     {
-        return self::getAvailableLanguages();
+        $data = [
+            "spell" => [
+                "SpellNumber::TO_LETTERS" => "%value-to-letters",
+                "SpellNumber::TO_ORDINAL" => "%value-to-ordinal",
+                "SpellNumber::TO_MONEY" => "%value-to-money",
+                "SpellNumber::TO_CLOCK" => "%value-to-clock",
+                "SpellNumber::TO_SCIENTIFIC" => "%value-to-scientific",
+                "SpellNumber::TO_PERCENT" => "%value-to-percent",
+                "SpellNumber::TO_CURRENCY" => "%value-to-currency",
+                "SpellNumber::TO_SUMMARY" => "%value-to-summary",
+                "SpellNumber::TO_ROMAN_NUMERAL" => "%value-to-roman-numeral",
+            ],
+            "ordinal-numbers" => [
+                "SpellNumber::ORDINAL_DEFAULT" => '%spellout-ordinal',
+                "SpellNumber::ORDINAL_FEMALE" => '%spellout-ordinal-feminine',
+                "SpellNumber::ORDINAL_MALE" => '%spellout-ordinal-masculine',
+            ],
+            "date" => [
+                "SpellNumber::DATE_SHORT" => "%date-format-short",
+                "SpellNumber::DATE_MEDIUM" => "%date-format-medium",
+                "SpellNumber::DATE_LONG" => "%date-format-long",
+                "SpellNumber::DATE_FULL" => "%date-format-full",
+            ],
+        ];
+
+        $output = !empty($category) ? ($data[$category] ?? []) : $data;
+
+        return json_decode(json_encode($output), false);
     }
 }

src/Bases/BaseSpellNumberValidator.php

@@ -2,13 +2,6 @@
 
 namespace Rmunate\Utilities\Bases;
 
-/**
- * This class serves as a base validator for common data types.
- *
- * @method static BaseValidator mixed().
- * @method static BaseValidator integer().
- * @method static BaseValidator float().
- */
 abstract class BaseSpellNumberValidator
 {
     /**