@rogolev/value 0.0.1 → 0.0.3

package/docs/helpers/is_array.md

@@ -1,105 +1,105 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / is_array
-
-[Исходный код](../../src/helpers/is_array.mjs)
-
-# is_array
-
-`is_array` — Проверяет, является ли переданное значение массивом или ассоциативным массивом
-(объектом с ключами и значениями).
-
-## Сигнатура функции
-
-```ts
-function is_array(value: any): boolean;
-```
-
-## Описание
-
-В JavaScript массивы и объекты имеют разные структуры и предназначения:
-
-- Массивы (`Array`) являются упорядоченными коллекциями элементов, которые могут быть индексированы.
-- Объекты (`Object`) содержат пары "ключ-значение", которые могут быть неупорядоченными.
-
-Эта функция проверяет, является ли переданное значение обычным массивом (например, `[1, 2, 3]`),
-либо ассоциативным массивом (объектом с парами "ключ-значение", например, `{foo: 'bar'}`).
-
-## Алгоритм работы функции
-
-1. Сначала проверяется, является ли переданное значение обычным массивом с помощью встроенного
-   метода `Array.isArray(value)`. Если это массив, функция сразу возвращает `true`.
-
-2. Если переменная не является массивом, то выполняются дополнительные проверки:
-
-    - Проверяется, что значение не равно `null` (так как `null` в JavaScript также является
-      объектом, но не является ни массивом, ни объектом с парами "ключ-значение").
-    - Проверяется, что значение является объектом JavaScript (с помощью
-      `typeof value === 'object'`).
-    - Проверяется, что прототип объекта совпадает с `Object.prototype` (это объект, от которого
-      наследуются все объекты в JavaScript) или является `null` (это означает, что объект был создан
-      с помощью `Object.create(null)` и не имеет прототипа).
-    - Исключаются массивоподобные объекты (например, `arguments`, `NodeList`), путем проверки, что
-      свойство `length` не является собственным свойством объекта.
-    - Дополнительно проверяется, что объект является простым (его конструктор равен `Object`), а
-      также исключаются встроенные объекты (`Math`, `JSON`, `Reflect`, `Intl`), для которых функция
-      возвращает `true`.
-
-## Параметры
-
-- `value` (any)
-
-    Проверяемая переменная.
-
-## Возвращаемое значение
-
-Возвращает `true`, если переменная является обычным массивом (`Array`), ассоциативным массивом
-(объектом с парами "ключ-значение"), ассоциативным массивом, созданным с помощью
-`Object.create(null)`. В остальных случаях функция возвращает `false`.
-
-## Примеры использования
-
-1. Простые массивы:
-
-    ```js
-    is_array([1, 2, 3]); // true
-    is_array([]); // true
-    ```
-
-2. Ассоциативные массивы (объекты с ключами и значениями):
-
-    ```js
-    is_array({ foo: 'bar', baz: 42 }); // true
-    is_array({ 0: 'a', 1: 'b' }); // true
-    ```
-
-3. Объекты, созданные без прототипа:
-
-    ```js
-    const noProtoObject = Object.create(null);
-    noProtoObject.foo = 'bar';
-    is_array(noProtoObject); // true
-    ```
-
-4. Примитивы и невалидные значения:
-
-    ```js
-    is_array(null); // false
-    is_array(undefined); // false
-    is_array(42); // false
-    is_array('hello'); // false
-    ```
-
-5. Специальные объекты:
-
-    ```js
-    is_array(new Map()); // false
-    is_array(new Set()); // false
-    is_array(() => {}); // false
-    ```
-
-6. Классы и их экземпляры:
-
-    ```js
-    class MyClass {}
-    const instance = new MyClass();
-    is_array(instance); // false
-    ```
+[Главная](../../README.md) / [Помощники](../helpers.md) / is_array
+
+[Исходный код](../../src/helpers/is_array.mjs)
+
+# is_array
+
+`is_array` — Проверяет, является ли переданное значение массивом или ассоциативным массивом
+(объектом с ключами и значениями).
+
+## Сигнатура функции
+
+```ts
+function is_array(value: any): boolean;
+```
+
+## Описание
+
+В JavaScript массивы и объекты имеют разные структуры и предназначения:
+
+- Массивы (`Array`) являются упорядоченными коллекциями элементов, которые могут быть индексированы.
+- Объекты (`Object`) содержат пары "ключ-значение", которые могут быть неупорядоченными.
+
+Эта функция проверяет, является ли переданное значение обычным массивом (например, `[1, 2, 3]`),
+либо ассоциативным массивом (объектом с парами "ключ-значение", например, `{foo: 'bar'}`).
+
+## Алгоритм работы функции
+
+1. Сначала проверяется, является ли переданное значение обычным массивом с помощью встроенного
+   метода `Array.isArray(value)`. Если это массив, функция сразу возвращает `true`.
+
+2. Если переменная не является массивом, то выполняются дополнительные проверки:
+
+    - Проверяется, что значение не равно `null` (так как `null` в JavaScript также является
+      объектом, но не является ни массивом, ни объектом с парами "ключ-значение").
+    - Проверяется, что значение является объектом JavaScript (с помощью
+      `typeof value === 'object'`).
+    - Проверяется, что прототип объекта совпадает с `Object.prototype` (это объект, от которого
+      наследуются все объекты в JavaScript) или является `null` (это означает, что объект был создан
+      с помощью `Object.create(null)` и не имеет прототипа).
+    - Исключаются массивоподобные объекты (например, `arguments`, `NodeList`), путем проверки, что
+      свойство `length` не является собственным свойством объекта.
+    - Дополнительно проверяется, что объект является простым (его конструктор равен `Object`), а
+      также исключаются встроенные объекты (`Math`, `JSON`, `Reflect`, `Intl`), для которых функция
+      возвращает `true`.
+
+## Параметры
+
+- `value` (any)
+
+    Проверяемая переменная.
+
+## Возвращаемое значение
+
+Возвращает `true`, если переменная является обычным массивом (`Array`), ассоциативным массивом
+(объектом с парами "ключ-значение"), ассоциативным массивом, созданным с помощью
+`Object.create(null)`. В остальных случаях функция возвращает `false`.
+
+## Примеры использования
+
+1. Простые массивы:
+
+    ```js
+    is_array([1, 2, 3]); // true
+    is_array([]); // true
+    ```
+
+2. Ассоциативные массивы (объекты с ключами и значениями):
+
+    ```js
+    is_array({ foo: 'bar', baz: 42 }); // true
+    is_array({ 0: 'a', 1: 'b' }); // true
+    ```
+
+3. Объекты, созданные без прототипа:
+
+    ```js
+    const noProtoObject = Object.create(null);
+    noProtoObject.foo = 'bar';
+    is_array(noProtoObject); // true
+    ```
+
+4. Примитивы и невалидные значения:
+
+    ```js
+    is_array(null); // false
+    is_array(undefined); // false
+    is_array(42); // false
+    is_array('hello'); // false
+    ```
+
+5. Специальные объекты:
+
+    ```js
+    is_array(new Map()); // false
+    is_array(new Set()); // false
+    is_array(() => {}); // false
+    ```
+
+6. Классы и их экземпляры:
+
+    ```js
+    class MyClass {}
+    const instance = new MyClass();
+    is_array(instance); // false
+    ```

package/docs/helpers/is_assoc.md

@@ -1,59 +1,59 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / is_assoc
-
-[Исходный код](../../src/helpers/is_assoc.mjs)
-
-# `is_assoc`
-
-`is_assoc` — Проверяет, является ли значение ассоциативным массивом.
-
-## Сигнатура функции
-
-```ts
-function is_assoc(value: any): boolean;
-```
-
-## Параметры
-
-- `value` (any)
-
-    Значение, которое необходимо проверить на принадлежность к ассоциативному массиву.
-
-## Описание
-
-Функция `is_assoc` предназначена для проверки, является ли переданное значение ассоциативным
-массивом.
-
-Она использует метод `is_array` для проверки значения и убеждается, что значение не является обычным
-массивом.
-
-## Возвращаемое значение
-
-Функция возвращает:
-
-- `true`, если значение является ассоциативным массивом.
-- `false` в противном случае.
-
-## Примеры использования
-
-### Пример 1: Проверка ассоциативных массивов
-
-```js
-is_assoc({ foo: 'bar' }); // true
-is_assoc({}); // true
-```
-
-### Пример 2: Проверка обычных массивов
-
-```js
-is_assoc([]); // false
-is_assoc([1, 2, 3]); // false
-```
-
-### Пример 3: Проверка значений других типов
-
-```js
-is_assoc('string'); // false (строка)
-is_assoc(42); // false (число)
-is_assoc(null); // false
-is_assoc(undefined); // false
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / is_assoc
+
+[Исходный код](../../src/helpers/is_assoc.mjs)
+
+# `is_assoc`
+
+`is_assoc` — Проверяет, является ли значение ассоциативным массивом.
+
+## Сигнатура функции
+
+```ts
+function is_assoc(value: any): boolean;
+```
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо проверить на принадлежность к ассоциативному массиву.
+
+## Описание
+
+Функция `is_assoc` предназначена для проверки, является ли переданное значение ассоциативным
+массивом.
+
+Она использует метод `is_array` для проверки значения и убеждается, что значение не является обычным
+массивом.
+
+## Возвращаемое значение
+
+Функция возвращает:
+
+- `true`, если значение является ассоциативным массивом.
+- `false` в противном случае.
+
+## Примеры использования
+
+### Пример 1: Проверка ассоциативных массивов
+
+```js
+is_assoc({ foo: 'bar' }); // true
+is_assoc({}); // true
+```
+
+### Пример 2: Проверка обычных массивов
+
+```js
+is_assoc([]); // false
+is_assoc([1, 2, 3]); // false
+```
+
+### Пример 3: Проверка значений других типов
+
+```js
+is_assoc('string'); // false (строка)
+is_assoc(42); // false (число)
+is_assoc(null); // false
+is_assoc(undefined); // false
+```

package/docs/helpers/is_bigint.md

@@ -1,57 +1,57 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / is_bigint
-
-[Исходный код](../../src/helpers/is_bigint.mjs)
-
-# `is_bigint`
-
-`is_bigint` — Проверяет, является ли значение типом `bigint`.
-
-## Сигнатура функции
-
-```ts
-function is_bigint(value: any): boolean;
-```
-
-## Параметры
-
-- `value` (any)
-
-    Значение, которое необходимо проверить на принадлежность к типу `bigint`.
-
-## Описание
-
-Функция `is_bigint` предназначена для проверки, является ли переданное значение типом `bigint`.
-
-Она проверяет:
-
-1. Что значение имеет тип `bigint`.
-
-Функция возвращает `false` для значений других типов, таких как числа, строки, объекты или массивы.
-
-## Возвращаемое значение
-
-Функция возвращает:
-
-- `true`, если значение является типом `bigint`.
-- `false` в противном случае.
-
-## Примеры использования
-
-### Пример 1: Проверка значений типа bigint
-
-```js
-is_bigint(BigInt(123456)); // true
-is_bigint(BigInt(-123456)); // true
-```
-
-### Пример 2: Проверка значений других типов
-
-```js
-is_bigint(42); // false (число)
-is_bigint('42'); // false (строка)
-is_bigint(true); // false (логическое значение)
-is_bigint(null); // false
-is_bigint(undefined); // false
-is_bigint({}); // false (объект)
-is_bigint([]); // false (массив)
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / is_bigint
+
+[Исходный код](../../src/helpers/is_bigint.mjs)
+
+# `is_bigint`
+
+`is_bigint` — Проверяет, является ли значение типом `bigint`.
+
+## Сигнатура функции
+
+```ts
+function is_bigint(value: any): boolean;
+```
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо проверить на принадлежность к типу `bigint`.
+
+## Описание
+
+Функция `is_bigint` предназначена для проверки, является ли переданное значение типом `bigint`.
+
+Она проверяет:
+
+1. Что значение имеет тип `bigint`.
+
+Функция возвращает `false` для значений других типов, таких как числа, строки, объекты или массивы.
+
+## Возвращаемое значение
+
+Функция возвращает:
+
+- `true`, если значение является типом `bigint`.
+- `false` в противном случае.
+
+## Примеры использования
+
+### Пример 1: Проверка значений типа bigint
+
+```js
+is_bigint(BigInt(123456)); // true
+is_bigint(BigInt(-123456)); // true
+```
+
+### Пример 2: Проверка значений других типов
+
+```js
+is_bigint(42); // false (число)
+is_bigint('42'); // false (строка)
+is_bigint(true); // false (логическое значение)
+is_bigint(null); // false
+is_bigint(undefined); // false
+is_bigint({}); // false (объект)
+is_bigint([]); // false (массив)
+```

package/docs/helpers/is_bool.md

@@ -1,50 +1,50 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / is_bool
-
-[Исходный код](../../src/helpers/is_bool.mjs)
-
-# is_bool
-
-`is_bool` — Проверяет, является ли переданное значение логическим типом (`boolean`).
-
-## Сигнатура функции
-
-```ts
-function is_bool(value: any): boolean;
-```
-
-## Параметры
-
-- `value` (any)
-
-    Проверяемая переменная.
-
-## Описание
-
-В JavaScript логическое значение может быть только двумя состояниями: `true` или `false`.  
-Функция проверяет тип переданного значения с использованием оператора `typeof`.  
-Если значение является примитивом типа `boolean`, функция возвращает `true`.  
-Для всех других типов (включая объекты, строки, числа, `null`, `undefined` и другие) функция вернёт
-`false`.
-
-### Примечание
-
-- Функция возвращает `false` для объектов типа `Boolean`, созданных с помощью конструктора
-  `new Boolean()`.
-- Возвращает `false` для массивов, объектов и других типов данных, отличных от `boolean`.
-
-## Возвращаемое значение
-
-Возвращает `true`, если значение `value` — логическое (`boolean`), иначе `false`.
-
-## Примеры использования
-
-```js
-is_bool(true); // Возвращает: true
-is_bool(false); // Возвращает: true
-is_bool(0); // Возвращает: false
-is_bool('true'); // Возвращает: false
-is_bool(null); // Возвращает: false
-is_bool([]); // Возвращает: false
-is_bool({}); // Возвращает: false
-is_bool(new Boolean(true)); // Возвращает: false
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / is_bool
+
+[Исходный код](../../src/helpers/is_bool.mjs)
+
+# is_bool
+
+`is_bool` — Проверяет, является ли переданное значение логическим типом (`boolean`).
+
+## Сигнатура функции
+
+```ts
+function is_bool(value: any): boolean;
+```
+
+## Параметры
+
+- `value` (any)
+
+    Проверяемая переменная.
+
+## Описание
+
+В JavaScript логическое значение может быть только двумя состояниями: `true` или `false`.  
+Функция проверяет тип переданного значения с использованием оператора `typeof`.  
+Если значение является примитивом типа `boolean`, функция возвращает `true`.  
+Для всех других типов (включая объекты, строки, числа, `null`, `undefined` и другие) функция вернёт
+`false`.
+
+### Примечание
+
+- Функция возвращает `false` для объектов типа `Boolean`, созданных с помощью конструктора
+  `new Boolean()`.
+- Возвращает `false` для массивов, объектов и других типов данных, отличных от `boolean`.
+
+## Возвращаемое значение
+
+Возвращает `true`, если значение `value` — логическое (`boolean`), иначе `false`.
+
+## Примеры использования
+
+```js
+is_bool(true); // Возвращает: true
+is_bool(false); // Возвращает: true
+is_bool(0); // Возвращает: false
+is_bool('true'); // Возвращает: false
+is_bool(null); // Возвращает: false
+is_bool([]); // Возвращает: false
+is_bool({}); // Возвращает: false
+is_bool(new Boolean(true)); // Возвращает: false
+```

package/docs/helpers/is_boolean.md

@@ -1,50 +1,50 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / is_boolean
-
-[Исходный код](../../src/helpers/is_boolean.mjs)
-
-# is_boolean
-
-`is_boolean` — Проверяет, является ли переданное значение логическим типом (`boolean`).
-
-## Сигнатура функции
-
-```ts
-function is_boolean(value: any): boolean;
-```
-
-## Параметры
-
-- `value` (any)
-
-    Проверяемая переменная.
-
-## Описание
-
-В JavaScript логическое значение может быть только двумя состояниями: `true` или `false`.  
-Функция проверяет тип переданного значения с использованием оператора `typeof`.  
-Если значение является примитивом типа `boolean`, функция возвращает `true`.  
-Для всех других типов (включая объекты, строки, числа, `null`, `undefined` и другие) функция вернёт
-`false`.
-
-### Примечание
-
-- Функция возвращает `false` для объектов типа `Boolean`, созданных с помощью конструктора
-  `new Boolean()`.
-- Возвращает `false` для массивов, объектов и других типов данных, отличных от `boolean`.
-
-## Возвращаемое значение
-
-Возвращает `true`, если значение `value` — логическое (`boolean`), иначе `false`.
-
-## Примеры использования
-
-```js
-is_boolean(true); // Возвращает: true
-is_boolean(false); // Возвращает: true
-is_boolean(0); // Возвращает: false
-is_boolean('true'); // Возвращает: false
-is_boolean(null); // Возвращает: false
-is_boolean([]); // Возвращает: false
-is_boolean({}); // Возвращает: false
-is_boolean(new Boolean(true)); // Возвращает: false
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / is_boolean
+
+[Исходный код](../../src/helpers/is_boolean.mjs)
+
+# is_boolean
+
+`is_boolean` — Проверяет, является ли переданное значение логическим типом (`boolean`).
+
+## Сигнатура функции
+
+```ts
+function is_boolean(value: any): boolean;
+```
+
+## Параметры
+
+- `value` (any)
+
+    Проверяемая переменная.
+
+## Описание
+
+В JavaScript логическое значение может быть только двумя состояниями: `true` или `false`.  
+Функция проверяет тип переданного значения с использованием оператора `typeof`.  
+Если значение является примитивом типа `boolean`, функция возвращает `true`.  
+Для всех других типов (включая объекты, строки, числа, `null`, `undefined` и другие) функция вернёт
+`false`.
+
+### Примечание
+
+- Функция возвращает `false` для объектов типа `Boolean`, созданных с помощью конструктора
+  `new Boolean()`.
+- Возвращает `false` для массивов, объектов и других типов данных, отличных от `boolean`.
+
+## Возвращаемое значение
+
+Возвращает `true`, если значение `value` — логическое (`boolean`), иначе `false`.
+
+## Примеры использования
+
+```js
+is_boolean(true); // Возвращает: true
+is_boolean(false); // Возвращает: true
+is_boolean(0); // Возвращает: false
+is_boolean('true'); // Возвращает: false
+is_boolean(null); // Возвращает: false
+is_boolean([]); // Возвращает: false
+is_boolean({}); // Возвращает: false
+is_boolean(new Boolean(true)); // Возвращает: false
+```