@rogolev/value 0.0.1 → 0.0.2

package/src/helpers/is_int.mjs

@@ -1,57 +1,57 @@
-/**
- * Проверяет, является ли значение целым числом.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Значение, которое нужно проверить.
- *
- * ### Описание
- *
- * Функция `is_int` определяет, является ли переданное значение целым числом.
- *
- * Она выполняет следующие проверки:
- *
- * 1. **Тип значения**: Убеждается, что `value` имеет тип `number`.
- * 2. **Конечность числа**: Проверяет, что значение не является `Infinity` или `NaN` с помощью `Number.isFinite(value)`.
- * 3. **Целочисленность**: Убедится, что остаток от деления числа на 1 равен нулю (`value % 1 === 0`).
- *
- * Если значение соответствует всем этим условиям, оно считается целым числом.
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если значение является целым числом, иначе `false`.
- *
- * ### Примеры использования
- *
- * ```js
- * // Проверка целых чисел
- * is_int(42);       // true
- * is_int(0);        // true
- * is_int(-123);     // true
- *
- * // Проверка дробных чисел
- * is_int(3.14);     // false
- * is_int(-0.001);   // false
- *
- * // Некорректные типы данных
- * is_int('42');     // false (строка)
- * is_int(true);     // false (логическое значение)
- * is_int(null);     // false (null)
- * is_int(undefined);// false (undefined)
- *
- * // Бесконечные и некорректные числовые значения
- * is_int(Infinity); // false (бесконечность)
- * is_int(-Infinity);// false (отрицательная бесконечность)
- * is_int(NaN);      // false (не число)
- *
- * // Проверка типа bigint
- * is_int(BigInt(123456)); // false
- * ```
- *
- * @param {any} value Значение для проверки.
- * @returns {boolean} Возвращает `true`, если значение является целым числом, иначе `false`.
- */
-export default function is_int(value) {
-    return typeof value === 'number' && Number.isFinite(value) && value % 1 === 0;
-}
+/**
+ * Проверяет, является ли значение целым числом.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Значение, которое нужно проверить.
+ *
+ * ### Описание
+ *
+ * Функция `is_int` определяет, является ли переданное значение целым числом.
+ *
+ * Она выполняет следующие проверки:
+ *
+ * 1. **Тип значения**: Убеждается, что `value` имеет тип `number`.
+ * 2. **Конечность числа**: Проверяет, что значение не является `Infinity` или `NaN` с помощью `Number.isFinite(value)`.
+ * 3. **Целочисленность**: Убедится, что остаток от деления числа на 1 равен нулю (`value % 1 === 0`).
+ *
+ * Если значение соответствует всем этим условиям, оно считается целым числом.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если значение является целым числом, иначе `false`.
+ *
+ * ### Примеры использования
+ *
+ * ```js
+ * // Проверка целых чисел
+ * is_int(42);       // true
+ * is_int(0);        // true
+ * is_int(-123);     // true
+ *
+ * // Проверка дробных чисел
+ * is_int(3.14);     // false
+ * is_int(-0.001);   // false
+ *
+ * // Некорректные типы данных
+ * is_int('42');     // false (строка)
+ * is_int(true);     // false (логическое значение)
+ * is_int(null);     // false (null)
+ * is_int(undefined);// false (undefined)
+ *
+ * // Бесконечные и некорректные числовые значения
+ * is_int(Infinity); // false (бесконечность)
+ * is_int(-Infinity);// false (отрицательная бесконечность)
+ * is_int(NaN);      // false (не число)
+ *
+ * // Проверка типа bigint
+ * is_int(BigInt(123456)); // false
+ * ```
+ *
+ * @param {any} value Значение для проверки.
+ * @returns {boolean} Возвращает `true`, если значение является целым числом, иначе `false`.
+ */
+export default function is_int(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value % 1 === 0;
+}

package/src/helpers/is_integer.mjs

@@ -1,74 +1,74 @@
-/**
- * Проверяет, является ли значение целым числом.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Значение, которое необходимо проверить.
- *
- * ### Описание
- *
- * Функция `is_integer` проверяет, является ли переданное значение целым числом.
- *
- * 1. Проверяется, что значение имеет тип `number`.
- * 2. Убеждается, что значение является конечным числом.
- * 3. Проверяется, что остаток от деления значения на 1 равен 0.
- *
- * Функция возвращает `false` для:
- *
- * - Чисел с плавающей точкой (например, `3.14`, `-0.99`).
- * - Специальных чисел (`NaN`, `Infinity`, `-Infinity`).
- * - Значений других типов, таких как строки, объекты или массивы.
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если значение является целым числом, и `false` в противном случае.
- *
- * ### Примеры использования
- *
- * #### Пример 1: Проверка целых чисел
- *
- * ```js
- * is_integer(42); // true
- * is_integer(-7); // true
- * is_integer(0); // true
- * ```
- *
- * #### Пример 2: Проверка чисел с плавающей точкой
- *
- * ```js
- * is_integer(3.14); // false
- * is_integer(-0.5); // false
- * ```
- *
- * #### Пример 3: Проверка специальных чисел
- *
- * ```js
- * is_integer(NaN); // false
- * is_integer(Infinity); // false
- * is_integer(-Infinity); // false
- * ```
- *
- * #### Пример 4: Проверка других типов данных
- *
- * ```js
- * is_integer('42'); // false (строка)
- * is_integer(true); // false (логическое значение)
- * is_integer(null); // false
- * is_integer(undefined); // false
- * is_integer({}); // false (объект)
- * is_integer([]); // false (массив)
- * ```
- *
- * #### Пример 5: Проверка типа bigint
- *
- * ```js
- * is_integer(BigInt(123456)); // false
- * ```a
- *
- * @param {any} value Значение для проверки.
- * @returns {boolean} Возвращает `true`, если значение является целым числом, иначе `false`.
- */
-export default function is_integer(value) {
-    return typeof value === 'number' && Number.isFinite(value) && value % 1 === 0;
-}
+/**
+ * Проверяет, является ли значение целым числом.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Значение, которое необходимо проверить.
+ *
+ * ### Описание
+ *
+ * Функция `is_integer` проверяет, является ли переданное значение целым числом.
+ *
+ * 1. Проверяется, что значение имеет тип `number`.
+ * 2. Убеждается, что значение является конечным числом.
+ * 3. Проверяется, что остаток от деления значения на 1 равен 0.
+ *
+ * Функция возвращает `false` для:
+ *
+ * - Чисел с плавающей точкой (например, `3.14`, `-0.99`).
+ * - Специальных чисел (`NaN`, `Infinity`, `-Infinity`).
+ * - Значений других типов, таких как строки, объекты или массивы.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если значение является целым числом, и `false` в противном случае.
+ *
+ * ### Примеры использования
+ *
+ * #### Пример 1: Проверка целых чисел
+ *
+ * ```js
+ * is_integer(42); // true
+ * is_integer(-7); // true
+ * is_integer(0); // true
+ * ```
+ *
+ * #### Пример 2: Проверка чисел с плавающей точкой
+ *
+ * ```js
+ * is_integer(3.14); // false
+ * is_integer(-0.5); // false
+ * ```
+ *
+ * #### Пример 3: Проверка специальных чисел
+ *
+ * ```js
+ * is_integer(NaN); // false
+ * is_integer(Infinity); // false
+ * is_integer(-Infinity); // false
+ * ```
+ *
+ * #### Пример 4: Проверка других типов данных
+ *
+ * ```js
+ * is_integer('42'); // false (строка)
+ * is_integer(true); // false (логическое значение)
+ * is_integer(null); // false
+ * is_integer(undefined); // false
+ * is_integer({}); // false (объект)
+ * is_integer([]); // false (массив)
+ * ```
+ *
+ * #### Пример 5: Проверка типа bigint
+ *
+ * ```js
+ * is_integer(BigInt(123456)); // false
+ * ```a
+ *
+ * @param {any} value Значение для проверки.
+ * @returns {boolean} Возвращает `true`, если значение является целым числом, иначе `false`.
+ */
+export default function is_integer(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value % 1 === 0;
+}

package/src/helpers/is_list.mjs

@@ -1,43 +1,43 @@
-/**
- * Проверяет, является ли значение списком.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Значение, которое необходимо проверить.
- *
- * ### Описание
- *
- * Функция `is_list` проверяет, является ли переданное значение списком.
- *
- * Она использует метод `Array.isArray` для проверки значения.
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если значение является списком, и `false` в противном случае.
- *
- * ### Примеры использования
- *
- * #### Пример 1: Проверка массивов
- *
- * ```js
- * is_list([]); // true
- * is_list([1, 2, 3]); // true
- * ```
- *
- * #### Пример 2: Проверка значений других типов
- *
- * ```js
- * is_list({}); // false (ассоциативный массив)
- * is_list('string'); // false (строка)
- * is_list(42); // false (число)
- * is_list(null); // false
- * is_list(undefined); // false
- * ```
- *
- * @param {any} value Значение, которое необходимо проверить.
- * @returns {boolean} Возвращает `true`, если значение является списком, и `false` в противном случае.
- */
-export default function is_list(value) {
-    return Array.isArray(value);
-}
+/**
+ * Проверяет, является ли значение списком.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Значение, которое необходимо проверить.
+ *
+ * ### Описание
+ *
+ * Функция `is_list` проверяет, является ли переданное значение списком.
+ *
+ * Она использует метод `Array.isArray` для проверки значения.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если значение является списком, и `false` в противном случае.
+ *
+ * ### Примеры использования
+ *
+ * #### Пример 1: Проверка массивов
+ *
+ * ```js
+ * is_list([]); // true
+ * is_list([1, 2, 3]); // true
+ * ```
+ *
+ * #### Пример 2: Проверка значений других типов
+ *
+ * ```js
+ * is_list({}); // false (ассоциативный массив)
+ * is_list('string'); // false (строка)
+ * is_list(42); // false (число)
+ * is_list(null); // false
+ * is_list(undefined); // false
+ * ```
+ *
+ * @param {any} value Значение, которое необходимо проверить.
+ * @returns {boolean} Возвращает `true`, если значение является списком, и `false` в противном случае.
+ */
+export default function is_list(value) {
+    return Array.isArray(value);
+}

package/src/helpers/is_nan.mjs

@@ -1,51 +1,51 @@
-/**
- * Проверяет, является ли значение NaN.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Значение, которое необходимо проверить.
- *
- * ### Описание
- *
- * Функция `is_nan` проверяет, является ли переданное значение NaN (Not-a-Number).
- *
- * Она использует метод `Number.isNaN` для проверки значения.
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если значение является NaN, и `false` в противном случае.
- *
- * ### Примеры использования
- *
- * #### Пример 1: Проверка значения NaN
- *
- * ```js
- * is_nan(NaN); // true
- * ```
- *
- * #### Пример 2: Проверка числовых значений
- *
- * ```js
- * is_nan(42); // false
- * is_nan(3.14); // false
- * is_nan(Infinity); // false
- * ```
- *
- * #### Пример 3: Проверка значений других типов
- *
- * ```js
- * is_nan('42'); // false (строка)
- * is_nan(true); // false (логическое значение)
- * is_nan(null); // false
- * is_nan(undefined); // false
- * is_nan({}); // false (объект)
- * is_nan([]); // false (массив)
- * ```
- *
- * @param {any} value Значение, которое необходимо проверить.
- * @returns {boolean} Возвращает `true`, если значение является NaN, и `false` в противном случае.
- */
-export default function is_nan(value) {
-    return Number.isNaN(value);
-}
+/**
+ * Проверяет, является ли значение NaN.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Значение, которое необходимо проверить.
+ *
+ * ### Описание
+ *
+ * Функция `is_nan` проверяет, является ли переданное значение NaN (Not-a-Number).
+ *
+ * Она использует метод `Number.isNaN` для проверки значения.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если значение является NaN, и `false` в противном случае.
+ *
+ * ### Примеры использования
+ *
+ * #### Пример 1: Проверка значения NaN
+ *
+ * ```js
+ * is_nan(NaN); // true
+ * ```
+ *
+ * #### Пример 2: Проверка числовых значений
+ *
+ * ```js
+ * is_nan(42); // false
+ * is_nan(3.14); // false
+ * is_nan(Infinity); // false
+ * ```
+ *
+ * #### Пример 3: Проверка значений других типов
+ *
+ * ```js
+ * is_nan('42'); // false (строка)
+ * is_nan(true); // false (логическое значение)
+ * is_nan(null); // false
+ * is_nan(undefined); // false
+ * is_nan({}); // false (объект)
+ * is_nan([]); // false (массив)
+ * ```
+ *
+ * @param {any} value Значение, которое необходимо проверить.
+ * @returns {boolean} Возвращает `true`, если значение является NaN, и `false` в противном случае.
+ */
+export default function is_nan(value) {
+    return Number.isNaN(value);
+}

package/src/helpers/is_null.mjs

@@ -1,37 +1,37 @@
-/**
- * Проверяет, является ли значение `null`.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Проверяемая переменная.
- *
- * ### Описание
- *
- * Функция `is_null` предназначена для проверки, является ли переданное значение `null`.
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если значение является `null`, иначе `false`.
- *
- * ### Примеры использования
- *
- * ```js
- * // Пример 1: Проверка значения `null`
- * is_null(null); // true
- *
- * // Пример 2: Проверка значений, не являющихся `null`
- * is_null(undefined); // false
- * is_null(0); // false
- * is_null(''); // false
- * is_null(false); // false
- * is_null({}); // false
- * is_null([]); // false
- * ```
- *
- * @param {any} value Проверяемая переменная.
- * @returns {boolean} Возвращает `true`, если значение является `null`, иначе `false`.
- */
-export default function is_null(value) {
-    return value === null;
-}
+/**
+ * Проверяет, является ли значение `null`.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Проверяемая переменная.
+ *
+ * ### Описание
+ *
+ * Функция `is_null` предназначена для проверки, является ли переданное значение `null`.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если значение является `null`, иначе `false`.
+ *
+ * ### Примеры использования
+ *
+ * ```js
+ * // Пример 1: Проверка значения `null`
+ * is_null(null); // true
+ *
+ * // Пример 2: Проверка значений, не являющихся `null`
+ * is_null(undefined); // false
+ * is_null(0); // false
+ * is_null(''); // false
+ * is_null(false); // false
+ * is_null({}); // false
+ * is_null([]); // false
+ * ```
+ *
+ * @param {any} value Проверяемая переменная.
+ * @returns {boolean} Возвращает `true`, если значение является `null`, иначе `false`.
+ */
+export default function is_null(value) {
+    return value === null;
+}

package/src/helpers/is_number.mjs

@@ -1,49 +1,49 @@
-/**
- * Проверяет, является ли значение числом.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Проверяемая переменная.
- *
- * ### Описание
- *
- * Функция `is_number` предназначена для проверки, является ли переданное значение числом.
- *
- * Она проверяет:
- *
- * 1. **Тип значения**: Убеждается, что `value` имеет тип `number`.
- * 2. **Конечность числа**: Проверяет, что значение не является `Infinity` или `NaN` с помощью `Number.isFinite(value)`.
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если значение является числом, иначе `false`.
- *
- * ### Примеры использования
- *
- * ```js
- * // Пример 1: Проверка числовых значений
- * is_number(42); // true
- * is_number(3.14); // true
- * is_number(-0.99); // true
- *
- * // Пример 2: Проверка специальных числовых значений
- * is_number(NaN); // false
- * is_number(Infinity); // false
- * is_number(-Infinity); // false
- *
- * // Пример 3: Проверка значений других типов
- * is_number('42'); // false (строка)
- * is_number(true); // false (логическое значение)
- * is_number(null); // false
- * is_number(undefined); // false
- * is_number({}); // false (объект)
- * is_number([]); // false (массив)
- * ```
- *
- * @param {any} value Проверяемая переменная.
- * @returns {boolean} Возвращает `true`, если значение является числом, иначе `false`.
- */
-export default function is_number(value) {
-    return typeof value === 'number' && Number.isFinite(value);
-}
+/**
+ * Проверяет, является ли значение числом.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Проверяемая переменная.
+ *
+ * ### Описание
+ *
+ * Функция `is_number` предназначена для проверки, является ли переданное значение числом.
+ *
+ * Она проверяет:
+ *
+ * 1. **Тип значения**: Убеждается, что `value` имеет тип `number`.
+ * 2. **Конечность числа**: Проверяет, что значение не является `Infinity` или `NaN` с помощью `Number.isFinite(value)`.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если значение является числом, иначе `false`.
+ *
+ * ### Примеры использования
+ *
+ * ```js
+ * // Пример 1: Проверка числовых значений
+ * is_number(42); // true
+ * is_number(3.14); // true
+ * is_number(-0.99); // true
+ *
+ * // Пример 2: Проверка специальных числовых значений
+ * is_number(NaN); // false
+ * is_number(Infinity); // false
+ * is_number(-Infinity); // false
+ *
+ * // Пример 3: Проверка значений других типов
+ * is_number('42'); // false (строка)
+ * is_number(true); // false (логическое значение)
+ * is_number(null); // false
+ * is_number(undefined); // false
+ * is_number({}); // false (объект)
+ * is_number([]); // false (массив)
+ * ```
+ *
+ * @param {any} value Проверяемая переменная.
+ * @returns {boolean} Возвращает `true`, если значение является числом, иначе `false`.
+ */
+export default function is_number(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}