@rogolev/value 0.0.1 → 0.0.2

package/src/helpers/is_class.mjs

@@ -1,87 +1,87 @@
-/**
- * Проверяет, является ли переданная переменная классом.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Проверяемая переменная.
- *
- * ### Описание
- *
- * В JavaScript классы являются функциями, но с уникальным поведением.
- *
- * Для определения класса функция проверяет:
- *
- * 1. Что переданная переменная является функцией.
- * 2. Что строковое представление функции начинается с `class `.
- *
- * #### Примечание
- *
- * Конструкторы функций, созданные с помощью `function`, не будут распознаны как классы.
- *
- * Для примера:
- *
- * ```js
- * function Foo() {}
- * is_class(Foo); // Возвращает: false
- * ```
- *
- * В отличие от классов, которые выглядят так:
- *
- * ```js
- * class MyClass {}
- * is_class(MyClass); // Возвращает: true
- * ```
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если значение является классом, иначе `false`.
- *
- * ### Примеры использования
- *
- * 1. Классы:
- *
- * ```js
- * class MyClass {}
- * is_class(MyClass); // true
- * ```
- *
- * 2. Функции-конструкторы:
- *
- * ```js
- * function MyFunction() {}
- * is_class(MyFunction); // false
- * ```
- *
- * 3. Объекты и примитивы:
- *
- * ```js
- * is_class({}); // false
- * is_class([]); // false
- * is_class(null); // false
- * is_class(42); // false
- * ```
- *
- * @param {any} value Проверяемая переменная.
- * @returns {boolean} Возвращает `true`, если значение является классом, иначе `false`.
- */
-export default function is_class(value) {
-    // Проверяем, является ли значение функцией
-    if (typeof value !== 'function') {
-        return false;
-    }
-
-    // Проверяем, не является ли значение классом, используя строковое представление функции
-    if (typeof value.toString === 'function') {
-        return /^class\s/.test(value.toString());
-    }
-
-    // Если у функции нет прототипа, значит это стрелочная функция или метод
-    if (!value.prototype) {
-        return false;
-    }
-
-    // Строковое представление может быть изменено в разных средах выполнения
-    // или при минификации кода, поэтому проводим дополнительную проверку.
-    return !Object.getOwnPropertyDescriptor(value, 'prototype')?.writable;
-}
+/**
+ * Проверяет, является ли переданная переменная классом.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Проверяемая переменная.
+ *
+ * ### Описание
+ *
+ * В JavaScript классы являются функциями, но с уникальным поведением.
+ *
+ * Для определения класса функция проверяет:
+ *
+ * 1. Что переданная переменная является функцией.
+ * 2. Что строковое представление функции начинается с `class `.
+ *
+ * #### Примечание
+ *
+ * Конструкторы функций, созданные с помощью `function`, не будут распознаны как классы.
+ *
+ * Для примера:
+ *
+ * ```js
+ * function Foo() {}
+ * is_class(Foo); // Возвращает: false
+ * ```
+ *
+ * В отличие от классов, которые выглядят так:
+ *
+ * ```js
+ * class MyClass {}
+ * is_class(MyClass); // Возвращает: true
+ * ```
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если значение является классом, иначе `false`.
+ *
+ * ### Примеры использования
+ *
+ * 1. Классы:
+ *
+ * ```js
+ * class MyClass {}
+ * is_class(MyClass); // true
+ * ```
+ *
+ * 2. Функции-конструкторы:
+ *
+ * ```js
+ * function MyFunction() {}
+ * is_class(MyFunction); // false
+ * ```
+ *
+ * 3. Объекты и примитивы:
+ *
+ * ```js
+ * is_class({}); // false
+ * is_class([]); // false
+ * is_class(null); // false
+ * is_class(42); // false
+ * ```
+ *
+ * @param {any} value Проверяемая переменная.
+ * @returns {boolean} Возвращает `true`, если значение является классом, иначе `false`.
+ */
+export default function is_class(value) {
+    // Проверяем, является ли значение функцией
+    if (typeof value !== 'function') {
+        return false;
+    }
+
+    // Проверяем, не является ли значение классом, используя строковое представление функции
+    if (typeof value.toString === 'function') {
+        return /^class\s/.test(value.toString());
+    }
+
+    // Если у функции нет прототипа, значит это стрелочная функция или метод
+    if (!value.prototype) {
+        return false;
+    }
+
+    // Строковое представление может быть изменено в разных средах выполнения
+    // или при минификации кода, поэтому проводим дополнительную проверку.
+    return !Object.getOwnPropertyDescriptor(value, 'prototype')?.writable;
+}

package/src/helpers/is_float.mjs

@@ -1,67 +1,67 @@
-/**
- * Проверяет, является ли значение числом с плавающей точкой.
- *
- * ### Параметры
- *
- * - `value` (any)
- *      Значение для проверки.
- *
- * ### Описание
- *
- * Функция `is_float` проверяет, является ли переданное значение числом с дробной частью, которое отличается от целого числа.
- *
- * Она работает следующим образом:
- *
- * 1. Проверяет, что значение имеет тип `number`.
- * 2. Исключает значения `NaN`, которые также относятся к типу `number`, но не считаются числовыми значениями.
- * 3. Проверяет, что у числа есть дробная часть, проверяя остаток от деления на `1` (`value % 1 !== 0`).
- *
- * Значения, которые не являются числами или числа без дробной части, не считаются числами с плавающей точкой.
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если значение является числом с плавающей точкой, иначе `false`.
- *
- * ### Примеры использования
- *
- * #### Числа с плавающей точкой
- *
- * ```js
- * is_float(3.14);    // true
- * is_float(-0.5);    // true
- * is_float(0.1 + 0.2); // true
- * ```
- *
- * #### Целые числа
- *
- * ```js
- * is_float(0);       // false
- * is_float(42);      // false
- * is_float(-100);    // false
- * ```
- *
- * #### Нечисловые значения
- *
- * ```js
- * is_float('3.14');  // false
- * is_float(NaN);     // false
- * is_float(null);    // false
- * is_float(undefined); // false
- * is_float(true);    // false
- * is_float({});      // false
- * is_float([]);      // false
- * ```
- *
- * #### Специальные значения
- *
- * ```js
- * is_float(Infinity);   // false
- * is_float(-Infinity);  // false
- * ```
- *
- * @param {any} value Значение для проверки.
- * @returns {boolean} Возвращает `true`, если значение является числом с плавающей точкой, иначе `false`.
- */
-export default function is_float(value) {
-    return typeof value === 'number' && Number.isFinite(value) && value % 1 !== 0;
-}
+/**
+ * Проверяет, является ли значение числом с плавающей точкой.
+ *
+ * ### Параметры
+ *
+ * - `value` (any)
+ *      Значение для проверки.
+ *
+ * ### Описание
+ *
+ * Функция `is_float` проверяет, является ли переданное значение числом с дробной частью, которое отличается от целого числа.
+ *
+ * Она работает следующим образом:
+ *
+ * 1. Проверяет, что значение имеет тип `number`.
+ * 2. Исключает значения `NaN`, которые также относятся к типу `number`, но не считаются числовыми значениями.
+ * 3. Проверяет, что у числа есть дробная часть, проверяя остаток от деления на `1` (`value % 1 !== 0`).
+ *
+ * Значения, которые не являются числами или числа без дробной части, не считаются числами с плавающей точкой.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если значение является числом с плавающей точкой, иначе `false`.
+ *
+ * ### Примеры использования
+ *
+ * #### Числа с плавающей точкой
+ *
+ * ```js
+ * is_float(3.14);    // true
+ * is_float(-0.5);    // true
+ * is_float(0.1 + 0.2); // true
+ * ```
+ *
+ * #### Целые числа
+ *
+ * ```js
+ * is_float(0);       // false
+ * is_float(42);      // false
+ * is_float(-100);    // false
+ * ```
+ *
+ * #### Нечисловые значения
+ *
+ * ```js
+ * is_float('3.14');  // false
+ * is_float(NaN);     // false
+ * is_float(null);    // false
+ * is_float(undefined); // false
+ * is_float(true);    // false
+ * is_float({});      // false
+ * is_float([]);      // false
+ * ```
+ *
+ * #### Специальные значения
+ *
+ * ```js
+ * is_float(Infinity);   // false
+ * is_float(-Infinity);  // false
+ * ```
+ *
+ * @param {any} value Значение для проверки.
+ * @returns {boolean} Возвращает `true`, если значение является числом с плавающей точкой, иначе `false`.
+ */
+export default function is_float(value) {
+    return typeof value === 'number' && Number.isFinite(value) && value % 1 !== 0;
+}

package/src/helpers/is_function.mjs

@@ -1,74 +1,74 @@
-/**
- * Проверяет, что значение является функцией, исключая классы.
- *
- * ### Параметры
- *
- * - `value` (any):
- *      Проверяемое значение. Может быть любым типом данных.
- *
- * ### Описание
- *
- * Функция проверяет, является ли переданное значение функцией, исключая классы.
- * В JavaScript функции и классы оба являются типом `function`, но классы имеют особый синтаксис и поведение.
- * Функция `is_function` различает их, проверяя, не начинается ли строковое представление функции с `class`, что указывает на то, что это класс, а не обычная функция.
- * Если значение является функцией (но не классом), функция возвращает `true`.
- * Для всех остальных типов данных (включая классы, объекты, примитивы) функция возвращает `false`.
- *
- * ### Возвращаемое значение
- *
- * Возвращает `true`, если переданное значение является функцией (но не классом).
- * Возвращает `false`, если переданное значение является классом или любым другим типом данных.
- *
- * ### Примеры использования
- *
- * Пример 1: обычная функция
- *
- * ```js
- * function test() {}
- * is_function(test); // Возвращает: true
- * ```
- *
- * Пример 2: класс
- *
- * ```js
- * class MyClass {}
- * is_function(MyClass); // Возвращает: false
- * ```
- *
- * Пример 3: объект
- *
- * ```js
- * const obj = {};
- * is_function(obj); // Возвращает: false
- * ```
- *
- * Пример 4: примитив
- *
- * ```js
- * is_function(42); // Возвращает: false
- * is_function('hello'); // Возвращает: false
- * ```
- *
- * @param {any} value - Проверяемое значение.
- * @returns {boolean} Возвращает `true`, если значение является функцией, иначе `false`.
- */
-export default function is_function(value) {
-    // Проверяем, является ли значение функцией
-    if (typeof value !== 'function') {
-        return false;
-    }
-
-    // Проверяем, не является ли значение классом, используя строковое представление функции
-    if (typeof value.toString === 'function') {
-        return !/^class\s/.test(value.toString());
-    }
-
-    // Если у функции нет прототипа, значит это стрелочная функция или метод
-    if (!value.prototype) {
-        return true;
-    }
-
-    // Строковое представление может быть изменено в разных средах выполнения
-    // или при минификации кода, поэтому проводим дополнительную проверку.
-    return Boolean(Object.getOwnPropertyDescriptor(value, 'prototype')?.writable);
-}
+/**
+ * Проверяет, что значение является функцией, исключая классы.
+ *
+ * ### Параметры
+ *
+ * - `value` (any):
+ *      Проверяемое значение. Может быть любым типом данных.
+ *
+ * ### Описание
+ *
+ * Функция проверяет, является ли переданное значение функцией, исключая классы.
+ * В JavaScript функции и классы оба являются типом `function`, но классы имеют особый синтаксис и поведение.
+ * Функция `is_function` различает их, проверяя, не начинается ли строковое представление функции с `class`, что указывает на то, что это класс, а не обычная функция.
+ * Если значение является функцией (но не классом), функция возвращает `true`.
+ * Для всех остальных типов данных (включая классы, объекты, примитивы) функция возвращает `false`.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает `true`, если переданное значение является функцией (но не классом).
+ * Возвращает `false`, если переданное значение является классом или любым другим типом данных.
+ *
+ * ### Примеры использования
+ *
+ * Пример 1: обычная функция
+ *
+ * ```js
+ * function test() {}
+ * is_function(test); // Возвращает: true
+ * ```
+ *
+ * Пример 2: класс
+ *
+ * ```js
+ * class MyClass {}
+ * is_function(MyClass); // Возвращает: false
+ * ```
+ *
+ * Пример 3: объект
+ *
+ * ```js
+ * const obj = {};
+ * is_function(obj); // Возвращает: false
+ * ```
+ *
+ * Пример 4: примитив
+ *
+ * ```js
+ * is_function(42); // Возвращает: false
+ * is_function('hello'); // Возвращает: false
+ * ```
+ *
+ * @param {any} value - Проверяемое значение.
+ * @returns {boolean} Возвращает `true`, если значение является функцией, иначе `false`.
+ */
+export default function is_function(value) {
+    // Проверяем, является ли значение функцией
+    if (typeof value !== 'function') {
+        return false;
+    }
+
+    // Проверяем, не является ли значение классом, используя строковое представление функции
+    if (typeof value.toString === 'function') {
+        return !/^class\s/.test(value.toString());
+    }
+
+    // Если у функции нет прототипа, значит это стрелочная функция или метод
+    if (!value.prototype) {
+        return true;
+    }
+
+    // Строковое представление может быть изменено в разных средах выполнения
+    // или при минификации кода, поэтому проводим дополнительную проверку.
+    return Boolean(Object.getOwnPropertyDescriptor(value, 'prototype')?.writable);
+}

package/src/helpers/is_infinity.mjs

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