Expand PHPDocs notations to show throwable exceptions

Author: PostScripton

src/Calculators/Calculator.php

@@ -12,6 +12,7 @@ public function subtract(string $amount, string $subtrahend): string;
 
     public function multiply(string $amount, string $multiplier): string;
 
+    /** @throws \InvalidArgumentException */
     public function divide(string $amount, string $divisor): string;
 
     public function ceil(string $amount): string;

src/Currency.php

@@ -42,6 +42,7 @@ public function __construct(array $currency)
         $this->display = CurrencyDisplay::Symbol;
     }
 
+    /** @throws CurrencyDoesNotExistException */
     public static function code(string $code): ?self
     {
         if (is_numeric($code)) {
@@ -64,6 +65,7 @@ public static function code(string $code): ?self
         return $currency;
     }
 
+    /** @throws CurrencyDoesNotExistException */
     public static function get(Currency|string|null $currency): ?self
     {
         if (is_string($currency)) {
@@ -73,6 +75,7 @@ public static function get(Currency|string|null $currency): ?self
         return $currency;
     }
 
+    /** @throws CurrencyDoesNotExistException */
     public static function getOrDefault(Currency|string|null $currency): self
     {
         return self::get($currency) ?? self::getDefault();

src/Money.php

@@ -25,6 +25,10 @@ class Money implements MoneyInterface, JsonSerializable
 
     private Currency $currency;
 
+    /**
+     * @throws InvalidArgumentException
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
+     */
     public function __construct(string $amount, Currency|string|null $currency = null)
     {
         if (! is_numeric($amount)) {

src/PHPDocs/MoneyInterface.php

@@ -22,6 +22,7 @@ public function getCurrency(): Currency;
      * For converting between currencies use `convertInto()` method
      * @param Currency|string $currency
      * @return self
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      */
     public function setCurrency(Currency|string $currency): self;
 
@@ -73,6 +74,7 @@ public function multiply(string $multiplier): self;
      * @param string $divisor <p>
      * A number on which the money will be divided </p>
      * @return self
+     * @throws \InvalidArgumentException
      */
     public function divide(string $divisor): self;
 
@@ -203,6 +205,7 @@ public function equals(Money $money, bool $strict = true): bool;
      * @param Carbon|null $date <p>
      * Historical mode. Pass the date you want to get rate of </p>
      * @return Money
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      * @throws \PostScripton\Money\Exceptions\CurrenciesNotSupportedByRateExchangerException
      * @throws \PostScripton\Money\Exceptions\RateExchangerException
      */
@@ -216,6 +219,7 @@ public function convertTo(Currency|string $to, ?Carbon $date = null): Money;
      * Currency you want to convert to </p>
      * @param string $rate
      * @return Money
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      */
     public function offlineConvertTo(Currency|string $currency, string $rate): Money;
 
@@ -256,13 +260,16 @@ public static function setFormatter(MoneyFormatter $formatter): void;
      * Raw amount: 12345 stands for 1.2345 </p>
      * @param Currency|string|null $currency
      * @return self
+     * @throws \InvalidArgumentException
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      */
     public static function of(string $amount, Currency|string|null $currency = null): Money;
 
     /**
      * Empty monetary object
      * @param Currency|string|null $currency
      * @return Money
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      */
     public static function zero(Currency|string|null $currency = null): Money;
 
@@ -271,6 +278,8 @@ public static function zero(Currency|string|null $currency = null): Money;
      * @param string $money
      * @param Currency|string|null $currency
      * @return self
+     * @throws \Exception
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      */
     public static function parse(string $money, Currency|string|null $currency = null): Money;
 

src/Parser.php

@@ -10,6 +10,10 @@ class Parser
 {
     private const MONEY_REGEX = '/^(?:(?<start_currency>%s)\s?)?(?<amount>%s)(?:\s?(?<end_currency>%s))?$/';
 
+    /**
+     * @throws Exception
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
+     */
     public static function parse(string $money, Currency|string|null $currency = null): Money
     {
         $currency = Currency::getOrDefault($currency);

src/helpers.php

@@ -10,6 +10,8 @@
      * Raw amount: 12345 stands for 1.2345 </p>
      * @param Currency|string|null $currency
      * @return Money
+     * @throws InvalidArgumentException
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      */
     function money(string $amount, Currency|string|null $currency = null): Money
     {
@@ -22,6 +24,7 @@ function money(string $amount, Currency|string|null $currency = null): Money
      * Empty monetary object
      * @param Currency|string|null $currency
      * @return Money
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      */
     function money_zero(Currency|string|null $currency = null): Money
     {
@@ -35,6 +38,8 @@ function money_zero(Currency|string|null $currency = null): Money
      * @param string $money
      * @param Currency|string|null $currency
      * @return Money
+     * @throws \Exception
+     * @throws \PostScripton\Money\Exceptions\CurrencyDoesNotExistException
      */
     function money_parse(string $money, Currency|string|null $currency = null): Money
     {