dependencies-upgrade

vendor/dragonmantank/cron-expression/src/Cron/FieldInterface.php

@@ -1,41 +1,46 @@
 <?php
 
+declare(strict_types=1);
+
 namespace Cron;
 
 use DateTimeInterface;
 
 /**
- * CRON field interface
+ * CRON field interface.
  */
 interface FieldInterface
 {
     /**
-     * Check if the respective value of a DateTime field satisfies a CRON exp
+     * Check if the respective value of a DateTime field satisfies a CRON exp.
      *
+     * @internal
      * @param DateTimeInterface $date  DateTime object to check
      * @param string            $value CRON expression to test against
      *
      * @return bool Returns TRUE if satisfied, FALSE otherwise
      */
-    public function isSatisfiedBy(DateTimeInterface $date, $value);
+    public function isSatisfiedBy(DateTimeInterface $date, $value, bool $invert): bool;
 
     /**
      * When a CRON expression is not satisfied, this method is used to increment
-     * or decrement a DateTime object by the unit of the cron field
+     * or decrement a DateTime object by the unit of the cron field.
      *
-     * @param DateTimeInterface &$date  DateTime object to change
-     * @param bool              $invert (optional) Set to TRUE to decrement
+     * @internal
+     * @param DateTimeInterface $date DateTime object to change
+     * @param bool $invert (optional) Set to TRUE to decrement
+     * @param string|null $parts (optional) Set parts to use
      *
      * @return FieldInterface
      */
-    public function increment(DateTimeInterface &$date, $invert = false);
+    public function increment(DateTimeInterface &$date, $invert = false, $parts = null): FieldInterface;
 
     /**
-     * Validates a CRON expression for a given field
+     * Validates a CRON expression for a given field.
      *
      * @param string $value CRON expression value to validate
      *
      * @return bool Returns TRUE if valid, FALSE otherwise
      */
-    public function validate($value);
+    public function validate(string $value): bool;
 }