@omnisass/library 0.2.0

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

@@ -0,0 +1,124 @@
+@use '../type-of/is-color' as type-of;
+
+/// Проверяет, что все элементы в списке являются цветами.
+///
+/// Функция проходит по всем элементам списка и проверяет тип
+/// каждого элемента. Если все элементы имеют тип `color`,
+/// функция возвращает `true`. Если хотя бы один элемент не
+/// является цветом, функция немедленно возвращает `false`.
+///
+/// Важные особенности функции:
+/// - Проверяет тип каждого элемента с помощью `meta.type-of()`,
+/// 	обёрткой которого является `is-color()`
+/// - Возвращает `false` при первой же найденной нецветовой
+/// 	записи
+/// - Возвращает `true` для пустого списка (vacuous truth)
+/// - Не выполняет дополнительных проверок формата цвета
+/// - Игнорирует вложенные списки и другие структуры
+/// - Использует локальные переменные с префиксом `$-` для
+/// 	избежания конфликтов
+/// ---
+/// @name is-color-list
+/// @group utilities-validators
+/// @since 2026.01.03
+/// @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/meta#type-of См. также: Официальная документация Sass - Функция meta.type-of()
+/// @link https://sass-lang.com/documentation/values/colors См. также: Официальная документация Sass - Тип данных "Цвета"
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/color_value MDN Web Docs - CSS значения цвета
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#section-39 См. также: Sass Guidelines - Раздел про проверку типов
+/// @link https://frontender.info/sass-type-checking/ См. также: Frontender Magazine - Проверка типов в Sass
+/// @link https://www.w3schools.com/sass/sass_functions_color.php См. также: W3Schools - Функции для работы с цветами в Sass
+/// @link https://habr.com/ru/post/247879/ См. также: Habr - Статья "Sass для верстальщика: проверки и валидация"
+/// @example scss - Все элементы являются цветами
+/// 	@debug is-color-list((#ff0000, #00ff00, #0000ff));         // true
+/// 	@debug is-color-list((red, blue, green));                  // true
+/// 	@debug is-color-list((rgb(255, 0, 0), hsl(120, 100%, 50%))); // true
+/// 	@debug is-color-list(());                                  // true (пустой список)
+/// @example scss - Смешанные типы данных
+/// 	@debug is-color-list((#ff0000, 10px, #0000ff));           // false
+/// 	@debug is-color-list(("red", "blue", "green"));           // false
+/// 	@debug is-color-list((#fff, null, #000));                 // false
+/// 	@debug is-color-list((true, false, #ff0000));             // false
+/// @example scss - Разные форматы цветов
+/// 	@debug is-color-list((#f00, #ff0000, rgb(255, 0, 0)));    // true
+/// 	@debug is-color-list((hsl(0, 100%, 50%), rgba(255, 0, 0, 0.5))); // true
+/// 	@debug is-color-list((currentColor, transparent));        // false (?)
+/// @example scss - Практическое использование в миксинах
+/// 	@use 'sass:list';
+///
+/// 	@mixin set-colors($colors) {
+/// 		@if not is-color-list($colors) {
+/// 			@error "Параметр $colors должен содержать только цвета";
+/// 		}
+/// 		color: list.nth($colors, 1);
+/// 		background-color: list.nth($colors, 2);
+/// 		border-color: list.nth($colors, 3);
+/// 	}
+/// 	// Корректно:
+/// 	.test {
+/// 		@include set-colors((#ff0000, #00ff00, #0000ff));
+/// 	}
+/// 	// Ошибка:
+/// 	// @include set-colors((#ff0000, 10px, #0000ff));
+/// @example css - Результат
+/// 	.test {
+/// 		color: #ff0000;
+/// 		background-color: #00ff00;
+/// 		border-color: #0000ff;
+/// 	}
+/// @example scss - Практическое использование в функциях
+/// 	@use 'sass:math';
+/// 	@use 'sass:color';
+///
+/// 	@function calculate-color-brightness($colors) {
+/// 		@if not is-color-list($colors) {
+/// 			@return null;
+/// 		}
+/// 		$total: 0;
+/// 		@each $color in $colors {
+/// 			$total: $total + color.channel($color, "lightness", $space: hsl);
+/// 		}
+/// 		@return math.div($total, list.length($colors));
+/// 	}
+/// 	@debug calculate-color-brightness((#000, #fff));  // 50
+/// 	@debug calculate-color-brightness((#000, 10px));  // null
+/// @example scss - Валидация палитры цветов
+/// 	@use 'sass:map';
+///
+/// 	$palette: (primary: #3498db, secondary: #2ecc71, accent: #e74c3c);
+/// 	@debug is-color-list(map.values($palette)); // true
+///
+/// 	$invalid-palette: (primary: #3498db, size: 16px, accent: #e74c3c);
+/// 	@debug is-color-list(map.values($invalid-palette)); // false
+/// @param {List} $list - Список значений, который может
+/// 	содержать элементы разных типов. Функция проверит
+/// 	каждый элемент на соответствие типу `color`.
+/// @return {Boolean} - Возвращает `true`, если все элементы
+/// 	в списке являются цветами. Возвращает `false`, если
+/// 	хотя бы один элемент не является цветом. Для пустого
+/// 	списка возвращает `true`.
+/// @throws {Error} - Не выбрасывает ошибок, безопасно
+/// 	обрабатывает любые типы данных.
+@function is-color-list($list) {
+
+	@each $-item in $list {
+
+		@if not type-of.is-color($-item) {
+			@return false;
+		}
+
+	}
+
+	@return true;
+
+}
+
+
+
+
+
+

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

@@ -0,0 +1,65 @@
+@use 'sass:list';
+
+/// Проверяет, содержится ли значение в указанном списке.
+///
+/// Функция проверяет наличие заданного значения в переданном
+/// списке. Использует функцию `list.index()` для поиска
+/// значения и преобразует результат в булево значение
+/// (`true` если найдено, `false` если нет).
+///
+/// Функция преобразует результат `list.index()` в
+/// булево значение:
+/// - `list.index()` возвращает `null`, если значение не
+/// 	найдено
+/// - `null != list.index(...)` возвращает `false` для `null`
+/// 	и `true` для любого индекса
+///
+/// Это стандартный паттерн для проверки наличия элемента в списке Sass.
+/// ---
+/// @name is-list-contained
+/// @group utilities-validators
+/// @since 2026.01.03
+/// @access public
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @author Неизвестный автор [идея не моя, но автора исходной функции не помню уже]
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
+/// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
+/// @link https://sass-lang.com/documentation/modules/list#index См. также: Официальная документация Sass - Функция list.index()
+/// @link https://sass-lang.com/documentation/values/lists См. также: Официальная документация Sass - Тип данных "Списки"
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/:nth-child См. также: MDN Web Docs - Псевдокласс :nth-child
+/// @link https://stackoverflow.com/questions/29620552/check-if-value-exists-in-list-in-sass См. также: Stack Overflow - Проверка наличия значения в списке Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#validation-functions См. также: Sass Guidelines - Функции валидации
+/// @link https://frontender.info/sass-lists/ См. также: Frontender Magazine - Работа со списками в Sass
+/// @link https://www.w3schools.com/sass/sass_functions_list.php См. также: W3Schools - Функции для работы со списками в Sass
+/// @example scss - Проверка наличия цвета в палитре
+/// 	$colors: red, blue, green, yellow;
+/// 	@debug is-list-contained($colors, blue);    // true
+/// 	@debug is-list-contained($colors, purple);  // false
+/// @example scss - Проверка наличия размера в допустимых значениях
+/// 	$sizes: small, medium, large, x-large;
+/// 	@debug is-list-contained($sizes, medium);   // true
+/// 	@debug is-list-contained($sizes. huge);     // false
+/// @example scss - Проверка числовых значений
+/// 	$numbers: 1, 2, 3, 4, 5;
+/// 	@debug is-list-contained($numbers, 3);      // true
+/// 	@debug is-list-contained($numbers, 10);     // false
+/// @example scss - Использование для валидации параметров
+/// 	@mixin set-position($position) {
+/// 		$allowed-positions: top, right, bottom, left, center;
+///
+/// 		@if not is-list-contained($position, $allowed-positions) {
+/// 			@error "Недопустимая позиция: #{$position}. Используйте: #{$allowed-positions}";
+/// 		}
+///
+/// 		position: $position;
+/// 	}
+/// @param {*} $value - Значение для поиска в списке
+/// @param {List} $list - Список, в котором выполняется поиск
+/// @return {Boolean} - Возвращает `true`, если значение
+/// 	найдено в списке, иначе возвращает `false`.
+/// @throws Не выбрасывает ошибок, безопасно работает с
+/// 	любыми списками
+@function is-list-contained($list, $value) {
+	@return (null != list.index($list, $value));
+}

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

@@ -0,0 +1,115 @@
+@use 'sass:meta';
+@use 'sass:list';
+@use 'sass:math';
+
+/// Проверяет, является ли значение корректным
+/// временным значением.
+///
+/// Функция проверяет тип и единицы измерения переданного
+/// значения для определения, можно ли его использовать в
+/// качестве значения времени. Поддерживаются значения с
+/// единицами измерения секунды (s), миллисекунды (ms) и
+/// часы (h), а также нулевое значение без единиц измерения (0).
+/// ---
+/// @name is-time
+/// @group utilities-validators
+/// @since 2025.12.27
+/// @access public
+/// @author Halil İbrahim Çakıroğlu
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @link https://github.com/selfishprimate GitHub - Halil İbrahim Çakıroğlu
+/// @link https://github.com/selfishprimate/gerillass/blob/master/scss/utilities/_is-time.scss GitHub - Исходник
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
+/// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
+/// @link https://sass-lang.com/documentation/modules/meta#type-of См. также: Официальная документация Sass - Функция meta.type-of()
+/// @link https://sass-lang.com/documentation/modules/meta См. также: Официальная документация Sass - Модуль meta
+/// @link https://sass-lang.com/documentation/modules/math#unit См. также: Официальная документация Sass - Функция math.unit()
+/// @link https://sass-lang.com/documentation/modules/math См. также: Официальная документация Sass - Модуль math
+/// @link https://sass-lang.com/documentation/modules/list#index См. также: Официальная документация Sass - Функция list.index()
+/// @link https://sass-lang.com/documentation/modules/list См. также: Официальная документация Sass - Модуль list
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа" (Numbers)
+/// @link https://sass-lang.com/documentation/values/numbers#units См. также: Официальная документация Sass - Единицы измерения
+/// @link https://sass-lang.com/documentation/at-rules/function См. также: Официальная документация Sass - Правило @function
+/// @link https://sass-lang.com/documentation/style-rules/declarations#custom-properties См. также: Документация Sass - Пользовательские функции
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/time См. также: MDN Web Docs - CSS тип данных <time>
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Values_and_Units См. также: MDN Web Docs - CSS значения и единицы измерения
+/// @link https://www.w3schools.com/sass/sass_functions_numeric.php См. также: W3Schools - Числовые функции в Sass
+/// @link https://www.sass.hk/docs/ См. также: Китайская документация Sass - Полное руководство
+/// @link https://sass-guidelin.es/ru/#section-39 См. также: Sass Guidelines - Раздел про проверку типов данных
+/// @link https://github.com/sass/sass/blob/main/accepted/module-system.md См. также: GitHub - Документация по модульной системе Sass
+/// @link https://stackoverflow.com/questions/30867526/how-to-check-the-type-of-a-variable-is-a-string-or-a-number-in-scss См. также: Stack Overflow - Как проверить тип переменной в Sass
+/// @link https://stackoverflow.com/questions/12528457/determine-type-of-a-variable-in-sass См. также: Stack Overflow - Определение типа переменной в Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://web.dev/learn/css/units/ См. также: web.dev - Изучение единиц измерения в CSS
+/// @link https://frontender.info/sass-numbers/ См. также: Frontender Magazine - Работа с числами в Sass
+/// @link https://habr.com/ru/post/247887/ См. также: Habr - Статья "Sass для верстальщика: числа и единицы измерения"
+/// @link https://www.sitepoint.com/sass-basics-operators/ См. также: SitePoint - Основы Sass: операторы
+/// @link https://www.freecodecamp.org/news/sass-data-types/ См. также: freeCodeCamp - Типы данных в Sass
+/// @link https://code.tutsplus.com/tutorials/understanding-sass-data-types--cms-22110 См. также: Envato Tuts+ - Понимание типов данных в Sass
+/// @link https://dev.to/kathryngrayson/sass-type-checking-1p6c См. также: Dev.to - Проверка типов в Sass
+/// @link https://css-live.ru/articles/uskorenie-razrabotki-s-pomoshhyu-sass.html См. также: CSS-Live - Ускорение разработки с помощью Sass
+/// @link https://itchief.ru/sass/data-types См. также: itchief - Типы данных в Sass
+/// @link https://htmlacademy.ru/blog/boost/tools/sass-2 См. также: HTML Academy - Sass: переменные и типы данных
+/// @link https://metanit.com/web/html5/13.3.php См. также: Metanit - Типы данных в Sass
+/// @link https://ru.hexlet.io/courses/sass-basics/lessons/data-types/theory_unit См. также: Hexlet - Типы данных в Sass
+/// @link https://www.youtube.com/watch?v=Zz6eOVaaelI См. также: YouTube - Sass Tutorial #4 - Data Types (The Net Ninja)
+/// @link https://www.youtube.com/watch?v=URtUXqOQq0k См. также: YouTube - Типы данных в Sass (на русском)
+/// @link https://codelabs.developers.google.com/codelabs/cloud-sass-cli#5 См. также: Google Codelabs - Создание пользовательских функций в Sass
+/// @link https://www.npmjs.com/package/sass См. также: npm - Документация пакета Dart Sass
+/// @link https://marketplace.visualstudio.com/items?itemName=Syler.sass-indented См. также: VS Code Marketplace - Поддержка синтаксиса Sass
+/// @link https://stylelint.io/user-guide/rules/time-min-milliseconds/ См. также: Stylelint - Правила для временных значений
+/// @link https://sass-lang.com/documentation/js-api См. также: JavaScript API - Работа с Sass через JavaScript
+/// @link https://sass-lang.com/documentation/cli/dart-sass См. также: CLI - Командная строка Dart Sass
+/// @link https://sass-lang.com/documentation/breaking-changes/module-system См. также: Breaking Changes - Изменения в модульной системе
+/// @link https://sass-lang.com/documentation/values/booleans См. также: Документация Sass - Логические значения
+/// @link https://sass-lang.com/documentation/values/strings См. также: Документация Sass - Строки
+/// @link https://sass-lang.com/documentation/values/colors См. также: Документация Sass - Цвета
+/// @link https://sass-lang.com/documentation/values/lists См. также: Документация Sass - Списки
+/// @link https://sass-lang.com/documentation/values/null См. также: Документация Sass - Значение null
+/// @link https://sass-lang.com/documentation/values/maps См. также: Документация Sass - Карты
+/// @link https://sass-lang.com/documentation/interpolation См. также: Документация Sass - Интерполяция
+/// @link https://sass-lang.com/documentation/modules/math#abs См. также: Документация Sass - Функция math.abs()
+/// @link https://sass-lang.com/documentation/modules/math#compatible См. также: Документация Sass - Функция math.compatible()
+/// @link https://sass-lang.com/documentation/modules/math#unitless См. также: Документация Sass - Функция math.unitless()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/transition-duration См. также: MDN Web Docs - CSS свойство transition-duration
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/animation-duration См. также: MDN Web Docs - CSS свойство animation-duration
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/transition-timing-function См. также: MDN Web Docs - CSS свойство transition-timing-function
+/// @link https://www.w3.org/TR/css-values-4/#time W3C CSS Values - Спецификация типа <time>
+/// @link https://www.w3.org/TR/css-values-4/#lengths W3C CSS Values - Единицы измерения длины и времени
+/// @example scss - Корректные значения времени
+/// 	@debug is-time(1s);      // true
+/// 	@debug is-time(0.5s);    // true
+/// 	@debug is-time(250ms);   // true
+/// 	@debug is-time(1.5h);    // true
+/// 	@debug is-time(0);       // true
+/// @example scss - Некорректные значения времени
+/// 	@debug is-time(1px) ;    // false
+/// 	@debug is-time(1em) ;    // false
+/// 	@debug is-time(10);      // false (не 0 и без единиц)
+/// 	@debug is-time("1s");    // false (строка вместо числа)
+/// 	@debug is-time(null);    // false
+/// 	@debug is-time(true);    // false
+/// @example scss - Использование в условных конструкциях
+/// 	$duration: 1s;
+///
+/// 	.test {
+/// 		@if is-time($duration) {
+/// 			transition-duration: $duration;
+/// 		} @else {
+/// 			@error "Некорректное значение времени: #{$duration}";
+/// 		}
+/// 	}
+/// @param {*} $value - Значение для проверки. Может быть
+/// 	любого типа, но функция ожидает число с соответствующими
+/// 	единицами измерения или ноль.
+/// @return {Boolean} - Возвращает `true`, если значение является
+/// 	корректным временным значением, иначе возвращает `false`.
+@function is-time($value) {
+	@for $i from 1 through list.length($value) {
+		@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

@@ -0,0 +1,69 @@
+@use './is-int' as *;
+
+/// Проверяет, является ли целое число четным.
+///
+/// Функция выполняет двойную проверку: сначала убеждается,
+/// что значение является целым числом (integer), затем
+/// проверяет, делится ли оно на 2 без остатка. Если значение
+/// не является целым числом, функция возвращает `false`.
+///
+/// Важные особенности функции:
+/// - Проверяет, что значение является целым числом (is-int())
+/// - Проверяет делимость на 2 без остатка (оператор %)
+/// - Возвращает false для нецелых чисел, даже если они близки
+/// 	к четным
+/// - Не выполняет автоматического округления или
+/// 	преобразования типов
+/// - Использует математический оператор модуля для проверки
+/// 	четности
+/// ---
+/// @name is-int-even
+/// @group utilities-validators
+/// @since 2026.01.03
+/// @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/operators/numeric#modulo См. также: Официальная документация Sass - Оператор модуля (%)
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа"
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Remainder См. также: MDN Web Docs - Оператор остатка от деления
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#section-39 См. также: Sass Guidelines - Раздел про проверку типов
+/// @link https://frontender.info/sass-type-checking/ См. также: Frontender Magazine - Проверка типов в Sass
+/// @link https://www.w3schools.com/sass/sass_functions_numeric.php См. также: W3Schools - Числовые функции в Sass
+/// @link https://habr.com/ru/post/247887/ См. также: Habr - Статья "Sass для верстальщика: числа и математика"
+/// @example scss - Четные целые числа
+/// 	@debug is-int-even(0);         // true
+/// 	@debug is-int-even(2);         // true
+/// 	@debug is-int-even(10);        // true
+/// 	@debug is-int-even(-4);        // true
+/// 	@debug is-int-even(100);       // true
+/// @example scss - Нечетные целые числа
+/// 	@debug is-int-even(1);         // false
+/// 	@debug is-int-even(3);         // false
+/// 	@debug is-int-even(7);         // false
+/// 	@debug is-int-even(-5);        // false
+/// 	@debug is-int-even(99);        // false
+/// @example scss - Нецелые числа (всегда false)
+/// 	@debug is-int-even(2.5);       // false
+/// 	@debug is-int-even(3.14);      // false
+/// 	@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
+/// @param {*} $value - Значение для проверки. Может быть
+/// 	любого типа, но функция вернет `true` только для
+/// 	целых чисел, которые делятся на 2 без остатка.
+/// @return {Boolean} - Возвращает `true`, если значение
+/// 	является целым числом и делится на 2 без остатка.
+/// 	Во всех остальных случаях возвращает `false`,
+/// 	включая нецелые числа и значения других типов.
+/// @throws {Error} - Не выбрасывает ошибок, безопасно
+/// 	обрабатывает значения любого типа.
+@function is-int-even($value) {
+	@return is-int($value) and $value % 2 == 0;
+}

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

@@ -0,0 +1,70 @@
+@use './is-int' as *;
+
+/// Проверяет, является ли целое число нечетным.
+///
+/// Функция выполняет двойную проверку: сначала убеждается, что
+/// значение является целым числом (integer), затем проверяет,
+/// что оно не делится на 2 без остатка. Если значение не
+/// является целым числом, функция возвращает `false`.
+///
+/// Важные особенности функции:
+/// - Проверяет, что значение является целым числом (is-int())
+/// - Проверяет, что остаток от деления на 2 не равен нулю
+/// 	(оператор %)
+/// - Возвращает false для нецелых чисел, даже если они близки
+/// 	к нечетным
+/// - Не выполняет автоматического округления или
+/// 	преобразования типов
+/// - Использует математический оператор модуля для проверки
+/// 	нечетности
+/// ---
+/// @name is-int-odd
+/// @group utilities-validators
+/// @since 2026.01.03
+/// @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/operators/numeric#modulo См. также: Официальная документация Sass - Оператор модуля (%)
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа"
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Remainder См. также: MDN Web Docs - Оператор остатка от деления
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#section-39 См. также: Sass Guidelines - Раздел про проверку типов
+/// @link https://frontender.info/sass-type-checking/ См. также: Frontender Magazine - Проверка типов в Sass
+/// @link https://www.w3schools.com/sass/sass_functions_numeric.php См. также: W3Schools - Числовые функции в Sass
+/// @link https://habr.com/ru/post/247887/ См. также: Habr - Статья "Sass для верстальщика: числа и математика"
+/// @example scss - Нечетные целые числа
+/// 	@debug is-int-odd(1);          // true
+/// 	@debug is-int-odd(3);          // true
+/// 	@debug is-int-odd(7);          // true
+/// 	@debug is-int-odd(-5);         // true
+/// 	@debug is-int-odd(99);         // true
+/// @example scss - Четные целые числа
+/// 	@debug is-int-odd(0);          // false
+/// 	@debug is-int-odd(2);          // false
+/// 	@debug is-int-odd(10);         // false
+/// 	@debug is-int-odd(-4);         // false
+/// 	@debug is-int-odd(100);        // false
+/// @example scss - Нецелые числа (всегда false)
+/// 	@debug is-int-odd(1.5);        // false
+/// 	@debug is-int-odd(3.14);       // false
+/// 	@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 - Значение для проверки. Может быть
+/// 	любого типа, но функция вернет `true` только для
+/// 	целых чисел, которые не делятся на 2 без остатка.
+/// @return {Boolean} - Возвращает `true`, если значение
+/// 	является целым числом и не делится на 2 без остатка.
+/// 	Во всех остальных случаях возвращает `false`,
+/// 	включая нецелые числа и значения других типов.
+/// @throws {Error} - Не выбрасывает ошибок, безопасно
+/// 	обрабатывает значения любого типа.
+@function is-int-odd($value) {
+	@return is-int($value) and $value % 2 != 0;
+}

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

@@ -0,0 +1,124 @@
+@use 'sass:math';
+@use 'sass:meta';
+
+/// Проверяет, является ли число целым (integer).
+///
+/// Функция проверяет, что переданное значение
+/// является числом и не имеет дробной части.
+/// Если передано не числовое значение, функция
+/// возвращает `false`.
+///
+/// Полезно для валидации параметров, которые
+/// должны быть целыми числами (например,
+/// индексы, счётчики).
+///
+/// > В исходной функции от Zsolt Pentz есть
+/// > предупреждение, если проверяемое значение не
+/// > число. Я переписал функцию так, чтобы она
+/// > возвращала только `true` или `false`. Проверку и
+/// > вывод ошибки можно написать отдельно, возможно, я
+/// > это сделаю, так как это несложно.
+/// > В примере 2 "Использование в условиях" показано как
+/// > это реализовать.
+/// ---
+/// @name is-int
+/// @group utilities-validators
+/// @since 2026.01.03
+/// @access public
+/// @author Zsolt Pentz
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @link https://github.com/pentzzsolt GitHub - Zsolt Pentz
+/// @link https://github.com/pentzzsolt/sass-recursive-map-merge GitHub - Источник функции
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
+/// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
+/// @link https://sass-lang.com/documentation/modules/meta#type-of См. также: Официальная документация Sass - Функция meta.type-of()
+/// @link https://sass-lang.com/documentation/modules/meta См. также: Официальная документация Sass - Модуль meta
+/// @link https://sass-lang.com/documentation/modules/math#round См. также: Официальная документация Sass - Функция math.round()
+/// @link https://sass-lang.com/documentation/modules/math См. также: Официальная документация Sass - Модуль math
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа" (Numbers)
+/// @link https://sass-lang.com/documentation/at-rules/function См. также: Официальная документация Sass - Правило @function
+/// @link https://sass-lang.com/documentation/style-rules/declarations#custom-properties См. также: Документация Sass - Пользовательские функции
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/integer См. также: MDN Web Docs - CSS тип данных <integer>
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/number См. также: MDN Web Docs - CSS тип данных <number>
+/// @link https://www.w3schools.com/sass/sass_functions_numeric.php См. также: W3Schools - Числовые функции в Sass
+/// @link https://www.sass.hk/docs/ См. также: Китайская документация Sass - Полное руководство
+/// @link https://sass-guidelin.es/ru/#section-39 См. также: Sass Guidelines - Раздел про проверку типов данных
+/// @link https://github.com/sass/sass/blob/main/accepted/module-system.md См. также: GitHub - Документация по модульной системе Sass
+/// @link https://stackoverflow.com/questions/30867526/how-to-check-the-type-of-a-variable-is-a-string-or-a-number-in-scss См. также: Stack Overflow - Как проверить тип переменной в Sass
+/// @link https://stackoverflow.com/questions/53976920/how-to-check-if-a-number-is-an-integer-in-sass См. также: Stack Overflow - Как проверить, является ли число целым в Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://web.dev/learn/css/numbers/ См. также: web.dev - Изучение чисел в CSS
+/// @link https://frontender.info/sass-numbers/ См. также: Frontender Magazine - Работа с числами в Sass
+/// @link https://habr.com/ru/post/247887/ См. также: Habr - Статья "Sass для верстальщика: числа и математика"
+/// @link https://www.sitepoint.com/sass-basics-operators/ См. также: SitePoint - Основы Sass: операторы
+/// @link https://www.freecodecamp.org/news/sass-data-types/ См. также: freeCodeCamp - Типы данных в Sass
+/// @link https://code.tutsplus.com/tutorials/understanding-sass-data-types--cms-22110 См. также: Envato Tuts+ - Понимание типов данных в Sass
+/// @link https://dev.to/kathryngrayson/sass-type-checking-1p6c См. также: Dev.to - Проверка типов в Sass
+/// @link https://css-live.ru/articles/uskorenie-razrabotki-s-pomoshhyu-sass.html См. также: CSS-Live - Ускорение разработки с помощью Sass
+/// @link https://itchief.ru/sass/data-types См. также: itchief - Типы данных в Sass
+/// @link https://htmlacademy.ru/blog/boost/tools/sass-2 См. также: HTML Academy - Sass: переменные и типы данных
+/// @link https://metanit.com/web/html5/13.3.php См. также: Metanit - Типы данных в Sass
+/// @link https://ru.hexlet.io/courses/sass-basics/lessons/data-types/theory_unit См. также: Hexlet - Типы данных в Sass
+/// @link https://www.youtube.com/watch?v=Zz6eOVaaelI См. также: YouTube - Sass Tutorial #4 - Data Types (The Net Ninja)
+/// @link https://www.youtube.com/watch?v=URtUXqOQq0k См. также: YouTube - Типы данных в Sass (на русском)
+/// @link https://codelabs.developers.google.com/codelabs/cloud-sass-cli#5 См. также: Google Codelabs - Создание пользовательских функций в Sass
+/// @link https://www.npmjs.com/package/sass См. также: npm - Документация пакета Dart Sass
+/// @link https://marketplace.visualstudio.com/items?itemName=Syler.sass-indented См. также: VS Code Marketplace - Поддержка синтаксиса Sass
+/// @link https://stylelint.io/user-guide/rules/number-max-precision/ См. также: Stylelint - Правила для точности чисел
+/// @link https://sass-lang.com/documentation/js-api См. также: JavaScript API - Работа с Sass через JavaScript
+/// @link https://sass-lang.com/documentation/cli/dart-sass См. также: CLI - Командная строка Dart Sass
+/// @link https://sass-lang.com/documentation/breaking-changes/module-system См. также: Breaking Changes - Изменения в модульной системе
+/// @link https://sass-lang.com/documentation/values/booleans См. также: Документация Sass - Логические значения
+/// @link https://sass-lang.com/documentation/values/strings См. также: Документация Sass - Строки
+/// @link https://sass-lang.com/documentation/values/colors См. также: Документация Sass - Цвета
+/// @link https://sass-lang.com/documentation/values/lists См. также: Документация Sass - Списки
+/// @link https://sass-lang.com/documentation/values/null См. также: Документация Sass - Значение null
+/// @link https://sass-lang.com/documentation/values/maps См. также: Документация Sass - Карты
+/// @link https://sass-lang.com/documentation/interpolation См. также: Документация Sass - Интерполяция
+/// @link https://sass-lang.com/documentation/modules/math#abs См. также: Документация Sass - Функция math.abs()
+/// @link https://sass-lang.com/documentation/modules/math#ceil См. также: Документация Sass - Функция math.ceil()
+/// @link https://sass-lang.com/documentation/modules/math#floor См. также: Документация Sass - Функция math.floor()
+/// @link https://sass-lang.com/documentation/modules/math#max См. также: Документация Sass - Функция math.max()
+/// @link https://sass-lang.com/documentation/modules/math#min См. также: Документация Sass - Функция math.min()
+/// @link https://sass-lang.com/documentation/modules/math#percentage См. также: Документация Sass - Функция math.percentage()
+/// @link https://sass-lang.com/documentation/modules/math#random См. также: Документация Sass - Функция math.random()
+/// @link https://sass-lang.com/documentation/modules/math#unit См. также: Документация Sass - Функция math.unit()
+/// @link https://sass-lang.com/documentation/modules/math#unitless См. также: Документация Sass - Функция math.unitless()
+/// @link https://sass-lang.com/documentation/modules/math#compatible См. также: Документация Sass - Функция math.compatible()
+/// @link https://sass-lang.com/documentation/values/numbers#units См. также: Документация Sass - Числа и единицы измерения
+/// @link https://sass-lang.com/documentation/values/numbers#precision См. также: Документация Sass - Точность чисел в Sass
+/// @example scss - Проверка целых чисел
+/// 	@debug is-int(42);		// true
+/// 	@debug is-int(3.14);	// false
+/// 	@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
+///
+/// @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);
+/// 		}
+/// 	}
+/// 	// $integers: (1, 4, 5)
+/// @param {*} $value - Проверяемое значение
+/// @return {Boolean} - `true` если значение является
+/// 	целым числом, `false` во всех остальных случаях.
+@function is-int($value) {
+	@return meta.type-of($value) == number and math.round($value) == $value;
+}