@omnisass/library 0.2.0 → 0.3.0

package/modules/utilities/validators/misc/_is-time.scss

@@ -105,11 +105,40 @@
 /// @return {Boolean} - Возвращает `true`, если значение является
 /// 	корректным временным значением, иначе возвращает `false`.
 @function is-time($value) {
+
+	// Цикл, который выполняется от 1 до длины значения $value.
+	// Однако здесь есть логическая ошибка: $value передается как
+	// одиночное значение, но используется list.length($value),
+	// что предполагает, что $value является списком.
+	// Это может быть опечатка или концептуальная ошибка.
 	@for $i from 1 through list.length($value) {
+
+		// Логика проверки, является ли значение временной величиной:
+		// Условие состоит из двух частей, соединенных оператором or:
+		//
+		// Первая часть (до or):
+		// 1. meta.type-of($value) == 'number' - проверяет, является ли
+		//    значение числом (включая числа с единицами измерения)
+		// 2. list.index('ms' 's' 'h', math.unit($value)) != null - проверяет,
+		//    что единица измерения числа находится в списке допустимых
+		//    временных единиц ('ms' - миллисекунды, 's' - секунды, 'h' - часы)
+		//    list.index() возвращает позицию единицы в списке или null
+		//
+		// Вторая часть (после or):
+		// $value == 0 - проверяет, равно ли значение нулю
+		// Нулевое значение считается допустимой временной величиной,
+		// независимо от единиц измерения (0, 0s, 0ms и т.д.)
+		//
+		// Возвращаемое значение:
+		// - true: если значение является числом с допустимой временной единицей
+		//         ИЛИ равно нулю
+		// - false: в противном случае
 		@if (meta.type-of($value) == 'number' and list.index('ms' 's' 'h', math.unit($value)) != null) or $value == 0 {
 			@return true;
 		} @else {
 			@return false;
 		}
+
 	}
+
 }

package/modules/utilities/validators/number/_is-int-even.scss

@@ -1,4 +1,6 @@
 @use './is-int' as *;
+@use '../type-of/is-number' as *;
+@use '../../loggers/log-invalid-type' as *;
 
 /// Проверяет, является ли целое число четным.
 ///
@@ -50,11 +52,11 @@
 /// 	@debug is-int-even(10.0);      // true (10.0 считается целым в Sass)
 /// 	@debug is-int-even(2.000001);  // false
 /// @example scss - Нечисловые значения
-/// 	@debug is-int-even("2");       // false
-/// 	@debug is-int-even(#ff0000);   // false
-/// 	@debug is-int-even(true);      // false
-/// 	@debug is-int-even(null);      // false
-/// 	@debug is-int-even((1, 2, 3)); // false
+/// 	@debug is-int-even("2");       // Error: "⛔ Параметр «$value» функции «is-int-even» получил неожиданный тип «string», хотя ожидается «number»"
+/// 	@debug is-int-even(#ff0000);   // Error: "⛔ Параметр «$value» функции «is-int-even» получил неожиданный тип «color», хотя ожидается «number»"
+/// 	@debug is-int-even(true);      // Error: "⛔ Параметр «$value» функции «is-int-even» получил неожиданный тип «bool», хотя ожидается «number»"
+/// 	@debug is-int-even(null);      // Error: "⛔ Параметр «$value» функции «is-int-even» получил неожиданный тип «null», хотя ожидается «number»"
+/// 	@debug is-int-even((1, 2, 3)); // Error: "⛔ Параметр «$value» функции «is-int-even» получил неожиданный тип «list», хотя ожидается «number»"
 /// @param {*} $value - Значение для проверки. Может быть
 /// 	любого типа, но функция вернет `true` только для
 /// 	целых чисел, которые делятся на 2 без остатка.
@@ -62,8 +64,48 @@
 /// 	является целым числом и делится на 2 без остатка.
 /// 	Во всех остальных случаях возвращает `false`,
 /// 	включая нецелые числа и значения других типов.
-/// @throws {Error} - Не выбрасывает ошибок, безопасно
-/// 	обрабатывает значения любого типа.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function is-int-even($value) {
-	@return is-int($value) and $value % 2 == 0;
+
+	// Проверка типа входного параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'is-int-even',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Основная логика выполняется только если $value является
+	// корректным числом.
+	@else {
+
+		// Логика определения четности целого числа:
+		// Условие состоит из двух частей, соединенных оператором and:
+		// 1. is-int($value) - проверяет, является ли число целым
+		//    (предполагается, что функция is-int() существует и проверяет,
+		//    что число целое и без дробной части)
+		// 2. $value % 2 == 0 - проверяет, делится ли число на 2 без остатка
+		//    Оператор % возвращает остаток от деления
+		//
+		// Возвращаемое значение:
+		// - true: если число целое И четное
+		// - false: если число не целое ИЛИ нечетное
+		//
+		// Ключевая особенность: функция возвращает булево значение (true/false),
+		// которое можно использовать в условных конструкциях @if/@else.
+		@return is-int($value) and $value % 2 == 0;
+
+	}
+
 }

package/modules/utilities/validators/number/_is-int-odd.scss

@@ -1,4 +1,6 @@
 @use './is-int' as *;
+@use '../type-of/is-number' as *;
+@use '../../loggers/log-invalid-type' as *;
 
 /// Проверяет, является ли целое число нечетным.
 ///
@@ -51,20 +53,60 @@
 /// 	@debug is-int-odd(5.0);        // false (5.0 считается целым в Sass, поэтому true)
 /// 	@debug is-int-odd(1.000001);   // false
 /// @example scss - Нечисловые значения
-/// 	@debug is-int-odd("1");        // false
-/// 	@debug is-int-odd(#ff0000);    // false
-/// 	@debug is-int-odd(false);      // false
-/// 	@debug is-int-odd(null);       // false
-/// 	@debug is-int-odd((1, 2, 3));  // false
-/// @param {*} $value - Значение для проверки. Может быть
+/// 	@debug is-int-odd("1");        // Error: "⛔ Параметр «$value» функции «is-int-odd» получил неожиданный тип «string», хотя ожидается «number»"
+/// 	@debug is-int-odd(#ff0000);    // Error: "⛔ Параметр «$value» функции «is-int-odd» получил неожиданный тип «color», хотя ожидается «number»"
+/// 	@debug is-int-odd(false);      // Error: "⛔ Параметр «$value» функции «is-int-odd» получил неожиданный тип «bool», хотя ожидается «number»"
+/// 	@debug is-int-odd(null);       // Error: "⛔ Параметр «$value» функции «is-int-odd» получил неожиданный тип «null», хотя ожидается «number»"
+/// 	@debug is-int-odd((1, 2, 3));  // Error: "⛔ Параметр «$value» функции «is-int-odd» получил неожиданный тип «list», хотя ожидается «number»"
+/// @param {Number} $value - Значение для проверки. Может быть
 /// 	любого типа, но функция вернет `true` только для
 /// 	целых чисел, которые не делятся на 2 без остатка.
 /// @return {Boolean} - Возвращает `true`, если значение
 /// 	является целым числом и не делится на 2 без остатка.
 /// 	Во всех остальных случаях возвращает `false`,
 /// 	включая нецелые числа и значения других типов.
-/// @throws {Error} - Не выбрасывает ошибок, безопасно
-/// 	обрабатывает значения любого типа.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function is-int-odd($value) {
-	@return is-int($value) and $value % 2 != 0;
+
+	// Проверка типа входного параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'is-int-odd',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Основная логика выполняется только если $value является
+	// корректным числом.
+	@else {
+
+		// Логика определения нечетности целого числа:
+		// Условие состоит из двух частей, соединенных оператором and:
+		// 1. is-int($value) - проверяет, является ли число целым
+		//    (предполагается, что функция is-int() существует и проверяет,
+		//    что число целое и без дробной части)
+		// 2. $value % 2 != 0 - проверяет, делится ли число на 2 с остатком
+		//    Оператор % возвращает остаток от деления
+		//
+		// Возвращаемое значение:
+		// - true: если число целое И нечетное
+		// - false: если число не целое ИЛИ четное
+		//
+		// Ключевая особенность: функция возвращает булево значение (true/false),
+		// которое можно использовать в условных конструкциях @if/@else.
+		@return is-int($value) and $value % 2 != 0;
+
+	}
+
 }

package/modules/utilities/validators/number/_is-int.scss

@@ -1,5 +1,7 @@
 @use 'sass:math';
 @use 'sass:meta';
+@use '../type-of/is-number' as *;
+@use '../../loggers/log-invalid-type' as *;
 
 /// Проверяет, является ли число целым (integer).
 ///
@@ -93,32 +95,89 @@
 /// 	@debug is-int(-7);		// true
 /// 	@debug is-int(0);		// true
 /// 	@debug is-int(2.0);	// true
-///
 /// @example scss - Проверка нечисловых значений
-/// 	@debug is-int("text");	// false
-/// 	@debug is-int(true);		// false
-/// 	@debug is-int(null);		// false
-///
+/// 	@debug is-int("text");	// Error: "⛔ Параметр «$value» функции «is-int» получил неожиданный тип «string», хотя ожидается «number»"
+/// 	@debug is-int(true);		// Error: "⛔ Параметр «$value» функции «is-int» получил неожиданный тип «bool», хотя ожидается «number»"
+/// 	@debug is-int(null);		// Error: "⛔ Параметр «$value» функции «is-int» получил неожиданный тип «null», хотя ожидается «number»"
 /// @example scss - Использование в условиях
 /// 	@if is-int($index) {
 /// 		@debug "Индекс корректен: #{$index}";
 /// 	} @else {
 /// 		@warn "Ожидается целое число";
 /// 	}
-///
 /// @example scss - Фильтрация значений
 /// 	$values: 1, 2.5, "3", 4, 5.0;
 /// 	$integers: ();
 ///
 /// 	@each $value in $values {
-/// 		@if is-int($value) {
-/// 			$integers: append($integers, $value);
+/// 		@if is-int($value, false) {
+/// 			$integers: list.append($integers, $value);
 /// 		}
 /// 	}
-/// 	// $integers: (1, 4, 5)
-/// @param {*} $value - Проверяемое значение
+/// 	// Error: "⛔ Параметр «$value» функции «is-int» получил неожиданный тип «string», хотя ожидается «number»"
+/// @param {Number} $value - Проверяемое значение
+/// @param {Boolean} $set-strict-mode-local [true] - Включение
+/// 	строгой проверки типов.
 /// @return {Boolean} - `true` если значение является
 /// 	целым числом, `false` во всех остальных случаях.
-@function is-int($value) {
-	@return meta.type-of($value) == number and math.round($value) == $value;
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
+@function is-int($value, $set-strict-mode-local: true) {
+
+	// Проверка строгого режима: если включен, выполняется
+	// валидация типа значения
+	@if $set-strict-mode-local {
+
+		// Валидация типа входного параметра
+		// Функция is-number() проверяет, является ли $value числом
+		// При включенном строгом режиме некорректные типы приводят к ошибке
+		@if not is-number($value) {
+
+			// Если $value не является числом, возвращаем ошибку через
+			// стандартную функцию логирования. Это предотвращает
+			// дальнейшие вычисления с нечисловыми данными и обеспечивает
+			// раннее обнаружение ошибок в строгом режиме.
+			@return log-invalid-type(
+				'is-int',
+				$value,
+				'$value',
+				'number'
+			);
+
+		}
+
+	}
+
+	// Основная логика проверки целочисленности выполняется всегда,
+	// независимо от режима строгой проверки типов.
+	@else {
+
+		// Алгоритм проверки целочисленности:
+		// Условие состоит из двух частей, соединенных оператором and:
+		//
+		// 1. meta.type-of($value) == number - проверка базового типа данных
+		//    Функция meta.type-of() возвращает строковое представление типа.
+		//    Эта проверка актуальна даже при отключенном строгом режиме,
+		//    так как обеспечивает базовую корректность операции округления.
+		//
+		// 2. math.round($value) == $value - проверка целочисленности
+		//    math.round() выполняет математическое округление до ближайшего целого.
+		//    Для целых чисел округление не изменяет значение, поэтому сравнение
+		//    дает true. Для дробных чисел округление изменяет значение, и
+		//    сравнение дает false.
+		//
+		// Особенности работы:
+		// - Корректно работает с положительными и отрицательными числами
+		// - Корректно работает с числами, имеющими единицы измерения
+		//   (px, rem, em, %, и т.д.)
+		// - Использует стандартное математическое округление (0.5 → 1)
+		//
+		// Возвращаемое значение:
+		// - true: значение является числом И не изменяется при округлении
+		// - false: значение не является числом ИЛИ изменяется при округлении
+		@return meta.type-of($value) == number and math.round($value) == $value;
+
+	}
+
 }

package/modules/utilities/validators/number/_is-number-has-unit.scss

@@ -1,5 +1,6 @@
 @use 'sass:math';
-@use '../type-of/is-number' as type-of;
+@use '../type-of/is-number' as *;
+@use '../../loggers/log-invalid-type' as *;
 
 /// Проверяет, имеет ли число единицы измерения.
 ///
@@ -60,14 +61,14 @@
 /// 	@debug is-number-has-unit(0rem);       // true (ноль, но с единицами)
 /// 	@debug is-number-has-unit(1e-10);      // false (научная нотация без единиц)
 /// 	@debug is-number-has-unit(1.0px);      // true (число с плавающей точкой и единицами)
-/// @example scss - Нечисловые значения (всегда false)
-/// 	@debug is-number-has-unit("16px");     // false
-/// 	@debug is-number-has-unit(#ff0000);    // false
-/// 	@debug is-number-has-unit(true);       // false
-/// 	@debug is-number-has-unit(null);       // false
-/// 	@debug is-number-has-unit(auto);       // false
-/// 	@debug is-number-has-unit((16, px));   // false
-/// @param {*} $value - Значение для проверки. Может быть
+/// @example scss - Нечисловые значения (всегда Error)
+/// 	@debug is-number-has-unit("16px");     // Error: "⛔ Параметр «$value» функции «is-number-has-unit» получил неожиданный тип «string», хотя ожидается «number»"
+/// 	@debug is-number-has-unit(#ff0000);    // Error: "⛔ Параметр «$value» функции «is-number-has-unit» получил неожиданный тип «color», хотя ожидается «number»"
+/// 	@debug is-number-has-unit(true);       // Error: "⛔ Параметр «$value» функции «is-number-has-unit» получил неожиданный тип «bool», хотя ожидается «number»"
+/// 	@debug is-number-has-unit(null);       // Error: "⛔ Параметр «$value» функции «is-number-has-unit» получил неожиданный тип «null», хотя ожидается «number»"
+/// 	@debug is-number-has-unit(auto);       // Error: "⛔ Параметр «$value» функции «is-number-has-unit» получил неожиданный тип «string», хотя ожидается «number»"
+/// 	@debug is-number-has-unit((16, px));   // Error: "⛔ Параметр «$value» функции «is-number-has-unit» получил неожиданный тип «list», хотя ожидается «number»"
+/// @param {Number} $value - Значение для проверки. Может быть
 /// 	любого типа, но функция вернет `true` только для
 /// 	чисел, которые имеют единицы измерения. Любые
 /// 	единицы измерения (даже сложные комбинации)
@@ -77,9 +78,50 @@
 /// 	`math.unit($value)` не является пустой строкой).
 /// 	Возвращает `false` для безразмерных чисел и всех
 /// 	нечисловых значений.
-/// @throws {Error} - Не выбрасывает ошибков, безопасно
-/// 	обрабатывает значения любого типа. Функция `math.unit()`
-/// 	безопасно работает с любыми значениями.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function is-number-has-unit($value) {
-	@return type-of.is-number($value) and math.unit($value) != '';
+
+	// Проверка типа входного параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'is-number-has-unit',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Основная логика выполняется только если $value является
+	// корректным числом.
+	@else {
+
+		// Логика проверки, имеет ли число единицы измерения:
+		// Условие состоит из двух частей, соединенных оператором and:
+		// 1. is-number($value) - повторная проверка, что значение является числом
+		//    (хотя эта проверка уже была выполнена выше, она добавляет
+		//    дополнительную безопасность для внутренней логики)
+		// 2. math.unit($value) != '' - проверяет, что строка единиц измерения
+		//    не является пустой. Функция math.unit() возвращает единицу измерения
+		//    числа как строку. Для безразмерных чисел возвращает пустую строку.
+		//
+		// Возвращаемое значение:
+		// - true: если значение является числом И имеет непустую единицу измерения
+		// - false: если значение не является числом ИЛИ имеет пустую единицу измерения
+		//          (безразмерное число)
+		//
+		// Ключевая особенность: функция возвращает булево значение (true/false),
+		// которое можно использовать в условных конструкциях @if/@else.
+		@return is-number($value) and math.unit($value) != '';
+
+	}
+
 }

package/modules/utilities/validators/number/_is-number-negative.scss

@@ -1,4 +1,5 @@
-@use '../type-of/is-number' as type-of;
+@use '../type-of/is-number' as *;
+@use '../../loggers/log-invalid-type' as *;
 
 /// Проверяет, является ли значение отрицательным числом.
 ///
@@ -55,13 +56,13 @@
 /// 	@debug is-number-negative(-5);         // true (явно указанный минус)
 /// 	@debug is-number-negative(-0.0);       // false (отрицательный ноль рассматривается как ноль)
 /// @example scss - Нечисловые значения
-/// 	@debug is-number-negative("-1");       // false
-/// 	@debug is-number-negative(#ff0000);    // false
-/// 	@debug is-number-negative(false);      // false
-/// 	@debug is-number-negative(null);       // false
-/// 	@debug is-number-negative((1, 2, 3));  // false
-/// 	@debug is-number-negative(auto);       // false
-/// @param {*} $value - Значение для проверки. Может быть
+/// 	@debug is-number-negative("-1");       // Error: "⛔ Параметр «$value» функции «is-number-negative» получил неожиданный тип «string», хотя ожидается «number»"
+/// 	@debug is-number-negative(#ff0000);    // Error: "⛔ Параметр «$value» функции «is-number-negative» получил неожиданный тип «color», хотя ожидается «number»"
+/// 	@debug is-number-negative(false);      // Error: "⛔ Параметр «$value» функции «is-number-negative» получил неожиданный тип «bool», хотя ожидается «number»"
+/// 	@debug is-number-negative(null);       // Error: "⛔ Параметр «$value» функции «is-number-negative» получил неожиданный тип «null», хотя ожидается «number»"
+/// 	@debug is-number-negative((1, 2, 3));  // Error: "⛔ Параметр «$value» функции «is-number-negative» получил неожиданный тип «list», хотя ожидается «number»"
+/// 	@debug is-number-negative(auto);       // Error: "⛔ Параметр «$value» функции «is-number-negative» получил неожиданный тип «string», хотя ожидается «number»"
+/// @param {Number} $value - Значение для проверки. Может быть
 /// 	любого типа, но функция вернет `true` только для
 /// 	чисел строго меньше нуля, включая числа с единицами
 /// 	измерения.
@@ -69,8 +70,49 @@
 /// 	является числом и строго меньше нуля. Во всех
 /// 	остальных случаях возвращает `false`, включая
 /// 	ноль, положительные числа и значения других типов.
-/// @throws {Error} - Не выбрасывает ошибок, безопасно
-/// 	обрабатывает значения любого типа.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function is-number-negative($value) {
-  @return type-of.is-number($value) and $value < 0;
+
+	// Проверка типа входного параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'is-number-negative',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Основная логика выполняется только если $value является
+	// корректным числом.
+	@else {
+
+		// Логика проверки, является ли число отрицательным:
+		// Условие состоит из двух частей, соединенных оператором and:
+		// 1. is-number($value) - повторная проверка, что значение является числом
+		//    (хотя эта проверка уже была выполнена выше, она добавляет
+		//    дополнительную безопасность для внутренней логики)
+		// 2. $value < 0 - проверяет, меньше ли значение нуля
+		//    Оператор < сравнивает числовые значения, учитывая единицы измерения
+		//    (например, -10px < 0px вернет true)
+		//
+		// Возвращаемое значение:
+		// - true: если значение является числом И меньше нуля
+		// - false: если значение не является числом ИЛИ больше или равно нулю
+		//
+		// Ключевая особенность: функция возвращает булево значение (true/false),
+		// которое можно использовать в условных конструкциях @if/@else.
+		@return is-number($value) and $value < 0;
+
+	}
+
 }

package/modules/utilities/validators/number/_is-number-positive.scss

@@ -1,4 +1,5 @@
-@use '../type-of/is-number' as type-of;
+@use '../type-of/is-number' as *;
+@use '../../loggers/log-invalid-type' as *;
 
 /// Проверяет, является ли значение положительным числом.
 ///
@@ -53,12 +54,12 @@
 /// 	@debug is-number-positive(1.0);        // true (целое число в формате с плавающей точкой)
 /// 	@debug is-number-positive(+5);         // true (явно указанный плюс)
 /// @example scss - Нечисловые значения
-/// 	@debug is-number-positive("1");        // false
-/// 	@debug is-number-positive(#ff0000);    // false
-/// 	@debug is-number-positive(true);       // false
-/// 	@debug is-number-positive(null);       // false
-/// 	@debug is-number-positive((1, 2, 3));  // false
-/// 	@debug is-number-positive(auto);       // false
+/// 	@debug is-number-positive("1");        // Error: "⛔ Параметр «$value» функции «is-number-positive» получил неожиданный тип «string», хотя ожидается «number»"
+/// 	@debug is-number-positive(#ff0000);    // Error: "⛔ Параметр «$value» функции «is-number-positive» получил неожиданный тип «color», хотя ожидается «number»"
+/// 	@debug is-number-positive(true);       // Error: "⛔ Параметр «$value» функции «is-number-positive» получил неожиданный тип «bool», хотя ожидается «number»"
+/// 	@debug is-number-positive(null);       // Error: "⛔ Параметр «$value» функции «is-number-positive» получил неожиданный тип «null», хотя ожидается «number»"
+/// 	@debug is-number-positive((1, 2, 3));  // Error: "⛔ Параметр «$value» функции «is-number-positive» получил неожиданный тип «list», хотя ожидается «number»"
+/// 	@debug is-number-positive(auto);       // Error: "⛔ Параметр «$value» функции «is-number-positive» получил неожиданный тип «string», хотя ожидается «number»"
 /// @param {*} $value - Значение для проверки. Может быть
 /// 	любого типа, но функция вернет `true` только для
 /// 	чисел строго больше нуля, включая числа с единицами
@@ -67,8 +68,49 @@
 /// 	является числом и строго больше нуля. Во всех
 /// 	остальных случаях возвращает `false`, включая
 /// 	ноль, отрицательные числа и значения других типов.
-/// @throws {Error} - Не выбрасывает ошибок, безопасно
-/// 	обрабатывает значения любого типа.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `number`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function is-number-positive($value) {
-	@return type-of.is-number($value) and $value > 0;
+
+	// Проверка типа входного параметра: ожидается числовое значение.
+	// Функция is-number() проверяет, является ли $value числом.
+	// Это может быть целое число, дробное число или число с единицами измерения.
+	@if not is-number($value) {
+
+		// Если $value не является числом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нечисловыми данными.
+		@return log-invalid-type(
+			'is-number-positive',
+			$value,
+			'$value',
+			'number'
+		);
+
+	}
+
+	// Основная логика выполняется только если $value является
+	// корректным числом.
+	@else {
+
+		// Логика проверки, является ли число положительным:
+		// Условие состоит из двух частей, соединенных оператором and:
+		// 1. is-number($value) - повторная проверка, что значение является числом
+		//    (хотя эта проверка уже была выполнена выше, она добавляет
+		//    дополнительную безопасность для внутренней логики)
+		// 2. $value > 0 - проверяет, больше ли значение нуля
+		//    Оператор > сравнивает числовые значения, учитывая единицы измерения
+		//    (например, 10px > 0px вернет true)
+		//
+		// Возвращаемое значение:
+		// - true: если значение является числом И больше нуля
+		// - false: если значение не является числом ИЛИ меньше или равно нулю
+		//
+		// Ключевая особенность: функция возвращает булево значение (true/false),
+		// которое можно использовать в условных конструкциях @if/@else.
+		@return is-number($value) and $value > 0;
+
+	}
+
 }