@rogolev/value 0.0.1 → 0.0.2

package/src/helpers/to_integer.mjs

@@ -1,81 +1,81 @@
-import to_int from './to_int.mjs';
-
-/**
- * Приводит значение переменной к целому числу.
- *
- * ### Описание
- *
- * Функция `to_integer` является синонимом функции `to_int` и используется для преобразования различных типов данных в целое число.
- * Если значение не является числом или строкой, функция возвращает `1` для истинных значений и `0` для ложных значений.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Переменная, значение которой необходимо привести к целому числу.
- *
- * - `base` (number)
- *      Основание системы счисления для преобразования строки в число. По умолчанию `10`.
- *
- * ### Возвращаемое значение
- *
- * Возвращает целое число, соответствующее переданному значению.
- *
- * ### Примеры использования
- *
- * 1. Преобразование строки в целое число:
- *
- *    ```js
- *    const result = to_integer('123');
- *    // Результат: 123
- *    ```
- *
- * 2. Преобразование числа с плавающей точкой в целое число:
- *
- *    ```js
- *    const result = to_integer(123.45);
- *    // Результат: 123
- *    ```
- *
- * 3. Преобразование булевых значений:
- *
- *    ```js
- *    const result1 = to_integer(true);
- *    // Результат: 1
- *
- *    const result2 = to_integer(false);
- *    // Результат: 0
- *    ```
- *
- * 4. Преобразование других значений:
- *
- *    ```js
- *    const result1 = to_integer(null);
- *    // Результат: 0
- *
- *    const result2 = to_integer(undefined);
- *    // Результат: 0
- *
- *    const result3 = to_integer('example');
- *    // Результат: 0
- *    ```
- *
- * 5. Преобразование строки с основанием системы счисления:
- *
- *    ```js
- *    const result1 = to_integer('10', 2);
- *    // Результат: 2
- *
- *    const result2 = to_integer('A', 16);
- *    // Результат: 10
- *
- *    const result3 = to_integer('7', 8);
- *    // Результат: 7
- *    ```
- *
- * @param {any} value Переменная, значение которой необходимо привести к целому числу.
- * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
- * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
- */
-export default function to_integer(value, base = 10) {
-    return to_int(value, base);
-}
+import to_int from './to_int.mjs';
+
+/**
+ * Приводит значение переменной к целому числу.
+ *
+ * ### Описание
+ *
+ * Функция `to_integer` является синонимом функции `to_int` и используется для преобразования различных типов данных в целое число.
+ * Если значение не является числом или строкой, функция возвращает `1` для истинных значений и `0` для ложных значений.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо привести к целому числу.
+ *
+ * - `base` (number)
+ *      Основание системы счисления для преобразования строки в число. По умолчанию `10`.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает целое число, соответствующее переданному значению.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование строки в целое число:
+ *
+ *    ```js
+ *    const result = to_integer('123');
+ *    // Результат: 123
+ *    ```
+ *
+ * 2. Преобразование числа с плавающей точкой в целое число:
+ *
+ *    ```js
+ *    const result = to_integer(123.45);
+ *    // Результат: 123
+ *    ```
+ *
+ * 3. Преобразование булевых значений:
+ *
+ *    ```js
+ *    const result1 = to_integer(true);
+ *    // Результат: 1
+ *
+ *    const result2 = to_integer(false);
+ *    // Результат: 0
+ *    ```
+ *
+ * 4. Преобразование других значений:
+ *
+ *    ```js
+ *    const result1 = to_integer(null);
+ *    // Результат: 0
+ *
+ *    const result2 = to_integer(undefined);
+ *    // Результат: 0
+ *
+ *    const result3 = to_integer('example');
+ *    // Результат: 0
+ *    ```
+ *
+ * 5. Преобразование строки с основанием системы счисления:
+ *
+ *    ```js
+ *    const result1 = to_integer('10', 2);
+ *    // Результат: 2
+ *
+ *    const result2 = to_integer('A', 16);
+ *    // Результат: 10
+ *
+ *    const result3 = to_integer('7', 8);
+ *    // Результат: 7
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо привести к целому числу.
+ * @param {number} [base=10] Основание системы счисления для преобразования строки в число.
+ * @returns {number} Возвращает приведенное к целому числу значение переменной `value`.
+ */
+export default function to_integer(value, base = 10) {
+    return to_int(value, base);
+}

package/src/helpers/to_list.mjs

@@ -1,56 +1,56 @@
-import is_array from './is_array.mjs';
-import is_null from './is_null.mjs';
-import is_undefined from './is_undefined.mjs';
-
-/**
- * Преобразует значение в список.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Значение, которое необходимо преобразовать.
- *
- * ### Описание
- *
- * Функция `to_list` преобразует переданное значение в список.
- *
- * Она выполняет следующие проверки:
- *
- * 1. **Null и Undefined**: Возвращает пустой массив для значений `null` и `undefined`.
- * 2. **Array**: Возвращает исходный массив, если он передан.
- * 3. **Object**: Возвращает массив значений объекта, если передан ассоциативный массив.
- * 4. **Примитивы и другие типы**: Возвращает массив, содержащий переданное значение.
- *
- * ### Возвращаемое значение
- *
- * Возвращает массив, представляющий список значений.
- *
- * ### Примеры использования
- *
- * ```js
- * to_list(null); // []
- * to_list(undefined); // []
- * to_list([1, 2, 3]); // [1, 2, 3]
- * to_list({ key: 'value' }); // ['value']
- * to_list('example'); // ['example']
- * to_list(123); // [123]
- * ```
- *
- * @param {any} value Значение, которое необходимо преобразовать.
- * @returns {Array} Возвращает массив, представляющий список значений.
- */
-export default function to_list(value) {
-    if (is_null(value) || is_undefined(value)) {
-        return [];
-    }
-
-    if (Array.isArray(value)) {
-        return value;
-    }
-
-    if (is_array(value)) {
-        return Object.values(value);
-    }
-
-    return [value];
-}
+import is_array from './is_array.mjs';
+import is_null from './is_null.mjs';
+import is_undefined from './is_undefined.mjs';
+
+/**
+ * Преобразует значение в список.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Значение, которое необходимо преобразовать.
+ *
+ * ### Описание
+ *
+ * Функция `to_list` преобразует переданное значение в список.
+ *
+ * Она выполняет следующие проверки:
+ *
+ * 1. **Null и Undefined**: Возвращает пустой массив для значений `null` и `undefined`.
+ * 2. **Array**: Возвращает исходный массив, если он передан.
+ * 3. **Object**: Возвращает массив значений объекта, если передан ассоциативный массив.
+ * 4. **Примитивы и другие типы**: Возвращает массив, содержащий переданное значение.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает массив, представляющий список значений.
+ *
+ * ### Примеры использования
+ *
+ * ```js
+ * to_list(null); // []
+ * to_list(undefined); // []
+ * to_list([1, 2, 3]); // [1, 2, 3]
+ * to_list({ key: 'value' }); // ['value']
+ * to_list('example'); // ['example']
+ * to_list(123); // [123]
+ * ```
+ *
+ * @param {any} value Значение, которое необходимо преобразовать.
+ * @returns {Array} Возвращает массив, представляющий список значений.
+ */
+export default function to_list(value) {
+    if (is_null(value) || is_undefined(value)) {
+        return [];
+    }
+
+    if (Array.isArray(value)) {
+        return value;
+    }
+
+    if (is_array(value)) {
+        return Object.values(value);
+    }
+
+    return [value];
+}

package/src/helpers/to_object.mjs

@@ -1,94 +1,94 @@
-import is_array from './is_array.mjs';
-import is_class from './is_class.mjs';
-import is_null from './is_null.mjs';
-import is_object from './is_object.mjs';
-import is_undefined from './is_undefined.mjs';
-
-/**
- * Приводит значение переменной к объекту.
- *
- * ### Описание
- *
- * Функция `to_object` используется для преобразования различных типов данных в объект. Если значение уже является объектом, оно возвращается без изменений. Если значение является классом, возвращается новый экземпляр этого класса. Если значение является массивом, элементы массива копируются в новый объект. Для других значений создается объект с полем `value`, содержащим это значение.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Переменная, значение которой необходимо привести к объекту.
- *
- * ### Возвращаемое значение
- *
- * Возвращает объект, соответствующий переданному значению.
- *
- * ### Примеры использования
- *
- * 1. Преобразование объекта:
- *
- *    ```js
- *    class MyClass {}
- *    const obj = new MyClass();
- *    const result = to_object(obj);
- *    // Результат: obj
- *    ```
- *
- * 2. Преобразование класса:
- *
- *    ```js
- *    class MyClass {}
- *    const result = to_object(MyClass);
- *    // Результат: экземпляр MyClass
- *    ```
- *
- * 3. Преобразование null и undefined:
- *
- *    ```js
- *    const result1 = to_object(null);
- *    // Результат: экземпляр анонимного класса
- *
- *    const result2 = to_object(undefined);
- *    // Результат: экземпляр анонимного класса
- *    ```
- *
- * 4. Преобразование массива:
- *
- *    ```js
- *    const arr = [1, 2, 3];
- *    const result = to_object(arr);
- *    // Результат: объект с элементами массива
- *    ```
- *
- * 5. Преобразование других значений:
- *
- *    ```js
- *    const result = to_object('example');
- *    // Результат: объект с полем value, содержащим 'example'
- *    ```
- *
- * @param {any} value Переменная, значение которой необходимо привести к объекту.
- * @returns {object} Возвращает приведенное к объекту значение переменной `value`.
- */
-export default function to_object(value) {
-    if (is_object(value)) {
-        return value;
-    }
-
-    if (is_class(value)) {
-        return new value();
-    }
-
-    const object = new (class {})();
-
-    if (is_null(value) || is_undefined(value)) {
-        return object;
-    }
-
-    if (is_array(value)) {
-        Object.assign(object, value);
-
-        return object;
-    }
-
-    object.value = value;
-
-    return object;
-}
+import is_array from './is_array.mjs';
+import is_class from './is_class.mjs';
+import is_null from './is_null.mjs';
+import is_object from './is_object.mjs';
+import is_undefined from './is_undefined.mjs';
+
+/**
+ * Приводит значение переменной к объекту.
+ *
+ * ### Описание
+ *
+ * Функция `to_object` используется для преобразования различных типов данных в объект. Если значение уже является объектом, оно возвращается без изменений. Если значение является классом, возвращается новый экземпляр этого класса. Если значение является массивом, элементы массива копируются в новый объект. Для других значений создается объект с полем `value`, содержащим это значение.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Переменная, значение которой необходимо привести к объекту.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает объект, соответствующий переданному значению.
+ *
+ * ### Примеры использования
+ *
+ * 1. Преобразование объекта:
+ *
+ *    ```js
+ *    class MyClass {}
+ *    const obj = new MyClass();
+ *    const result = to_object(obj);
+ *    // Результат: obj
+ *    ```
+ *
+ * 2. Преобразование класса:
+ *
+ *    ```js
+ *    class MyClass {}
+ *    const result = to_object(MyClass);
+ *    // Результат: экземпляр MyClass
+ *    ```
+ *
+ * 3. Преобразование null и undefined:
+ *
+ *    ```js
+ *    const result1 = to_object(null);
+ *    // Результат: экземпляр анонимного класса
+ *
+ *    const result2 = to_object(undefined);
+ *    // Результат: экземпляр анонимного класса
+ *    ```
+ *
+ * 4. Преобразование массива:
+ *
+ *    ```js
+ *    const arr = [1, 2, 3];
+ *    const result = to_object(arr);
+ *    // Результат: объект с элементами массива
+ *    ```
+ *
+ * 5. Преобразование других значений:
+ *
+ *    ```js
+ *    const result = to_object('example');
+ *    // Результат: объект с полем value, содержащим 'example'
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо привести к объекту.
+ * @returns {object} Возвращает приведенное к объекту значение переменной `value`.
+ */
+export default function to_object(value) {
+    if (is_object(value)) {
+        return value;
+    }
+
+    if (is_class(value)) {
+        return new value();
+    }
+
+    const object = new (class {})();
+
+    if (is_null(value) || is_undefined(value)) {
+        return object;
+    }
+
+    if (is_array(value)) {
+        Object.assign(object, value);
+
+        return object;
+    }
+
+    object.value = value;
+
+    return object;
+}