@rogolev/value 0.0.1 → 0.0.2

package/docs/helpers/to_list.md

@@ -1,47 +1,47 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / to_list
-
-[Исходный код](../../src/helpers/to_list.mjs)
-
-# `to_list`
-
-`to_list` — Преобразует значение в список.
-
-## Сигнатура функции
-
-```ts
-function to_list(value: any): Array<any>;
-```
-
-## Параметры
-
-- `value` (any)
-
-    Значение, которое необходимо преобразовать в список.
-
-## Описание
-
-Функция `to_list` предназначена для преобразования переданного значения в список.
-
-Она выполняет следующие проверки:
-
-1. **Null и Undefined**: Возвращает пустой массив для значений `null` и `undefined`.
-2. **Array**: Возвращает исходный массив, если он передан.
-3. **Object**: Возвращает массив значений объекта, если передан ассоциативный массив.
-4. **Примитивы и другие типы**: Возвращает массив, содержащий переданное значение.
-
-## Возвращаемое значение
-
-Функция возвращает массив, представляющий список значений.
-
-## Примеры использования
-
-### Пример 1: Преобразование различных типов значений в список
-
-```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]
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / to_list
+
+[Исходный код](../../src/helpers/to_list.mjs)
+
+# `to_list`
+
+`to_list` &mdash; Преобразует значение в список.
+
+## Сигнатура функции
+
+```ts
+function to_list(value: any): Array<any>;
+```
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо преобразовать в список.
+
+## Описание
+
+Функция `to_list` предназначена для преобразования переданного значения в список.
+
+Она выполняет следующие проверки:
+
+1. **Null и Undefined**: Возвращает пустой массив для значений `null` и `undefined`.
+2. **Array**: Возвращает исходный массив, если он передан.
+3. **Object**: Возвращает массив значений объекта, если передан ассоциативный массив.
+4. **Примитивы и другие типы**: Возвращает массив, содержащий переданное значение.
+
+## Возвращаемое значение
+
+Функция возвращает массив, представляющий список значений.
+
+## Примеры использования
+
+### Пример 1: Преобразование различных типов значений в список
+
+```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]
+```

package/docs/helpers/to_object.md

@@ -1,76 +1,76 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / to_object
-
-[Исходный код](../../src/helpers/to_object.mjs)
-
-# `to_object`
-
-`to_object` — Преобразует значение в объект.
-
-## Сигнатура функции
-
-```ts
-function to_object(value: any): object;
-```
-
-## Описание
-
-Функция `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'
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / to_object
+
+[Исходный код](../../src/helpers/to_object.mjs)
+
+# `to_object`
+
+`to_object` — Преобразует значение в объект.
+
+## Сигнатура функции
+
+```ts
+function to_object(value: any): object;
+```
+
+## Описание
+
+Функция `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'
+```

package/docs/helpers/to_string.md

@@ -1,134 +1,134 @@
-[Главная](../../README.md) / [Помощники](../helpers.md) / to_string
-
-[Исходный код](../../src/helpers/to_string.mjs)
-
-# `to_string`
-
-`to_string` — Преобразует значение в строку.
-
-## Сигнатура функции
-
-```ts
-function to_string(value: any): string;
-```
-
-## Описание
-
-Функция `to_string` используется для преобразования различных типов данных в строку. Она
-обрабатывает массивы, объекты, классы, функции, символы и другие типы данных, возвращая их строковое
-представление.
-
-## Параметры
-
-- `value` (any)
-
-    Значение, которое необходимо преобразовать в строку.
-
-## Возвращаемое значение
-
-Функция возвращает:
-
-- Строку, соответствующую переданному значению.
-
-## Примеры использования
-
-### Пример 1: Преобразование строки
-
-```js
-const result = to_string('example');
-// Результат: 'example'
-```
-
-### Пример 2: Преобразование числа
-
-```js
-const result = to_string(123);
-// Результат: '123'
-```
-
-### Пример 3: Преобразование булевых значений
-
-```js
-const result1 = to_string(true);
-// Результат: 'true'
-
-const result2 = to_string(false);
-// Результат: 'false'
-```
-
-### Пример 4: Преобразование null и undefined
-
-```js
-const result1 = to_string(null);
-// Результат: 'null'
-
-const result2 = to_string(undefined);
-// Результат: 'undefined'
-```
-
-### Пример 5: Преобразование массива
-
-```js
-const arr = [1, 2, 3];
-const result = to_string(arr);
-// Результат: '[\n    1,\n    2,\n    3,\n]'
-```
-
-### Пример 6: Преобразование ассоциативного массива
-
-```js
-const obj = { key: 'value' };
-const result = to_string(obj);
-// Результат: '{\n    key: 'value',\n}'
-```
-
-### Пример 7: Преобразование функции
-
-```js
-const func = function () {};
-const result = to_string(func);
-// Результат: 'function func() {}'
-```
-
-### Пример 8: Преобразование символа
-
-```js
-const symbol = Symbol('example');
-const result = to_string(symbol);
-// Результат: 'Symbol(example)'
-```
-
-### Пример 9: Преобразование BigInt
-
-```js
-const bigInt = BigInt(123);
-const result = to_string(bigInt);
-// Результат: '123'
-```
-
-### Пример 10: Преобразование класса
-
-```js
-class MyClass {
-    static test = 'test';
-}
-const result = to_string(MyClass);
-// Результат: 'class MyClass {}'
-```
-
-### Пример 11: Преобразование экземпляра класса
-
-```js
-class MyClass {}
-const instance = new MyClass();
-const result = to_string(instance);
-// Результат: 'object MyClass'
-```
-
-### Пример 12: Преобразование интерфейса
-
-```js
-class MyContract extends Interface {}
-const result = to_string(MyContract);
-// Результат: 'interface MyContract {}'
-```
+[Главная](../../README.md) / [Помощники](../helpers.md) / to_string
+
+[Исходный код](../../src/helpers/to_string.mjs)
+
+# `to_string`
+
+`to_string` — Преобразует значение в строку.
+
+## Сигнатура функции
+
+```ts
+function to_string(value: any): string;
+```
+
+## Описание
+
+Функция `to_string` используется для преобразования различных типов данных в строку. Она
+обрабатывает массивы, объекты, классы, функции, символы и другие типы данных, возвращая их строковое
+представление.
+
+## Параметры
+
+- `value` (any)
+
+    Значение, которое необходимо преобразовать в строку.
+
+## Возвращаемое значение
+
+Функция возвращает:
+
+- Строку, соответствующую переданному значению.
+
+## Примеры использования
+
+### Пример 1: Преобразование строки
+
+```js
+const result = to_string('example');
+// Результат: 'example'
+```
+
+### Пример 2: Преобразование числа
+
+```js
+const result = to_string(123);
+// Результат: '123'
+```
+
+### Пример 3: Преобразование булевых значений
+
+```js
+const result1 = to_string(true);
+// Результат: 'true'
+
+const result2 = to_string(false);
+// Результат: 'false'
+```
+
+### Пример 4: Преобразование null и undefined
+
+```js
+const result1 = to_string(null);
+// Результат: 'null'
+
+const result2 = to_string(undefined);
+// Результат: 'undefined'
+```
+
+### Пример 5: Преобразование массива
+
+```js
+const arr = [1, 2, 3];
+const result = to_string(arr);
+// Результат: '[\n    1,\n    2,\n    3,\n]'
+```
+
+### Пример 6: Преобразование ассоциативного массива
+
+```js
+const obj = { key: 'value' };
+const result = to_string(obj);
+// Результат: '{\n    key: 'value',\n}'
+```
+
+### Пример 7: Преобразование функции
+
+```js
+const func = function () {};
+const result = to_string(func);
+// Результат: 'function func() {}'
+```
+
+### Пример 8: Преобразование символа
+
+```js
+const symbol = Symbol('example');
+const result = to_string(symbol);
+// Результат: 'Symbol(example)'
+```
+
+### Пример 9: Преобразование BigInt
+
+```js
+const bigInt = BigInt(123);
+const result = to_string(bigInt);
+// Результат: '123'
+```
+
+### Пример 10: Преобразование класса
+
+```js
+class MyClass {
+    static test = 'test';
+}
+const result = to_string(MyClass);
+// Результат: 'class MyClass {}'
+```
+
+### Пример 11: Преобразование экземпляра класса
+
+```js
+class MyClass {}
+const instance = new MyClass();
+const result = to_string(instance);
+// Результат: 'object MyClass'
+```
+
+### Пример 12: Преобразование интерфейса
+
+```js
+class MyContract extends Interface {}
+const result = to_string(MyContract);
+// Результат: 'interface MyContract {}'
+```

package/docs/helpers.md

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