Prerelease

CHANGELOG.md

@@ -1,6 +1,26 @@
 # (MODX)EvolutionCMS.libraries.ddTools changelog
 
 
+## Version 0.62 (2024-06-14)
+* \+ `\ddTools::isEmpty`: The new public static method. Determines whether a variable is empty.
+* \* `\ddTools::parseText` → Parameters:
+	* \+ `$params->data`: Both objects and arrays are supported regardless of nesting level.
+	* \+ `$params->data->{$key}` → Valid values → `boolean`: The new supported value. It will be converted to `'1'` or `'0'` respectively.
+	* \* `$params->isCompletelyParsingEnabled`:
+		* \* Has been renamed from `$params->mergeAll` (with backward compatibility).
+		* \+ If enabled, the method will parse everything, including document fields, settings, chunks, snippets and URLs.
+* \* `\DDTools\ObjectTools::`
+	* \+ `getPropValue` → Parameters → `$params->notFoundResult`: The new optional parameter. Allows to define what will be returned if required property will not found (see README → Examples).
+	* \+ `unfold` → Parameters → `$params->isCrossTypeEnabled`: The new optional parameter. This parameter determines whether the method should process elements across different data types, such as arrays and objects, at all levels. When set to `true`, the method will recursively unfold elements of both array and object types, regardless of the type of the root parent (see README → Examples).
+	* \* `isPropExists` → Parameters → `$params->object`: The method will return `false` even if the parameter is not an object or array.
+* \* `\DDTools\ObjectCollection::setOneItemData` → Parameters: The following have been renamed (old names are still supported but deprecated):
+	* \* `itemIndex` → `index`.
+	* \* `itemData` → `data`.
+* \+ `\DDTools\Base\Base::getClassName`: The new public static method. Gets data about a class name (see README).
+* \+ `\DDTools\Base\AncestorTrait::getChildClassName`: The new public static method (see README).
+* \+ `\DDTools\Storage\`: The new classes. This is beta functionality, use it at your own risk.
+
+
 ## Version 0.61 (2023-10-01)
 * \+ `\DDTools\ObjectTools::convertType` → Parameters → `$params->type` → Valid values → `'stringHtmlAttrs'`: The new available value. Allows conversion to an HTML attributes string (see README → Examples).
 

CHANGELOG_ru.md

@@ -1,6 +1,26 @@
 # (MODX)EvolutionCMS.libraries.ddTools changelog
 
 
+## Версия 0.62 (2024-06-14)
+* \+ `\ddTools::isEmpty`: Новый публичный статичный метод. Проверяет, пуста ли переменная.
+* \* `\ddTools::parseText` → Параметры:
+	* \+ `$params->data`: Поддерживаются как объекты, так и массивы одновременно, независимо от уровня вложенности.
+	* \+ `$params->data->{$key}` → Допустимые значения → `boolean`: Новое поддерживаемое значение. Будет сконвертировано в `'1'` или `'0'` соответственно.
+	* \* `$params->isCompletelyParsingEnabled`:
+		* \* Переименован из `$params->mergeAll` (с обратной совместимостью).
+		* \+ Если включён, метод будет парсить всё, включая поля документа, настройки, чанки, сниппеты и URL.
+* \* `\DDTools\ObjectTools::`
+	* \+ `getPropValue` → Параметры → `$params->notFoundResult`: Новый необязательный параметр. Позволяет настроить, что будет возвращено, если нужное свойство не найдено (см. README → Примеры).
+	* \+ `unfold` → Параметры → `$params->isCrossTypeEnabled`: Новый необязательный параметр. Параметр определяет, должен ли метод обрабатывать объекты и массивы одновременно, независимо от типа, на всех уровнях вложенности. При значении `true` метод будет рекурсивно разворачивать элементы как массивов, так и объектов, независимо от типа корневого родителя (см. README → Примеры).
+	* \* `isPropExists` → Параметры → `$params->object`: Метод вернёт `false` даже если параметр не является объектом или массивом.
+* \* `\DDTools\ObjectCollection::setOneItemData` → Параметры: Следующие переименованы (старые имена по-прежнему поддерживаются, но объявлены устаревшими):
+	* \* `itemIndex` → `index`.
+	* \* `itemData` → `data`.
+* \+ `\DDTools\Base\Base::getClassName`: Новый публичный статичный метод. Получает данные об имени класса (см. README).
+* \+ `\DDTools\Base\AncestorTrait::getChildClassName`: Новый публичный статичный метод (см. README).
+* \+ `\DDTools\Storage\`: Новые классы. Это бета-версия, используйте её на свой страх и риск.
+
+
 ## Версия 0.61 (2023-10-01)
 * \+ `\DDTools\ObjectTools::convertType` → Параметры → `$params->type` → Допустимые значения → `'stringHtmlAttrs'`: Новое значение. Позволяет преобразовать в строку HTML-атрибутов (см. README → Примеры).
 

composer.json

@@ -1,7 +1,7 @@
 {
 	"name": "dd/evolutioncms-libraries-ddtools",
 	"type": "modxevo-library-ddtools",
-	"version": "0.61.0",
+	"version": "0.62.0",
 	"description": "A library with various tools facilitating your work.",
 	"keywords": [
 		"modx",

modx.ddtools.class.php

@@ -1,11 +1,11 @@
 <?php
 /**
  * EvolutionCMS.libraries.ddTools
- * @version 0.61 (2023-10-01)
+ * @version 0.62 (2024-06-14)
  * 
  * @see README.md
  * 
- * @copyright 2012–2023 Ronef {@link https://Ronef.ru }
+ * @copyright 2012–2024 Ronef {@link https://Ronef.ru }
  */
 
 global $modx;