@omnisass/library 0.2.0

package/modules/utilities/validators/string/_is-string-ending-with.scss

@@ -0,0 +1,66 @@
+@use 'sass:string';
+
+/// Проверяет, заканчивается ли строка указанной подстрокой.
+///
+/// Функция извлекает конец строки, равный по длине проверяемой
+/// подстроке, и сравнивает его с этой подстрокой. Если
+/// извлеченная часть строки совпадает с подстрокой, функция
+/// возвращает `true`. В противном случае возвращается `false`.
+///
+/// Важные особенности функции:
+/// - Использует функцию `string.slice()` с отрицательным индексом
+/// 	для извлечения конца строки
+/// - Сравнивает извлеченную часть с подстрокой оператором равенства (==)
+/// - Отрицательный индекс позволяет отсчитывать позиции с конца строки
+/// - Чувствительна к регистру символов
+/// - Учитывает пробелы и специальные символы в конце строки
+/// ---
+/// @name is-string-ending-with
+/// @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/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://sass-lang.com/documentation/modules/string#slice См. также: Официальная документация Sass - Функция string.slice()
+/// @link https://sass-lang.com/documentation/modules/string#length См. также: Официальная документация Sass - Функция string.length()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/string_value См. также: MDN Web Docs - CSS-тип <string>
+/// @link https://sass-lang.com/documentation/operators/equality См. также: Официальная документация Sass - Операторы равенства
+/// @link https://sass-lang.com/documentation/values/strings#interpolation См. также: Официальная документация Sass - Интерполяция строк
+/// @link https://sass-lang.com/documentation/values/strings#quotes См. также: Официальная документация Sass - Кавычки в строках
+/// @example scss - Строка заканчивается подстрокой
+/// 	@debug is-string-ending-with('hello world', 'world'); // true
+/// 	@debug is-string-ending-with('test-string', 'string'); // true
+/// 	@debug is-string-ending-with('filename.jpg', '.jpg'); // true
+/// @example scss - Строка не заканчивается подстрокой
+/// 	@debug is-string-ending-with('hello world', 'hello'); // false
+/// 	@debug is-string-ending-with('test', 'testing');      // false (подстрока длиннее строки)
+/// 	@debug is-string-ending-with('World', 'world');       // false (регистр не совпадает)
+/// @example scss - Граничные случаи
+/// 	@debug is-string-ending-with('', '');                 // true (обе строки пустые)
+/// 	@debug is-string-ending-with('abc', '');              // false
+/// 	@debug is-string-ending-with('', 'abc');              // false (строка короче подстроки)
+/// 	@debug is-string-ending-with('space  ', '  ');        // true (пробелы в конце учитываются)
+/// @example scss - Специальные символы и расширения файлов
+/// 	@debug is-string-ending-with('style.css', '.css');    // true
+/// 	@debug is-string-ending-with('data.json', '.json');   // true
+/// 	@debug is-string-ending-with('index.html', '.html');  // true
+/// 	@debug is-string-ending-with('text.txt', '.txt');     // true
+/// @param {String} $string - Основная строка, в которой выполняется поиск.
+/// @param {String} $substring - Подстрока, наличие которой проверяется
+/// 	в конце основной строки.
+/// @return {Boolean} - Возвращает `true`, если строка заканчивается
+/// 	указанной подстрокой. Возвращает `false`, если строка не заканчивается
+/// 	подстрокой, если подстрока длиннее строки, или если регистр
+/// 	символов не совпадает.
+/// @throws {Error} - Не выбрасывает ошибок. Если переданы нестроковые
+/// 	значения, функция может вернуть неожиданный результат или вызвать
+/// 	ошибку выполнения.
+@function is-string-ending-with($string, $substring) {
+
+	$-substring-length: string.length($substring);
+
+	@return string.slice($string, -$-substring-length) == $substring;
+
+}

package/modules/utilities/validators/string/_is-string-starting-with.scss

@@ -0,0 +1,66 @@
+@use 'sass:string';
+
+/// Проверяет, начинается ли строка с указанной подстроки.
+///
+/// Функция извлекает начало строки, равное по длине проверяемой
+/// подстроке, и сравнивает его с этой подстрокой. Если
+/// извлеченная часть строки совпадает с подстрокой, функция
+/// возвращает `true`. В противном случае возвращается `false`.
+///
+/// Важные особенности функции:
+/// - Использует функцию `string.slice()` для извлечения части
+/// 	строки
+/// - Сравнивает извлеченную часть с подстрокой оператором равенства (==)
+/// - Проверяет начало строки, начиная с первого символа (индекс 1)
+/// - Чувствительна к регистру символов
+/// - Учитывает пробелы и специальные символы
+/// ---
+/// @name is-string-starting-with
+/// @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/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://sass-lang.com/documentation/modules/string#slice См. также: Официальная документация Sass - Функция string.slice()
+/// @link https://sass-lang.com/documentation/modules/string#length См. также: Официальная документация Sass - Функция string.length()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/string_value См. также: MDN Web Docs - CSS-тип <string>
+/// @link https://sass-lang.com/documentation/operators/equality См. также: Официальная документация Sass - Операторы равенства
+/// @link https://sass-lang.com/documentation/values/strings#interpolation См. также: Официальная документация Sass - Интерполяция строк
+/// @link https://sass-lang.com/documentation/values/strings#quotes См. также: Официальная документация Sass - Кавычки в строках
+/// @example scss - Строка начинается с подстроки
+/// 	@debug is-string-starting-with('hello world', 'hello'); // true
+/// 	@debug is-string-starting-with('test-string', 'test');  // true
+/// 	@debug is-string-starting-with('12345', '123');         // true
+/// @example scss - Строка не начинается с подстроки
+/// 	@debug is-string-starting-with('hello world', 'world'); // false
+/// 	@debug is-string-starting-with('test', 'testing');      // false (подстрока длиннее строки)
+/// 	@debug is-string-starting-with('Hello', 'hello');       // false (регистр не совпадает)
+/// @example scss - Граничные случаи
+/// 	@debug is-string-starting-with('', '');                 // true (обе строки пустые)
+/// 	@debug is-string-starting-with('abc', '');              // true (пустая подстрока всегда в начале)
+/// 	@debug is-string-starting-with('', 'abc');              // false (строка короче подстроки)
+/// 	@debug is-string-starting-with('  space', '  ');        // true (пробелы учитываются)
+/// @example scss - Специальные символы
+/// 	@debug is-string-starting-with('#selector', '#');       // true
+/// 	@debug is-string-starting-with('.class-name', '.');     // true
+/// 	@debug is-string-starting-with('url(image.jpg)', 'url'); // true
+/// @param {String} $string - Основная строка, в которой
+/// 	выполняется поиск.
+/// @param {String} $substring - Подстрока, наличие которой
+/// 	проверяется в начале основной строки.
+/// @return {Boolean} - Возвращает `true`, если строка начинается
+/// 	с указанной подстроки. Возвращает `false`, если строка не
+/// 	начинается с подстроки, если подстрока длиннее строки, или
+/// 	если регистр символов не совпадает.
+/// @throws {Error} - Не выбрасывает ошибок. Если переданы
+/// 	нестроковые значения, функция может вернуть неожиданный
+/// 	результат или вызвать ошибку выполнения.
+@function is-string-starting-with($string, $substring) {
+	@return string.slice(
+		$string,
+		1,
+		string.length($substring)
+	) == $substring;
+}

package/modules/utilities/validators/type-of/_is-boolean.scss

@@ -0,0 +1,92 @@
+@use 'sass:meta';
+
+/// Проверяет, является ли переданное значение
+/// логическим типом (boolean).
+///
+/// Функция анализирует тип переданной переменной
+/// и возвращает `true`, если это логическое
+/// значение (true или false). Используется для
+/// валидации входных параметров в функциях и миксинах,
+/// а также для условных операций в зависимости от
+/// типа данных.
+/// ---
+/// @name is-boolean
+/// @group utilities-validators
+/// @since 2025.12.27
+/// @access public
+/// @author takamoso
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @link https://github.com/takamoso GitHub - takamoso
+/// @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/values/booleans См. также: Официальная документация Sass - Тип данных "Логические значения" (Booleans)
+/// @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/:checked См. также: MDN Web Docs - Псевдокласс :checked
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/:enabled См. также: MDN Web Docs - Псевдокласс :enabled
+/// @link https://www.w3schools.com/sass/sass_functions_meta.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/51785890/sass-check-if-a-variable-is-of-type-boolean См. также: Stack Overflow - Проверка, является ли переменная булевой
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://web.dev/learn/css/pseudo-classes/ См. также: web.dev - Изучение псевдоклассов CSS
+/// @link https://frontender.info/sass-type-checking/ См. также: Frontender Magazine - Проверка типов в Sass
+/// @link https://habr.com/ru/post/156549/ См. также: 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/selector-pseudo-class/ См. также: 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/numbers См. также: Документация 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/null См. также: Документация Sass - Значение null
+/// @link https://sass-lang.com/documentation/values/maps См. также: Документация Sass - Карты (maps)
+/// @link https://sass-lang.com/documentation/interpolation См. также: Документация Sass - Интерполяция
+/// @example scss - Базовое использование
+/// 	$is-valid: true;
+/// 	$count: 42;
+/// 	$message: "text";
+///
+/// 	@debug is-boolean($is-valid);	//=> true
+/// 	@debug is-boolean($count);			//=> false
+/// 	@debug is-boolean($message); 	//=> false
+/// @example scss - Использование в условиях
+/// 	@if is-boolean($setting) {
+/// 		// Выполняется только для boolean значений
+/// 		@debug "Настройка имеет логический тип";
+/// 	} @else {
+/// 		@warn "Ожидается логическое значение true/false";
+/// 	}
+/// @example scss - Валидация параметров функции
+/// 	@function set-visibility($is-visible) {
+/// 		@if not is-boolean($is-visible) {
+/// 			@error "Параметр $is-visible должен быть true или false";
+/// 		}
+/// 		@return if($is-visible, block, none);
+/// 	}
+/// @param {*} $value - Переменная для проверки типа
+/// 	(может быть любого типа).
+/// @return {Boolean} - `true` если переменная является
+/// 	логическим типом (true/false), `false` во
+/// 	всех остальных случаях.
+@function is-boolean($value) {
+	@return meta.type-of($value) == bool;
+}

package/modules/utilities/validators/type-of/_is-color.scss

@@ -0,0 +1,96 @@
+@use 'sass:meta';
+
+/// Проверяет, является ли значение допустимым цветом.
+///
+/// Функция `is-color()` определяет, представляет ли
+/// переданное значение допустимый цвет в Sass. Это
+/// типобезопасная проверка, которая помогает избежать
+/// ошибок при работе с динамическими значениями,
+/// или данными из внешних источников.
+///
+/// Особенно полезна в миксинах и функциях, которые ожидают
+/// цветовые параметры.
+///
+/// > Функция проверяет тип значения во время компиляции, а
+/// > не содержимое. Строка `"#ff0000"` вернет `false`, хотя
+/// > выглядит как цвет.
+///
+/// > CSS-переменные (`var(--my-color)`) считаются строками,
+/// > а не цветами, даже если они ссылаются на цветовые
+/// > значения.
+/// ---
+/// @name is-color
+/// @group utilities-validators
+/// @since 2025.12.27
+/// @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/values/colors См. также: Sass - Значения цветов
+/// @link https://sass-lang.com/documentation/modules/meta#type-of См. также: Sass - Функция meta.type-of()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/color_value См. также: MDN - Значения цвета CSS
+/// @link https://www.w3.org/TR/css-color-4/ См. также: W3C - CSS Color Module Level 4
+/// @link https://www.w3schools.com/sass/sass_data_types.php См. также: W3Schools - Типы данных Sass
+/// @link https://www.sitepoint.com/5-things-you-might-not-know-about-sass/#typeof См. также: SitePoint - 5 вещей о Sass
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/ См. также: CSS-Tricks - Продвинутая проверка типов в Sass
+/// @link https://webplatform.news/issues/2023-07-12 См. также: WebPlatform News - Цвета в CSS
+///	@example scss - Проверка статических значений
+///		@debug is-color(#ff0000); // true
+///		@debug is-color(rgb(255, 0, 0)); // true
+///		@debug is-color(red); // true
+///		@debug is-color("red"); // false (строка, не цвет!)
+///		@debug is-color(16px); // false
+///		@debug is-color(null); // false
+///
+///	@example scss - Обработка динамических значений
+///		@mixin apply-color($value) {
+///			@if is-color($value) {
+///				color: $value;
+///			} @else {
+///				@warn "Ожидался цвет, получено: #{$value}. Используется значение по умолчанию.";
+///				color: #333;
+///			}
+///		}
+///
+///		.test {
+///			@include apply-color(#ffffff);
+///		}
+///	@example css - Результат
+/// 	.test {
+/// 		color: #ffffff;
+/// 	}
+///	@example scss - Валидация в дизайн-системе
+///		:root {
+///
+///			$custom-color: var(--user-color, #3498db);
+///
+///			@if is-color($custom-color) {
+///				--validated-color: #{$custom-color};
+///			} @else {
+///				--validated-color: #3498db;
+///			}
+///
+///		}
+///	@example css - Результат
+/// 	:root {
+/// 		--validated-color: #3498db;
+/// 	}
+/// @param {*} $value - Произвольное значение для проверки.
+/// 	Может быть любого типа: строка, число, список, карта,
+/// 	цвет, логическое значение и т.д.
+/// @return {Boolean} - Возвращает `true`, если значение
+/// 	является цветом, и `false` в противном случае.
+/// 	Распознает все форматы цветов, поддерживаемые Sass:
+/// - HEX (`#ff0000`, `#f00`),
+/// - RGB/A (`rgb(255, 0, 0)`, `rgba(255, 0, 0, 0.5)`),
+/// - HSL/A (`hsl(0, 100%, 50%)`, `hsla(0, 100%, 50%, 0.5)`),
+/// - Именованные цвета (`red`, `blue`, `transparent`, `currentColor`),
+/// - Цвета в новых пространствах (`lab()`, `lch()`, `oklab()`, `oklch()`),
+/// - CSS-переменные (если они ссылаются на цвета)
+@function is-color($value) {
+	@return meta.type-of($value) == color;
+}
+
+
+
+

package/modules/utilities/validators/type-of/_is-list.scss

@@ -0,0 +1,105 @@
+@use 'sass:list';
+@use 'sass:meta';
+
+/// Проверяет, является ли значение списком
+/// (list) или списком аргументов (arglist).
+///
+/// Функция определяет, относится ли переданное
+/// значение к типам данных "список" в Sass.
+/// Проверяет как обычные списки (list), так и
+/// списки аргументов (arglist), которые используются
+/// в миксинах и функциях для передачи переменного
+/// количества параметров.
+/// ---
+/// @name is-list
+/// @group utilities-validators
+/// @since 2025.12.27
+/// @access public
+/// @author takamoso
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @link https://github.com/takamoso GitHub - takamoso
+/// @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/values/lists См. также: Официальная документация Sass - Тип данных "Списки" (Lists)
+/// @link https://sass-lang.com/documentation/values/lists#arglists См. также: Официальная документация Sass - Arglist (списки аргументов)
+/// @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/list-style-type См. также: MDN Web Docs - CSS свойство list-style-type
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_lists См. также: MDN Web Docs - Работа со списками в CSS
+/// @link https://www.w3schools.com/sass/sass_functions_list.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/36885966/sass-get-first-item-from-a-list См. также: 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/lists/ См. также: web.dev - Изучение CSS списков
+/// @link https://frontender.info/sass-lists/ См. также: Frontender Magazine - Работа со списками в Sass
+/// @link https://habr.com/ru/post/156549/ См. также: Habr - Статья "Sass для верстальщика: списки и циклы"
+/// @link https://www.sitepoint.com/using-sass-maps/ См. также: SitePoint - Использование карт (maps) в Sass
+/// @link https://www.freecodecamp.org/news/how-to-use-lists-in-sass/ См. также: freeCodeCamp - Как использовать списки в Sass
+/// @link https://code.tutsplus.com/tutorials/understanding-sass-lists--cms-22020 См. также: Envato Tuts+ - Понимание списков в Sass
+/// @link https://dev.to/kathryngrayson/using-sass-list-functions-4lp См. также: Dev.to - Использование функций для работы со списками в Sass
+/// @link https://css-live.ru/vecssti-i-sovety/vse-o-spiskax-v-sass.html См. также: CSS-Live - Все о списках в Sass
+/// @link https://itchief.ru/sass/cycles-and-lists См. также: itchief - Циклы и списки в Sass
+/// @link https://htmlacademy.ru/blog/boost/tools/sass-3 См. также: HTML Academy - Sass: списки, циклы, условия
+/// @link https://metanit.com/web/html5/13.6.php См. также: Metanit - Списки и циклы в Sass
+/// @link https://ru.hexlet.io/courses/sass-basics/lessons/conditionals/theory_unit См. также: Hexlet - Условные операторы и списки в Sass
+/// @link https://www.youtube.com/watch?v=roywYSEPSvc См. также: YouTube - Sass Tutorial #10 - Lists (The Net Ninja)
+/// @link https://www.youtube.com/watch?v=BIz02qY5BRA См. также: 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/list/ См. также: 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/null См. также: Документация Sass - Значение null
+/// @link https://sass-lang.com/documentation/values/maps См. также: Документация Sass - Карты (maps)
+/// @link https://sass-lang.com/documentation/interpolation См. также: Документация Sass - Интерполяция
+/// @link https://sass-lang.com/documentation/at-rules/mixin#taking-arbitrary-arguments См. также: Документация Sass - Прием произвольных аргументов (arglist)
+/// @link https://sass-lang.com/documentation/at-rules/function#taking-arbitrary-arguments См. также: Документация Sass - Функции с произвольными аргументами
+/// @link https://sass-lang.com/documentation/modules/list#functions-in-the-list-module См. также: Документация Sass - Функции модуля list
+/// @example scss - Проверка списков
+/// 	$simple-list: 1, 2, 3;
+/// 	$nested-list: (1, 2), (3, 4);
+/// 	$single-item: (1,);
+/// 	$empty-list: ();
+///
+/// 	@debug is-list($simple-list); // true
+/// 	@debug is-list($nested-list); // true
+/// 	@debug is-list($single-item); // true
+/// 	@debug is-list($empty-list);  // true
+/// @example scss - Проверка других типов
+/// 	@debug is-list(42);						// false
+/// 	@debug is-list("text");				// false
+/// 	@debug is-list(true);					// false
+/// 	@debug is-list(#fff);					// false
+/// 	@debug is-list((key: value)); // false (это map)
+/// @example scss - Использование с миксинами
+/// 	@mixin custom-mixin($items...) {
+/// 		@if is-list($items) {
+/// 			@each $item in $items {
+/// 				// Обработка каждого элемента списка
+/// 			}
+/// 		}
+/// 	}
+/// @example scss - Валидация параметров
+/// 	@function join-lists($list1, $list2) {
+/// 		@if not is-list($list1) or not is-list($list2) {
+/// 			@error "Оба параметра должны быть списками";
+/// 		}
+/// 		@return join($list1, $list2);
+/// 	}
+/// @param {*} $value - Проверяемое значение
+/// @return {Boolean} - `true` если значение является
+/// 	списком или списком аргументов, `false` во всех
+/// 	остальных случаях.
+@function is-list($value) {
+	@return meta.type-of($value) == list or meta.type-of($value) == arglist;
+}

package/modules/utilities/validators/type-of/_is-map.scss

@@ -0,0 +1,105 @@
+@use 'sass:meta';
+
+/// Проверяет, является ли значение ассоциативным
+/// массивом (map).
+///
+/// Функция определяет, относится ли переданное
+/// значение к типу данных "map" в Sass.
+/// Map представляет собой коллекцию пар ключ-значение
+/// и используется для хранения структурированных данных,
+/// конфигураций и тематических настроек.
+/// ---
+/// @name is-map
+/// @group utilities-validators
+/// @since 2025.12.27
+/// @access public
+/// @author takamoso
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @link https://github.com/takamoso GitHub - takamoso
+/// @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/values/maps См. также: Официальная документация Sass - Тип данных "Карты" (Maps)
+/// @link https://sass-lang.com/documentation/modules/map См. также: Официальная документация Sass - Модуль map
+/// @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/map См. также: MDN Web Docs - CSS тип данных map()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_functions См. также: MDN Web Docs - CSS функции
+/// @link https://www.w3schools.com/sass/sass_functions_map.php См. также: W3Schools - Функции для работы с картами в Sass
+/// @link https://www.sass.hk/docs/ См. также: Китайская документация Sass - Полное руководство
+/// @link https://sass-guidelin.es/ru/#maps См. также: Sass Guidelines - Руководство по использованию карт в Sass
+/// @link https://github.com/sass/sass/blob/main/accepted/module-system.md См. также: GitHub - Документация по модульной системе Sass
+/// @link https://stackoverflow.com/questions/21192078/sass-check-if-map-has-key См. также: Stack Overflow - Проверка наличия ключа в карте Sass
+/// @link https://stackoverflow.com/questions/21768988/how-to-check-for-a-map-in-sass См. также: Stack Overflow - Как проверить, является ли значение картой в Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://web.dev/learn/css/functions/ См. также: web.dev - Изучение CSS функций
+/// @link https://frontender.info/sass-maps/ См. также: Frontender Magazine - Работа с картами в Sass
+/// @link https://habr.com/ru/post/247881/ См. также: Habr - Статья "Sass для верстальщика: карты (maps)"
+/// @link https://www.sitepoint.com/using-sass-maps/ См. также: SitePoint - Использование карт в Sass
+/// @link https://www.freecodecamp.org/news/sass-maps/ См. также: freeCodeCamp - Карты в Sass
+/// @link https://code.tutsplus.com/tutorials/understanding-sass-maps--cms-22184 См. также: Envato Tuts+ - Понимание карт в Sass
+/// @link https://dev.to/kathryngrayson/sass-maps-43cn См. также: Dev.to - Карты в Sass
+/// @link https://css-live.ru/articles/karty-v-sass-samaya-polnaya-statya.html См. также: CSS-Live - Карты в Sass: самая полная статья
+/// @link https://itchief.ru/sass/maps См. также: itchief - Карты в Sass
+/// @link https://htmlacademy.ru/blog/boost/tools/sass-maps См. также: HTML Academy - Карты в Sass
+/// @link https://metanit.com/web/html5/13.7.php См. также: Metanit - Карты в Sass
+/// @link https://ru.hexlet.io/courses/sass-basics/lessons/maps/theory_unit См. также: Hexlet - Карты в Sass
+/// @link https://www.youtube.com/watch?v=7uUaU0KpO3Y См. также: YouTube - Sass Tutorial #11 - Maps (The Net Ninja)
+/// @link https://www.youtube.com/watch?v=8y-6p8n8Vc8 См. также: 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/declaration-property-value/ См. также: 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/lists См. также: Документация Sass - Списки
+/// @link https://sass-lang.com/documentation/values/colors См. также: Документация Sass - Цвета
+/// @link https://sass-lang.com/documentation/values/null См. также: Документация Sass - Значение `null`
+/// @link https://sass-lang.com/documentation/interpolation См. также: Документация Sass - Интерполяция
+/// @link https://sass-lang.com/documentation/modules/map#functions-in-the-map-module См. также: Документация Sass - Функции модуля map
+/// @link https://sass-lang.com/documentation/modules/map#keys См. также: Документация Sass - Функция `map.keys()`
+/// @link https://sass-lang.com/documentation/modules/map#values См. также: Документация Sass - Функция `map.values()`
+/// @link https://sass-lang.com/documentation/modules/map#get См. также: Документация Sass - Функция `map.get()`
+/// @link https://sass-lang.com/documentation/modules/map#merge См. также: Документация Sass - Функция `map.merge()`
+/// @link https://sass-lang.com/documentation/modules/map#remove См. также: Документация Sass - Функция `map.remove()`
+/// @example scss - Проверка map
+/// 	$color-map: (primary: blue, secondary: green);
+/// 	$config-map: (font-size: 16px, spacing: 10px);
+/// 	$nested-map: (colors: (primary: red, secondary: blue));
+/// 	$empty-map: ();
+///
+/// 	@debug is-map($color-map);		// true
+/// 	@debug is-map($config-map);		// true
+/// 	@debug is-map($nested-map);		// true
+/// 	@debug is-map($empty-map);		// true
+/// @example scss - Проверка других типов
+/// 	@debug is-map((1, 2, 3));	// false (это list)
+/// 	@debug is-map("hello");		// false
+/// 	@debug is-map(42);				// false
+/// 	@debug is-map(true);			// false
+/// @example scss - Использование для безопасного доступа к map
+/// 	@function map-get-safe($map, $key) {
+/// 		@if not is-map($map) {
+/// 		@warn "Первый параметр должен быть map";
+/// 			@return null;
+/// 		}
+/// 		@return map.get($map, $key);
+/// 	}
+/// @example scss - Валидация конфигурационных объектов
+/// 	@mixin configure($config) {
+/// 		@if not is-map($config) {
+/// 			@error "Конфигурация должна быть передана в виде map";
+/// 		}
+/// 		// Применение конфигурации
+/// 	}
+/// @param {*} $value - Проверяемое значение
+/// @return {Boolean} - `true` если значение является
+/// 	ассоциативным массивом (map), `false` во всех
+/// 	остальных случаях.
+@function is-map($value) {
+  @return meta.type-of($value) == map;
+}