@rogolev/value 0.0.2 → 0.0.3

package/src/helpers/to_string.mjs

@@ -1,157 +1,157 @@
-import is_array from './is_array.mjs';
-import is_class from './is_class.mjs';
-import is_function from './is_function.mjs';
-import is_object from './is_object.mjs';
-import is_string from './is_string.mjs';
-
-/**
- * Приводит значение переменной к строке.
- *
- * ### Описание
- *
- * Функция `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'
- *    ```
- *
- * @param {any} value Переменная, значение которой необходимо привести к строке.
- * @returns {string} Возвращает приведенное к строке значение переменной `value`.
- */
-export default function to_string(value) {
-    if (Array.isArray(value)) {
-        let string = '[';
-
-        for (const v of value) {
-            string += `\n    ${is_string(v) ? "'" : ''}${to_string(v).replace(/\n/g, '\n    ')}${is_string(v) ? "'" : ''},`;
-        }
-
-        return (string += string.length > 1 ? '\n]' : ']');
-    }
-
-    if (is_array(value)) {
-        let string = '{';
-
-        for (const [k, v] of Object.entries(value)) {
-            string += `\n    ${k}: ${is_string(v) ? "'" : ''}${to_string(v).replace(/\n/g, '\n    ')}${is_string(v) ? "'" : ''},`;
-        }
-
-        return (string += string.length > 1 ? '\n}' : '}');
-    }
-
-    if (is_class(value)) {
-        return `class ${value.name ? `${value.name} ` : ''}{}`;
-    }
-
-    if (is_object(value)) {
-        return value.toString() === '[object Object]' ?
-                `object ${Object.getPrototypeOf(value).constructor.name}`
-            :   value.toString();
-    }
-
-    if (is_function(value)) {
-        return `function ${value.name}() {}`;
-    }
-
-    return String(value);
-}
+import is_array from './is_array.mjs';
+import is_class from './is_class.mjs';
+import is_function from './is_function.mjs';
+import is_object from './is_object.mjs';
+import is_string from './is_string.mjs';
+
+/**
+ * Приводит значение переменной к строке.
+ *
+ * ### Описание
+ *
+ * Функция `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'
+ *    ```
+ *
+ * @param {any} value Переменная, значение которой необходимо привести к строке.
+ * @returns {string} Возвращает приведенное к строке значение переменной `value`.
+ */
+export default function to_string(value) {
+    if (Array.isArray(value)) {
+        let string = '[';
+
+        for (const v of value) {
+            string += `\n    ${is_string(v) ? "'" : ''}${to_string(v).replace(/\n/g, '\n    ')}${is_string(v) ? "'" : ''},`;
+        }
+
+        return (string += string.length > 1 ? '\n]' : ']');
+    }
+
+    if (is_array(value)) {
+        let string = '{';
+
+        for (const [k, v] of Object.entries(value)) {
+            string += `\n    ${k}: ${is_string(v) ? "'" : ''}${to_string(v).replace(/\n/g, '\n    ')}${is_string(v) ? "'" : ''},`;
+        }
+
+        return (string += string.length > 1 ? '\n}' : '}');
+    }
+
+    if (is_class(value)) {
+        return `class ${value.name ? `${value.name} ` : ''}{}`;
+    }
+
+    if (is_object(value)) {
+        return value.toString() === '[object Object]' ?
+                `object ${Object.getPrototypeOf(value).constructor.name}`
+            :   value.toString();
+    }
+
+    if (is_function(value)) {
+        return `function ${value.name}() {}`;
+    }
+
+    return String(value);
+}

package/src/helpers/value.mjs

@@ -0,0 +1,92 @@
+import Value from '../classes/Value.mjs';
+
+/**
+ * Создает новый экземпляр класса `Value` с заданным значением.
+ *
+ * ### Описание
+ *
+ * Функция `value` используется для создания нового экземпляра класса `Value` с переданным значением.
+ * Это позволяет легко обернуть значение в экземпляр класса `Value` и использовать методы класса для работы с этим значением.
+ *
+ * ### Параметры
+ *
+ * - `val` (any)
+ *      Значение, которое необходимо обернуть в экземпляр класса `Value`.
+ *
+ * ### Возвращаемое значение
+ *
+ * Возвращает новый экземпляр класса `Value` с переданным значением.
+ *
+ * ### Примеры использования
+ *
+ * 1. Создание экземпляра класса `Value` с числом:
+ *
+ *    ```js
+ *    const valueInstance = value(123);
+ *    console.log(valueInstance.get()); // 123
+ *    console.log(valueInstance.getType()); // 'integer'
+ *    console.log(valueInstance.isNumber()); // true
+ *    ```
+ *
+ * 2. Создание экземпляра класса `Value` со строкой:
+ *
+ *    ```js
+ *    const valueInstance = value('example');
+ *    console.log(valueInstance.get()); // 'example'
+ *    console.log(valueInstance.getType()); // 'string'
+ *    console.log(valueInstance.isString()); // true
+ *    ```
+ *
+ * 3. Создание экземпляра класса `Value` с объектом:
+ *
+ *    ```js
+ *    const obj = { key: 'value' };
+ *    const valueInstance = value(obj);
+ *    console.log(valueInstance.get()); // { key: 'value' }
+ *    console.log(valueInstance.getType()); // 'object'
+ *    console.log(valueInstance.isObject()); // true
+ *    ```
+ *
+ * 4. Создание экземпляра класса `Value` с массивом:
+ *
+ *    ```js
+ *    const arr = [1, 2, 3];
+ *    const valueInstance = value(arr);
+ *    console.log(valueInstance.get()); // [1, 2, 3]
+ *    console.log(valueInstance.getType()); // 'array'
+ *    console.log(valueInstance.isArray()); // true
+ *    ```
+ *
+ * 5. Создание экземпляра класса `Value` с булевым значением:
+ *
+ *    ```js
+ *    const valueInstance = value(true);
+ *    console.log(valueInstance.get()); // true
+ *    console.log(valueInstance.getType()); // 'boolean'
+ *    console.log(valueInstance.isBool()); // true
+ *    ```
+ *
+ * 6. Создание экземпляра класса `Value` с null:
+ *
+ *    ```js
+ *    const valueInstance = value(null);
+ *    console.log(valueInstance.get()); // null
+ *    console.log(valueInstance.getType()); // 'null'
+ *    console.log(valueInstance.isNull()); // true
+ *    ```
+ *
+ * 7. Создание экземпляра класса `Value` с undefined:
+ *
+ *    ```js
+ *    const valueInstance = value(undefined);
+ *    console.log(valueInstance.get()); // undefined
+ *    console.log(valueInstance.getType()); // 'undefined'
+ *    console.log(valueInstance.isUndefined()); // true
+ *    ```
+ *
+ * @param {any} val Значение, которое необходимо обернуть в экземпляр класса `Value`.
+ * @returns {Value} Возвращает новый экземпляр класса `Value` с переданным значением.
+ */
+export default function value(val) {
+    return new Value(val);
+}