@rogolev/value 0.0.1 → 0.0.2

package/.prettierignore

@@ -1,4 +1,4 @@
-**/.git
-**/.svn
-**/.hg
-**/node_modules
+**/.git
+**/.svn
+**/.hg
+**/node_modules

package/CHANGELOG.md

@@ -1,56 +1,68 @@
-# v0.0.1
-
-## Добавлено
-
-### Помощники для работы с типами данных
-
-- [array](./docs/helpers/array.md) — Создаёт массив из переданных значений, обрабатывая
-  ассоциативные массивы (объекты с ключами).
-- [empty](./docs/helpers/empty.md) — Проверяет, является ли переменная пустой.
-- [gettype](./docs/helpers/gettype.md) — Определяет тип переданного значения.
-- [is_array](./docs/helpers/is_array.md) — Проверяет, является ли переданное значение массивом
-  или ассоциативным массивом (объектом с ключами и значениями).
-- [is_assoc](./docs/helpers/is_assoc.md) — Проверяет, является ли значение ассоциативным
-  массивом.
-- [is_bigint](./docs/helpers/is_bigint.md) — Проверяет, является ли значение типом `bigint`.
-- [is_bool](./docs/helpers/is_bool.md) — Проверяет, является ли переданное значение логическим
-  типом (`boolean`).
-- [is_boolean](./docs/helpers/is_boolean.md) — Проверяет, является ли переданное значение
-  логическим типом (`boolean`).
-- [is_class](./docs/helpers/is_class.md) — Проверяет, является ли переданная переменная
-  классом.
-- [is_float](./docs/helpers/is_float.md) — Проверяет, является ли значение числом с плавающей
-  точкой.
-- [is_function](./docs/helpers/is_function.md) — Проверяет, что значение является функцией,
-  исключая классы.
-- [is_infinity](./docs/helpers/is_infinity.md) — Проверяет, является ли значение
-  бесконечностью (Infinity или -Infinity).
-- [is_int](./docs/helpers/is_int.md) — Проверяет, является ли значение целым числом.
-- [is_integer](./docs/helpers/is_integer.md) — Проверяет, является ли значение целым числом.
-- [is_list](./docs/helpers/is_list.md) — Проверяет, является ли значение списком.
-- [is_nan](./docs/helpers/is_nan.md) — Проверяет, является ли значение NaN.
-- [is_null](./docs/helpers/is_null.md) — Проверяет, является ли значение `null`.
-- [is_number](./docs/helpers/is_number.md) — Проверяет, является ли значение числом.
-- [is_numeric](./docs/helpers/is_numeric.md) — Проверяет, является ли значение числом или
-  числовой строкой.
-- [is_object](./docs/helpers/is_object.md) — Проверяет, является ли переданная переменная
-  объектом, созданным с использованием класса.
-- [is_scalar](./docs/helpers/is_scalar.md) — Проверяет, является ли значение скалярным.
-- [is_string](./docs/helpers/is_string.md) — Проверяет, является ли значение строкой.
-- [is_symbol](./docs/helpers/is_symbol.md) — Проверяет, является ли значение символом.
-- [is_undefined](./docs/helpers/is_undefined.md) — Проверяет, является ли значение
-  `undefined`.
-- [print](./docs/helpers/print.md) — Преобразует значение в строку и выводит его на консоль.
-- [print_type](./docs/helpers/print_type.md) — Преобразует значение в строку с указанием типа
-  и выводит его на консоль.
-- [settype](./docs/helpers/settype.md) — Преобразует значение в указанный тип.
-- [to_array](./docs/helpers/to_array.md) — Преобразует значение в массив.
-- [to_assoc](./docs/helpers/to_assoc.md) — Преобразует значение в ассоциативный массив.
-- [to_bool](./docs/helpers/to_bool.md) — Преобразует значение в логическое значение.
-- [to_boolean](./docs/helpers/to_bool.md) — Преобразует значение в логическое значение.
-- [to_float](./docs/helpers/to_float.md) — Преобразует значение в число с плавающей точкой.
-- [to_int](./docs/helpers/to_int.md) — Преобразует значение в целое число.
-- [to_integer](./docs/helpers/to_integer.md) — Преобразует значение в целое число.
-- [to_list](./docs/helpers/to_list.md) — Преобразует значение в список.
-- [to_object](./docs/helpers/to_object.md) — Преобразует значение в объект.
-- [to_string](./docs/helpers/to_string.md) — Преобразует значение в строку.
+# v0.0.2
+
+## Добавлено
+
+### Классы для работы с типами
+
+- [Convert](./docs/classes/Convert.md) — Класс, предоставляющий методы для преобразования
+  различных типов данных в JavaScript.
+- [Type](./docs/classes/Type.md) — Класс, предоставляющий методы для проверки типов данных в
+  JavaScript.
+
+# v0.0.1
+
+## Добавлено
+
+### Помощники для работы с типами данных
+
+- [array](./docs/helpers/array.md) — Создаёт массив из переданных значений, обрабатывая
+  ассоциативные массивы (объекты с ключами).
+- [empty](./docs/helpers/empty.md) — Проверяет, является ли переменная пустой.
+- [gettype](./docs/helpers/gettype.md) — Определяет тип переданного значения.
+- [is_array](./docs/helpers/is_array.md) — Проверяет, является ли переданное значение массивом
+  или ассоциативным массивом (объектом с ключами и значениями).
+- [is_assoc](./docs/helpers/is_assoc.md) — Проверяет, является ли значение ассоциативным
+  массивом.
+- [is_bigint](./docs/helpers/is_bigint.md) — Проверяет, является ли значение типом `bigint`.
+- [is_bool](./docs/helpers/is_bool.md) — Проверяет, является ли переданное значение логическим
+  типом (`boolean`).
+- [is_boolean](./docs/helpers/is_boolean.md) — Проверяет, является ли переданное значение
+  логическим типом (`boolean`).
+- [is_class](./docs/helpers/is_class.md) — Проверяет, является ли переданная переменная
+  классом.
+- [is_float](./docs/helpers/is_float.md) — Проверяет, является ли значение числом с плавающей
+  точкой.
+- [is_function](./docs/helpers/is_function.md) — Проверяет, что значение является функцией,
+  исключая классы.
+- [is_infinity](./docs/helpers/is_infinity.md) — Проверяет, является ли значение
+  бесконечностью (Infinity или -Infinity).
+- [is_int](./docs/helpers/is_int.md) — Проверяет, является ли значение целым числом.
+- [is_integer](./docs/helpers/is_integer.md) — Проверяет, является ли значение целым числом.
+- [is_list](./docs/helpers/is_list.md) — Проверяет, является ли значение списком.
+- [is_nan](./docs/helpers/is_nan.md) — Проверяет, является ли значение NaN.
+- [is_null](./docs/helpers/is_null.md) — Проверяет, является ли значение `null`.
+- [is_number](./docs/helpers/is_number.md) — Проверяет, является ли значение числом.
+- [is_numeric](./docs/helpers/is_numeric.md) — Проверяет, является ли значение числом или
+  числовой строкой.
+- [is_object](./docs/helpers/is_object.md) — Проверяет, является ли переданная переменная
+  объектом, созданным с использованием класса.
+- [is_scalar](./docs/helpers/is_scalar.md) — Проверяет, является ли значение скалярным.
+- [is_string](./docs/helpers/is_string.md) — Проверяет, является ли значение строкой.
+- [is_symbol](./docs/helpers/is_symbol.md) — Проверяет, является ли значение символом.
+- [is_undefined](./docs/helpers/is_undefined.md) — Проверяет, является ли значение
+  `undefined`.
+- [print](./docs/helpers/print.md) — Преобразует значение в строку и выводит его на консоль.
+- [print_type](./docs/helpers/print_type.md) — Преобразует значение в строку с указанием типа
+  и выводит его на консоль.
+- [settype](./docs/helpers/settype.md) — Преобразует значение в указанный тип.
+- [to_array](./docs/helpers/to_array.md) — Преобразует значение в массив.
+- [to_assoc](./docs/helpers/to_assoc.md) — Преобразует значение в ассоциативный массив.
+- [to_bool](./docs/helpers/to_bool.md) — Преобразует значение в логическое значение.
+- [to_boolean](./docs/helpers/to_bool.md) — Преобразует значение в логическое значение.
+- [to_float](./docs/helpers/to_float.md) — Преобразует значение в число с плавающей точкой.
+- [to_int](./docs/helpers/to_int.md) — Преобразует значение в целое число.
+- [to_integer](./docs/helpers/to_integer.md) — Преобразует значение в целое число.
+- [to_list](./docs/helpers/to_list.md) — Преобразует значение в список.
+- [to_object](./docs/helpers/to_object.md) — Преобразует значение в объект.
+- [to_string](./docs/helpers/to_string.md) — Преобразует значение в строку.
+

package/LICENSE

@@ -1,41 +1,41 @@
-MIT License
-
-Copyright (c) 2025 Роголев Дмитрий Александрович
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
-associated documentation files (the "Software"), to deal in the Software without restriction,
-including without limitation the rights to use, copy, modify, merge, publish, distribute,
-sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial
-portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
-NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
-OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-# Перевод
-
-Лицензия MIT
-
-Авторское право (c) 2025 Роголев Дмитрий Александрович
-
-Настоящим предоставляется бесплатное разрешение любому лицу, получившему копию данного программного
-обеспечения и сопутствующей документации (в дальнейшем "Программное обеспечение"), использовать
-Программное обеспечение без ограничений, включая неограниченное право на использование, копирование,
-изменение, слияние, публикацию, распространение, сублицензирование и/или продажу копий Программного
-обеспечения, а также лицам, которым предоставляется данное Программное обеспечение, при соблюдении
-следующих условий:
-
-Вышеуказанное уведомление об авторских правах и данное разрешение должны быть включены во все копии
-или значимые части данного Программного обеспечения.
-
-ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ "КАК ЕСТЬ", БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ
-ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ ГАРАНТИЯМИ ТОВАРНОЙ ПРИГОДНОСТИ, ПРИГОДНОСТИ ДЛЯ
-ОПРЕДЕЛЕННОЙ ЦЕЛИ И НЕНАРУШЕНИЯ ПРАВ. НИ В КОЕМ СЛУЧАЕ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ
-ОТВЕТСТВЕННОСТИ ЗА КАКИЕ-ЛИБО ИСКИ, УЩЕРБ ИЛИ ДРУГИЕ ОБЯЗАТЕЛЬСТВА, НЕЗАВИСИМО ОТ ДЕЙСТВИЯ ДОГОВОРА,
-ДЕЛИКТА ИЛИ ИНАЧЕ, ВОЗНИКШИЕ ИЗ, ИЛИ В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ИЛИ ИНЫМИ
-ДЕЙСТВИЯМИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.
+MIT License
+
+Copyright (c) 2025 Роголев Дмитрий Александрович
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and
+associated documentation files (the "Software"), to deal in the Software without restriction,
+including without limitation the rights to use, copy, modify, merge, publish, distribute,
+sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+# Перевод
+
+Лицензия MIT
+
+Авторское право (c) 2025 Роголев Дмитрий Александрович
+
+Настоящим предоставляется бесплатное разрешение любому лицу, получившему копию данного программного
+обеспечения и сопутствующей документации (в дальнейшем "Программное обеспечение"), использовать
+Программное обеспечение без ограничений, включая неограниченное право на использование, копирование,
+изменение, слияние, публикацию, распространение, сублицензирование и/или продажу копий Программного
+обеспечения, а также лицам, которым предоставляется данное Программное обеспечение, при соблюдении
+следующих условий:
+
+Вышеуказанное уведомление об авторских правах и данное разрешение должны быть включены во все копии
+или значимые части данного Программного обеспечения.
+
+ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ "КАК ЕСТЬ", БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ
+ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ ГАРАНТИЯМИ ТОВАРНОЙ ПРИГОДНОСТИ, ПРИГОДНОСТИ ДЛЯ
+ОПРЕДЕЛЕННОЙ ЦЕЛИ И НЕНАРУШЕНИЯ ПРАВ. НИ В КОЕМ СЛУЧАЕ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ
+ОТВЕТСТВЕННОСТИ ЗА КАКИЕ-ЛИБО ИСКИ, УЩЕРБ ИЛИ ДРУГИЕ ОБЯЗАТЕЛЬСТВА, НЕЗАВИСИМО ОТ ДЕЙСТВИЯ ДОГОВОРА,
+ДЕЛИКТА ИЛИ ИНАЧЕ, ВОЗНИКШИЕ ИЗ, ИЛИ В СВЯЗИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ ИЛИ ИСПОЛЬЗОВАНИЕМ ИЛИ ИНЫМИ
+ДЕЙСТВИЯМИ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.

package/README.md

@@ -1,91 +1,100 @@
-# value.js
-
-**value.js** — Библиотека для **JavaScript**, переосмысливающая типы данных и работу с ними.
-
-## Документация
-
-[Типы данных в value.js](./docs/types.md).
-
-[Помощники для работы с типами данных value.js](./docs/helpers.md)
-
-## Примеры использования
-
-```js
-import {
-    array,
-    is_array,
-    is_object,
-    is_class,
-    is_function,
-    is_int,
-    is_float,
-    gettype,
-} from '@rogolev/value.js';
-
-// Создаем ассоциативный массив - контейнер пар ключ-значение
-const assoc = array({ key1: 'value1', key2: 'value2', key3: 'value3' });
-
-console.log(assoc); // {key1: 'value1', key2: 'value2', key3: 'value3'}
-
-// Ассоциативные массивы создаются с помощью конструкции Object.create(null)
-console.log(Object.getPrototypeOf(assoc)); // null
-
-// Функция array добавляет итератор Symbol.iterator к ассоциативным массивам
-for (const [key, value] of assoc) {
-    console.log(key, value);
-}
-
-// Ассоциативные массивы являются массивами
-console.log(is_array(assoc)); // true
-
-// Списки являются массивами
-console.log(is_array([1, 2, 3])); // true
-
-class stdClass {}
-function MyFunction() {}
-
-const object = new stdClass();
-const objFunc = new MyFunction();
-
-// Экземпляры классов не являются массивами
-console.log(is_array(object)); // false
-
-// Экземпляр класса является объектом
-console.log(is_object(object)); // true
-
-// Экземпляр функции не является объектом
-console.log(is_object(objFunc)); // false
-
-// Класс является классом
-console.log(is_class(stdClass)); // true
-
-// Функция не является классом
-console.log(is_class(MyFunction)); // false
-
-// Функция является функцией
-console.log(is_function(MyFunction)); // true
-
-// Класс не является функцией
-console.log(is_function(stdClass)); // false
-
-// Целое число
-console.log(is_int(3)); // true
-
-// Число с плавающей точкой
-console.log(is_float(3.14)); // true
-
-// Получение типа
-console.log(gettype(stdClass)); // "class"
-```
-
-## Автор
-
-Роголев Дмитрий Александрович
-
-<drogolev@internet.ru>
-
-<https://github.com/dmitry-rogolev>
-
-## Лицензия
-
-Этот проект лицензируется на условиях лицензии MIT. Подробности см. в файле [LICENSE](./LICENSE).
+# value.js
+
+**value.js** &mdash; Библиотека для **JavaScript**, переосмысливающая типы данных и работу с ними.
+
+## Документация
+
+[Типы данных в value.js](./docs/types.md).
+
+[Классы](./docs/classes.md)
+
+[Помощники для работы с типами данных value.js](./docs/helpers.md)
+
+## Установка
+
+```
+npm install @rogolev/value
+```
+
+## Примеры использования
+
+```js
+import {
+    array,
+    is_array,
+    is_object,
+    is_class,
+    is_function,
+    is_int,
+    is_float,
+    gettype,
+} from '@rogolev/value.js';
+
+// Создаем ассоциативный массив - контейнер пар ключ-значение
+const assoc = array({ key1: 'value1', key2: 'value2', key3: 'value3' });
+
+console.log(assoc); // {key1: 'value1', key2: 'value2', key3: 'value3'}
+
+// Ассоциативные массивы создаются с помощью конструкции Object.create(null)
+console.log(Object.getPrototypeOf(assoc)); // null
+
+// Функция array добавляет итератор Symbol.iterator к ассоциативным массивам
+for (const [key, value] of assoc) {
+    console.log(key, value);
+}
+
+// Ассоциативные массивы являются массивами
+console.log(is_array(assoc)); // true
+
+// Списки являются массивами
+console.log(is_array([1, 2, 3])); // true
+
+class stdClass {}
+function MyFunction() {}
+
+const object = new stdClass();
+const objFunc = new MyFunction();
+
+// Экземпляры классов не являются массивами
+console.log(is_array(object)); // false
+
+// Экземпляр класса является объектом
+console.log(is_object(object)); // true
+
+// Экземпляр функции не является объектом
+console.log(is_object(objFunc)); // false
+
+// Класс является классом
+console.log(is_class(stdClass)); // true
+
+// Функция не является классом
+console.log(is_class(MyFunction)); // false
+
+// Функция является функцией
+console.log(is_function(MyFunction)); // true
+
+// Класс не является функцией
+console.log(is_function(stdClass)); // false
+
+// Целое число
+console.log(is_int(3)); // true
+
+// Число с плавающей точкой
+console.log(is_float(3.14)); // true
+
+// Получение типа
+console.log(gettype(stdClass)); // "class"
+```
+
+## Автор
+
+Роголев Дмитрий Александрович
+
+<drogolev@internet.ru>
+
+<https://github.com/dmitry-rogolev>
+
+## Лицензия
+
+Этот проект лицензируется на условиях лицензии MIT. Подробности см. в файле [LICENSE](./LICENSE).
+

package/babel.config.json

@@ -1,20 +1,20 @@
-{
-    "presets": [
-        [
-            "@babel/preset-env",
-            {
-                // Настройка целевых браузеров
-                "targets": "> 0.25%, not dead",
-
-                // Автоматически добавлять полифилы, где это необходимо
-                "useBuiltIns": "usage",
-
-                // Использование core-js версии 3 для полифилов
-                "corejs": 3,
-
-                // Преобразование модулей ES6 в CommonJS
-                "modules": "commonjs"
-            }
-        ]
-    ]
-}
+{
+    "presets": [
+        [
+            "@babel/preset-env",
+            {
+                // Настройка целевых браузеров
+                "targets": "> 0.25%, not dead",
+
+                // Автоматически добавлять полифилы, где это необходимо
+                "useBuiltIns": "usage",
+
+                // Использование core-js версии 3 для полифилов
+                "corejs": 3,
+
+                // Преобразование модулей ES6 в CommonJS
+                "modules": "commonjs"
+            }
+        ]
+    ]
+}

package/docs/classes/Convert/toArray.md

@@ -0,0 +1,100 @@
+[Главная](../../../README.md) / [Классы](../../classes.md) / [Convert](../Convert.md) / toArray
+
+[Исходный код](../../../src/classes/Convert.mjs)
+
+# Convert.toArray
+
+`Convert.toArray` — Преобразует значение в массив.
+
+## Сигнатура метода
+
+```ts
+static toArray(value: any): Array<any>;
+```
+
+## Описание
+
+Метод `Convert.toArray` используется для преобразования различных типов данных в массив. Если
+значение уже является массивом (тип `Array` или ассоциативный массив), возвращается оно же. Объекты
+(экземпляры классов) преобразуются в массив с одним элементом.
+
+## Примечание
+
+Метод `Convert.toArray` для объектов (ассоциативных массивов) возвращает результат работы функции
+`array`, которая создает объект-контейнер пар ключ-значение (ассоциативный массив) с помощью
+конструкции `Object.create(null)`, копирует все видимые пары в этот контейнер, а также добавляет
+итератор `Symbol.iterator` для перебора контейнера в цикле `for-of`.
+
+## Параметры
+
+- `value` (any)
+
+    Переменная, значение которой необходимо привести к массиву.
+
+## Возвращаемое значение
+
+Возвращает массив, содержащий переданное значение. Если значение уже является массивом, возвращается
+оно же.
+
+## Примеры использования
+
+1. Преобразование строки в массив:
+
+    ```js
+    const result = Convert.toArray('example');
+    // Результат: ["example"]
+    ```
+
+2. Преобразование числа в массив:
+
+    ```js
+    const result = Convert.toArray(123);
+    // Результат: [123]
+    ```
+
+3. Преобразование массива (без изменений):
+
+    ```js
+    const result = Convert.toArray([1, 2, 3]);
+    // Результат: [1, 2, 3]
+    ```
+
+4. Преобразование объекта в массив:
+
+    ```js
+    const result = Convert.toArray({ key: 'value' });
+    // Результат: { key: "value" }
+
+    const proto = Object.getPrototypeOf(result);
+    // Результат: null
+
+    for (const [key, value] of result) {
+        console.log(key, value);
+    }
+    // Результат: 'key', 'value'
+    ```
+
+5. Преобразование экземпляра класса в массив:
+
+    ```js
+    class MyClass {}
+
+    const instance = new MyClass();
+    const result = Convert.toArray(instance);
+    // Результат: [instance]
+    ```
+
+6. Преобразование null:
+
+    ```js
+    const result = Convert.toArray(null);
+    // Результат: []
+    ```
+
+7. Преобразование undefined:
+
+    ```js
+    const result = Convert.toArray(undefined);
+    // Результат: []
+    ```
+