eventespresso / event-espresso-core

core/services/orm/tree_traversal/RelationNode.php

Indentation +296 added lines, -296 removed lines

@@ -24,302 +24,302 @@
  */
 class RelationNode extends BaseNode
 {
-    protected ?int $count = null;
-
-    /**
-     * @var string|int
-     */
-    protected $id;
-
-    protected EEM_Base $main_model;
-
-    /**
-     * @var ModelObjNode[]
-     */
-    protected array $nodes;
-
-    protected EEM_Base $related_model;
-
-    public ?string $main_model_name = null;
-    public ?string $related_model_name = null;
-
-
-    /**
-     * RelationNode constructor.
-     *
-     * @param          $main_model_obj_id
-     * @param EEM_Base $main_model
-     * @param EEM_Base $related_model
-     * @param array    $dont_traverse_models array of model names we DON'T want to traverse
-     */
-    public function __construct(
-        $main_model_obj_id,
-        EEM_Base $main_model,
-        EEM_Base $related_model,
-        array $dont_traverse_models = []
-    ) {
-        $this->id                   = $main_model_obj_id;
-        $this->main_model           = $main_model;
-        $this->related_model        = $related_model;
-        $this->nodes                = [];
-        $this->dont_traverse_models = $dont_traverse_models;
-    }
-
-
-    /**
-     * Here is where most of the work happens. We've counted how many related model objects exist, here we identify
-     * them (ie, learn their IDs). But its recursive, so we'll also find their related dependent model objects etc.
-     *
-     * @param int $model_objects_to_identify
-     * @return int
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    protected function work($model_objects_to_identify)
-    {
-        $num_identified = $this->visitAlreadyDiscoveredNodes($this->nodes, $model_objects_to_identify);
-        if ($num_identified < $model_objects_to_identify) {
-            $related_model_objs = $this->related_model->get_all(
-                [
-                    $this->whereQueryParams(),
-                    'limit' => [
-                        count($this->nodes),
-                        $model_objects_to_identify - $num_identified,
-                    ],
-                ]
-            );
-            $new_item_nodes     = [];
-
-            // Add entity nodes for each of the model objects we fetched.
-            foreach ($related_model_objs as $related_model_obj) {
-                $entity_node                                = new ModelObjNode(
-                    $related_model_obj->ID(),
-                    $related_model_obj->get_model(),
-                    $this->dont_traverse_models
-                );
-                $this->nodes[ $related_model_obj->ID() ]    = $entity_node;
-                $new_item_nodes[ $related_model_obj->ID() ] = $entity_node;
-            }
-            $num_identified += count($new_item_nodes);
-            if ($num_identified < $model_objects_to_identify) {
-                // And lastly do the work.
-                $num_identified += $this->visitAlreadyDiscoveredNodes(
-                    $new_item_nodes,
-                    $model_objects_to_identify - $num_identified
-                );
-            }
-        }
-
-        if (count($this->nodes) >= $this->count && $this->allChildrenComplete()) {
-            $this->complete = true;
-        }
-        return $num_identified;
-    }
-
-
-    /**
-     * Checks if all the identified child nodes are complete or not.
-     *
-     * @return bool
-     */
-    protected function allChildrenComplete()
-    {
-        foreach ($this->nodes as $model_obj_node) {
-            if (! $model_obj_node->isComplete()) {
-                return false;
-            }
-        }
-        return true;
-    }
-
-
-    /**
-     * Visits the provided nodes and keeps track of how much work was done, making sure to not go over budget.
-     *
-     * @param ModelObjNode[] $model_obj_nodes
-     * @param                $work_budget
-     * @return int
-     */
-    protected function visitAlreadyDiscoveredNodes($model_obj_nodes, $work_budget)
-    {
-        $work_done = 0;
-        if (! $model_obj_nodes) {
-            return 0;
-        }
-        foreach ($model_obj_nodes as $model_obj_node) {
-            if ($work_done >= $work_budget) {
-                break;
-            }
-            $work_done += $model_obj_node->visit($work_budget - $work_done);
-        }
-        return $work_done;
-    }
-
-
-    /**
-     * Whether this item has already been initialized
-     */
-    protected function isDiscovered()
-    {
-        return $this->count !== null;
-    }
-
-
-    /**
-     * @return boolean
-     */
-    public function isComplete()
-    {
-        if ($this->complete === null) {
-            if (count($this->nodes) === $this->count) {
-                $this->complete = true;
-            } else {
-                $this->complete = false;
-            }
-        }
-        return $this->complete;
-    }
-
-
-    /**
-     * Discovers how many related model objects exist.
-     *
-     * @return void
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     */
-    protected function discover()
-    {
-        $this->count = $this->related_model->count([$this->whereQueryParams()]);
-    }
-
-
-    /**
-     * @return array
-     * @throws EE_Error
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws InvalidArgumentException
-     */
-    protected function whereQueryParams()
-    {
-        $where_params = [
-            $this->related_model->get_foreign_key_to(
-                $this->main_model->get_this_model_name()
-            )->get_name() => $this->id,
-        ];
-        try {
-            $relation_settings = $this->main_model->related_settings_for($this->related_model->get_this_model_name());
-        } catch (EE_Error $e) {
-            // This will happen for has-and-belongs-to-many relations, when this node's related model is that join table
-            // which hasn't been explicitly declared in the main model object's model's relations.
-            $relation_settings = null;
-        }
-        if ($relation_settings instanceof EE_Has_Many_Any_Relation) {
-            $where_params[ $this->related_model->get_field_containing_related_model_name()->get_name() ] =
-                $this->main_model->get_this_model_name();
-        }
-        return $where_params;
-    }
-
-
-    /**
-     * @return array
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function toArray()
-    {
-        $tree = [
-            'count'    => $this->count,
-            'complete' => $this->isComplete(),
-            'objs'     => [],
-        ];
-        foreach ($this->nodes as $id => $model_obj_node) {
-            $tree['objs'][ $id ] = $model_obj_node->toArray();
-        }
-        return $tree;
-    }
-
-
-    /**
-     * Gets the IDs of all the model objects to delete; indexed first by model object name.
-     *
-     * @return array
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function getIds()
-    {
-        if (empty($this->nodes)) {
-            return [];
-        }
-        $ids = [
-            $this->related_model->get_this_model_name() => array_combine(
-                array_keys($this->nodes),
-                array_keys($this->nodes)
-            ),
-        ];
-        foreach ($this->nodes as $model_obj_node) {
-            $ids = array_replace_recursive($ids, $model_obj_node->getIds());
-        }
-        return $ids;
-    }
-
-
-    /**
-     * Returns the number of sub-nodes found (ie, related model objects across this relation.)
-     *
-     * @return int
-     */
-    public function countSubNodes()
-    {
-        return count($this->nodes);
-    }
-
-
-    /**
-     * Don't serialize the models. Just record their names on some dynamic properties.
-     *
-     * @return array
-     */
-    public function __sleep()
-    {
-        $this->main_model_name  = $this->main_model->get_this_model_name();
-        $this->related_model_name = $this->related_model->get_this_model_name();
-        return array_merge(
-            [
-                'main_model_name',
-                'related_model_name',
-                'id',
-                'count',
-                'nodes',
-            ],
-            parent::__sleep()
-        );
-    }
-
-
-    /**
-     * Use the dynamic properties to instantiate the models we use.
-     *
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     */
-    public function __wakeup()
-    {
-        $this->main_model    = EE_Registry::instance()->load_model($this->main_model_name);
-        $this->related_model = EE_Registry::instance()->load_model($this->related_model_name);
-        parent::__wakeup();
-    }
+	protected ?int $count = null;
+
+	/**
+	 * @var string|int
+	 */
+	protected $id;
+
+	protected EEM_Base $main_model;
+
+	/**
+	 * @var ModelObjNode[]
+	 */
+	protected array $nodes;
+
+	protected EEM_Base $related_model;
+
+	public ?string $main_model_name = null;
+	public ?string $related_model_name = null;
+
+
+	/**
+	 * RelationNode constructor.
+	 *
+	 * @param          $main_model_obj_id
+	 * @param EEM_Base $main_model
+	 * @param EEM_Base $related_model
+	 * @param array    $dont_traverse_models array of model names we DON'T want to traverse
+	 */
+	public function __construct(
+		$main_model_obj_id,
+		EEM_Base $main_model,
+		EEM_Base $related_model,
+		array $dont_traverse_models = []
+	) {
+		$this->id                   = $main_model_obj_id;
+		$this->main_model           = $main_model;
+		$this->related_model        = $related_model;
+		$this->nodes                = [];
+		$this->dont_traverse_models = $dont_traverse_models;
+	}
+
+
+	/**
+	 * Here is where most of the work happens. We've counted how many related model objects exist, here we identify
+	 * them (ie, learn their IDs). But its recursive, so we'll also find their related dependent model objects etc.
+	 *
+	 * @param int $model_objects_to_identify
+	 * @return int
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	protected function work($model_objects_to_identify)
+	{
+		$num_identified = $this->visitAlreadyDiscoveredNodes($this->nodes, $model_objects_to_identify);
+		if ($num_identified < $model_objects_to_identify) {
+			$related_model_objs = $this->related_model->get_all(
+				[
+					$this->whereQueryParams(),
+					'limit' => [
+						count($this->nodes),
+						$model_objects_to_identify - $num_identified,
+					],
+				]
+			);
+			$new_item_nodes     = [];
+
+			// Add entity nodes for each of the model objects we fetched.
+			foreach ($related_model_objs as $related_model_obj) {
+				$entity_node                                = new ModelObjNode(
+					$related_model_obj->ID(),
+					$related_model_obj->get_model(),
+					$this->dont_traverse_models
+				);
+				$this->nodes[ $related_model_obj->ID() ]    = $entity_node;
+				$new_item_nodes[ $related_model_obj->ID() ] = $entity_node;
+			}
+			$num_identified += count($new_item_nodes);
+			if ($num_identified < $model_objects_to_identify) {
+				// And lastly do the work.
+				$num_identified += $this->visitAlreadyDiscoveredNodes(
+					$new_item_nodes,
+					$model_objects_to_identify - $num_identified
+				);
+			}
+		}
+
+		if (count($this->nodes) >= $this->count && $this->allChildrenComplete()) {
+			$this->complete = true;
+		}
+		return $num_identified;
+	}
+
+
+	/**
+	 * Checks if all the identified child nodes are complete or not.
+	 *
+	 * @return bool
+	 */
+	protected function allChildrenComplete()
+	{
+		foreach ($this->nodes as $model_obj_node) {
+			if (! $model_obj_node->isComplete()) {
+				return false;
+			}
+		}
+		return true;
+	}
+
+
+	/**
+	 * Visits the provided nodes and keeps track of how much work was done, making sure to not go over budget.
+	 *
+	 * @param ModelObjNode[] $model_obj_nodes
+	 * @param                $work_budget
+	 * @return int
+	 */
+	protected function visitAlreadyDiscoveredNodes($model_obj_nodes, $work_budget)
+	{
+		$work_done = 0;
+		if (! $model_obj_nodes) {
+			return 0;
+		}
+		foreach ($model_obj_nodes as $model_obj_node) {
+			if ($work_done >= $work_budget) {
+				break;
+			}
+			$work_done += $model_obj_node->visit($work_budget - $work_done);
+		}
+		return $work_done;
+	}
+
+
+	/**
+	 * Whether this item has already been initialized
+	 */
+	protected function isDiscovered()
+	{
+		return $this->count !== null;
+	}
+
+
+	/**
+	 * @return boolean
+	 */
+	public function isComplete()
+	{
+		if ($this->complete === null) {
+			if (count($this->nodes) === $this->count) {
+				$this->complete = true;
+			} else {
+				$this->complete = false;
+			}
+		}
+		return $this->complete;
+	}
+
+
+	/**
+	 * Discovers how many related model objects exist.
+	 *
+	 * @return void
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 */
+	protected function discover()
+	{
+		$this->count = $this->related_model->count([$this->whereQueryParams()]);
+	}
+
+
+	/**
+	 * @return array
+	 * @throws EE_Error
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws InvalidArgumentException
+	 */
+	protected function whereQueryParams()
+	{
+		$where_params = [
+			$this->related_model->get_foreign_key_to(
+				$this->main_model->get_this_model_name()
+			)->get_name() => $this->id,
+		];
+		try {
+			$relation_settings = $this->main_model->related_settings_for($this->related_model->get_this_model_name());
+		} catch (EE_Error $e) {
+			// This will happen for has-and-belongs-to-many relations, when this node's related model is that join table
+			// which hasn't been explicitly declared in the main model object's model's relations.
+			$relation_settings = null;
+		}
+		if ($relation_settings instanceof EE_Has_Many_Any_Relation) {
+			$where_params[ $this->related_model->get_field_containing_related_model_name()->get_name() ] =
+				$this->main_model->get_this_model_name();
+		}
+		return $where_params;
+	}
+
+
+	/**
+	 * @return array
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function toArray()
+	{
+		$tree = [
+			'count'    => $this->count,
+			'complete' => $this->isComplete(),
+			'objs'     => [],
+		];
+		foreach ($this->nodes as $id => $model_obj_node) {
+			$tree['objs'][ $id ] = $model_obj_node->toArray();
+		}
+		return $tree;
+	}
+
+
+	/**
+	 * Gets the IDs of all the model objects to delete; indexed first by model object name.
+	 *
+	 * @return array
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function getIds()
+	{
+		if (empty($this->nodes)) {
+			return [];
+		}
+		$ids = [
+			$this->related_model->get_this_model_name() => array_combine(
+				array_keys($this->nodes),
+				array_keys($this->nodes)
+			),
+		];
+		foreach ($this->nodes as $model_obj_node) {
+			$ids = array_replace_recursive($ids, $model_obj_node->getIds());
+		}
+		return $ids;
+	}
+
+
+	/**
+	 * Returns the number of sub-nodes found (ie, related model objects across this relation.)
+	 *
+	 * @return int
+	 */
+	public function countSubNodes()
+	{
+		return count($this->nodes);
+	}
+
+
+	/**
+	 * Don't serialize the models. Just record their names on some dynamic properties.
+	 *
+	 * @return array
+	 */
+	public function __sleep()
+	{
+		$this->main_model_name  = $this->main_model->get_this_model_name();
+		$this->related_model_name = $this->related_model->get_this_model_name();
+		return array_merge(
+			[
+				'main_model_name',
+				'related_model_name',
+				'id',
+				'count',
+				'nodes',
+			],
+			parent::__sleep()
+		);
+	}
+
+
+	/**
+	 * Use the dynamic properties to instantiate the models we use.
+	 *
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 */
+	public function __wakeup()
+	{
+		$this->main_model    = EE_Registry::instance()->load_model($this->main_model_name);
+		$this->related_model = EE_Registry::instance()->load_model($this->related_model_name);
+		parent::__wakeup();
+	}
 }
 // End of file RelationNode.php
 // Location: EventEspresso\core\services\orm\tree_traversal/RelationNode.php

Spacing +9 added lines, -9 removed lines

@@ -91,17 +91,17 @@ 
                     ],
                 ]
             );
-            $new_item_nodes     = [];
+            $new_item_nodes = [];
 
             // Add entity nodes for each of the model objects we fetched.
             foreach ($related_model_objs as $related_model_obj) {
-                $entity_node                                = new ModelObjNode(
+                $entity_node = new ModelObjNode(
                     $related_model_obj->ID(),
                     $related_model_obj->get_model(),
                     $this->dont_traverse_models
                 );
-                $this->nodes[ $related_model_obj->ID() ]    = $entity_node;
-                $new_item_nodes[ $related_model_obj->ID() ] = $entity_node;
+                $this->nodes[$related_model_obj->ID()]    = $entity_node;
+                $new_item_nodes[$related_model_obj->ID()] = $entity_node;
             }
             $num_identified += count($new_item_nodes);
             if ($num_identified < $model_objects_to_identify) {
@@ -128,7 +128,7 @@ 
     protected function allChildrenComplete()
     {
         foreach ($this->nodes as $model_obj_node) {
-            if (! $model_obj_node->isComplete()) {
+            if ( ! $model_obj_node->isComplete()) {
                 return false;
             }
         }
@@ -146,7 +146,7 @@ 
     protected function visitAlreadyDiscoveredNodes($model_obj_nodes, $work_budget)
     {
         $work_done = 0;
-        if (! $model_obj_nodes) {
+        if ( ! $model_obj_nodes) {
             return 0;
         }
         foreach ($model_obj_nodes as $model_obj_node) {
@@ -221,7 +221,7 @@ 
             $relation_settings = null;
         }
         if ($relation_settings instanceof EE_Has_Many_Any_Relation) {
-            $where_params[ $this->related_model->get_field_containing_related_model_name()->get_name() ] =
+            $where_params[$this->related_model->get_field_containing_related_model_name()->get_name()] =
                 $this->main_model->get_this_model_name();
         }
         return $where_params;
@@ -241,7 +241,7 @@ 
             'objs'     => [],
         ];
         foreach ($this->nodes as $id => $model_obj_node) {
-            $tree['objs'][ $id ] = $model_obj_node->toArray();
+            $tree['objs'][$id] = $model_obj_node->toArray();
         }
         return $tree;
     }
@@ -290,7 +290,7 @@ 
      */
     public function __sleep()
     {
-        $this->main_model_name  = $this->main_model->get_this_model_name();
+        $this->main_model_name = $this->main_model->get_this_model_name();
         $this->related_model_name = $this->related_model->get_this_model_name();
         return array_merge(
             [

core/services/orm/tree_traversal/BaseNode.php

Indentation +87 added lines, -87 removed lines

@@ -31,106 +31,106 @@
  */
 abstract class BaseNode
 {
-    protected ?bool $complete = null;
+	protected ?bool $complete = null;
 
-    /**
-     * @var array of model names we don't want to traverse
-     */
-    protected array $dont_traverse_models = [];
+	/**
+	 * @var array of model names we don't want to traverse
+	 */
+	protected array $dont_traverse_models = [];
 
 
-    public ?bool $sleep_complete = null;
-    public ?array $sleep_dtm = null;
+	public ?bool $sleep_complete = null;
+	public ?array $sleep_dtm = null;
 
 
-    /**
-     * Whether this item has already been initialized
-     */
-    abstract protected function isDiscovered();
+	/**
+	 * Whether this item has already been initialized
+	 */
+	abstract protected function isDiscovered();
 
-    /**
-     * Determines if the work is done yet or not. Requires you to have first discovered what work exists by calling
-     * discover().
-     * @since 4.10.12.p
-     * @return boolean
-     */
-    abstract public function isComplete();
+	/**
+	 * Determines if the work is done yet or not. Requires you to have first discovered what work exists by calling
+	 * discover().
+	 * @since 4.10.12.p
+	 * @return boolean
+	 */
+	abstract public function isComplete();
 
-    /**
-     * Discovers what work needs to be done to complete traversing this node and its children.
-     * Note that this is separate from the constructor, so we can create child nodes without
-     * discovering them immediately.
-     * @since 4.10.12.p
-     * @return mixed
-     */
-    abstract protected function discover();
+	/**
+	 * Discovers what work needs to be done to complete traversing this node and its children.
+	 * Note that this is separate from the constructor, so we can create child nodes without
+	 * discovering them immediately.
+	 * @since 4.10.12.p
+	 * @return mixed
+	 */
+	abstract protected function discover();
 
-    /**
-     * Identifies model objects, up to the limit $model_objects_to_identify.
-     * @since 4.10.12.p
-     * @param int $model_objects_to_identify
-     * @return int units of work done
-     */
-    abstract protected function work($model_objects_to_identify);
+	/**
+	 * Identifies model objects, up to the limit $model_objects_to_identify.
+	 * @since 4.10.12.p
+	 * @param int $model_objects_to_identify
+	 * @return int units of work done
+	 */
+	abstract protected function work($model_objects_to_identify);
 
-    /**
-     * Shows the entity/relation node as an array.
-     * @since 4.10.12.p
-     * @return array
-     */
-    abstract public function toArray();
+	/**
+	 * Shows the entity/relation node as an array.
+	 * @since 4.10.12.p
+	 * @return array
+	 */
+	abstract public function toArray();
 
-    /**
-     * Discovers how much work there is to do, double-checks the work isn't already finished, and then does the work.
-     * Note: do not call when site is in maintenance mode level 2.
-     *
-     * @since 4.10.12.p
-     * @param $model_objects_to_identify
-     * @return int number of model objects we want to identify during this call. On subsequent calls we'll continue
-     * where we left off.
-     */
-    public function visit($model_objects_to_identify)
-    {
-        if (! $this->isDiscovered()) {
-            $this->discover();
-        }
-        if ($this->isComplete()) {
-            return 0;
-        }
-        return $this->work($model_objects_to_identify);
-    }
+	/**
+	 * Discovers how much work there is to do, double-checks the work isn't already finished, and then does the work.
+	 * Note: do not call when site is in maintenance mode level 2.
+	 *
+	 * @since 4.10.12.p
+	 * @param $model_objects_to_identify
+	 * @return int number of model objects we want to identify during this call. On subsequent calls we'll continue
+	 * where we left off.
+	 */
+	public function visit($model_objects_to_identify)
+	{
+		if (! $this->isDiscovered()) {
+			$this->discover();
+		}
+		if ($this->isComplete()) {
+			return 0;
+		}
+		return $this->work($model_objects_to_identify);
+	}
 
-    /**
-     * Gets the IDs of completely identified model objects that can be deleted.
-     * @since 4.10.12.p
-     * @return mixed
-     */
-    abstract public function getIds();
+	/**
+	 * Gets the IDs of completely identified model objects that can be deleted.
+	 * @since 4.10.12.p
+	 * @return mixed
+	 */
+	abstract public function getIds();
 
-    /**
-     * Make sure we encode whether its complete or not, but don't use such a long name.
-     * @since 4.10.12.p
-     * @return array
-     */
-    public function __sleep()
-    {
-        $this->sleep_complete = $this->complete;
-        $this->sleep_dtm = $this->dont_traverse_models;
-        return [
-            'sleep_complete',
-            'sleep_dtm'
-        ];
-    }
+	/**
+	 * Make sure we encode whether its complete or not, but don't use such a long name.
+	 * @since 4.10.12.p
+	 * @return array
+	 */
+	public function __sleep()
+	{
+		$this->sleep_complete = $this->complete;
+		$this->sleep_dtm = $this->dont_traverse_models;
+		return [
+			'sleep_complete',
+			'sleep_dtm'
+		];
+	}
 
-    /**
-     * Use the dynamic property to set the "complete" property.
-     * @since 4.10.12.p
-     */
-    public function __wakeup()
-    {
-        $this->complete = $this->sleep_complete;
-        $this->dont_traverse_models = $this->sleep_dtm;
-    }
+	/**
+	 * Use the dynamic property to set the "complete" property.
+	 * @since 4.10.12.p
+	 */
+	public function __wakeup()
+	{
+		$this->complete = $this->sleep_complete;
+		$this->dont_traverse_models = $this->sleep_dtm;
+	}
 }
 // End of file BaseNode.php
 // Location: EventEspresso\core\services\orm\tree_traversal/BaseNode.php

core/services/orm/tree_traversal/ModelObjNode.php

Indentation +214 added lines, -214 removed lines

@@ -23,220 +23,220 @@
  */
 class ModelObjNode extends BaseNode
 {
-    /**
-     * @var int|string
-     */
-    protected $id;
-
-    /**
-     * @var EEM_Base
-     */
-    protected EEM_Base $model;
-
-    /**
-     * @var RelationNode[]|null
-     */
-    protected ?array $nodes = null;
-
-    public ?string $model_name = null;
-
-
-    /**
-     * We don't pass the model objects because this needs to serialize to something tiny for effiency.
-     *
-     * @param int|string $model_obj_id
-     * @param EEM_Base   $model
-     * @param array      $dont_traverse_models array of model names we DON'T want to traverse.
-     */
-    public function __construct($model_obj_id, EEM_Base $model, array $dont_traverse_models = [])
-    {
-        $this->id                   = $model_obj_id;
-        $this->model                = $model;
-        $this->dont_traverse_models = $dont_traverse_models;
-    }
-
-
-    /**
-     * Creates a relation node for each relation of this model's relations.
-     * Does NOT call `discover` on them yet though.
-     *
-     * @throws EE_Error
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws InvalidArgumentException
-     * @throws ReflectionException
-     * @since 4.10.12.p
-     */
-    protected function discover()
-    {
-        $this->nodes = [];
-        foreach ($this->model->relation_settings() as $relationName => $relation) {
-            // Make sure this isn't one of the models we were told to not traverse into.
-            if (in_array($relationName, $this->dont_traverse_models)) {
-                continue;
-            }
-            if ($relation instanceof EE_Has_Many_Relation) {
-                $this->nodes[ $relationName ] = new RelationNode(
-                    $this->id,
-                    $this->model,
-                    $relation->get_other_model(),
-                    $this->dont_traverse_models
-                );
-            } elseif (
-                $relation instanceof EE_HABTM_Relation &&
-                ! in_array(
-                    $relation->get_join_model()->get_this_model_name(),
-                    $this->dont_traverse_models
-                )
-            ) {
-                $this->nodes[ $relation->get_join_model()->get_this_model_name() ] = new RelationNode(
-                    $this->id,
-                    $this->model,
-                    $relation->get_join_model(),
-                    $this->dont_traverse_models
-                );
-            }
-        }
-        ksort($this->nodes);
-    }
-
-
-    /**
-     * Whether this item has already been initialized
-     */
-    protected function isDiscovered()
-    {
-        return is_array($this->nodes);
-    }
-
-    /**
-     * @since 4.10.12.p
-     * @return boolean
-     */
-    public function isComplete()
-    {
-        if ($this->complete === null) {
-            $this->complete = false;
-        }
-        return $this->complete;
-    }
-
-
-    /**
-     * Triggers working on each child relation node that has work to do.
-     *
-     * @param $model_objects_to_identify
-     * @return int units of work done
-     * @since 4.10.12.p
-     */
-    protected function work($model_objects_to_identify)
-    {
-        $num_identified = 0;
-        // Begin assuming we'll finish all the work on this node and its children...
-        $this->complete = true;
-        foreach ($this->nodes as $model_name => $relation_node) {
-            $num_identified += $relation_node->visit($model_objects_to_identify - $num_identified);
-            // To save on space when serializing, only bother keeping a record of relation nodes that actually found
-            // related model objects.
-            if ($relation_node->isComplete() && $relation_node->countSubNodes() === 0) {
-                unset($this->nodes[ $model_name ]);
-            }
-            if ($num_identified >= $model_objects_to_identify) {
-                // ...but admit we're wrong if the work exceeded the budget.
-                $this->complete = false;
-                break;
-            }
-        }
-        return $num_identified;
-    }
-
-
-    /**
-     * @return array
-     * @throws EE_Error
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws InvalidArgumentException
-     * @throws ReflectionException
-     * @since 4.10.12.p
-     */
-    public function toArray()
-    {
-        $tree = [
-            'id'       => $this->id,
-            'complete' => $this->isComplete(),
-            'rels'     => [],
-        ];
-        if ($this->nodes === null) {
-            $tree['rels'] = null;
-        } else {
-            foreach ($this->nodes as $relation_name => $relation_node) {
-                $tree['rels'][ $relation_name ] = $relation_node->toArray();
-            }
-        }
-        return $tree;
-    }
-
-
-    /**
-     * @return array|mixed
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @throws EE_Error
-     * @since 4.10.12.p
-     */
-    public function getIds()
-    {
-        $ids = [
-            $this->model->get_this_model_name() => [
-                $this->id => $this->id,
-            ],
-        ];
-        if ($this->nodes && is_array($this->nodes)) {
-            foreach ($this->nodes as $relation_node) {
-                $ids = array_replace_recursive($ids, $relation_node->getIds());
-            }
-        }
-        return $ids;
-    }
-
-
-    /**
-     * Don't serialize the models. Just record their names on some dynamic properties.
-     *
-     * @since 4.10.12.p
-     */
-    public function __sleep()
-    {
-        $this->model_name = $this->model->get_this_model_name();
-        return array_merge(
-            [
-                'model_name',
-                'id',
-                'nodes',
-            ],
-            parent::__sleep()
-        );
-    }
-
-
-    /**
-     * Use the dynamic properties to instantiate the models we use.
-     *
-     * @throws EE_Error
-     * @throws InvalidArgumentException
-     * @throws InvalidDataTypeException
-     * @throws InvalidInterfaceException
-     * @throws ReflectionException
-     * @since 4.10.12.p
-     */
-    public function __wakeup()
-    {
-        $this->model = EE_Registry::instance()->load_model($this->model_name);
-        parent::__wakeup();
-    }
+	/**
+	 * @var int|string
+	 */
+	protected $id;
+
+	/**
+	 * @var EEM_Base
+	 */
+	protected EEM_Base $model;
+
+	/**
+	 * @var RelationNode[]|null
+	 */
+	protected ?array $nodes = null;
+
+	public ?string $model_name = null;
+
+
+	/**
+	 * We don't pass the model objects because this needs to serialize to something tiny for effiency.
+	 *
+	 * @param int|string $model_obj_id
+	 * @param EEM_Base   $model
+	 * @param array      $dont_traverse_models array of model names we DON'T want to traverse.
+	 */
+	public function __construct($model_obj_id, EEM_Base $model, array $dont_traverse_models = [])
+	{
+		$this->id                   = $model_obj_id;
+		$this->model                = $model;
+		$this->dont_traverse_models = $dont_traverse_models;
+	}
+
+
+	/**
+	 * Creates a relation node for each relation of this model's relations.
+	 * Does NOT call `discover` on them yet though.
+	 *
+	 * @throws EE_Error
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws InvalidArgumentException
+	 * @throws ReflectionException
+	 * @since 4.10.12.p
+	 */
+	protected function discover()
+	{
+		$this->nodes = [];
+		foreach ($this->model->relation_settings() as $relationName => $relation) {
+			// Make sure this isn't one of the models we were told to not traverse into.
+			if (in_array($relationName, $this->dont_traverse_models)) {
+				continue;
+			}
+			if ($relation instanceof EE_Has_Many_Relation) {
+				$this->nodes[ $relationName ] = new RelationNode(
+					$this->id,
+					$this->model,
+					$relation->get_other_model(),
+					$this->dont_traverse_models
+				);
+			} elseif (
+				$relation instanceof EE_HABTM_Relation &&
+				! in_array(
+					$relation->get_join_model()->get_this_model_name(),
+					$this->dont_traverse_models
+				)
+			) {
+				$this->nodes[ $relation->get_join_model()->get_this_model_name() ] = new RelationNode(
+					$this->id,
+					$this->model,
+					$relation->get_join_model(),
+					$this->dont_traverse_models
+				);
+			}
+		}
+		ksort($this->nodes);
+	}
+
+
+	/**
+	 * Whether this item has already been initialized
+	 */
+	protected function isDiscovered()
+	{
+		return is_array($this->nodes);
+	}
+
+	/**
+	 * @since 4.10.12.p
+	 * @return boolean
+	 */
+	public function isComplete()
+	{
+		if ($this->complete === null) {
+			$this->complete = false;
+		}
+		return $this->complete;
+	}
+
+
+	/**
+	 * Triggers working on each child relation node that has work to do.
+	 *
+	 * @param $model_objects_to_identify
+	 * @return int units of work done
+	 * @since 4.10.12.p
+	 */
+	protected function work($model_objects_to_identify)
+	{
+		$num_identified = 0;
+		// Begin assuming we'll finish all the work on this node and its children...
+		$this->complete = true;
+		foreach ($this->nodes as $model_name => $relation_node) {
+			$num_identified += $relation_node->visit($model_objects_to_identify - $num_identified);
+			// To save on space when serializing, only bother keeping a record of relation nodes that actually found
+			// related model objects.
+			if ($relation_node->isComplete() && $relation_node->countSubNodes() === 0) {
+				unset($this->nodes[ $model_name ]);
+			}
+			if ($num_identified >= $model_objects_to_identify) {
+				// ...but admit we're wrong if the work exceeded the budget.
+				$this->complete = false;
+				break;
+			}
+		}
+		return $num_identified;
+	}
+
+
+	/**
+	 * @return array
+	 * @throws EE_Error
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws InvalidArgumentException
+	 * @throws ReflectionException
+	 * @since 4.10.12.p
+	 */
+	public function toArray()
+	{
+		$tree = [
+			'id'       => $this->id,
+			'complete' => $this->isComplete(),
+			'rels'     => [],
+		];
+		if ($this->nodes === null) {
+			$tree['rels'] = null;
+		} else {
+			foreach ($this->nodes as $relation_name => $relation_node) {
+				$tree['rels'][ $relation_name ] = $relation_node->toArray();
+			}
+		}
+		return $tree;
+	}
+
+
+	/**
+	 * @return array|mixed
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @throws EE_Error
+	 * @since 4.10.12.p
+	 */
+	public function getIds()
+	{
+		$ids = [
+			$this->model->get_this_model_name() => [
+				$this->id => $this->id,
+			],
+		];
+		if ($this->nodes && is_array($this->nodes)) {
+			foreach ($this->nodes as $relation_node) {
+				$ids = array_replace_recursive($ids, $relation_node->getIds());
+			}
+		}
+		return $ids;
+	}
+
+
+	/**
+	 * Don't serialize the models. Just record their names on some dynamic properties.
+	 *
+	 * @since 4.10.12.p
+	 */
+	public function __sleep()
+	{
+		$this->model_name = $this->model->get_this_model_name();
+		return array_merge(
+			[
+				'model_name',
+				'id',
+				'nodes',
+			],
+			parent::__sleep()
+		);
+	}
+
+
+	/**
+	 * Use the dynamic properties to instantiate the models we use.
+	 *
+	 * @throws EE_Error
+	 * @throws InvalidArgumentException
+	 * @throws InvalidDataTypeException
+	 * @throws InvalidInterfaceException
+	 * @throws ReflectionException
+	 * @since 4.10.12.p
+	 */
+	public function __wakeup()
+	{
+		$this->model = EE_Registry::instance()->load_model($this->model_name);
+		parent::__wakeup();
+	}
 }
 // End of file Visitor.php
 // Location: EventEspresso\core\services\orm\tree_traversal/Visitor.php

core/services/orm/model_field/SchemaType.php

Indentation +45 added lines, -45 removed lines

@@ -11,61 +11,61 @@
  */
 class SchemaType
 {
-    const ARRAY   = 'array';
+	const ARRAY   = 'array';
 
-    const BOOLEAN = 'boolean';
+	const BOOLEAN = 'boolean';
 
-    const DB_FIELD = 'db_field';
+	const DB_FIELD = 'db_field';
 
-    const FLOAT = 'number';
+	const FLOAT = 'number';
 
-    const INTEGER = 'integer';
+	const INTEGER = 'integer';
 
-    const NULL    = 'null';
+	const NULL    = 'null';
 
-    const NUMBER  = 'number';
+	const NUMBER  = 'number';
 
-    const OBJECT  = 'object';
+	const OBJECT  = 'object';
 
-    const STRING  = 'string';
+	const STRING  = 'string';
 
 
-    /**
-     * @link http://json-schema.org/latest/json-schema-core.html#rfc.section.4.2
-     * @var array|string[]
-     */
-    private static array $allowable_types = [
-        SchemaType::ARRAY,
-        SchemaType::BOOLEAN,
-        SchemaType::FLOAT,
-        SchemaType::INTEGER,
-        SchemaType::NULL,
-        SchemaType::NUMBER,
-        SchemaType::OBJECT,
-        SchemaType::STRING,
-    ];
+	/**
+	 * @link http://json-schema.org/latest/json-schema-core.html#rfc.section.4.2
+	 * @var array|string[]
+	 */
+	private static array $allowable_types = [
+		SchemaType::ARRAY,
+		SchemaType::BOOLEAN,
+		SchemaType::FLOAT,
+		SchemaType::INTEGER,
+		SchemaType::NULL,
+		SchemaType::NUMBER,
+		SchemaType::OBJECT,
+		SchemaType::STRING,
+	];
 
 
-    /**
-     * Validates the incoming string|array to ensure its an allowable type.
-     *
-     * @param string $schema_type
-     * @throws InvalidArgumentException
-     */
-    public static function validateSchemaType(string $schema_type)
-    {
-        if (in_array($schema_type, SchemaType::$allowable_types, true)) {
-            return;
-        }
-        throw new InvalidArgumentException(
-            sprintf(
-                esc_html__(
-                    'The incoming argument (%1$s) must be one of the allowable types: %2$s',
-                    'event_espresso'
-                ),
-                $schema_type,
-                implode(',', SchemaType::$allowable_types)
-            )
-        );
-    }
+	/**
+	 * Validates the incoming string|array to ensure its an allowable type.
+	 *
+	 * @param string $schema_type
+	 * @throws InvalidArgumentException
+	 */
+	public static function validateSchemaType(string $schema_type)
+	{
+		if (in_array($schema_type, SchemaType::$allowable_types, true)) {
+			return;
+		}
+		throw new InvalidArgumentException(
+			sprintf(
+				esc_html__(
+					'The incoming argument (%1$s) must be one of the allowable types: %2$s',
+					'event_espresso'
+				),
+				$schema_type,
+				implode(',', SchemaType::$allowable_types)
+			)
+		);
+	}
 }

core/services/orm/model_field/SchemaFormat.php

Indentation +42 added lines, -42 removed lines

@@ -9,56 +9,56 @@
  */
 class SchemaFormat
 {
-    const DATETIME = 'date-time';
+	const DATETIME = 'date-time';
 
-    const EMAIL    = 'email';
+	const EMAIL    = 'email';
 
-    const HOSTNAME = 'hostname';
+	const HOSTNAME = 'hostname';
 
-    const IPV4     = 'ipv4';
+	const IPV4     = 'ipv4';
 
-    const IPV6     = 'ipv6';
+	const IPV6     = 'ipv6';
 
-    const URI      = 'uri';
+	const URI      = 'uri';
 
-    const URIREF   = 'uriref';
+	const URIREF   = 'uriref';
 
 
-    /**
-     * @var array|string[]
-     * @link http://json-schema.org/latest/json-schema-validation.html#rfc.section.7
-     */
-    private static array $allowable_formats = [
-        SchemaFormat::DATETIME,
-        SchemaFormat::EMAIL,
-        SchemaFormat::HOSTNAME,
-        SchemaFormat::IPV4,
-        SchemaFormat::IPV6,
-        SchemaFormat::URI,
-        SchemaFormat::URIREF,
-    ];
+	/**
+	 * @var array|string[]
+	 * @link http://json-schema.org/latest/json-schema-validation.html#rfc.section.7
+	 */
+	private static array $allowable_formats = [
+		SchemaFormat::DATETIME,
+		SchemaFormat::EMAIL,
+		SchemaFormat::HOSTNAME,
+		SchemaFormat::IPV4,
+		SchemaFormat::IPV6,
+		SchemaFormat::URI,
+		SchemaFormat::URIREF,
+	];
 
 
-    /**
-     * Validates that the incoming format is an allowable string to use for the _schema_format property
-     *
-     * @param string $schema_format
-     * @throws InvalidArgumentException
-     */
-    public static function validateSchemaFormat(string $schema_format)
-    {
-        if (in_array($schema_format, SchemaFormat::$allowable_formats, true)) {
-            return;
-        }
-        throw new InvalidArgumentException(
-            sprintf(
-                esc_html__(
-                    'The incoming argument (%1$s) must be one of the allowable formats: %2$s',
-                    'event_espresso'
-                ),
-                $schema_format,
-                implode(',', SchemaFormat::$allowable_formats)
-            )
-        );
-    }
+	/**
+	 * Validates that the incoming format is an allowable string to use for the _schema_format property
+	 *
+	 * @param string $schema_format
+	 * @throws InvalidArgumentException
+	 */
+	public static function validateSchemaFormat(string $schema_format)
+	{
+		if (in_array($schema_format, SchemaFormat::$allowable_formats, true)) {
+			return;
+		}
+		throw new InvalidArgumentException(
+			sprintf(
+				esc_html__(
+					'The incoming argument (%1$s) must be one of the allowable formats: %2$s',
+					'event_espresso'
+				),
+				$schema_format,
+				implode(',', SchemaFormat::$allowable_formats)
+			)
+		);
+	}
 }

core/services/calculators/LineItemCalculator.php

Indentation +934 added lines, -934 removed lines

@@ -21,938 +21,938 @@
  */
 class LineItemCalculator
 {
-    use DebugDisplay;
-
-    protected DecimalValues $decimal_values;
-
-    protected array $default_query_params = [];
-
-
-    /**
-     * @param DecimalValues $decimal_values
-     */
-    public function __construct(DecimalValues $decimal_values)
-    {
-        $this->decimal_values = $decimal_values;
-        $this->initializeDebugDisplay();
-    }
-
-
-    /**
-     * Gets the final total on this item, taking taxes into account.
-     * Has the side effect of setting the sub-total as it was just calculated.
-     * If this is used on a grand-total line item, also updates the transaction's
-     * TXN_total (provided this line item is allowed to persist, otherwise we don't
-     * want to change a persistable transaction with info from a non-persistent line item)
-     *
-     * @param EE_Line_Item $line_item
-     * @param bool         $update_txn_status
-     * @return float
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function recalculateTotalIncludingTaxes(EE_Line_Item $line_item, bool $update_txn_status = false): float
-    {
-        $this->debugLog('', 2);
-        $this->debugLog(__METHOD__);
-        $this->debugLog(str_repeat('*', strlen(__METHOD__)), 2);
-        $this->debugLog(">>> TXN : " . $line_item->TXN_ID(), 2);
-        $this->validateLineItemAndType($line_item, EEM_Line_Item::type_total);
-        $ticket_line_items = EEH_Line_Item::get_ticket_line_items($line_item);
-        if (empty($ticket_line_items)) {
-            // no tickets? ensure totals are zero
-            $this->updatePreTaxTotal($line_item, 0);
-            $this->updateTotal($line_item, 0);
-            $this->updateTransaction($line_item, 0, $update_txn_status);
-            return 0;
-        }
-        [, $pretax_total] = $this->recalculateLineItemTotals($line_item);
-        // EEH_Line_Item::visualize($line_item);
-        $total_tax = $this->recalculateTaxesAndTaxTotal($line_item);
-        // no negative totals plz
-        $grand_total = max($pretax_total + $total_tax, 0);
-        $this->updatePreTaxTotal($line_item, $pretax_total, true);
-        $grand_total = $this->updateTotal($line_item, $grand_total, true);
-        $this->updateTransaction($line_item, $grand_total, $update_txn_status);
-        return $grand_total;
-    }
-
-
-    /**
-     * Recursively goes through all the children and recalculates sub-totals EXCEPT for
-     * tax-sub-totals (they're an odd beast). Updates the 'total' on each line item according to either its
-     * unit price * quantity or the total of all its children EXCEPT when we're only calculating the taxable total and
-     * when this is called on the grand total
-     *
-     * @param EE_Line_Item $line_item
-     * @param float        $total
-     * @param float        $pretax_total
-     * @param bool         $is_taxable
-     * @return array
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function recalculateLineItemTotals(
-        EE_Line_Item $line_item,
-        float $total = 0,
-        float $pretax_total = 0,
-        bool $is_taxable = false
-    ): array {
-        $this->debugLog(__FUNCTION__);
-        $OBJ = $line_item->OBJ_type();
-        $OBJ .= $OBJ ? ': ' : '';
-        $this->debugLog(
-            ' * ' . $OBJ . $line_item->name() . ' - ' . $line_item->type() . ' (' . $line_item->code() . ')',
-            2
-        );
-        $this->debugLog(" * total: $total", 3);
-        $this->debugLog(" * pretax: $pretax_total", 3);
-        switch ($line_item->type()) {
-            case EEM_Line_Item::type_total:
-            case EEM_Line_Item::type_sub_total:
-                [$total, $pretax_total] = $this->recalculateSubTotal($line_item);
-                break;
-
-            case EEM_Line_Item::type_line_item:
-                [$total, $pretax_total] = $this->recalculateLineItem($line_item, $total, $pretax_total);
-                break;
-
-            case EEM_Line_Item::type_sub_line_item:
-            case EEM_Line_Item::type_cancellation:
-                // sub-line-items operate on the total and update both the total AND the pre-tax total
-                [$total, $pretax_total] = $this->recalculateSubLineItem($line_item, $total, $pretax_total, $is_taxable);
-                break;
-
-            case EEM_Line_Item::type_sub_tax:
-                // sub-line-items taxes ONLY operate on the pre-tax total and ONLY update the total
-                [$total, $pretax_total] = $this->recalculateSubTax($line_item, $pretax_total);
-                break;
-
-            case EEM_Line_Item::type_tax_sub_total:
-            case EEM_Line_Item::type_tax:
-                // completely ignore tax totals, tax sub-totals, and cancelled line items
-                // when calculating the pre-tax-total
-                $total = $pretax_total = 0;
-                break;
-        }
-        return [$total, $pretax_total];
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @return array
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function recalculateSubTotal(EE_Line_Item $line_item): array
-    {
-        $this->debugLog(__FUNCTION__);
-        // reset the total and pretax total to zero since we are recalculating them
-        $total = $pretax_total = 0;
-        if ($line_item->is_total()) {
-            // if this is the grand total line item
-            // then first update ALL the line item quantities (if need be)
-            $this->updateLineItemQuantities($line_item);
-        }
-        // recursively loop through children and recalculate their totals
-        $children = $line_item->children($this->default_query_params);
-        if (empty($children)) {
-            $this->debugLog(' - ' . __FUNCTION__, 3);
-            $this->debugLog(" - - total : $total ", 3);
-            $this->debugLog(" - - pretax: $pretax_total ", 3);
-            return [$total, $pretax_total];
-        }
-        foreach ($children as $child_line_item) {
-            [$child_total, $child_pretax_total] = $this->recalculateLineItemTotals(
-                $child_line_item,
-                $total,
-                $pretax_total
-            );
-            $total        += $child_total;
-            $pretax_total += $child_pretax_total;
-        }
-        // update the unit price and pretax total
-        $this->updateUnitPrice($line_item, $pretax_total, false);
-        $pretax_total = $this->updatePreTaxTotal($line_item, $pretax_total, true, false);
-        $this->debugLog(' - ' . __FUNCTION__, 3);
-        $this->debugLog(" - - line_item->name() : " . $line_item->name(), 3);
-        $this->debugLog(" - - line_item->code() : " . $line_item->code(), 3);
-        // for the actual pre-tax sub-total line item, we want to save the pretax value for everything
-        if ($line_item->is_sub_total() && $line_item->code() === 'pre-tax-subtotal') {
-            $this->updateTotal($line_item, $pretax_total, true);
-        } elseif (! $line_item->is_total()) {
-            // we don't update the total for the total line item, because that will need to include taxes
-            $total = $this->updateTotal($line_item, $total, true);
-        }
-        $this->debugLog(' - ' . __FUNCTION__, 3);
-        $this->debugLog(" - - total : $total ", 3);
-        $this->debugLog(" - - pretax: $pretax_total ", 3);
-        return [$total, $pretax_total];
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @param float        $total
-     * @param float        $pretax_total
-     * @return array
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function recalculateLineItem(
-        EE_Line_Item $line_item,
-        float $total = 0,
-        float $pretax_total = 0
-    ): array {
-        $this->debugLog(__FUNCTION__);
-        $this->reorderSubLineItems($line_item);
-        [$total, $pretax_total] = $line_item->is_percent()
-            ? $this->recalculatePercentageLineItem($line_item, $total, $pretax_total)
-            : $this->recalculateNonPercentageLineItem($line_item);
-
-        $total        = $this->updateTotal($line_item, $total, true);
-        $pretax_total = $this->updatePreTaxTotal($line_item, $pretax_total, true);
-
-        // need to also adjust unit price too if the pretax total or quantity has been updated
-        $this->updateUnitPrice($line_item, $pretax_total);
-        $this->debugLog(' - ' . __FUNCTION__, 3);
-        $this->debugLog(" - - total : $total", 3);
-        $this->debugLog(" - - pretax: $pretax_total", 3);
-        return [$total, $pretax_total];
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @param float        $total
-     * @param float        $pretax_total
-     * @return float[]
-     * @throws EE_Error
-     * @throws ReflectionException
-     * @since 5.0.12.p
-     */
-    private function recalculatePercentageLineItem(
-        EE_Line_Item $line_item,
-        float $total = 0,
-        float $pretax_total = 0
-    ): array {
-        $this->debugLog(' % ' . __FUNCTION__, 2);
-        $pretax_total = $this->calculatePercentage($pretax_total, $line_item->percent());
-        // if the line item is taxable, then we need to calculate the total,
-        // otherwise we can just use the pretax total
-        $total = $line_item->is_taxable()
-            ? $this->calculatePercentage($total, $line_item->percent())
-            : $pretax_total;
-        $this->debugLog(' % ' . __FUNCTION__, 3);
-        $this->debugLog(" % % total : $total ", 3);
-        $this->debugLog(" % % pretax: $pretax_total ", 3);
-        return [$total, $pretax_total];
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @return float[]
-     * @throws EE_Error
-     * @throws ReflectionException
-     * @since 5.0.12.p
-     */
-    private function recalculateNonPercentageLineItem(
-        EE_Line_Item $line_item
-    ): array {
-        $this->debugLog(' $ ' . __FUNCTION__, 2);
-        // recursively loop through children and recalculate their totals
-        $children = $line_item->children($this->default_query_params);
-        if (! empty($children)) {
-            // reset the total and pretax total to zero since we are recalculating them
-            $total = $pretax_total = 0;
-            foreach ($children as $child_line_item) {
-                [$child_total, $child_pretax_total] = $this->recalculateLineItemTotals(
-                    $child_line_item,
-                    $total,
-                    $pretax_total,
-                    $line_item->is_taxable()
-                );
-                $this->debugLog(' $ $ ' . __FUNCTION__, 3);
-                $this->debugLog(
-                    ' $ $ $ ' . $child_line_item->name() . ' '
-                    . $child_line_item->type() . ' ' . $child_line_item->code(),
-                    3
-                );
-                $this->debugLog(" $ $ $ $ child total: $child_total", 3);
-                $this->debugLog(" $ $ $ $ child pretax: $child_pretax_total", 3);
-                $total        += $child_total;
-                $pretax_total += $child_pretax_total;
-            }
-        } else {
-            // no child line items, so recalculate the total from the unit price and quantity
-            // and set the pretax total to match since there are obviously no sub-taxes
-            $pretax_total = $total = $this->calculateTotalForQuantity($line_item);
-        }
-        $this->debugLog(' $ ' . __FUNCTION__, 3);
-        $this->debugLog(' $ $ ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
-        $this->debugLog(" $ $ $ total: $total", 3);
-        $this->debugLog(" $ $ $ pretax: $pretax_total", 3);
-        return [$total, $pretax_total];
-    }
-
-
-    /**
-     * @param EE_Line_Item $sub_line_item
-     * @param float|int    $total
-     * @param float|int    $pretax_total
-     * @param bool         $is_taxable
-     * @return float[]
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function recalculateSubLineItem(
-        EE_Line_Item $sub_line_item,
-        float $total = 0,
-        float $pretax_total = 0,
-        bool $is_taxable = false
-    ): array {
-        $this->debugLog(__FUNCTION__);
-        $total = $is_taxable ? $total : $pretax_total;
-        if ($sub_line_item->is_percent()) {
-            $new_total        = $this->calculatePercentage($total, $sub_line_item->percent());
-            $new_pretax_total = $this->calculatePercentage($pretax_total, $sub_line_item->percent());
-        } else {
-            $new_total = $new_pretax_total = $this->calculateTotalForQuantity($sub_line_item);
-        }
-        $total        = $this->updateTotal($sub_line_item, $new_total, false, false);
-        $pretax_total = $this->updatePreTaxTotal($sub_line_item, $new_pretax_total, false, false);
-        // need to also adjust unit price too if the pretax total or quantity has been updated
-        $this->updateUnitPrice($sub_line_item, $pretax_total);
-        $this->debugLog(" - - total : $total ", 3);
-        $this->debugLog(" - - pretax: $pretax_total ", 3);
-        return [$total, $pretax_total];
-    }
-
-
-    /**
-     * @param EE_Line_Item $sub_line_item
-     * @param float|int    $pretax_total
-     * @return float[]
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function recalculateSubTax(EE_Line_Item $sub_line_item, float $pretax_total = 0): array
-    {
-        $this->debugLog(__FUNCTION__);
-        $total_tax = $this->calculatePercentage($pretax_total, $sub_line_item->percent());
-        $total_tax = $this->updateTotal($sub_line_item, $total_tax);
-        $this->debugLog(" - total_tax : $total_tax ", 3);
-        return [$total_tax, 0];
-    }
-
-
-    /**
-     * recursively loops through the entire line item tree updating line item quantities accordingly.
-     * this needs to be done prior to running any other calculations for reasons that are hopefully obvious :p
-     *
-     * @param EE_Line_Item $line_item
-     * @param int          $quantity
-     * @return int
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function updateLineItemQuantities(EE_Line_Item $line_item, int $quantity = 1): int
-    {
-        switch ($line_item->type()) {
-            case EEM_Line_Item::type_total:
-            case EEM_Line_Item::type_sub_total:
-            case EEM_Line_Item::type_tax_sub_total:
-                // first, loop through children and set their quantities
-                $count    = 0;
-                $children = $line_item->children($this->default_query_params);
-                foreach ($children as $child_line_item) {
-                    $count += $this->updateLineItemQuantities($child_line_item);
-                }
-                // totals and subtotals should have a quantity of 1
-                // unless their children have all been removed, in which case we can set them to 0
-                $quantity = $count > 0 ? 1 : 0;
-                $this->updateQuantity($line_item, $quantity);
-                return $quantity;
-
-            case EEM_Line_Item::type_line_item:
-                // line items should ALREADY have accurate quantities set, if not, then somebody done goofed!
-                // but if this is a percentage based line item, then ensure its quantity is 1
-                if ($line_item->is_percent()) {
-                    $this->updateQuantity($line_item, 1);
-                }
-                // and we also need to loop through all the sub items and ensure those quantities match this parent.
-                $children = $line_item->children($this->default_query_params);
-                $quantity = $line_item->quantity();
-                foreach ($children as $child_line_item) {
-                    $this->updateLineItemQuantities($child_line_item, $quantity);
-                }
-                // percentage line items should not increment their parent's count, so they return 0
-                return ! $line_item->is_percent() ? $quantity : 0;
-
-            case EEM_Line_Item::type_sub_line_item:
-                // percentage based items need their quantity set to 1,
-                // all others use the incoming value from the parent line item
-                $quantity = $line_item->is_percent() ? 1 : $quantity;
-                $this->updateQuantity($line_item, $quantity);
-                // percentage line items should not increment their parent's count, so they return 0
-                return ! $line_item->is_percent() ? $quantity : 0;
-
-            case EEM_Line_Item::type_tax:
-            case EEM_Line_Item::type_sub_tax:
-                // taxes should have a quantity of 1
-                $this->updateQuantity($line_item, 1);
-                return 1;
-
-            case EEM_Line_Item::type_cancellation:
-                // cancellations will be ignored for all calculations
-                // because their parent quantities should have already been adjusted when they were added
-                // so assume that things are already set correctly
-                return 0;
-        }
-        return 0;
-    }
-
-
-    /**
-     * @param float $total
-     * @param float $percent
-     * @param bool  $round
-     * @return float
-     */
-    private function calculatePercentage(float $total, float $percent, bool $round = false): float
-    {
-        $amount = $total * $percent / 100;
-        $amount = $this->decimal_values->roundDecimalValue($amount, $round);
-        $this->debugLog(' % ' . __FUNCTION__, 2);
-        $this->debugLog(" % % total: $total", 3);
-        $this->debugLog(" % % percent: $percent", 3);
-        $this->debugLog(" % % amount: $amount", 3);
-        return $amount;
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @return float
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function calculateTotalForQuantity(EE_Line_Item $line_item): float
-    {
-        $this->debugLog(' # ' . __FUNCTION__, 2);
-        $this->debugLog(' # # ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
-        $this->debugLog(" # # # unit_price: " . $line_item->unit_price(), 3);
-        $this->debugLog(" # # # quantity: " . $line_item->quantity(), 3);
-        $total = $line_item->unit_price() * $line_item->quantity();
-        return $this->decimal_values->roundDecimalValue($total);
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @param float        $percent
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function updatePercent(EE_Line_Item $line_item, float $percent)
-    {
-        // update and save new percent only if incoming value does not match existing value
-        if ($line_item->percent() !== $percent) {
-            $line_item->set_percent($percent);
-            $line_item->maybe_save();
-        }
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @param float        $pretax_total
-     * @param bool         $round
-     * @param bool         $save
-     * @return float
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function updatePreTaxTotal(
-        EE_Line_Item $line_item,
-        float $pretax_total,
-        bool $round = false,
-        bool $save = true
-    ): float {
-        $pretax_total = $this->decimal_values->roundDecimalValue($pretax_total, $round);
-        $sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
-        $pretax_total = $sign * $pretax_total;
-        $this->debugLog(' ? ' . __FUNCTION__, 2);
-        $this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
-        $this->debugLog(" ????? SIGN: $sign  &&  pretax_total: $pretax_total", 3);
-        // update and save new total only if incoming value does not match existing value
-        if ($line_item->preTaxTotal() !== $pretax_total) {
-            $line_item->setPreTaxTotal($pretax_total);
-            if ($save) {
-                $line_item->maybe_save();
-            }
-        }
-        return $pretax_total;
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @param int          $quantity
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function updateQuantity(EE_Line_Item $line_item, int $quantity)
-    {
-        // update and save new quantity only if incoming value does not match existing value
-        if ($line_item->quantity() !== $quantity) {
-            $line_item->set_quantity($quantity);
-            $line_item->maybe_save();
-        }
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @param float        $total
-     * @param bool         $round
-     * @param bool         $save
-     * @return float
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function updateTotal(EE_Line_Item $line_item, float $total, bool $round = false, bool $save = true): float
-    {
-        $total = $this->decimal_values->roundDecimalValue($total, $round);
-        $sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
-        $total = $sign * $total;
-        $this->debugLog(' ? ' . __FUNCTION__, 2);
-        $this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
-        $this->debugLog(" ????? SIGN: $sign  &&  total: $total", 3);
-        // update and save new total only if incoming value does not match existing value
-        if ($line_item->total() !== $total) {
-            $line_item->set_total($total);
-            if ($save) {
-                $line_item->maybe_save();
-            }
-        }
-        return (float) $total;
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @param float        $total
-     * @param bool         $update_status
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function updateTransaction(EE_Line_Item $line_item, float $total, bool $update_status)
-    {
-        // only update the related transaction's total
-        // if we intend to save this line item and it's a grand total
-        if ($line_item->allow_persist()) {
-            $transaction = $line_item->transaction();
-            if ($transaction instanceof EE_Transaction) {
-                $transaction->set_total($total);
-                if ($update_status) {
-                    // don't save the TXN because that will be done below
-                    // and the following method only saves if the status changes
-                    $transaction->update_status_based_on_total_paid(false);
-                }
-                if ($transaction->ID()) {
-                    $transaction->save();
-                }
-            }
-        }
-    }
-
-
-    /**
-     * @param EE_Line_Item $line_item
-     * @param float        $pretax_total
-     * @param bool         $save
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function updateUnitPrice(EE_Line_Item $line_item, float $pretax_total, bool $save = true)
-    {
-        $quantity = $line_item->quantity();
-        // don't divide by zero else you'll create a singularity and implode the interweb
-        // we also don't set unit prices for percentage based line items
-        if ($quantity === 0 || $line_item->is_percent()) {
-            return;
-        }
-        $new_unit_price = $pretax_total / $quantity;
-        $new_unit_price = $this->decimal_values->roundDecimalValue($new_unit_price);
-        $sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
-        $new_unit_price = $sign * $new_unit_price;
-        $this->debugLog(' ? ' . __FUNCTION__, 2);
-        $this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
-        $this->debugLog(" ????? SIGN: $sign  &&  new_unit_price: $new_unit_price", 3);
-        // update and save new total only if incoming value does not match existing value
-        if ($line_item->unit_price() !== $new_unit_price) {
-            $this->debugLog(' @ ' . __FUNCTION__, 3);
-            $this->debugLog(' @ @ ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
-            $this->debugLog(" @ @ @ pretax: $pretax_total", 3);
-            $this->debugLog(" @ @ @ quantity: $quantity", 3);
-            $this->debugLog(" @ @ @ old unit price: " . $line_item->unit_price(), 3);
-            $this->debugLog(" @ @ @ new unit price: $new_unit_price", 3);
-            $line_item->set_unit_price($new_unit_price);
-            if ($save) {
-                $line_item->maybe_save();
-            }
-        }
-    }
-
-
-    /**
-     * Recalculates the total on each individual tax (based on a recalculation of the pre-tax total), sets
-     * the totals on each tax calculated, and returns the final tax total. Re-saves tax line items
-     * and tax sub-total if already in the DB
-     *
-     * @param EE_Line_Item $total_line_item
-     * @return float
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function recalculateTaxesAndTaxTotal(EE_Line_Item $total_line_item): float
-    {
-        $this->debugLog(__FUNCTION__, 3);
-        $this->validateLineItemAndType($total_line_item, EEM_Line_Item::type_total);
-        // calculate the total taxable amount for globally applied taxes
-        $taxable_total    = $this->taxableAmountForGlobalTaxes($total_line_item);
-        [$total_tax, $global_taxes ]    = $this->applyGlobalTaxes($total_line_item, $taxable_total);
-        $non_global_taxes = $this->calculateNonGlobalTaxes($total_line_item);
-        $all_tax_total    = $this->applyNonGlobalTaxes($total_line_item, $total_tax, $global_taxes, $non_global_taxes);
-        $this->recalculateTaxSubTotal($total_line_item);
-        $this->debugLog(" - taxable_total : $taxable_total", 4);
-        $this->debugLog(" - total_tax : $total_tax", 4);
-        $this->debugLog(" - all_tax_total : $all_tax_total", 4);
-        return $all_tax_total;
-    }
-
-
-    /**
-     * @param EE_Line_Item $total_line_item
-     * @param float        $taxable_total
-     * @return array
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function applyGlobalTaxes(EE_Line_Item $total_line_item, float $taxable_total): array
-    {
-        $this->debugLog(__FUNCTION__, 4);
-        $this->validateLineItemAndType($total_line_item, EEM_Line_Item::type_total);
-        $total_tax = 0;
-        if ($taxable_total === 0.0) {
-            return [0, []];
-        }
-        // loop through all global taxes all taxes
-        $global_taxes = $total_line_item->tax_descendants();
-        foreach ($global_taxes as $tax) {
-            $tax_total = $this->calculatePercentage($taxable_total, $tax->percent());
-            if ($tax_total === 0.0) {
-                $tax->delete();
-                continue;
-            }
-            $tax_total = $this->updateTotal($tax, $tax_total, true);
-            $total_tax += $tax_total;
-        }
-        return [$this->decimal_values->roundDecimalValue($total_tax, true), $global_taxes];
-    }
-
-
-    /**
-     * Simply forces all the tax-sub-totals to recalculate. Assumes the taxes have been calculated
-     *
-     * @param EE_Line_Item $line_item
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function recalculateTaxSubTotal(EE_Line_Item $line_item)
-    {
-        $this->debugLog(__FUNCTION__, 4);
-        $this->validateLineItemAndType($line_item, EEM_Line_Item::type_total);
-        foreach ($line_item->children() as $maybe_tax_subtotal) {
-            if (
-                $this->validateLineItemAndType($maybe_tax_subtotal)
-                && $maybe_tax_subtotal->is_tax_sub_total()
-            ) {
-                $total         = 0;
-                $total_percent = 0;
-                // simply loop through all its children (which should be taxes) and sum their total
-                foreach ($maybe_tax_subtotal->children() as $child_tax) {
-                    if ($this->validateLineItemAndType($child_tax) && $child_tax->isGlobalTax()) {
-                        $total         += $child_tax->total();
-                        $total_percent += $child_tax->percent();
-                    }
-                }
-                $this->updateTotal($maybe_tax_subtotal, $total, true);
-                $this->updatePercent($maybe_tax_subtotal, $total_percent);
-            }
-        }
-    }
-
-
-    /**
-     * returns an array of tax details like:
-     *  [
-     *      'GST_7' => [
-     *          'name'  => 'GST',
-     *          'rate'  => float(7),
-     *          'total' => float(4.9),
-     *      ]
-     *  ]
-     *
-     * @param EE_Line_Item $total_line_item
-     * @param array        $non_global_taxes
-     * @param float        $line_item_total
-     * @return array
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function calculateNonGlobalTaxes(
-        EE_Line_Item $total_line_item,
-        array $non_global_taxes = [],
-        float $line_item_total = 0
-    ): array {
-        $this->debugLog(__FUNCTION__, 4);
-        foreach ($total_line_item->children() as $line_item) {
-            if ($this->validateLineItemAndType($line_item)) {
-                if ($line_item->is_sub_total()) {
-                    $non_global_taxes = $this->calculateNonGlobalTaxes($line_item, $non_global_taxes);
-                } elseif ($line_item->is_line_item()) {
-                    $non_global_taxes = $this->calculateNonGlobalTaxes(
-                        $line_item,
-                        $non_global_taxes,
-                        $line_item->pretaxTotal()
-                    );
-                } elseif ($line_item->isSubTax()) {
-                    $tax_ID = $line_item->name() . '_' . $line_item->percent();
-                    if (! isset($non_global_taxes[ $tax_ID ])) {
-                        $non_global_taxes[ $tax_ID ] = [
-                            'name'  => $line_item->name(),
-                            'rate'  => $line_item->percent(),
-                            'total' => 0,
-                            'obj'   => $line_item->OBJ_type(),
-                            'objID' => $line_item->OBJ_ID(),
-                        ];
-                    }
-                    $tax = $this->calculatePercentage($line_item_total, $line_item->percent());
-
-                    $non_global_taxes[ $tax_ID ]['total'] += $tax;
-                }
-            }
-        }
-        return $non_global_taxes;
-    }
-
-
-    /**
-     * @param EE_Line_Item   $total_line_item
-     * @param float          $tax_total
-     * @param EE_Line_Item[] $global_taxes array of tax line items returned from applyGlobalTaxes()
-     * @param array          $non_global_taxes array of tax details generated by calculateNonGlobalTaxes()
-     * @return float
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function applyNonGlobalTaxes(
-        EE_Line_Item $total_line_item,
-        float $tax_total,
-        array $global_taxes,
-        array $non_global_taxes
-    ): float {
-        $this->debugLog(__FUNCTION__, 4);
-        $taxes_subtotal = EEH_Line_Item::get_taxes_subtotal($total_line_item);
-        foreach ($non_global_taxes as $non_global_tax) {
-            $found = false;
-            foreach ($global_taxes as $global_tax) {
-                if (
-                    $this->validateLineItemAndType($global_tax)
-                    && $non_global_tax['obj'] === $global_tax->OBJ_type()
-                    && $non_global_tax['objID'] === $global_tax->OBJ_ID()
-                ) {
-                    $found     = true;
-                    $new_total = $global_tax->total() + $non_global_tax['total'];
-                    // add non-global tax to matching global tax AND the tax total
-                    $global_tax->set_total($new_total);
-                    $global_tax->maybe_save();
-                    $tax_total += $non_global_tax['total'];
-                }
-            }
-            if (! $found) {
-                // add a new line item for this non-global tax
-                $taxes_subtotal->add_child_line_item(
-                    EE_Line_Item::new_instance(
-                        [
-                            'LIN_name'       => $non_global_tax['name'],
-                            'LIN_percent'    => $non_global_tax['rate'],
-                            'LIN_is_taxable' => false,
-                            'LIN_total'      => $non_global_tax['total'],
-                            'LIN_type'       => EEM_Line_Item::type_tax,
-                            'OBJ_type'       => $non_global_tax['obj'],
-                            'OBJ_ID'         => $non_global_tax['objID'],
-                        ]
-                    )
-                );
-                $tax_total += $non_global_tax['total'];
-            }
-        }
-        return $this->decimal_values->roundDecimalValue($tax_total, true);
-    }
-
-
-    /**
-     * Gets the total tax on this line item. Assumes taxes have already been calculated using
-     * recalculate_taxes_and_total
-     *
-     * @param EE_Line_Item $line_item
-     * @return float
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function getTotalTax(EE_Line_Item $line_item): float
-    {
-        $this->validateLineItemAndType($line_item, EEM_Line_Item::type_total);
-        $this->recalculateTaxSubTotal($line_item);
-        $total = 0;
-        foreach ($line_item->tax_descendants() as $tax_line_item) {
-            if ($this->validateLineItemAndType($tax_line_item)) {
-                $total += $tax_line_item->total();
-            }
-        }
-        return $this->decimal_values->roundDecimalValue($total, true);
-    }
-
-
-    /**
-     * Returns the amount taxable among this line item's children (or if it has no children,
-     * how much of it is taxable). Does not recalculate totals or subtotals.
-     * If the taxable total is negative, (eg, if none of the tickets were taxable,
-     * but there is a "Taxable" discount), returns 0.
-     *
-     * @param EE_Line_Item|null $line_item
-     * @return float
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    public function taxableAmountForGlobalTaxes(?EE_Line_Item $line_item): float
-    {
-        $this->debugLog(__FUNCTION__, 4);
-        $total            = 0;
-        $child_line_items = $line_item->children($this->default_query_params);
-        foreach ($child_line_items as $child_line_item) {
-            $this->validateLineItemAndType($child_line_item);
-            if ($child_line_item->is_sub_total()) {
-                $total += $this->taxableAmountForGlobalTaxes($child_line_item);
-            } elseif ($child_line_item->is_line_item() && $child_line_item->is_taxable()) {
-                // if it's a percent item, only take into account
-                // the percentage that's taxable (the taxable total so far)
-                if ($child_line_item->is_percent()) {
-                    $total += $this->calculatePercentage($total, $child_line_item->percent(), true);
-                } else {
-                    // pretax total will be equal to the total for line items with globally applied taxes
-                    $pretax_total = $this->calculateTotalForQuantity($child_line_item);
-                    $total        += $this->updatePreTaxTotal($child_line_item, $pretax_total);
-                }
-            }
-        }
-        return max($total, 0);
-    }
-
-
-    /**
-     * @param EE_Line_Item|null $line_item
-     * @param string|null       $type
-     * @return bool
-     * @throws EE_Error
-     * @throws ReflectionException
-     */
-    private function validateLineItemAndType(?EE_Line_Item $line_item, ?string $type = null): bool
-    {
-        if (! $line_item instanceof EE_Line_Item) {
-            throw new DomainException(
-                esc_html__('Invalid or missing Line Item supplied .', 'event_espresso')
-            );
-        }
-        if ($type && $line_item->type() !== $type) {
-            throw new DomainException(
-                sprintf(
-                    esc_html__(
-                        'Invalid Line Item type supplied. Received "%1$s" but expected "%2$s".',
-                        'event_espresso'
-                    ),
-                    $line_item->type(),
-                    $type
-                )
-            );
-        }
-        return true;
-    }
-
-
-    /**
-     * loops through all sub-line-items for the supplied line item and reorders them as follows:
-     * 1. sub items
-     * 2. other??? (not a sub-item or sub-tax)
-     * 3. sub taxes
-     *
-     * @param EE_Line_Item $line_item
-     * @return void
-     * @throws EE_Error
-     * @throws ReflectionException
-     * @since 5.0.12.p
-     */
-    public function reorderSubLineItems(EE_Line_Item $line_item)
-    {
-        if ($line_item->type() !== EEM_Line_Item::type_line_item) {
-            return;
-        }
-        $this->debugLog(' + LineItemCalculator::reorderSubLineItems', 3);
-        $this->debugLog(
-            ' + + ' . $line_item->OBJ_type() . ' ' . $line_item->name()
-            . ' - ' . $line_item->type() . ' (' . $line_item->code() . ')',
-            3
-        );
-        $sub_line_items = $line_item->children();
-        $items          = [];
-        $other          = [];
-        $taxes          = [];
-        foreach ($sub_line_items as $sub_line_item) {
-            switch ($sub_line_item->type()) {
-                case EEM_Line_Item::type_sub_line_item:
-                    $items[ $sub_line_item->ID() ] = $sub_line_item;
-                    break;
-                case EEM_Line_Item::type_sub_tax:
-                    $taxes[ $sub_line_item->ID() ] = $sub_line_item;
-                    break;
-                default:
-                    $other[ $sub_line_item->ID() ] = $sub_line_item;
-            }
-        }
-        $order      = 0;
-        $line_items = apply_filters(
-            'FHEE__EventEspresso_core_services_calculators_LineItemCalculator__reorderSubLineItems__line_items',
-            ['items' => $items, 'other' => $other, 'taxes' => $taxes]
-        );
-        foreach ($line_items as $sub_items) {
-            foreach ($sub_items as $sub_item) {
-                $order++;
-                $sub_item->set_order($order);
-                $sub_item->save();
-                $this->debugLog(
-                    ' + + + ' . $order . '. ' . $sub_item->OBJ_type() . ' ' . $sub_item->name()
-                    . ' - ' . $sub_item->type() . ' (' . $sub_item->code() . ')',
-                    3
-                );
-            }
-        }
-    }
+	use DebugDisplay;
+
+	protected DecimalValues $decimal_values;
+
+	protected array $default_query_params = [];
+
+
+	/**
+	 * @param DecimalValues $decimal_values
+	 */
+	public function __construct(DecimalValues $decimal_values)
+	{
+		$this->decimal_values = $decimal_values;
+		$this->initializeDebugDisplay();
+	}
+
+
+	/**
+	 * Gets the final total on this item, taking taxes into account.
+	 * Has the side effect of setting the sub-total as it was just calculated.
+	 * If this is used on a grand-total line item, also updates the transaction's
+	 * TXN_total (provided this line item is allowed to persist, otherwise we don't
+	 * want to change a persistable transaction with info from a non-persistent line item)
+	 *
+	 * @param EE_Line_Item $line_item
+	 * @param bool         $update_txn_status
+	 * @return float
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function recalculateTotalIncludingTaxes(EE_Line_Item $line_item, bool $update_txn_status = false): float
+	{
+		$this->debugLog('', 2);
+		$this->debugLog(__METHOD__);
+		$this->debugLog(str_repeat('*', strlen(__METHOD__)), 2);
+		$this->debugLog(">>> TXN : " . $line_item->TXN_ID(), 2);
+		$this->validateLineItemAndType($line_item, EEM_Line_Item::type_total);
+		$ticket_line_items = EEH_Line_Item::get_ticket_line_items($line_item);
+		if (empty($ticket_line_items)) {
+			// no tickets? ensure totals are zero
+			$this->updatePreTaxTotal($line_item, 0);
+			$this->updateTotal($line_item, 0);
+			$this->updateTransaction($line_item, 0, $update_txn_status);
+			return 0;
+		}
+		[, $pretax_total] = $this->recalculateLineItemTotals($line_item);
+		// EEH_Line_Item::visualize($line_item);
+		$total_tax = $this->recalculateTaxesAndTaxTotal($line_item);
+		// no negative totals plz
+		$grand_total = max($pretax_total + $total_tax, 0);
+		$this->updatePreTaxTotal($line_item, $pretax_total, true);
+		$grand_total = $this->updateTotal($line_item, $grand_total, true);
+		$this->updateTransaction($line_item, $grand_total, $update_txn_status);
+		return $grand_total;
+	}
+
+
+	/**
+	 * Recursively goes through all the children and recalculates sub-totals EXCEPT for
+	 * tax-sub-totals (they're an odd beast). Updates the 'total' on each line item according to either its
+	 * unit price * quantity or the total of all its children EXCEPT when we're only calculating the taxable total and
+	 * when this is called on the grand total
+	 *
+	 * @param EE_Line_Item $line_item
+	 * @param float        $total
+	 * @param float        $pretax_total
+	 * @param bool         $is_taxable
+	 * @return array
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function recalculateLineItemTotals(
+		EE_Line_Item $line_item,
+		float $total = 0,
+		float $pretax_total = 0,
+		bool $is_taxable = false
+	): array {
+		$this->debugLog(__FUNCTION__);
+		$OBJ = $line_item->OBJ_type();
+		$OBJ .= $OBJ ? ': ' : '';
+		$this->debugLog(
+			' * ' . $OBJ . $line_item->name() . ' - ' . $line_item->type() . ' (' . $line_item->code() . ')',
+			2
+		);
+		$this->debugLog(" * total: $total", 3);
+		$this->debugLog(" * pretax: $pretax_total", 3);
+		switch ($line_item->type()) {
+			case EEM_Line_Item::type_total:
+			case EEM_Line_Item::type_sub_total:
+				[$total, $pretax_total] = $this->recalculateSubTotal($line_item);
+				break;
+
+			case EEM_Line_Item::type_line_item:
+				[$total, $pretax_total] = $this->recalculateLineItem($line_item, $total, $pretax_total);
+				break;
+
+			case EEM_Line_Item::type_sub_line_item:
+			case EEM_Line_Item::type_cancellation:
+				// sub-line-items operate on the total and update both the total AND the pre-tax total
+				[$total, $pretax_total] = $this->recalculateSubLineItem($line_item, $total, $pretax_total, $is_taxable);
+				break;
+
+			case EEM_Line_Item::type_sub_tax:
+				// sub-line-items taxes ONLY operate on the pre-tax total and ONLY update the total
+				[$total, $pretax_total] = $this->recalculateSubTax($line_item, $pretax_total);
+				break;
+
+			case EEM_Line_Item::type_tax_sub_total:
+			case EEM_Line_Item::type_tax:
+				// completely ignore tax totals, tax sub-totals, and cancelled line items
+				// when calculating the pre-tax-total
+				$total = $pretax_total = 0;
+				break;
+		}
+		return [$total, $pretax_total];
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @return array
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function recalculateSubTotal(EE_Line_Item $line_item): array
+	{
+		$this->debugLog(__FUNCTION__);
+		// reset the total and pretax total to zero since we are recalculating them
+		$total = $pretax_total = 0;
+		if ($line_item->is_total()) {
+			// if this is the grand total line item
+			// then first update ALL the line item quantities (if need be)
+			$this->updateLineItemQuantities($line_item);
+		}
+		// recursively loop through children and recalculate their totals
+		$children = $line_item->children($this->default_query_params);
+		if (empty($children)) {
+			$this->debugLog(' - ' . __FUNCTION__, 3);
+			$this->debugLog(" - - total : $total ", 3);
+			$this->debugLog(" - - pretax: $pretax_total ", 3);
+			return [$total, $pretax_total];
+		}
+		foreach ($children as $child_line_item) {
+			[$child_total, $child_pretax_total] = $this->recalculateLineItemTotals(
+				$child_line_item,
+				$total,
+				$pretax_total
+			);
+			$total        += $child_total;
+			$pretax_total += $child_pretax_total;
+		}
+		// update the unit price and pretax total
+		$this->updateUnitPrice($line_item, $pretax_total, false);
+		$pretax_total = $this->updatePreTaxTotal($line_item, $pretax_total, true, false);
+		$this->debugLog(' - ' . __FUNCTION__, 3);
+		$this->debugLog(" - - line_item->name() : " . $line_item->name(), 3);
+		$this->debugLog(" - - line_item->code() : " . $line_item->code(), 3);
+		// for the actual pre-tax sub-total line item, we want to save the pretax value for everything
+		if ($line_item->is_sub_total() && $line_item->code() === 'pre-tax-subtotal') {
+			$this->updateTotal($line_item, $pretax_total, true);
+		} elseif (! $line_item->is_total()) {
+			// we don't update the total for the total line item, because that will need to include taxes
+			$total = $this->updateTotal($line_item, $total, true);
+		}
+		$this->debugLog(' - ' . __FUNCTION__, 3);
+		$this->debugLog(" - - total : $total ", 3);
+		$this->debugLog(" - - pretax: $pretax_total ", 3);
+		return [$total, $pretax_total];
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @param float        $total
+	 * @param float        $pretax_total
+	 * @return array
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function recalculateLineItem(
+		EE_Line_Item $line_item,
+		float $total = 0,
+		float $pretax_total = 0
+	): array {
+		$this->debugLog(__FUNCTION__);
+		$this->reorderSubLineItems($line_item);
+		[$total, $pretax_total] = $line_item->is_percent()
+			? $this->recalculatePercentageLineItem($line_item, $total, $pretax_total)
+			: $this->recalculateNonPercentageLineItem($line_item);
+
+		$total        = $this->updateTotal($line_item, $total, true);
+		$pretax_total = $this->updatePreTaxTotal($line_item, $pretax_total, true);
+
+		// need to also adjust unit price too if the pretax total or quantity has been updated
+		$this->updateUnitPrice($line_item, $pretax_total);
+		$this->debugLog(' - ' . __FUNCTION__, 3);
+		$this->debugLog(" - - total : $total", 3);
+		$this->debugLog(" - - pretax: $pretax_total", 3);
+		return [$total, $pretax_total];
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @param float        $total
+	 * @param float        $pretax_total
+	 * @return float[]
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 * @since 5.0.12.p
+	 */
+	private function recalculatePercentageLineItem(
+		EE_Line_Item $line_item,
+		float $total = 0,
+		float $pretax_total = 0
+	): array {
+		$this->debugLog(' % ' . __FUNCTION__, 2);
+		$pretax_total = $this->calculatePercentage($pretax_total, $line_item->percent());
+		// if the line item is taxable, then we need to calculate the total,
+		// otherwise we can just use the pretax total
+		$total = $line_item->is_taxable()
+			? $this->calculatePercentage($total, $line_item->percent())
+			: $pretax_total;
+		$this->debugLog(' % ' . __FUNCTION__, 3);
+		$this->debugLog(" % % total : $total ", 3);
+		$this->debugLog(" % % pretax: $pretax_total ", 3);
+		return [$total, $pretax_total];
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @return float[]
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 * @since 5.0.12.p
+	 */
+	private function recalculateNonPercentageLineItem(
+		EE_Line_Item $line_item
+	): array {
+		$this->debugLog(' $ ' . __FUNCTION__, 2);
+		// recursively loop through children and recalculate their totals
+		$children = $line_item->children($this->default_query_params);
+		if (! empty($children)) {
+			// reset the total and pretax total to zero since we are recalculating them
+			$total = $pretax_total = 0;
+			foreach ($children as $child_line_item) {
+				[$child_total, $child_pretax_total] = $this->recalculateLineItemTotals(
+					$child_line_item,
+					$total,
+					$pretax_total,
+					$line_item->is_taxable()
+				);
+				$this->debugLog(' $ $ ' . __FUNCTION__, 3);
+				$this->debugLog(
+					' $ $ $ ' . $child_line_item->name() . ' '
+					. $child_line_item->type() . ' ' . $child_line_item->code(),
+					3
+				);
+				$this->debugLog(" $ $ $ $ child total: $child_total", 3);
+				$this->debugLog(" $ $ $ $ child pretax: $child_pretax_total", 3);
+				$total        += $child_total;
+				$pretax_total += $child_pretax_total;
+			}
+		} else {
+			// no child line items, so recalculate the total from the unit price and quantity
+			// and set the pretax total to match since there are obviously no sub-taxes
+			$pretax_total = $total = $this->calculateTotalForQuantity($line_item);
+		}
+		$this->debugLog(' $ ' . __FUNCTION__, 3);
+		$this->debugLog(' $ $ ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+		$this->debugLog(" $ $ $ total: $total", 3);
+		$this->debugLog(" $ $ $ pretax: $pretax_total", 3);
+		return [$total, $pretax_total];
+	}
+
+
+	/**
+	 * @param EE_Line_Item $sub_line_item
+	 * @param float|int    $total
+	 * @param float|int    $pretax_total
+	 * @param bool         $is_taxable
+	 * @return float[]
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function recalculateSubLineItem(
+		EE_Line_Item $sub_line_item,
+		float $total = 0,
+		float $pretax_total = 0,
+		bool $is_taxable = false
+	): array {
+		$this->debugLog(__FUNCTION__);
+		$total = $is_taxable ? $total : $pretax_total;
+		if ($sub_line_item->is_percent()) {
+			$new_total        = $this->calculatePercentage($total, $sub_line_item->percent());
+			$new_pretax_total = $this->calculatePercentage($pretax_total, $sub_line_item->percent());
+		} else {
+			$new_total = $new_pretax_total = $this->calculateTotalForQuantity($sub_line_item);
+		}
+		$total        = $this->updateTotal($sub_line_item, $new_total, false, false);
+		$pretax_total = $this->updatePreTaxTotal($sub_line_item, $new_pretax_total, false, false);
+		// need to also adjust unit price too if the pretax total or quantity has been updated
+		$this->updateUnitPrice($sub_line_item, $pretax_total);
+		$this->debugLog(" - - total : $total ", 3);
+		$this->debugLog(" - - pretax: $pretax_total ", 3);
+		return [$total, $pretax_total];
+	}
+
+
+	/**
+	 * @param EE_Line_Item $sub_line_item
+	 * @param float|int    $pretax_total
+	 * @return float[]
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function recalculateSubTax(EE_Line_Item $sub_line_item, float $pretax_total = 0): array
+	{
+		$this->debugLog(__FUNCTION__);
+		$total_tax = $this->calculatePercentage($pretax_total, $sub_line_item->percent());
+		$total_tax = $this->updateTotal($sub_line_item, $total_tax);
+		$this->debugLog(" - total_tax : $total_tax ", 3);
+		return [$total_tax, 0];
+	}
+
+
+	/**
+	 * recursively loops through the entire line item tree updating line item quantities accordingly.
+	 * this needs to be done prior to running any other calculations for reasons that are hopefully obvious :p
+	 *
+	 * @param EE_Line_Item $line_item
+	 * @param int          $quantity
+	 * @return int
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function updateLineItemQuantities(EE_Line_Item $line_item, int $quantity = 1): int
+	{
+		switch ($line_item->type()) {
+			case EEM_Line_Item::type_total:
+			case EEM_Line_Item::type_sub_total:
+			case EEM_Line_Item::type_tax_sub_total:
+				// first, loop through children and set their quantities
+				$count    = 0;
+				$children = $line_item->children($this->default_query_params);
+				foreach ($children as $child_line_item) {
+					$count += $this->updateLineItemQuantities($child_line_item);
+				}
+				// totals and subtotals should have a quantity of 1
+				// unless their children have all been removed, in which case we can set them to 0
+				$quantity = $count > 0 ? 1 : 0;
+				$this->updateQuantity($line_item, $quantity);
+				return $quantity;
+
+			case EEM_Line_Item::type_line_item:
+				// line items should ALREADY have accurate quantities set, if not, then somebody done goofed!
+				// but if this is a percentage based line item, then ensure its quantity is 1
+				if ($line_item->is_percent()) {
+					$this->updateQuantity($line_item, 1);
+				}
+				// and we also need to loop through all the sub items and ensure those quantities match this parent.
+				$children = $line_item->children($this->default_query_params);
+				$quantity = $line_item->quantity();
+				foreach ($children as $child_line_item) {
+					$this->updateLineItemQuantities($child_line_item, $quantity);
+				}
+				// percentage line items should not increment their parent's count, so they return 0
+				return ! $line_item->is_percent() ? $quantity : 0;
+
+			case EEM_Line_Item::type_sub_line_item:
+				// percentage based items need their quantity set to 1,
+				// all others use the incoming value from the parent line item
+				$quantity = $line_item->is_percent() ? 1 : $quantity;
+				$this->updateQuantity($line_item, $quantity);
+				// percentage line items should not increment their parent's count, so they return 0
+				return ! $line_item->is_percent() ? $quantity : 0;
+
+			case EEM_Line_Item::type_tax:
+			case EEM_Line_Item::type_sub_tax:
+				// taxes should have a quantity of 1
+				$this->updateQuantity($line_item, 1);
+				return 1;
+
+			case EEM_Line_Item::type_cancellation:
+				// cancellations will be ignored for all calculations
+				// because their parent quantities should have already been adjusted when they were added
+				// so assume that things are already set correctly
+				return 0;
+		}
+		return 0;
+	}
+
+
+	/**
+	 * @param float $total
+	 * @param float $percent
+	 * @param bool  $round
+	 * @return float
+	 */
+	private function calculatePercentage(float $total, float $percent, bool $round = false): float
+	{
+		$amount = $total * $percent / 100;
+		$amount = $this->decimal_values->roundDecimalValue($amount, $round);
+		$this->debugLog(' % ' . __FUNCTION__, 2);
+		$this->debugLog(" % % total: $total", 3);
+		$this->debugLog(" % % percent: $percent", 3);
+		$this->debugLog(" % % amount: $amount", 3);
+		return $amount;
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @return float
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function calculateTotalForQuantity(EE_Line_Item $line_item): float
+	{
+		$this->debugLog(' # ' . __FUNCTION__, 2);
+		$this->debugLog(' # # ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+		$this->debugLog(" # # # unit_price: " . $line_item->unit_price(), 3);
+		$this->debugLog(" # # # quantity: " . $line_item->quantity(), 3);
+		$total = $line_item->unit_price() * $line_item->quantity();
+		return $this->decimal_values->roundDecimalValue($total);
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @param float        $percent
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function updatePercent(EE_Line_Item $line_item, float $percent)
+	{
+		// update and save new percent only if incoming value does not match existing value
+		if ($line_item->percent() !== $percent) {
+			$line_item->set_percent($percent);
+			$line_item->maybe_save();
+		}
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @param float        $pretax_total
+	 * @param bool         $round
+	 * @param bool         $save
+	 * @return float
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function updatePreTaxTotal(
+		EE_Line_Item $line_item,
+		float $pretax_total,
+		bool $round = false,
+		bool $save = true
+	): float {
+		$pretax_total = $this->decimal_values->roundDecimalValue($pretax_total, $round);
+		$sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
+		$pretax_total = $sign * $pretax_total;
+		$this->debugLog(' ? ' . __FUNCTION__, 2);
+		$this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+		$this->debugLog(" ????? SIGN: $sign  &&  pretax_total: $pretax_total", 3);
+		// update and save new total only if incoming value does not match existing value
+		if ($line_item->preTaxTotal() !== $pretax_total) {
+			$line_item->setPreTaxTotal($pretax_total);
+			if ($save) {
+				$line_item->maybe_save();
+			}
+		}
+		return $pretax_total;
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @param int          $quantity
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function updateQuantity(EE_Line_Item $line_item, int $quantity)
+	{
+		// update and save new quantity only if incoming value does not match existing value
+		if ($line_item->quantity() !== $quantity) {
+			$line_item->set_quantity($quantity);
+			$line_item->maybe_save();
+		}
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @param float        $total
+	 * @param bool         $round
+	 * @param bool         $save
+	 * @return float
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function updateTotal(EE_Line_Item $line_item, float $total, bool $round = false, bool $save = true): float
+	{
+		$total = $this->decimal_values->roundDecimalValue($total, $round);
+		$sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
+		$total = $sign * $total;
+		$this->debugLog(' ? ' . __FUNCTION__, 2);
+		$this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+		$this->debugLog(" ????? SIGN: $sign  &&  total: $total", 3);
+		// update and save new total only if incoming value does not match existing value
+		if ($line_item->total() !== $total) {
+			$line_item->set_total($total);
+			if ($save) {
+				$line_item->maybe_save();
+			}
+		}
+		return (float) $total;
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @param float        $total
+	 * @param bool         $update_status
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function updateTransaction(EE_Line_Item $line_item, float $total, bool $update_status)
+	{
+		// only update the related transaction's total
+		// if we intend to save this line item and it's a grand total
+		if ($line_item->allow_persist()) {
+			$transaction = $line_item->transaction();
+			if ($transaction instanceof EE_Transaction) {
+				$transaction->set_total($total);
+				if ($update_status) {
+					// don't save the TXN because that will be done below
+					// and the following method only saves if the status changes
+					$transaction->update_status_based_on_total_paid(false);
+				}
+				if ($transaction->ID()) {
+					$transaction->save();
+				}
+			}
+		}
+	}
+
+
+	/**
+	 * @param EE_Line_Item $line_item
+	 * @param float        $pretax_total
+	 * @param bool         $save
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function updateUnitPrice(EE_Line_Item $line_item, float $pretax_total, bool $save = true)
+	{
+		$quantity = $line_item->quantity();
+		// don't divide by zero else you'll create a singularity and implode the interweb
+		// we also don't set unit prices for percentage based line items
+		if ($quantity === 0 || $line_item->is_percent()) {
+			return;
+		}
+		$new_unit_price = $pretax_total / $quantity;
+		$new_unit_price = $this->decimal_values->roundDecimalValue($new_unit_price);
+		$sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
+		$new_unit_price = $sign * $new_unit_price;
+		$this->debugLog(' ? ' . __FUNCTION__, 2);
+		$this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+		$this->debugLog(" ????? SIGN: $sign  &&  new_unit_price: $new_unit_price", 3);
+		// update and save new total only if incoming value does not match existing value
+		if ($line_item->unit_price() !== $new_unit_price) {
+			$this->debugLog(' @ ' . __FUNCTION__, 3);
+			$this->debugLog(' @ @ ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+			$this->debugLog(" @ @ @ pretax: $pretax_total", 3);
+			$this->debugLog(" @ @ @ quantity: $quantity", 3);
+			$this->debugLog(" @ @ @ old unit price: " . $line_item->unit_price(), 3);
+			$this->debugLog(" @ @ @ new unit price: $new_unit_price", 3);
+			$line_item->set_unit_price($new_unit_price);
+			if ($save) {
+				$line_item->maybe_save();
+			}
+		}
+	}
+
+
+	/**
+	 * Recalculates the total on each individual tax (based on a recalculation of the pre-tax total), sets
+	 * the totals on each tax calculated, and returns the final tax total. Re-saves tax line items
+	 * and tax sub-total if already in the DB
+	 *
+	 * @param EE_Line_Item $total_line_item
+	 * @return float
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function recalculateTaxesAndTaxTotal(EE_Line_Item $total_line_item): float
+	{
+		$this->debugLog(__FUNCTION__, 3);
+		$this->validateLineItemAndType($total_line_item, EEM_Line_Item::type_total);
+		// calculate the total taxable amount for globally applied taxes
+		$taxable_total    = $this->taxableAmountForGlobalTaxes($total_line_item);
+		[$total_tax, $global_taxes ]    = $this->applyGlobalTaxes($total_line_item, $taxable_total);
+		$non_global_taxes = $this->calculateNonGlobalTaxes($total_line_item);
+		$all_tax_total    = $this->applyNonGlobalTaxes($total_line_item, $total_tax, $global_taxes, $non_global_taxes);
+		$this->recalculateTaxSubTotal($total_line_item);
+		$this->debugLog(" - taxable_total : $taxable_total", 4);
+		$this->debugLog(" - total_tax : $total_tax", 4);
+		$this->debugLog(" - all_tax_total : $all_tax_total", 4);
+		return $all_tax_total;
+	}
+
+
+	/**
+	 * @param EE_Line_Item $total_line_item
+	 * @param float        $taxable_total
+	 * @return array
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function applyGlobalTaxes(EE_Line_Item $total_line_item, float $taxable_total): array
+	{
+		$this->debugLog(__FUNCTION__, 4);
+		$this->validateLineItemAndType($total_line_item, EEM_Line_Item::type_total);
+		$total_tax = 0;
+		if ($taxable_total === 0.0) {
+			return [0, []];
+		}
+		// loop through all global taxes all taxes
+		$global_taxes = $total_line_item->tax_descendants();
+		foreach ($global_taxes as $tax) {
+			$tax_total = $this->calculatePercentage($taxable_total, $tax->percent());
+			if ($tax_total === 0.0) {
+				$tax->delete();
+				continue;
+			}
+			$tax_total = $this->updateTotal($tax, $tax_total, true);
+			$total_tax += $tax_total;
+		}
+		return [$this->decimal_values->roundDecimalValue($total_tax, true), $global_taxes];
+	}
+
+
+	/**
+	 * Simply forces all the tax-sub-totals to recalculate. Assumes the taxes have been calculated
+	 *
+	 * @param EE_Line_Item $line_item
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function recalculateTaxSubTotal(EE_Line_Item $line_item)
+	{
+		$this->debugLog(__FUNCTION__, 4);
+		$this->validateLineItemAndType($line_item, EEM_Line_Item::type_total);
+		foreach ($line_item->children() as $maybe_tax_subtotal) {
+			if (
+				$this->validateLineItemAndType($maybe_tax_subtotal)
+				&& $maybe_tax_subtotal->is_tax_sub_total()
+			) {
+				$total         = 0;
+				$total_percent = 0;
+				// simply loop through all its children (which should be taxes) and sum their total
+				foreach ($maybe_tax_subtotal->children() as $child_tax) {
+					if ($this->validateLineItemAndType($child_tax) && $child_tax->isGlobalTax()) {
+						$total         += $child_tax->total();
+						$total_percent += $child_tax->percent();
+					}
+				}
+				$this->updateTotal($maybe_tax_subtotal, $total, true);
+				$this->updatePercent($maybe_tax_subtotal, $total_percent);
+			}
+		}
+	}
+
+
+	/**
+	 * returns an array of tax details like:
+	 *  [
+	 *      'GST_7' => [
+	 *          'name'  => 'GST',
+	 *          'rate'  => float(7),
+	 *          'total' => float(4.9),
+	 *      ]
+	 *  ]
+	 *
+	 * @param EE_Line_Item $total_line_item
+	 * @param array        $non_global_taxes
+	 * @param float        $line_item_total
+	 * @return array
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function calculateNonGlobalTaxes(
+		EE_Line_Item $total_line_item,
+		array $non_global_taxes = [],
+		float $line_item_total = 0
+	): array {
+		$this->debugLog(__FUNCTION__, 4);
+		foreach ($total_line_item->children() as $line_item) {
+			if ($this->validateLineItemAndType($line_item)) {
+				if ($line_item->is_sub_total()) {
+					$non_global_taxes = $this->calculateNonGlobalTaxes($line_item, $non_global_taxes);
+				} elseif ($line_item->is_line_item()) {
+					$non_global_taxes = $this->calculateNonGlobalTaxes(
+						$line_item,
+						$non_global_taxes,
+						$line_item->pretaxTotal()
+					);
+				} elseif ($line_item->isSubTax()) {
+					$tax_ID = $line_item->name() . '_' . $line_item->percent();
+					if (! isset($non_global_taxes[ $tax_ID ])) {
+						$non_global_taxes[ $tax_ID ] = [
+							'name'  => $line_item->name(),
+							'rate'  => $line_item->percent(),
+							'total' => 0,
+							'obj'   => $line_item->OBJ_type(),
+							'objID' => $line_item->OBJ_ID(),
+						];
+					}
+					$tax = $this->calculatePercentage($line_item_total, $line_item->percent());
+
+					$non_global_taxes[ $tax_ID ]['total'] += $tax;
+				}
+			}
+		}
+		return $non_global_taxes;
+	}
+
+
+	/**
+	 * @param EE_Line_Item   $total_line_item
+	 * @param float          $tax_total
+	 * @param EE_Line_Item[] $global_taxes array of tax line items returned from applyGlobalTaxes()
+	 * @param array          $non_global_taxes array of tax details generated by calculateNonGlobalTaxes()
+	 * @return float
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function applyNonGlobalTaxes(
+		EE_Line_Item $total_line_item,
+		float $tax_total,
+		array $global_taxes,
+		array $non_global_taxes
+	): float {
+		$this->debugLog(__FUNCTION__, 4);
+		$taxes_subtotal = EEH_Line_Item::get_taxes_subtotal($total_line_item);
+		foreach ($non_global_taxes as $non_global_tax) {
+			$found = false;
+			foreach ($global_taxes as $global_tax) {
+				if (
+					$this->validateLineItemAndType($global_tax)
+					&& $non_global_tax['obj'] === $global_tax->OBJ_type()
+					&& $non_global_tax['objID'] === $global_tax->OBJ_ID()
+				) {
+					$found     = true;
+					$new_total = $global_tax->total() + $non_global_tax['total'];
+					// add non-global tax to matching global tax AND the tax total
+					$global_tax->set_total($new_total);
+					$global_tax->maybe_save();
+					$tax_total += $non_global_tax['total'];
+				}
+			}
+			if (! $found) {
+				// add a new line item for this non-global tax
+				$taxes_subtotal->add_child_line_item(
+					EE_Line_Item::new_instance(
+						[
+							'LIN_name'       => $non_global_tax['name'],
+							'LIN_percent'    => $non_global_tax['rate'],
+							'LIN_is_taxable' => false,
+							'LIN_total'      => $non_global_tax['total'],
+							'LIN_type'       => EEM_Line_Item::type_tax,
+							'OBJ_type'       => $non_global_tax['obj'],
+							'OBJ_ID'         => $non_global_tax['objID'],
+						]
+					)
+				);
+				$tax_total += $non_global_tax['total'];
+			}
+		}
+		return $this->decimal_values->roundDecimalValue($tax_total, true);
+	}
+
+
+	/**
+	 * Gets the total tax on this line item. Assumes taxes have already been calculated using
+	 * recalculate_taxes_and_total
+	 *
+	 * @param EE_Line_Item $line_item
+	 * @return float
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function getTotalTax(EE_Line_Item $line_item): float
+	{
+		$this->validateLineItemAndType($line_item, EEM_Line_Item::type_total);
+		$this->recalculateTaxSubTotal($line_item);
+		$total = 0;
+		foreach ($line_item->tax_descendants() as $tax_line_item) {
+			if ($this->validateLineItemAndType($tax_line_item)) {
+				$total += $tax_line_item->total();
+			}
+		}
+		return $this->decimal_values->roundDecimalValue($total, true);
+	}
+
+
+	/**
+	 * Returns the amount taxable among this line item's children (or if it has no children,
+	 * how much of it is taxable). Does not recalculate totals or subtotals.
+	 * If the taxable total is negative, (eg, if none of the tickets were taxable,
+	 * but there is a "Taxable" discount), returns 0.
+	 *
+	 * @param EE_Line_Item|null $line_item
+	 * @return float
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	public function taxableAmountForGlobalTaxes(?EE_Line_Item $line_item): float
+	{
+		$this->debugLog(__FUNCTION__, 4);
+		$total            = 0;
+		$child_line_items = $line_item->children($this->default_query_params);
+		foreach ($child_line_items as $child_line_item) {
+			$this->validateLineItemAndType($child_line_item);
+			if ($child_line_item->is_sub_total()) {
+				$total += $this->taxableAmountForGlobalTaxes($child_line_item);
+			} elseif ($child_line_item->is_line_item() && $child_line_item->is_taxable()) {
+				// if it's a percent item, only take into account
+				// the percentage that's taxable (the taxable total so far)
+				if ($child_line_item->is_percent()) {
+					$total += $this->calculatePercentage($total, $child_line_item->percent(), true);
+				} else {
+					// pretax total will be equal to the total for line items with globally applied taxes
+					$pretax_total = $this->calculateTotalForQuantity($child_line_item);
+					$total        += $this->updatePreTaxTotal($child_line_item, $pretax_total);
+				}
+			}
+		}
+		return max($total, 0);
+	}
+
+
+	/**
+	 * @param EE_Line_Item|null $line_item
+	 * @param string|null       $type
+	 * @return bool
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 */
+	private function validateLineItemAndType(?EE_Line_Item $line_item, ?string $type = null): bool
+	{
+		if (! $line_item instanceof EE_Line_Item) {
+			throw new DomainException(
+				esc_html__('Invalid or missing Line Item supplied .', 'event_espresso')
+			);
+		}
+		if ($type && $line_item->type() !== $type) {
+			throw new DomainException(
+				sprintf(
+					esc_html__(
+						'Invalid Line Item type supplied. Received "%1$s" but expected "%2$s".',
+						'event_espresso'
+					),
+					$line_item->type(),
+					$type
+				)
+			);
+		}
+		return true;
+	}
+
+
+	/**
+	 * loops through all sub-line-items for the supplied line item and reorders them as follows:
+	 * 1. sub items
+	 * 2. other??? (not a sub-item or sub-tax)
+	 * 3. sub taxes
+	 *
+	 * @param EE_Line_Item $line_item
+	 * @return void
+	 * @throws EE_Error
+	 * @throws ReflectionException
+	 * @since 5.0.12.p
+	 */
+	public function reorderSubLineItems(EE_Line_Item $line_item)
+	{
+		if ($line_item->type() !== EEM_Line_Item::type_line_item) {
+			return;
+		}
+		$this->debugLog(' + LineItemCalculator::reorderSubLineItems', 3);
+		$this->debugLog(
+			' + + ' . $line_item->OBJ_type() . ' ' . $line_item->name()
+			. ' - ' . $line_item->type() . ' (' . $line_item->code() . ')',
+			3
+		);
+		$sub_line_items = $line_item->children();
+		$items          = [];
+		$other          = [];
+		$taxes          = [];
+		foreach ($sub_line_items as $sub_line_item) {
+			switch ($sub_line_item->type()) {
+				case EEM_Line_Item::type_sub_line_item:
+					$items[ $sub_line_item->ID() ] = $sub_line_item;
+					break;
+				case EEM_Line_Item::type_sub_tax:
+					$taxes[ $sub_line_item->ID() ] = $sub_line_item;
+					break;
+				default:
+					$other[ $sub_line_item->ID() ] = $sub_line_item;
+			}
+		}
+		$order      = 0;
+		$line_items = apply_filters(
+			'FHEE__EventEspresso_core_services_calculators_LineItemCalculator__reorderSubLineItems__line_items',
+			['items' => $items, 'other' => $other, 'taxes' => $taxes]
+		);
+		foreach ($line_items as $sub_items) {
+			foreach ($sub_items as $sub_item) {
+				$order++;
+				$sub_item->set_order($order);
+				$sub_item->save();
+				$this->debugLog(
+					' + + + ' . $order . '. ' . $sub_item->OBJ_type() . ' ' . $sub_item->name()
+					. ' - ' . $sub_item->type() . ' (' . $sub_item->code() . ')',
+					3
+				);
+			}
+		}
+	}
 }

Spacing +47 added lines, -47 removed lines

@@ -56,7 +56,7 @@ 
         $this->debugLog('', 2);
         $this->debugLog(__METHOD__);
         $this->debugLog(str_repeat('*', strlen(__METHOD__)), 2);
-        $this->debugLog(">>> TXN : " . $line_item->TXN_ID(), 2);
+        $this->debugLog(">>> TXN : ".$line_item->TXN_ID(), 2);
         $this->validateLineItemAndType($line_item, EEM_Line_Item::type_total);
         $ticket_line_items = EEH_Line_Item::get_ticket_line_items($line_item);
         if (empty($ticket_line_items)) {
@@ -102,7 +102,7 @@ 
         $OBJ = $line_item->OBJ_type();
         $OBJ .= $OBJ ? ': ' : '';
         $this->debugLog(
-            ' * ' . $OBJ . $line_item->name() . ' - ' . $line_item->type() . ' (' . $line_item->code() . ')',
+            ' * '.$OBJ.$line_item->name().' - '.$line_item->type().' ('.$line_item->code().')',
             2
         );
         $this->debugLog(" * total: $total", 3);
@@ -158,7 +158,7 @@ 
         // recursively loop through children and recalculate their totals
         $children = $line_item->children($this->default_query_params);
         if (empty($children)) {
-            $this->debugLog(' - ' . __FUNCTION__, 3);
+            $this->debugLog(' - '.__FUNCTION__, 3);
             $this->debugLog(" - - total : $total ", 3);
             $this->debugLog(" - - pretax: $pretax_total ", 3);
             return [$total, $pretax_total];
@@ -175,17 +175,17 @@ 
         // update the unit price and pretax total
         $this->updateUnitPrice($line_item, $pretax_total, false);
         $pretax_total = $this->updatePreTaxTotal($line_item, $pretax_total, true, false);
-        $this->debugLog(' - ' . __FUNCTION__, 3);
-        $this->debugLog(" - - line_item->name() : " . $line_item->name(), 3);
-        $this->debugLog(" - - line_item->code() : " . $line_item->code(), 3);
+        $this->debugLog(' - '.__FUNCTION__, 3);
+        $this->debugLog(" - - line_item->name() : ".$line_item->name(), 3);
+        $this->debugLog(" - - line_item->code() : ".$line_item->code(), 3);
         // for the actual pre-tax sub-total line item, we want to save the pretax value for everything
         if ($line_item->is_sub_total() && $line_item->code() === 'pre-tax-subtotal') {
             $this->updateTotal($line_item, $pretax_total, true);
-        } elseif (! $line_item->is_total()) {
+        } elseif ( ! $line_item->is_total()) {
             // we don't update the total for the total line item, because that will need to include taxes
             $total = $this->updateTotal($line_item, $total, true);
         }
-        $this->debugLog(' - ' . __FUNCTION__, 3);
+        $this->debugLog(' - '.__FUNCTION__, 3);
         $this->debugLog(" - - total : $total ", 3);
         $this->debugLog(" - - pretax: $pretax_total ", 3);
         return [$total, $pretax_total];
@@ -216,7 +216,7 @@ 
 
         // need to also adjust unit price too if the pretax total or quantity has been updated
         $this->updateUnitPrice($line_item, $pretax_total);
-        $this->debugLog(' - ' . __FUNCTION__, 3);
+        $this->debugLog(' - '.__FUNCTION__, 3);
         $this->debugLog(" - - total : $total", 3);
         $this->debugLog(" - - pretax: $pretax_total", 3);
         return [$total, $pretax_total];
@@ -237,14 +237,14 @@ 
         float $total = 0,
         float $pretax_total = 0
     ): array {
-        $this->debugLog(' % ' . __FUNCTION__, 2);
+        $this->debugLog(' % '.__FUNCTION__, 2);
         $pretax_total = $this->calculatePercentage($pretax_total, $line_item->percent());
         // if the line item is taxable, then we need to calculate the total,
         // otherwise we can just use the pretax total
         $total = $line_item->is_taxable()
             ? $this->calculatePercentage($total, $line_item->percent())
             : $pretax_total;
-        $this->debugLog(' % ' . __FUNCTION__, 3);
+        $this->debugLog(' % '.__FUNCTION__, 3);
         $this->debugLog(" % % total : $total ", 3);
         $this->debugLog(" % % pretax: $pretax_total ", 3);
         return [$total, $pretax_total];
@@ -261,10 +261,10 @@ 
     private function recalculateNonPercentageLineItem(
         EE_Line_Item $line_item
     ): array {
-        $this->debugLog(' $ ' . __FUNCTION__, 2);
+        $this->debugLog(' $ '.__FUNCTION__, 2);
         // recursively loop through children and recalculate their totals
         $children = $line_item->children($this->default_query_params);
-        if (! empty($children)) {
+        if ( ! empty($children)) {
             // reset the total and pretax total to zero since we are recalculating them
             $total = $pretax_total = 0;
             foreach ($children as $child_line_item) {
@@ -274,10 +274,10 @@ 
                     $pretax_total,
                     $line_item->is_taxable()
                 );
-                $this->debugLog(' $ $ ' . __FUNCTION__, 3);
+                $this->debugLog(' $ $ '.__FUNCTION__, 3);
                 $this->debugLog(
-                    ' $ $ $ ' . $child_line_item->name() . ' '
-                    . $child_line_item->type() . ' ' . $child_line_item->code(),
+                    ' $ $ $ '.$child_line_item->name().' '
+                    . $child_line_item->type().' '.$child_line_item->code(),
                     3
                 );
                 $this->debugLog(" $ $ $ $ child total: $child_total", 3);
@@ -290,8 +290,8 @@ 
             // and set the pretax total to match since there are obviously no sub-taxes
             $pretax_total = $total = $this->calculateTotalForQuantity($line_item);
         }
-        $this->debugLog(' $ ' . __FUNCTION__, 3);
-        $this->debugLog(' $ $ ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+        $this->debugLog(' $ '.__FUNCTION__, 3);
+        $this->debugLog(' $ $ '.$line_item->name().' '.$line_item->type().' '.$line_item->code(), 3);
         $this->debugLog(" $ $ $ total: $total", 3);
         $this->debugLog(" $ $ $ pretax: $pretax_total", 3);
         return [$total, $pretax_total];
@@ -425,7 +425,7 @@ 
     {
         $amount = $total * $percent / 100;
         $amount = $this->decimal_values->roundDecimalValue($amount, $round);
-        $this->debugLog(' % ' . __FUNCTION__, 2);
+        $this->debugLog(' % '.__FUNCTION__, 2);
         $this->debugLog(" % % total: $total", 3);
         $this->debugLog(" % % percent: $percent", 3);
         $this->debugLog(" % % amount: $amount", 3);
@@ -441,10 +441,10 @@ 
      */
     private function calculateTotalForQuantity(EE_Line_Item $line_item): float
     {
-        $this->debugLog(' # ' . __FUNCTION__, 2);
-        $this->debugLog(' # # ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
-        $this->debugLog(" # # # unit_price: " . $line_item->unit_price(), 3);
-        $this->debugLog(" # # # quantity: " . $line_item->quantity(), 3);
+        $this->debugLog(' # '.__FUNCTION__, 2);
+        $this->debugLog(' # # '.$line_item->name().' '.$line_item->type().' '.$line_item->code(), 3);
+        $this->debugLog(" # # # unit_price: ".$line_item->unit_price(), 3);
+        $this->debugLog(" # # # quantity: ".$line_item->quantity(), 3);
         $total = $line_item->unit_price() * $line_item->quantity();
         return $this->decimal_values->roundDecimalValue($total);
     }
@@ -484,8 +484,8 @@ 
         $pretax_total = $this->decimal_values->roundDecimalValue($pretax_total, $round);
         $sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
         $pretax_total = $sign * $pretax_total;
-        $this->debugLog(' ? ' . __FUNCTION__, 2);
-        $this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+        $this->debugLog(' ? '.__FUNCTION__, 2);
+        $this->debugLog(' ??? '.$line_item->name().' '.$line_item->type().' '.$line_item->code(), 3);
         $this->debugLog(" ????? SIGN: $sign  &&  pretax_total: $pretax_total", 3);
         // update and save new total only if incoming value does not match existing value
         if ($line_item->preTaxTotal() !== $pretax_total) {
@@ -528,8 +528,8 @@ 
         $total = $this->decimal_values->roundDecimalValue($total, $round);
         $sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
         $total = $sign * $total;
-        $this->debugLog(' ? ' . __FUNCTION__, 2);
-        $this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+        $this->debugLog(' ? '.__FUNCTION__, 2);
+        $this->debugLog(' ??? '.$line_item->name().' '.$line_item->type().' '.$line_item->code(), 3);
         $this->debugLog(" ????? SIGN: $sign  &&  total: $total", 3);
         // update and save new total only if incoming value does not match existing value
         if ($line_item->total() !== $total) {
@@ -591,16 +591,16 @@ 
         $new_unit_price = $this->decimal_values->roundDecimalValue($new_unit_price);
         $sign = $line_item->type() === EEM_Line_Item::type_cancellation ? -1 : 1;
         $new_unit_price = $sign * $new_unit_price;
-        $this->debugLog(' ? ' . __FUNCTION__, 2);
-        $this->debugLog(' ??? ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+        $this->debugLog(' ? '.__FUNCTION__, 2);
+        $this->debugLog(' ??? '.$line_item->name().' '.$line_item->type().' '.$line_item->code(), 3);
         $this->debugLog(" ????? SIGN: $sign  &&  new_unit_price: $new_unit_price", 3);
         // update and save new total only if incoming value does not match existing value
         if ($line_item->unit_price() !== $new_unit_price) {
-            $this->debugLog(' @ ' . __FUNCTION__, 3);
-            $this->debugLog(' @ @ ' . $line_item->name() . ' ' . $line_item->type() . ' ' . $line_item->code(), 3);
+            $this->debugLog(' @ '.__FUNCTION__, 3);
+            $this->debugLog(' @ @ '.$line_item->name().' '.$line_item->type().' '.$line_item->code(), 3);
             $this->debugLog(" @ @ @ pretax: $pretax_total", 3);
             $this->debugLog(" @ @ @ quantity: $quantity", 3);
-            $this->debugLog(" @ @ @ old unit price: " . $line_item->unit_price(), 3);
+            $this->debugLog(" @ @ @ old unit price: ".$line_item->unit_price(), 3);
             $this->debugLog(" @ @ @ new unit price: $new_unit_price", 3);
             $line_item->set_unit_price($new_unit_price);
             if ($save) {
@@ -626,7 +626,7 @@ 
         $this->validateLineItemAndType($total_line_item, EEM_Line_Item::type_total);
         // calculate the total taxable amount for globally applied taxes
         $taxable_total    = $this->taxableAmountForGlobalTaxes($total_line_item);
-        [$total_tax, $global_taxes ]    = $this->applyGlobalTaxes($total_line_item, $taxable_total);
+        [$total_tax, $global_taxes] = $this->applyGlobalTaxes($total_line_item, $taxable_total);
         $non_global_taxes = $this->calculateNonGlobalTaxes($total_line_item);
         $all_tax_total    = $this->applyNonGlobalTaxes($total_line_item, $total_tax, $global_taxes, $non_global_taxes);
         $this->recalculateTaxSubTotal($total_line_item);
@@ -734,9 +734,9 @@ 
                         $line_item->pretaxTotal()
                     );
                 } elseif ($line_item->isSubTax()) {
-                    $tax_ID = $line_item->name() . '_' . $line_item->percent();
-                    if (! isset($non_global_taxes[ $tax_ID ])) {
-                        $non_global_taxes[ $tax_ID ] = [
+                    $tax_ID = $line_item->name().'_'.$line_item->percent();
+                    if ( ! isset($non_global_taxes[$tax_ID])) {
+                        $non_global_taxes[$tax_ID] = [
                             'name'  => $line_item->name(),
                             'rate'  => $line_item->percent(),
                             'total' => 0,
@@ -746,7 +746,7 @@ 
                     }
                     $tax = $this->calculatePercentage($line_item_total, $line_item->percent());
 
-                    $non_global_taxes[ $tax_ID ]['total'] += $tax;
+                    $non_global_taxes[$tax_ID]['total'] += $tax;
                 }
             }
         }
@@ -787,7 +787,7 @@ 
                     $tax_total += $non_global_tax['total'];
                 }
             }
-            if (! $found) {
+            if ( ! $found) {
                 // add a new line item for this non-global tax
                 $taxes_subtotal->add_child_line_item(
                     EE_Line_Item::new_instance(
@@ -860,7 +860,7 @@ 
                 } else {
                     // pretax total will be equal to the total for line items with globally applied taxes
                     $pretax_total = $this->calculateTotalForQuantity($child_line_item);
-                    $total        += $this->updatePreTaxTotal($child_line_item, $pretax_total);
+                    $total += $this->updatePreTaxTotal($child_line_item, $pretax_total);
                 }
             }
         }
@@ -877,7 +877,7 @@ 
      */
     private function validateLineItemAndType(?EE_Line_Item $line_item, ?string $type = null): bool
     {
-        if (! $line_item instanceof EE_Line_Item) {
+        if ( ! $line_item instanceof EE_Line_Item) {
             throw new DomainException(
                 esc_html__('Invalid or missing Line Item supplied .', 'event_espresso')
             );
@@ -917,8 +917,8 @@ 
         }
         $this->debugLog(' + LineItemCalculator::reorderSubLineItems', 3);
         $this->debugLog(
-            ' + + ' . $line_item->OBJ_type() . ' ' . $line_item->name()
-            . ' - ' . $line_item->type() . ' (' . $line_item->code() . ')',
+            ' + + '.$line_item->OBJ_type().' '.$line_item->name()
+            . ' - '.$line_item->type().' ('.$line_item->code().')',
             3
         );
         $sub_line_items = $line_item->children();
@@ -928,13 +928,13 @@ 
         foreach ($sub_line_items as $sub_line_item) {
             switch ($sub_line_item->type()) {
                 case EEM_Line_Item::type_sub_line_item:
-                    $items[ $sub_line_item->ID() ] = $sub_line_item;
+                    $items[$sub_line_item->ID()] = $sub_line_item;
                     break;
                 case EEM_Line_Item::type_sub_tax:
-                    $taxes[ $sub_line_item->ID() ] = $sub_line_item;
+                    $taxes[$sub_line_item->ID()] = $sub_line_item;
                     break;
                 default:
-                    $other[ $sub_line_item->ID() ] = $sub_line_item;
+                    $other[$sub_line_item->ID()] = $sub_line_item;
             }
         }
         $order      = 0;
@@ -948,8 +948,8 @@ 
                 $sub_item->set_order($order);
                 $sub_item->save();
                 $this->debugLog(
-                    ' + + + ' . $order . '. ' . $sub_item->OBJ_type() . ' ' . $sub_item->name()
-                    . ' - ' . $sub_item->type() . ' (' . $sub_item->code() . ')',
+                    ' + + + '.$order.'. '.$sub_item->OBJ_type().' '.$sub_item->name()
+                    . ' - '.$sub_item->type().' ('.$sub_item->code().')',
                     3
                 );
             }

core/services/routing/Router.php

Indentation +219 added lines, -219 removed lines

@@ -29,243 +29,243 @@
  */
 class Router
 {
-    protected EE_Dependency_Map $dependency_map;
+	protected EE_Dependency_Map $dependency_map;
 
-    protected LoaderInterface   $loader;
+	protected LoaderInterface   $loader;
 
-    protected RouteHandler      $route_handler;
+	protected RouteHandler      $route_handler;
 
-    protected string            $route_request_type;
+	protected string            $route_request_type;
 
-    protected array             $routes_loaded;
+	protected array             $routes_loaded;
 
 
-    /**
-     * RoutingSwitch constructor.
-     *
-     * @param EE_Dependency_Map $dependency_map
-     * @param LoaderInterface   $loader
-     * @param RouteHandler      $router
-     */
-    public function __construct(EE_Dependency_Map $dependency_map, LoaderInterface $loader, RouteHandler $router)
-    {
-        $this->dependency_map = $dependency_map;
-        $this->loader         = $loader;
-        $this->route_handler  = $router;
-    }
+	/**
+	 * RoutingSwitch constructor.
+	 *
+	 * @param EE_Dependency_Map $dependency_map
+	 * @param LoaderInterface   $loader
+	 * @param RouteHandler      $router
+	 */
+	public function __construct(EE_Dependency_Map $dependency_map, LoaderInterface $loader, RouteHandler $router)
+	{
+		$this->dependency_map = $dependency_map;
+		$this->loader         = $loader;
+		$this->route_handler  = $router;
+	}
 
 
-    /**
-     * @throws Exception
-     */
-    public function loadPrimaryRoutes()
-    {
-        if (isset($this->routes_loaded[ __FUNCTION__ ])) {
-            return;
-        }
-        $this->dependency_map->registerDependencies(
-            'EventEspresso\core\domain\entities\routing\handlers\admin\ActivationRequests',
-            Route::getFullDependencies()
-        );
-        $this->dependency_map->registerDependencies(
-            'EventEspresso\core\domain\entities\routing\handlers\shared\RegularRequests',
-            Route::getFullDependencies()
-        );
-        // now load and prep all primary Routes
-        $this->route_handler->addRoute('EventEspresso\core\domain\entities\routing\handlers\admin\ActivationRequests');
-        $this->route_handler->addRoute('EventEspresso\core\domain\entities\routing\handlers\shared\RegularRequests');
-        $this->route_request_type = $this->route_handler->getRouteRequestType();
-        do_action(
-            'AHEE__EventEspresso_core_services_routing_Router__loadPrimaryRoutes',
-            $this->route_handler,
-            $this->route_request_type,
-            $this->dependency_map
-        );
-        $this->routes_loaded[ __FUNCTION__ ] = true;
-    }
+	/**
+	 * @throws Exception
+	 */
+	public function loadPrimaryRoutes()
+	{
+		if (isset($this->routes_loaded[ __FUNCTION__ ])) {
+			return;
+		}
+		$this->dependency_map->registerDependencies(
+			'EventEspresso\core\domain\entities\routing\handlers\admin\ActivationRequests',
+			Route::getFullDependencies()
+		);
+		$this->dependency_map->registerDependencies(
+			'EventEspresso\core\domain\entities\routing\handlers\shared\RegularRequests',
+			Route::getFullDependencies()
+		);
+		// now load and prep all primary Routes
+		$this->route_handler->addRoute('EventEspresso\core\domain\entities\routing\handlers\admin\ActivationRequests');
+		$this->route_handler->addRoute('EventEspresso\core\domain\entities\routing\handlers\shared\RegularRequests');
+		$this->route_request_type = $this->route_handler->getRouteRequestType();
+		do_action(
+			'AHEE__EventEspresso_core_services_routing_Router__loadPrimaryRoutes',
+			$this->route_handler,
+			$this->route_request_type,
+			$this->dependency_map
+		);
+		$this->routes_loaded[ __FUNCTION__ ] = true;
+	}
 
 
-    /**
-     * @throws Exception
-     */
-    public function registerShortcodesModulesAndWidgets()
-    {
-        if (isset($this->routes_loaded[ __FUNCTION__ ])) {
-            return;
-        }
-        do_action(
-            'AHEE__EventEspresso_core_services_routing_Router__registerShortcodesModulesAndWidgets',
-            $this->route_handler,
-            $this->route_request_type,
-            $this->dependency_map
-        );
+	/**
+	 * @throws Exception
+	 */
+	public function registerShortcodesModulesAndWidgets()
+	{
+		if (isset($this->routes_loaded[ __FUNCTION__ ])) {
+			return;
+		}
+		do_action(
+			'AHEE__EventEspresso_core_services_routing_Router__registerShortcodesModulesAndWidgets',
+			$this->route_handler,
+			$this->route_request_type,
+			$this->dependency_map
+		);
 
-        /** @var LegacyModulesManager $legacy_modules_manager */
-        $legacy_modules_manager = $this->loader->getShared(LegacyModulesManager::class);
-        $legacy_modules_manager->setHooks();
+		/** @var LegacyModulesManager $legacy_modules_manager */
+		$legacy_modules_manager = $this->loader->getShared(LegacyModulesManager::class);
+		$legacy_modules_manager->setHooks();
 
-        switch ($this->route_request_type) {
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
-                break;
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\frontend\ShortcodeRequests'
-                );
-                /** @var LegacyWidgetsManager $legacy_widgets_manager */
-                $legacy_widgets_manager = $this->loader->getShared(LegacyWidgetsManager::class);
-                $legacy_widgets_manager->setHooks();
-                break;
-        }
-        $this->routes_loaded[ __FUNCTION__ ] = true;
-    }
+		switch ($this->route_request_type) {
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
+				break;
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\frontend\ShortcodeRequests'
+				);
+				/** @var LegacyWidgetsManager $legacy_widgets_manager */
+				$legacy_widgets_manager = $this->loader->getShared(LegacyWidgetsManager::class);
+				$legacy_widgets_manager->setHooks();
+				break;
+		}
+		$this->routes_loaded[ __FUNCTION__ ] = true;
+	}
 
 
-    /**
-     * @throws Exception
-     */
-    public function brewEspresso()
-    {
-        if (isset($this->routes_loaded[ __FUNCTION__ ])) {
-            return;
-        }
-        do_action(
-            'AHEE__EventEspresso_core_services_routing_Router__brewEspresso',
-            $this->route_handler,
-            $this->route_request_type,
-            $this->dependency_map
-        );
-        switch ($this->route_request_type) {
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
-                break;
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\shared\GQLRequests'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\shared\RestApiRequests'
-                );
-                break;
-        }
-        $this->routes_loaded[ __FUNCTION__ ] = true;
-    }
+	/**
+	 * @throws Exception
+	 */
+	public function brewEspresso()
+	{
+		if (isset($this->routes_loaded[ __FUNCTION__ ])) {
+			return;
+		}
+		do_action(
+			'AHEE__EventEspresso_core_services_routing_Router__brewEspresso',
+			$this->route_handler,
+			$this->route_request_type,
+			$this->dependency_map
+		);
+		switch ($this->route_request_type) {
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
+				break;
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\shared\GQLRequests'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\shared\RestApiRequests'
+				);
+				break;
+		}
+		$this->routes_loaded[ __FUNCTION__ ] = true;
+	}
 
 
-    /**
-     * @throws Exception
-     */
-    public function loadControllers()
-    {
-        if (isset($this->routes_loaded[ __FUNCTION__ ])) {
-            return;
-        }
-        do_action(
-            'AHEE__EventEspresso_core_services_routing_Router__loadControllers',
-            $this->route_handler,
-            $this->route_request_type,
-            $this->dependency_map
-        );
-        $this->route_handler->addRoute(
-            'EventEspresso\core\domain\entities\routing\handlers\admin\AdminRoute'
-        );
-        switch ($this->route_request_type) {
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\WordPressPluginsPage'
-                );
-                break;
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\frontend\FrontendRequests'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\EspressoLegacyAdmin'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\EspressoEventsAdmin'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\EspressoEventEditor'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\GutenbergEditor'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\NonEspressoAdminAjax'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\WordPressPluginsPage'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\WordPressProfilePage'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\WordPressPostsPage'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\shared\WordPressHeartbeat'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\EspressoBatchJob'
-                );
-                break;
-        }
-        $this->routes_loaded[ __FUNCTION__ ] = true;
-    }
+	/**
+	 * @throws Exception
+	 */
+	public function loadControllers()
+	{
+		if (isset($this->routes_loaded[ __FUNCTION__ ])) {
+			return;
+		}
+		do_action(
+			'AHEE__EventEspresso_core_services_routing_Router__loadControllers',
+			$this->route_handler,
+			$this->route_request_type,
+			$this->dependency_map
+		);
+		$this->route_handler->addRoute(
+			'EventEspresso\core\domain\entities\routing\handlers\admin\AdminRoute'
+		);
+		switch ($this->route_request_type) {
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\WordPressPluginsPage'
+				);
+				break;
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\frontend\FrontendRequests'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\EspressoLegacyAdmin'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\EspressoEventsAdmin'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\EspressoEventEditor'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\GutenbergEditor'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\NonEspressoAdminAjax'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\WordPressPluginsPage'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\WordPressProfilePage'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\WordPressPostsPage'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\shared\WordPressHeartbeat'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\EspressoBatchJob'
+				);
+				break;
+		}
+		$this->routes_loaded[ __FUNCTION__ ] = true;
+	}
 
 
-    /**
-     * @throws Exception
-     */
-    public function coreLoadedAndReady()
-    {
-        if (isset($this->routes_loaded[ __FUNCTION__ ])) {
-            return;
-        }
-        do_action(
-            'AHEE__EventEspresso_core_services_routing_Router__coreLoadedAndReady',
-            $this->route_handler,
-            $this->route_request_type,
-            $this->dependency_map
-        );
-        switch ($this->route_request_type) {
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
-                break;
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\shared\AssetRequests'
-                );
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\shared\SessionRequests'
-                );
-                break;
-        }
-        $this->routes_loaded[ __FUNCTION__ ] = true;
-    }
+	/**
+	 * @throws Exception
+	 */
+	public function coreLoadedAndReady()
+	{
+		if (isset($this->routes_loaded[ __FUNCTION__ ])) {
+			return;
+		}
+		do_action(
+			'AHEE__EventEspresso_core_services_routing_Router__coreLoadedAndReady',
+			$this->route_handler,
+			$this->route_request_type,
+			$this->dependency_map
+		);
+		switch ($this->route_request_type) {
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
+				break;
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\shared\AssetRequests'
+				);
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\shared\SessionRequests'
+				);
+				break;
+		}
+		$this->routes_loaded[ __FUNCTION__ ] = true;
+	}
 
 
-    /**
-     * @throws Exception
-     */
-    public function initializeLast()
-    {
-        if (isset($this->routes_loaded[ __FUNCTION__ ])) {
-            return;
-        }
-        do_action(
-            'AHEE__EventEspresso_core_services_routing_Router__initializeLast',
-            $this->route_handler,
-            $this->route_request_type,
-            $this->dependency_map
-        );
-        switch ($this->route_request_type) {
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
-                break;
-            case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
-                $this->route_handler->addRoute(
-                    'EventEspresso\core\domain\entities\routing\handlers\admin\PersonalDataRequests'
-                );
-                break;
-        }
-        $this->routes_loaded[ __FUNCTION__ ] = true;
-    }
+	/**
+	 * @throws Exception
+	 */
+	public function initializeLast()
+	{
+		if (isset($this->routes_loaded[ __FUNCTION__ ])) {
+			return;
+		}
+		do_action(
+			'AHEE__EventEspresso_core_services_routing_Router__initializeLast',
+			$this->route_handler,
+			$this->route_request_type,
+			$this->dependency_map
+		);
+		switch ($this->route_request_type) {
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_ACTIVATION:
+				break;
+			case PrimaryRoute::ROUTE_REQUEST_TYPE_REGULAR:
+				$this->route_handler->addRoute(
+					'EventEspresso\core\domain\entities\routing\handlers\admin\PersonalDataRequests'
+				);
+				break;
+		}
+		$this->routes_loaded[ __FUNCTION__ ] = true;
+	}
 }

core/services/graphql/interfaces/GraphQLInterfaceInterface.php

Indentation +11 added lines, -11 removed lines

@@ -8,18 +8,18 @@
 
 interface GraphQLInterfaceInterface
 {
-    public function getName(): string;
+	public function getName(): string;
 
-    public function getDescription(): string;
+	public function getDescription(): string;
 
-    /**
-     * @return GraphQLFieldInterface[]
-     */
-    public function getFields(): array;
+	/**
+	 * @return GraphQLFieldInterface[]
+	 */
+	public function getFields(): array;
 
-    /**
-     * @param mixed $source
-     * @return mixed
-     */
-    public function resolveField($source, array $args, AppContext $context, ResolveInfo $info);
+	/**
+	 * @param mixed $source
+	 * @return mixed
+	 */
+	public function resolveField($source, array $args, AppContext $context, ResolveInfo $info);
 }

core/services/graphql/interfaces/GraphQLInterface.php

Indentation +69 added lines, -69 removed lines

@@ -10,73 +10,73 @@
 
 abstract class GraphQLInterface implements GraphQLInterfaceInterface
 {
-    protected string $namespace = 'Espresso';
-
-    protected string $name;
-
-    protected FieldResolverV2 $resolver;
-
-    /**
-     * @var GraphQLFieldInterface[]
-     */
-    protected array $fields;
-
-    public function __construct()
-    {
-        $this->name = $this->namespace . $this->getShortName();
-
-        $this->validateFields($this->getArrayOfFields());
-
-        $this->fields = $this->getArrayOfFields();
-
-        $this->resolver = new FieldResolverV2($this->getArrayOfFields());
-    }
-
-    public function getName(): string
-    {
-        return $this->name;
-    }
-
-    public function getDescription(): string
-    {
-        return '';
-    }
-
-    /**
-     * @return GraphQLFieldInterface[]
-     */
-    public function getFields(): array
-    {
-        return $this->fields;
-    }
-
-    /**
-     * Get GraphQL interface name *without* namespace prefix
-     */
-    abstract protected function getShortName(): string;
-
-    /**
-     * @return GraphQLFieldInterface[]
-     */
-    abstract protected function getArrayOfFields(): array;
-
-    /**
-     * @param mixed[] $array
-     * @return GraphQLFieldInterface[]
-     */
-    protected function validateFields(array $array): array
-    {
-        foreach ($array as $field) {
-            if (! ($field instanceof GraphQLFieldInterface)) {
-                throw new RuntimeException(esc_html__(sprintf('GraphQL interface %1$s expects its fields to be instance of %2$s', $this->name, GraphQLFieldInterface::class), 'event_espresso'));
-            }
-        }
-
-        return $array;
-    }
-
-    public function resolveField($source, array $args, AppContext $context, ResolveInfo $info)
-    {
-        return $this->resolver->resolve($source, $args, $context, $info);
-    }
+	protected string $namespace = 'Espresso';
+
+	protected string $name;
+
+	protected FieldResolverV2 $resolver;
+
+	/**
+	 * @var GraphQLFieldInterface[]
+	 */
+	protected array $fields;
+
+	public function __construct()
+	{
+		$this->name = $this->namespace . $this->getShortName();
+
+		$this->validateFields($this->getArrayOfFields());
+
+		$this->fields = $this->getArrayOfFields();
+
+		$this->resolver = new FieldResolverV2($this->getArrayOfFields());
+	}
+
+	public function getName(): string
+	{
+		return $this->name;
+	}
+
+	public function getDescription(): string
+	{
+		return '';
+	}
+
+	/**
+	 * @return GraphQLFieldInterface[]
+	 */
+	public function getFields(): array
+	{
+		return $this->fields;
+	}
+
+	/**
+	 * Get GraphQL interface name *without* namespace prefix
+	 */
+	abstract protected function getShortName(): string;
+
+	/**
+	 * @return GraphQLFieldInterface[]
+	 */
+	abstract protected function getArrayOfFields(): array;
+
+	/**
+	 * @param mixed[] $array
+	 * @return GraphQLFieldInterface[]
+	 */
+	protected function validateFields(array $array): array
+	{
+		foreach ($array as $field) {
+			if (! ($field instanceof GraphQLFieldInterface)) {
+				throw new RuntimeException(esc_html__(sprintf('GraphQL interface %1$s expects its fields to be instance of %2$s', $this->name, GraphQLFieldInterface::class), 'event_espresso'));
+			}
+		}
+
+		return $array;
+	}
+
+	public function resolveField($source, array $args, AppContext $context, ResolveInfo $info)
+	{
+		return $this->resolver->resolve($source, $args, $context, $info);
+	}
 }

Spacing +2 added lines, -2 removed lines

@@ -23,7 +23,7 @@ 
 
     public function __construct()
     {
-        $this->name = $this->namespace . $this->getShortName();
+        $this->name = $this->namespace.$this->getShortName();
 
         $this->validateFields($this->getArrayOfFields());
 
@@ -67,7 +67,7 @@ 
     protected function validateFields(array $array): array
     {
         foreach ($array as $field) {
-            if (! ($field instanceof GraphQLFieldInterface)) {
+            if ( ! ($field instanceof GraphQLFieldInterface)) {
                 throw new RuntimeException(esc_html__(sprintf('GraphQL interface %1$s expects its fields to be instance of %2$s', $this->name, GraphQLFieldInterface::class), 'event_espresso'));
             }
         }