intelicoreact 1.5.40 → 1.6.0

package/dist/Functions/guards/assertions.js

@@ -0,0 +1,294 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return _default;
+    }
+});
+const _typeGuards = /*#__PURE__*/ _interop_require_default(require("./typeGuards"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+/**
+ * @name assertArray
+ * @description Функция assertArray проверяет, является ли значение массивом. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является массивом
+ * @example
+ * assertArray([]); // OK
+ * assertArray({}); // TypeError: Expected value to be an array
+ */ function assertArray(value, message) {
+    if (!Array.isArray(value)) {
+        throw new TypeError(message || 'Expected value to be an array');
+    }
+}
+/**
+ * @name assertObject
+ * @description Функция assertObject проверяет, является ли значение объектом. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является объектом
+ * @example
+ * assertObject({}); // OK
+ * assertObject([]); // TypeError: Expected value to be an object
+ */ function assertObject(value, message) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new TypeError(message || 'Expected value to be an object');
+    }
+}
+/**
+ * @name assertNumber
+ * @description Функция assertNumber проверяет, является ли значение числом. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является числом
+ * @example
+ * assertNumber(1); // OK
+ * assertNumber('1'); // TypeError: Expected value to be a number
+ */ function assertNumber(value, message) {
+    if (typeof value !== 'number') {
+        throw new TypeError(message || 'Expected value to be a number');
+    }
+}
+/**
+ * @name assertString
+ * @description Функция assertString проверяет, является ли значение строкой. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является строкой
+ * @example
+ * assertString('text'); // OK
+ * assertString(1); // TypeError: Expected value to be a string
+ */ function assertString(value, message) {
+    if (typeof value !== 'string') {
+        throw new TypeError(message || 'Expected value to be a string');
+    }
+}
+/**
+ * @name assertBoolean
+ * @description Функция assertBoolean проверяет, является ли значение булевым. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является булевым
+ * @example
+ * assertBoolean(true); // OK
+ * assertBoolean('true'); // TypeError: Expected value to be a boolean
+ */ function assertBoolean(value, message) {
+    if (typeof value !== 'boolean') {
+        throw new TypeError(message || 'Expected value to be a boolean');
+    }
+}
+/**
+ * @name assertFunction
+ * @description Функция assertFunction проверяет, является ли значение функцией. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является функцией
+ * @example
+ * assertFunction(() => {}); // OK
+ * assertFunction('function'); // TypeError: Expected value to be a function
+ */ function assertFunction(value, message) {
+    if (typeof value !== 'function') {
+        throw new TypeError(message || 'Expected value to be a function');
+    }
+}
+/**
+ * @name assertInstanceOf
+ * @description Функция assertInstanceOf проверяет, является ли значение экземпляром класса. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param classType - класс для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является экземпляром класса
+ * @example
+ * class TestClass {}
+ * assertInstanceOf(new TestClass(), TestClass); // OK
+ * assertInstanceOf({}, TestClass); // TypeError: Expected value to be an instance of TestClass
+ */ function assertInstanceOf(value, classType, message) {
+    if (!(value instanceof classType)) {
+        throw new TypeError(message || `Expected value to be an instance of ${classType.name}`);
+    }
+}
+/**
+ * @name assertEnumValue
+ * @description Функция assertEnumValue проверяет, является ли значение значением enum. Если нет - выбрасывает ошибку.
+ * @param enumObject - enum для проверки
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является значением enum
+ * @example
+ * enum Colors { Red = 'red', Green = 'green', Blue = 'blue' }
+ * assertEnumValue(Colors, 'red'); // OK
+ * assertEnumValue(Colors, 'yellow'); // TypeError: Expected value to be one of: red, green, blue
+ */ function assertEnumValue(enumObject, value, message) {
+    if (!Object.values(enumObject).includes(value)) {
+        throw new TypeError(message || `Expected value to be one of: ${Object.values(enumObject).join(', ')}`);
+    }
+}
+/**
+ * @name assertReactElement
+ * @description Функция assertReactElement проверяет, является ли значение React элементом. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является React элементом
+ * @example
+ * assertReactElement(<div>Test</div>); // OK
+ * assertReactElement('div'); // TypeError: Expected value to be a React element
+ */ function assertReactElement(value, message) {
+    if (!(_typeGuards.default.isObject(value) && 'type' in value && 'props' in value && '$$typeof' in value)) {
+        throw new TypeError(message || 'Expected value to be a React element');
+    }
+}
+/**
+ * @name assertReactComponent
+ * @description Функция assertReactComponent проверяет, является ли значение React компонентом. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является React компонентом
+ * @example
+ * const MyComponent = () => <div>Test</div>;
+ * assertReactComponent(MyComponent); // OK
+ * assertReactComponent('div'); // TypeError: Expected value to be a React component
+ */ function assertReactComponent(value, message) {
+    if (!(typeof value === 'function' || _typeGuards.default.isObject(value) && 'render' in value)) {
+        throw new TypeError(message || 'Expected value to be a React component');
+    }
+}
+/**
+ * @name assertNonNullable
+ * @description Функция assertNonNullable проверяет, что значение не null и не undefined. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение null или undefined
+ * @example
+ * assertNonNullable('text'); // OK
+ * assertNonNullable(null); // TypeError: Expected value to be non-nullable
+ */ function assertNonNullable(value, message) {
+    if (value === null || value === undefined) {
+        throw new TypeError(message || 'Expected value to be non-nullable');
+    }
+}
+/**
+ * @name assertTruthy
+ * @description Функция assertTruthy проверяет, что значение является truthy. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является truthy
+ * @example
+ * assertTruthy('text'); // OK
+ * assertTruthy(''); // TypeError: Expected value to be truthy
+ */ function assertTruthy(value, message) {
+    if (!value) {
+        throw new TypeError(message || 'Expected value to be truthy');
+    }
+}
+/**
+ * @name assertFalsy
+ * @description Функция assertFalsy проверяет, что значение является falsy. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение не является falsy
+ * @example
+ * assertFalsy(''); // OK
+ * assertFalsy('text'); // TypeError: Expected value to be falsy
+ */ function assertFalsy(value, message) {
+    if (value) {
+        throw new TypeError(message || 'Expected value to be falsy');
+    }
+}
+/**
+ * @name assertDefined
+ * @description Функция assertDefined проверяет, что значение не undefined. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если значение undefined
+ * @example
+ * assertDefined('text'); // OK
+ * assertDefined(undefined); // TypeError: Expected value to be defined
+ */ function assertDefined(value, message) {
+    if (value === undefined) {
+        throw new TypeError(message || 'Expected value to be defined');
+    }
+}
+/**
+ * @name assertNotEmptyString
+ * @description Функция assertNotEmptyString проверяет, что строка не пустая. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если строка пустая
+ * @example
+ * assertNotEmptyString('text'); // OK
+ * assertNotEmptyString(''); // TypeError: Expected string to be not empty
+ */ function assertNotEmptyString(value, message) {
+    if (value === '') {
+        throw new TypeError(message || 'Expected string to be not empty');
+    }
+}
+/**
+ * @name assertPositiveNumber
+ * @description Функция assertPositiveNumber проверяет, что число положительное. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если число не положительное
+ * @example
+ * assertPositiveNumber(1); // OK
+ * assertPositiveNumber(-1); // TypeError: Expected number to be positive
+ */ function assertPositiveNumber(value, message) {
+    if (value <= 0) {
+        throw new TypeError(message || 'Expected number to be positive');
+    }
+}
+/**
+ * @name assertNegativeNumber
+ * @description Функция assertNegativeNumber проверяет, что число отрицательное. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если число не отрицательное
+ * @example
+ * assertNegativeNumber(-1); // OK
+ * assertNegativeNumber(1); // TypeError: Expected number to be negative
+ */ function assertNegativeNumber(value, message) {
+    if (value >= 0) {
+        throw new TypeError(message || 'Expected number to be negative');
+    }
+}
+/**
+ * @name assertArrayNotEmpty
+ * @description Функция assertArrayNotEmpty проверяет, что массив не пустой. Если нет - выбрасывает ошибку.
+ * @param value - значение для проверки
+ * @param message - сообщение об ошибке (опционально)
+ * @throws {TypeError} Если массив пустой
+ * @example
+ * assertArrayNotEmpty([1]); // OK
+ * assertArrayNotEmpty([]); // TypeError: Expected array to be not empty
+ */ function assertArrayNotEmpty(value, message) {
+    if (value.length === 0) {
+        throw new TypeError(message || 'Expected array to be not empty');
+    }
+}
+const assertions = {
+    assertArray,
+    assertObject,
+    assertNumber,
+    assertString,
+    assertBoolean,
+    assertFunction,
+    assertInstanceOf,
+    assertEnumValue,
+    assertReactElement,
+    assertReactComponent,
+    assertNonNullable,
+    assertTruthy,
+    assertFalsy,
+    assertDefined,
+    assertNotEmptyString,
+    assertPositiveNumber,
+    assertNegativeNumber,
+    assertArrayNotEmpty
+};
+const _default = assertions;

package/dist/Functions/guards/safeValue.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "default", {
+    enumerable: true,
+    get: function() {
+        return _default;
+    }
+});
+const _utils = require("../utils");
+const _typeGuards = /*#__PURE__*/ _interop_require_default(require("./typeGuards"));
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+/**
+ * Проверяет и возвращает строку, если значение является непустой строкой
+ * @param value - Проверяемое значение
+ * @returns Переданную строку или пустую строку, если значение невалидно
+ */ function stringValue(value) {
+    if (typeof value === 'string' && value !== '') return value;
+    return '';
+}
+/**
+ * Проверяет и возвращает объект, если значение является непустым объектом
+ * @param value - Проверяемое значение
+ * @returns Копию переданного объекта или пустой объект, если значение невалидно
+ */ function objectValue(value) {
+    if (typeof value === 'object' && value !== null && Object.keys(value).length > 0) {
+        return (0, _utils.clone)(value);
+    }
+    return {};
+}
+/**
+ * Проверяет и возвращает число, если значение является валидным числом
+ * @param value - Проверяемое значение
+ * @returns Переданное число или 0, если значение невалидно
+ */ function numberValue(value) {
+    if (!Number.isNaN(value) && typeof value === 'number') return value;
+    return 0;
+}
+/**
+ * Проверяет и возвращает массив, если значение является массивом
+ * @param value - Проверяемое значение
+ * @returns Копию переданного массива или пустой массив, если значение невалидно
+ */ const arrayValue = (value)=>Array.isArray(value) ? (0, _utils.clone)(value) : [];
+/**
+ * Проверяет и возвращает булево значение, если значение является boolean
+ * @param value - Проверяемое значение
+ * @returns Переданное значение или false, если значение невалидно
+ */ function booleanValue(value) {
+    if (_typeGuards.default.isBoolean(value)) {
+        return value;
+    }
+    return false;
+}
+/**
+ * Проверяет и возвращает значение, если оно не равно null или undefined
+ * @param value - Проверяемое значение
+ * @param defaultValue - Значение по умолчанию
+ * @returns Переданное значение или значение по умолчанию
+ */ function notNullValue(value, defaultValue) {
+    return value !== null && value !== undefined ? value : defaultValue;
+}
+const safeValue = {
+    booleanValue,
+    stringValue,
+    objectValue,
+    numberValue,
+    arrayValue,
+    notNullValue
+};
+const _default = safeValue;