@omnisass/library 0.2.1 → 0.4.0

package/modules/utilities/helpers/string/_string-reverse.scss

@@ -0,0 +1,139 @@
+@use 'sass:string';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-string' as *;
+
+/// Переворачивает строку (меняет порядок символов на обратный).
+///
+/// Функция принимает строку и возвращает новую строку, в которой
+/// все символы расположены в обратном порядке. Например, строка
+/// "hello" превращается в "olleh". Это полезно для различных
+/// текстовых манипуляций, создания зеркальных эффектов в дизайне
+/// или обработки строк в специфичных сценариях.
+///
+/// Важные особенности функции:
+/// - Сохраняет все символы исходной строки без изменений
+/// - Работает с любыми символами, включая Unicode, пробелы, цифры
+/// - Выполняет строгую проверку типа входного параметра
+/// - Использует цикл для итерации по символам строки в обратном порядке
+/// - Возвращает пустую строку для пустого входного значения
+/// - Полезна для создания палиндромов или проверки симметрии текста
+/// - Может использоваться для зеркального отображения текста в CSS
+/// - Подходит для шифрования простых текстовых преобразований
+/// - Обрабатывает строки любой длины
+/// - Совместима с многострочными строками
+/// - Сохраняет пробелы и специальные символы
+/// - Функция использует цикл for с обратным порядком
+///   итерации `(from $-length through 1)`. Это эффективный
+///   способ перевернуть строку в Sass.
+/// - Для палиндромов (строк, которые читаются одинаково
+///   слева направо и справа налево) функция вернет исходную
+///   строку без изменений.
+/// - Функция корректно работает с Unicode-символами
+///   (например, эмодзи или символами нелатинских алфавитов),
+///   так как `string.slice()` в Sass правильно обрабатывает
+///   Unicode.
+/// - Производительность функции снижается для очень
+///   длинных строк (сотни символов), так как каждый символ
+///   обрабатывается в отдельной итерации цикла.
+/// ---
+/// @name string-reverse
+/// @group utilities-helpers
+/// @since 2026.01.18
+/// @access public
+/// @author Murad Rustamov (therteenten)
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
+/// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
+/// @link https://sass-lang.com/documentation/modules/string См. также: Официальная документация Sass - Модуль String
+/// @link https://sass-lang.com/documentation/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String См. также: MDN Web Docs - Объект String
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse См. также: MDN Web Docs - Метод Array.reverse()
+/// @link https://en.wikipedia.org/wiki/Palindrome См. также: Wikipedia - Палиндром
+/// @link https://en.wikipedia.org/wiki/String_(computer_science) См. также: Wikipedia - Строка (информатика)
+/// @link https://css-tricks.com/snippets/sass/string-reverse-function/ См. также: CSS-Tricks - Функция реверса строк в Sass
+/// @link https://css-tricks.com/sass-string-manipulation-functions/ См. также: CSS-Tricks - Функции для работы со строками в Sass
+/// @link https://sass-guidelin.es/ru/#section-44 См. также: Sass Guidelines - Раздел про функции
+/// @link https://github.com/sass/sass/issues/1402 См. также: GitHub - Обсуждение строковых операций в Sass
+/// @link https://www.30secondsofcode.org/sass/p/1/string-reverse См. также: 30 seconds of code - Функция string-reverse
+/// @example scss - Базовое использование
+/// 	@debug string-reverse("hello");      // "olleh"
+/// 	@debug string-reverse("world");      // "dlrow"
+/// 	@debug string-reverse("12345");      // "54321"
+/// 	@debug string-reverse("");           // ""
+/// 	@debug string-reverse("a");          // "a"
+/// @example scss - Работа с пробелами и специальными символами
+/// 	@debug string-reverse("hello world");   // "dlrow olleh"
+/// 	@debug string-reverse("a b c");         // "c b a"
+/// 	@debug string-reverse("test!");         // "!tset"
+/// 	@debug string-reverse("привет");        // "тевирп"
+/// @example scss - Создание зеркальных эффектов
+/// 	@debug string-reverse("CSS");          // "SSC"
+/// 	@debug string-reverse("level");        // "level" (палиндром)
+/// 	@debug string-reverse("radar");        // "radar" (палиндром)
+/// 	@debug string-reverse("madam");        // "madam" (палиндром)
+/// @param {String} $string - Исходная строка для переворачивания.
+///   Может быть любой строкой: пустой, односимвольной,
+///   многосимвольной, содержащей пробелы, Unicode-символы,
+///   цифры или специальные символы. Все символы сохраняются
+///   и меняют только порядок следования.
+/// @return {String} - Новая строка, содержащая все символы
+///   исходной строки в обратном порядке. Для пустой строки
+///   возвращается пустая строка. Для строки из одного символа
+///   возвращается та же строка (так как порядок не меняется).
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+@function string-reverse($string) {
+
+	// Проверка типа входного параметра: ожидается строковое значение.
+	// Функция предназначена для работы исключительно со строками,
+	// так как операция реверса имеет смысл только для последовательности
+	// символов.
+	@if not is-string($string) {
+
+		// Если $string не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные операции с нестроковыми типами данных.
+		@return log-invalid-type(
+			'string-reverse',
+			$string,
+			'$string',
+			'string'
+		);
+
+	}
+
+	// Параметр прошел валидацию - переворачиваем строку.
+	@else {
+
+		// Инициализация переменной результата.
+		// Начальное значение null позволяет начать конкатенацию
+		// с первого символа без специальной обработки.
+		$-result: null;
+
+		// Определение длины входной строки.
+		// Длина используется для итерации по символам строки
+		// в обратном порядке.
+		$-length: string.length($string);
+
+		// Цикл итерации по символам строки в обратном порядке.
+		// Начинаем с последнего символа (индекс $-length) и
+		// движемся к первому символу (индекс 1).
+		@for $i from $-length through 1 {
+
+			// Извлечение текущего символа строки по индексу.
+			// string.slice($string, $i, $i) возвращает один символ
+			// на позиции $i. Индексация в Sass начинается с 1.
+			$-result: $-result + string.slice($string, $i, $i);
+
+		}
+
+		// Возвращаем перевернутую строку.
+		// Если исходная строка была пустой, $-length = 0,
+		// цикл не выполнится ни разу, и функция вернет null,
+		// который в контексте строки преобразуется в пустую строку.
+		@return $-result;
+
+	}
+
+}

package/modules/utilities/helpers/string/_string-trim-end.scss

@@ -1,4 +1,6 @@
 @use 'sass:string';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-string' as *;
 
 /// Удаляет пробелы с конца строки (справа).
 ///
@@ -48,15 +50,56 @@
 /// @return {String} - Возвращает новую строку, в которой удалены
 /// 	все пробелы с конца оригинальной строки.
 /// 	Если строка состоит только из пробелов, возвращается пустая строка.
-/// @throws {Error} - Не выбрасывает ошибок. Если передано нестроковое
-/// 	значение, функция может вернуть неожиданный результат или вызвать
-/// 	ошибку выполнения.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `string`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function string-trim-end($string) {
 
-	@while string.slice($string, -1) == " " {
-		$string: string.slice($string, 1, -2);
+	// Проверка типа входного параметра: ожидается строковое значение.
+	// Функция is-string() проверяет, является ли $string строкой
+	// (тип данных string). Строка будет обработана для удаления
+	// пробельных символов в конце.
+	@if not is-string($string) {
+
+		// Если $string не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные операции обрезки с нестроковыми данными.
+		@return log-invalid-type(
+			'string-trim-end',
+			$string,
+			'$string',
+			'string'
+		);
+
 	}
 
-	@return $string;
+	// Основная логика выполняется только если $string является
+	// корректной строкой.
+	@else {
+
+		// Цикл удаления пробельных символов с конца строки.
+		// Цикл продолжается до тех пор, пока последний символ строки
+		// является пробелом.
+		@while string.slice($string, -1) == " " {
+
+			// Удаление последнего символа из строки.
+			// Алгоритм:
+			// 1. string.slice($string, 1, -2) - создает новую строку,
+			//    которая содержит все символы исходной строки,
+			//    кроме последнего.
+			//    - 1: начальный индекс (первый символ)
+			//    - -2: конечный индекс (предпоследний символ, считая с конца)
+			// 2. Присваивание результата обратно переменной $string
+			//    для следующей итерации цикла.
+			$string: string.slice($string, 1, -2);
+
+		}
+
+		// Возвращаем строку без пробельных символов в конце.
+		// Если в исходной строке не было пробелов в конце,
+		// возвращается оригинальная строка без изменений.
+		@return $string;
+
+	}
 
 }

package/modules/utilities/helpers/string/_string-trim-start.scss

@@ -1,4 +1,6 @@
 @use 'sass:string';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-string' as *;
 
 /// Удаляет пробелы с начала строки (слева).
 ///
@@ -48,15 +50,56 @@
 /// @return {String} - Возвращает новую строку, в которой удалены
 /// 	все пробелы с начала оригинальной строки.
 /// 	Если строка состоит только из пробелов, возвращается пустая строка.
-/// @throws {Error} - Не выбрасывает ошибок. Если передано нестроковое
-/// 	значение, функция может вернуть неожиданный результат или вызвать
-/// 	ошибку выполнения.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `string`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function string-trim-start($string) {
 
-	@while string.slice($string, 1, 1) == " " {
-		$string: string.slice($string, 2);
+	// Проверка типа входного параметра: ожидается строковое значение.
+	// Функция is-string() проверяет, является ли $string строкой
+	// (тип данных string). Строка будет обработана для удаления
+	// пробельных символов в начале.
+	@if not is-string($string) {
+
+		// Если $string не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные операции обрезки с нестроковыми данными.
+		@return log-invalid-type(
+			'string-trim-start',
+			$string,
+			'$string',
+			'string'
+		);
+
 	}
 
-	@return $string;
+	// Основная логика выполняется только если $string является
+	// корректной строкой.
+	@else {
+
+		// Цикл удаления пробельных символов с начала строки.
+		// Цикл продолжается до тех пор, пока первый символ строки
+		// является пробелом.
+		@while string.slice($string, 1, 1) == " " {
+
+			// Удаление первого символа из строки.
+			// Алгоритм:
+			// 1. string.slice($string, 2) - создает новую строку,
+			//    которая содержит все символы исходной строки,
+			//    начиная со второго символа.
+			//    - 2: начальный индекс (второй символ)
+			//    - Если не указан конечный индекс, берется до конца строки
+			// 2. Присваивание результата обратно переменной $string
+			//    для следующей итерации цикла.
+			$string: string.slice($string, 2);
+
+		}
+
+		// Возвращаем строку без пробельных символов в начале.
+		// Если в исходной строке не было пробелов в начале,
+		// возвращается оригинальная строка без изменений.
+		@return $string;
+
+	}
 
 }

package/modules/utilities/helpers/string/_string-trim.scss

@@ -1,4 +1,6 @@
 @use 'sass:string';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-string' as *;
 
 /// Удаляет пробелы с начала и конца строки.
 ///
@@ -49,21 +51,64 @@
 /// @return {String} - Возвращает новую строку, в которой удалены
 /// 	все пробелы с начала и конца оригинальной строки.
 /// 	Если строка состоит только из пробелов, возвращается пустая строка.
-/// @throws {Error} - Не выбрасывает ошибок. Если передано нестроковое
-/// 	значение, функция может вернуть неожиданный результат или вызвать
-/// 	ошибку выполнения.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `string`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function string-trim($string) {
 
-	// Убираем пробелы в начале
-	@while string.slice($string, 1, 1) == " " {
-		$string: string.slice($string, 2);
-	}
+	// Проверка типа входного параметра: ожидается строковое значение.
+	// Функция is-string() проверяет, является ли $string строкой
+	// (тип данных string). Строка будет обработана для удаления
+	// пробельных символов с обоих концов.
+	@if not is-string($string) {
+
+		// Если $string не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные операции обрезки с нестроковыми данными.
+		@return log-invalid-type(
+			'string-trim',
+			$string,
+			'$string',
+			'string'
+		);
 
-	// Убираем пробелы в конце
-	@while string.slice($string, -1) == " " {
-		$string: string.slice($string, 1, -2);
 	}
 
-	@return $string;
+	// Основная логика выполняется только если $string является
+	// корректной строкой.
+	@else {
+
+		// Удаление пробельных символов с начала строки.
+		// Цикл продолжается до тех пор, пока первый символ строки
+		// является пробелом.
+		@while string.slice($string, 1, 1) == " " {
+
+			// Удаление первого символа из строки.
+			// string.slice($string, 2) создает новую строку,
+			// которая содержит все символы исходной строки,
+			// начиная со второго символа.
+			$string: string.slice($string, 2);
+
+		}
+
+		// Удаление пробельных символов с конца строки.
+		// Цикл продолжается до тех пор, пока последний символ строки
+		// является пробелом.
+		@while string.slice($string, -1) == " " {
+
+			// Удаление последнего символа из строки.
+			// string.slice($string, 1, -2) создает новую строку,
+			// которая содержит все символы исходной строки,
+			// кроме последнего.
+			$string: string.slice($string, 1, -2);
+
+		}
+
+		// Возвращаем строку без пробельных символов в начале и конце.
+		// Если в исходной строке не было пробелов на краях,
+		// возвращается оригинальная строка без изменений.
+		@return $string;
+
+	}
 
 }

package/modules/utilities/loggers/_log-invalid-type.scss

@@ -111,7 +111,7 @@
 	// Получаем глобальные настройки из конфигурации
 	$-strict-mode: libconfigs.$set-strict-mode; // Режим работы: true = ошибки (строгий), false = предупреждения
 	$-loglang: libconfigs.$set-loglang;         // Язык вывода сообщений
-	$-log-message: '';                          // Текст сообщения об ошибке
+	$-log-message: null;                          // Текст сообщения об ошибке
 
 	// Определяем язык на основе глобальной настройки
 	@if $-loglang != 'ru' {

package/modules/utilities/loggers/_log-invalid-value.scss

@@ -109,7 +109,7 @@
 	// файла:
 	$-strict-mode: libconfigs.$set-strict-mode; // true = строгий режим (ошибки), false = режим предупреждений
 	$-loglang: libconfigs.$set-loglang;         // язык сообщений ('ru' = русский, любое другое = английский)
-	$-log-message: '';                          // переменная для хранения текста сообщения
+	$-log-message: null;                          // переменная для хранения текста сообщения
 
 	// Если язык НЕ русский, используем английский текст
 	@if $-loglang != 'ru' {

package/modules/utilities/validators/color/_is-color-light.scss

@@ -1,4 +1,7 @@
 @use 'sass:color';
+@use '../../loggers/log-invalid-type' as *;
+@use '../type-of/is-color' as *;
+@use '../type-of/is-number' as *;
 
 /// Определяет, является ли цвет светлым (по пороговому
 /// значению светлоты).
@@ -124,9 +127,63 @@
 /// 	используется значение 50%, которое является
 /// 	общепринятым разделением между светлыми и темными
 /// 	тонами. Можно изменить для тонкой настройки.
-/// @return {Boolean} - Возвращает `true`, если светлота
-/// 	цвета больше порогового значения, и `false` в противном
-/// 	случае.
+/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
+/// 	значение, не соответствующее типу `color` ($color) или
+/// 	`number` (`$threshold`). Компиляция Sass будет остановлена
+/// 	с ошибкой.
 @function is-color-light($color, $threshold: 50) {
-	@return color.channel($color, "lightness", $space: hsl) > $threshold;
+
+	// Проверка типа первого параметра: ожидается цветовое значение.
+	// Функция is-color() проверяет, является ли $color валидным цветом CSS.
+	// Цвет будет проанализирован для определения его яркости.
+	@if not is-color($color) {
+
+		// Если $color не является цветом, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с нецветовыми данными.
+		@return log-invalid-type(
+			'is-color-light',
+			$color,
+			'$color',
+			'color'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение
+	// порога яркости. $threshold определяет граничное значение
+	// яркости (в процентах), выше которой цвет считается светлым.
+	// По умолчанию используется 50%.
+	@else if not is-number($threshold) {
+
+		// Если $threshold не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $color прошел валидацию.
+		@return log-invalid-type(
+			'is-color-light',
+			$threshold,
+			'$threshold',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - определяем, является ли цвет светлым.
+	@else {
+
+		// Логика определения светлоты цвета:
+		// 1. color.channel($color, "lightness", $space: hsl) - извлекает
+		//    значение яркости цвета в пространстве HSL (от 0% до 100%)
+		// 2. ... > $threshold - сравнивает яркость цвета с пороговым значением
+		//
+		// Возвращаемое значение:
+		// - true: если яркость цвета больше порогового значения (цвет светлый)
+		// - false: если яркость цвета меньше или равна пороговому значению
+		//          (цвет темный или нейтральный)
+		//
+		// Ключевая особенность: функция возвращает булево значение (true/false),
+		// которое можно использовать в условных конструкциях @if/@else.
+		@return color.channel($color, "lightness", $space: hsl) > $threshold;
+
+	}
+
 }

package/modules/utilities/validators/color/_is-color-list.scss

@@ -1,4 +1,6 @@
-@use '../type-of/is-color' as type-of;
+@use '../../loggers/log-invalid-type' as *;
+@use '../type-of/is-color' as *;
+@use '../type-of/is-list' as *;
 
 /// Проверяет, что все элементы в списке являются цветами.
 ///
@@ -101,24 +103,54 @@
 /// 	в списке являются цветами. Возвращает `false`, если
 /// 	хотя бы один элемент не является цветом. Для пустого
 /// 	списка возвращает `true`.
-/// @throws {Error} - Не выбрасывает ошибок, безопасно
-/// 	обрабатывает любые типы данных.
+/// @throws {Error} - Выбрасывает ошибку, если параметру `$list` передано
+/// 	значение, не соответствующее типу `list`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function is-color-list($list) {
 
-	@each $-item in $list {
+	// Проверка типа входного параметра: ожидается список или arglist.
+	// Функция is-list() проверяет, является ли $list валидным списком
+	// или arglist (специальный тип для переменного числа аргументов).
+	@if not is-list($list) {
 
-		@if not type-of.is-color($-item) {
-			@return false;
-		}
+		// Если $list не является списком, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные проверки с некорректными данными.
+		@return log-invalid-type(
+			'is-color-list',
+			$list,
+			'$list',
+			('list', 'arglist')
+		);
 
 	}
 
-	@return true;
+	// Основная логика выполняется только если $list является
+	// корректным списком или arglist.
+	@else {
 
-}
+		// Итерация по всем элементам списка.
+		// Переменная $-item содержит текущий проверяемый элемент.
+		@each $-item in $list {
+
+			// Проверка: является ли текущий элемент цветом.
+			// Функция is-color() возвращает true для валидных цветов CSS.
+			@if not is-color($-item) {
 
+				// Если хотя бы один элемент не является цветом,
+				// немедленно возвращаем false. Это ранний выход из функции,
+				// который оптимизирует производительность для больших списков.
+				@return false;
 
+			}
 
+		}
 
+		// Если все элементы прошли проверку и являются цветами,
+		// возвращаем true. Эта точка достигается только если цикл
+		// завершился без преждевременного возврата.
+		@return true;
 
+	}
 
+}

package/modules/utilities/validators/list/_is-list-contained.scss

@@ -1,4 +1,6 @@
 @use 'sass:list';
+@use '../../loggers/log-invalid-type' as *;
+@use '../type-of/is-list' as *;
 
 /// Проверяет, содержится ли значение в указанном списке.
 ///
@@ -58,8 +60,45 @@
 /// @param {List} $list - Список, в котором выполняется поиск
 /// @return {Boolean} - Возвращает `true`, если значение
 /// 	найдено в списке, иначе возвращает `false`.
-/// @throws Не выбрасывает ошибок, безопасно работает с
-/// 	любыми списками
+/// @throws {Error} - Выбрасывает ошибку, если параметру `$list` передано
+/// 	значение, не соответствующее типу `list`. Компиляция Sass
+/// 	будет остановлена с ошибкой.
 @function is-list-contained($list, $value) {
-	@return (null != list.index($list, $value));
+
+	// Проверка типа первого параметра: ожидается список или arglist.
+	// Функция is-list() проверяет, является ли $list валидным списком
+	// или arglist (специальный тип для переменного числа аргументов).
+	@if not is-list($list) {
+
+		// Если $list не является списком, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные проверки с некорректными данными.
+		@return log-invalid-type(
+			'is-list-contained',
+			$list,
+			'$list',
+			('list', 'arglist')
+		);
+
+	}
+
+	// Основная логика выполняется только если $list является
+	// корректным списком или arglist.
+	@else {
+
+		// Проверка наличия значения в списке.
+		// Алгоритм:
+		// 1. list.index($list, $value) - ищет первое вхождение значения
+		//    в списке и возвращает его индекс (начиная с 1)
+		//    Если значение не найдено, возвращает null
+		// 2. null != ... - сравниваем результат с null
+		//    - Если результат не равен null → значение найдено → true
+		//    - Если результат равен null → значение не найдено → false
+		//
+		// Ключевая особенность: функция возвращает булево значение (true/false),
+		// указывающее, содержится ли значение хотя бы один раз в списке.
+		@return (null != list.index($list, $value));
+
+	}
+
 }

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;
 		}
+
 	}
+
 }