Prepare version 4.3.0; composer update

HISTORY.md

@@ -1,4 +1,4 @@
-## Version 4.2.3 - TBA
+## Version 4.3.0 - October 26, 2023
 
 ENH: Issues #824, #838, #851, #891, #910, #917 - General Behaviors Update: Cloning and Serializing supports behaviors.  IBaseBehavior has init($config) method. TClassBehavior tracks their owners.  Behaviors attach their registered event handlers at the behavior priority.  Registered Behavior event can optionally attached and detached automatically when the behavior is enabled or disabled (default).  Behavior events() support Closures. IBehavior are attachable class-wide by cloning. Behaviors for behaviors has better support.  Behaviors are case insensitive.  Supports Anonymous (unnamed/numeric) behaviors.  Wakeup updates the component behaviors with new named class behaviors. (belisoful)
 BUG: Issue #843 - Permissions Manager behaviors rename the method 'getManager' to 'getPermissionsManager' for specificity. (belisoful)

UPGRADE.md

@@ -1,4 +1,4 @@
-# Upgrading Instructions for PRADO Framework v4.x.x
+# Upgrading Instructions for PRADO Framework v4.3.0
 
 ### !!!IMPORTANT!!!
 

framework/Collections/ICollectionFilter.php

@@ -17,7 +17,7 @@
  * into {@see WeakReference}.
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  */
 interface ICollectionFilter
 {

framework/Collections/IPriorityCollection.php

@@ -16,7 +16,7 @@
  * that provide priority collections.
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  */
 interface IPriorityCollection
 {

framework/Collections/IWeakCollection.php

@@ -16,7 +16,7 @@
  * and {@see \Prado\Collections\TWeakList} for providing weak collections.
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  */
 interface IWeakCollection
 {

framework/Collections/IWeakRetainable.php

@@ -16,7 +16,7 @@
  * {@see \Prado\Collections\TWeakCallableCollection}, and {@see \Prado\TEventHandler}
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  */
 interface IWeakRetainable
 {

framework/Collections/TArraySubscription.php

@@ -63,7 +63,7 @@
  * ```
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  * @todo TComponent is too complex, TBaseObject for getters/setters.
  */
 class TArraySubscription

framework/Collections/TCollectionSubscription.php

@@ -24,7 +24,7 @@
  * reference.
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  */
 class TCollectionSubscription extends TArraySubscription
 {

framework/Collections/TList.php

@@ -416,7 +416,7 @@ public function offsetUnset($offset): void
 	 * because their value is the default one or useless to be cached for the next page loads.
 	 * When there are no items in the list, _d and _c are not stored
 	 * @param array $exprops by reference
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function _getZappableSleepProps(&$exprops)
 	{

framework/Collections/TMap.php

@@ -196,7 +196,7 @@ public function remove($key)
 	 * @param mixed $item the item to be removed
 	 * @throws TInvalidOperationException if the map is read-only
 	 * @return array The array of keys and the item removed.
-	 * since 4.2.3
+	 * since 4.3.0
 	 */
 	public function removeItem(mixed $item): array
 	{
@@ -236,7 +236,7 @@ public function contains($key): bool
 	 * @param mixed $item the item
 	 * @param bool $multiple Return an array of all the keys. Default true.
 	 * @return false|mixed the key of the item in the map, false if not found.
-	 * since 4.2.3
+	 * since 4.3.0
 	 */
 	public function keyOf($item, bool $multiple = true): mixed
 	{

framework/Collections/TPriorityCollectionTrait.php

@@ -57,7 +57,7 @@
  * ```
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  */
 trait TPriorityCollectionTrait
 {

framework/Collections/TPriorityList.php

@@ -613,7 +613,7 @@ public function offsetUnset($offset): void
 	 * Reimplement in derived classes to add new variables, but remember to  also to call the parent
 	 * implementation first.
 	 * @param array $exprops by reference
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function _getZappableSleepProps(&$exprops)
 	{

framework/Collections/TPriorityMap.php

@@ -427,7 +427,7 @@ public function mergeWith($data): void
 	 * Reimplement in derived classes to add new variables, but remember to  also to call the parent
 	 * implementation first.
 	 * @param array $exprops by reference
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function _getZappableSleepProps(&$exprops)
 	{

framework/Collections/TPriorityPropertyTrait.php

@@ -26,7 +26,7 @@
  * The priority is implement with a float.
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  */
 trait TPriorityPropertyTrait
 {

framework/Collections/TWeakCallableCollection.php

@@ -95,7 +95,7 @@ public function __construct($data = null, $readOnly = null, $defaultPriority = n
 
 	/**
 	 * Cloning a TWeakCallableCollection requires cloning the WeakMap
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function __clone()
 	{
@@ -106,7 +106,7 @@ public function __clone()
 	/**
 	 * Waking up a TWeakCallableCollection requires creating the WeakMap.  No items
 	 * are saved in TWeakList so only initialization of the WeakMap is required.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function __wakeup()
 	{
@@ -132,7 +132,7 @@ public function getAutoGlobalListen()
 	 * if the object being added is a TEventHandler, we use the {@see \Prado\TEventHandler::getHandlerObject}
 	 * object instead of the TEventHandler itself.
 	 * @param object $object The object to add to the managed weak map.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function weakCustomAdd(object $object)
 	{
@@ -151,7 +151,7 @@ protected function weakCustomAdd(object $object)
 	 * if the object being removed is a TEventHandler, we use the {@see \Prado\TEventHandler::getHandlerObject}
 	 * object instead of the TEventHandler itself.
 	 * @param object $object The object to remove to the managed weak map.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function weakCustomRemove(object $object)
 	{
@@ -226,7 +226,7 @@ public static function filterItemForInput(&$handler, $validate = false): void
 	 * have lost their object.
 	 * All invalid WeakReference[s] are optionally removed from the list when {@see
 	 * getDiscardInvalid} is true.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function scrubWeakReferences()
 	{
@@ -268,7 +268,7 @@ protected function scrubWeakReferences()
 
 	/**
 	 * @return bool Does the TWeakList scrub invalid WeakReferences.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function getDiscardInvalid(): bool
 	{
@@ -290,7 +290,7 @@ protected function collapseDiscardInvalid()
 	 * All invalid WeakReference[s] are optionally removed from the list on $value
 	 *  being "true".
 	 * @param null|bool|string $value Sets the TWeakList scrubbing of invalid WeakReferences.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function setDiscardInvalid($value): void
 	{
@@ -351,7 +351,7 @@ protected function flattenPriorities(): void
 	 * All invalid WeakReference[s] are optionally removed from the list before getting
 	 * the priorities.
 	 * @return array the array of priority numerics in increasing priority number
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function getPriorities(): array
 	{
@@ -365,7 +365,7 @@ public function getPriorities(): array
 	 * @param null|numeric $priority optional priority at which to count items.  if no
 	 *    parameter, it will be set to the default {@see getDefaultPriority}
 	 * @return int the number of items in the list at the specified priority
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function getPriorityCount($priority = null)
 	{
@@ -378,7 +378,7 @@ public function getPriorityCount($priority = null)
 	 * All invalid WeakReference[s] are optionally removed from the list before indexing.
 	 * This method is required by the interface \IteratorAggregate.
 	 * @return \Iterator an iterator for traversing the items in the list.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function getIterator(): \Iterator
 	{
@@ -392,7 +392,7 @@ public function getIterator(): \Iterator
 	 * Returns the total number of items in the list
 	 * All invalid WeakReference[s] are optionally removed from the list before counting.
 	 * @return int the number of items in the list
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function getCount(): int
 	{
@@ -462,7 +462,7 @@ public function itemAtIndexInPriority($index, $priority = null)
 	 * @param mixed $item new item to add
 	 * @throws TInvalidDataValueException If the index specified exceeds the bound
 	 * @throws TInvalidOperationException if the list is read-only
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function insertAt($index, $item)
 	{
@@ -513,7 +513,7 @@ public function insertAtIndexInPriority($item, $index = null, $priority = null,
 	 * @throws \Prado\Exceptions\TInvalidDataValueException If the index specified exceeds the
 	 *    bound
 	 * @throws \Prado\Exceptions\TInvalidOperationException if the list is read-only
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function internalInsertAtIndexInPriority($items, $index = null, $priority = null, $preserveCache = false)
 	{
@@ -563,7 +563,7 @@ protected function internalInsertAtIndexInPriority($items, $index = null, $prior
 	 *   the default priority.
 	 * @throws TInvalidDataValueException If the item does not exist
 	 * @return int index within the flattened list at which the item is being removed
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function remove($item, $priority = false)
 	{
@@ -609,7 +609,7 @@ public function remove($item, $priority = false)
 	 * @throws TInvalidDataValueException If the index specified exceeds the bound
 	 * @throws TInvalidOperationException if the list is read-only
 	 * @return mixed the removed item.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function removeAt($index)
 	{
@@ -647,7 +647,7 @@ public function removeAtIndexInPriority($index, $priority = null)
 	 *    left blank, it is then set to the default priority
 	 * @throws TInvalidDataValueException If the item does not exist
 	 * @return mixed the removed item.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function internalRemoveAtIndexInPriority($index, $priority = null)
 	{
@@ -662,7 +662,7 @@ protected function internalRemoveAtIndexInPriority($index, $priority = null)
 	/**
 	 * Removes all items in the priority list by calling removeAtIndexInPriority from the
 	 * last item to the first.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function clear(): void
 	{
@@ -685,7 +685,7 @@ public function clear(): void
 	/**
 	 * @param mixed $item the item
 	 * @return bool whether the list contains the item
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function contains($item): bool
 	{
@@ -814,7 +814,7 @@ public function priorityOf($item, $withindex = false)
 	 *   if $withindex is true, an array is returned of [0 => $priority, 1 => $priorityIndex,
 	 *   2 => flattenedIndex, 'priority' => $priority, 'index' => $priorityIndex, 'absindex'
 	 *   => flattenedIndex]
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function priorityAt($index, $withindex = false)
 	{
@@ -830,7 +830,7 @@ public function priorityAt($index, $withindex = false)
 	 * @param mixed $item the item to add before indexitem
 	 * @throws TInvalidDataValueException If the item does not exist
 	 * @return int where the item has been inserted in the flattened list
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function insertBefore($indexitem, $item)
 	{
@@ -855,7 +855,7 @@ public function insertBefore($indexitem, $item)
 	 * @param mixed $item the item to add after indexitem
 	 * @throws TInvalidDataValueException If the item does not exist
 	 * @return int where the item has been inserted in the flattened list
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function insertAfter($indexitem, $item)
 	{
@@ -875,7 +875,7 @@ public function insertAfter($indexitem, $item)
 	/**
 	 * All invalid WeakReference[s] are optionally removed from the list before returning.
 	 * @return array the priority list of items in array
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function toArray(): array
 	{
@@ -925,7 +925,7 @@ public function toPriorityArrayWeak()
 	 * @return array the array of priorities keys with values of arrays of items that
 	 *   are below a specified priority.  The priorities are sorted so important priorities,
 	 *   lower numerics, are first.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function toArrayBelowPriority($priority, bool $inclusive = false): array
 	{
@@ -946,7 +946,7 @@ public function toArrayBelowPriority($priority, bool $inclusive = false): array
 	 * @return array the array of priorities keys with values of arrays of items that
 	 *   are above a specified priority.  The priorities are sorted so important priorities,
 	 *   lower numerics, are first.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function toArrayAbovePriority($priority, bool $inclusive = true): array
 	{
@@ -962,7 +962,7 @@ public function toArrayAbovePriority($priority, bool $inclusive = true): array
 	 * @param mixed $data the data to be copied from, must be an array or object implementing
 	 *   Traversable
 	 * @throws TInvalidDataTypeException If data is neither an array nor a Traversable.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function copyFrom($data): void
 	{
@@ -1007,7 +1007,7 @@ public function copyFrom($data): void
 	 * @param mixed $data the data to be merged with, must be an array or object implementing
 	 *   Traversable
 	 * @throws TInvalidDataTypeException If data is neither an array nor an iterator.
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function mergeWith($data): void
 	{
@@ -1050,7 +1050,7 @@ public function mergeWith($data): void
 	 * is given.
 	 * @param int $offset the offset to set element
 	 * @param mixed $item the element value
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	public function offsetSet($offset, $item): void
 	{
@@ -1079,7 +1079,7 @@ public function offsetSet($offset, $item): void
 	 * for the next page loads.  Reimplement in derived classes to add new variables,
 	 * but remember to  also to call the parent implementation first.
 	 * @param array $exprops by reference
-	 * @since 4.2.3
+	 * @since 4.3.0
 	 */
 	protected function _getZappableSleepProps(&$exprops)
 	{

framework/Collections/TWeakCollectionTrait.php

@@ -27,7 +27,7 @@
  * {@see weakCount} and the count of each object with {@see weakObjectCount}.
  *
  * @author Brad Anderson <belisoful@icloud.com>
- * @since 4.2.3
+ * @since 4.3.0
  * @see https://www.php.net/manual/en/class.weakmap.php
  */
 trait TWeakCollectionTrait