@omnisass/library 0.2.0 → 2026.1.0-alpha.1

package/modules/utilities/getters/list/_get-list-item.scss

@@ -1,10 +1,5 @@
-@use 'sass:list';
-@use 'sass:map';
 @use './get-list-item-start' as *;
 @use './get-list-item-end' as *;
-@use '../../loggers/log-invalid-value' as *;
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-string' as *;
 
 /// Возвращает первый или последний элемент списка.
 ///
@@ -28,7 +23,7 @@
 /// ---
 /// @name get-list-item
 /// @group utilities-getters
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -95,85 +90,14 @@
 /// 	некорректных значений `$direction` возвращает `null`.
 @function get-list-item($list, $direction: 'start') {
 
-	// Переменная для хранения результата функции
-	// Инициализируем пустой строкой, но тип может
-	// измениться в зависимости от функций get-list-item-start/end
-	$-result: '';
-
-	// ВАЛИДАЦИЯ ПАРАМЕТРА $direction
-
-	// 1. Проверка типа: параметр `$direction` должен быть строкой.
-	// Используем вспомогательную функцию is-string. Если тип не
-	// `string`, выводим отладочное сообщение через
-	// `log-invalid-type`:
-	@if not is-string($direction) {
-		@debug log-invalid-type(
-			'get-list-item',
-			$direction,
-			'$direction',
-			'string'
-		);
-	}
-
-	// 2. Проверка значения: `$direction` должен быть `'start'`
-	// или `'end'`.
-	// Используем функцию `list.index` для поиска значения в списке.
-	// Если `direction` не найден в списке `('start' 'end')`, выводим
-	// сообщение об ошибке значения. Важно: эта проверка выполняется
-	// только если первая проверка прошла (или пропущена).
-	@if not list.index('start' 'end', $direction) {
-		@debug log-invalid-value(
-			'get-list-item',
-			$direction,
-			'$direction',
-			('start', 'end')
-		);
-	} @else {
-
-		// Если обе проверки пройдены (или не выполнялись из-за
-		// логики условия), переходим к основной логике функции.
-
-		// СОЗДАНИЕ КАРТЫ (MAP) ДЛЯ ВЫБОРА НУЖНОЙ ФУНКЦИИ
-		// Карта связывает строковые ключи с результатами
-		// соответствующих функций. Это элегантная альтернатива
-		// конструкции if-else.
-		$-directions: (
-			'start': get-list-item-start($list),  // Вызываем функцию для получения первого элемента
-			'end': get-list-item-end($list)       // Вызываем функцию для получения последнего элемента
-		);
-
-		// ПОЛУЧЕНИЕ РЕЗУЛЬТАТА ИЗ КАРТЫ
-		// Используем функцию `map.get` для получения значения по
-		// ключу `$direction`:
-		// - Если `$direction = 'start'`, получим результат `get-list-item-start($list)`
-		// - Если `$direction = 'end'`, получим результат `get-list-item-end($list)`
-
-		// Альтернативный подход: использовать прямое условие:
-		// `if(sass($direction == "start"): get-list-item-start($list); else: get-list-item-end($list))`
-		// Но карта более масштабируема для добавления новых
-		// направлений.
-		$-result: map.get($-directions, $direction);
-
-		// Примечание: если бы у нас было больше вариантов, можно
-		// было бы добавить их в карту:
-		// - `'middle': get-list-item-middle($list),`
-		// - `'second': get-list-item-second($list),`
-		// и т.д.
+	$-result: null;
 
+	@if $direction == 'start' {
+		$-result: get-list-item-start($list);
+	} @else if $direction == 'end' {
+		$-result: get-list-item-end($list);
 	}
 
-	// (!) Важно: мы не проводим проверку на тип `arglist` и/или
-	// `list`, поскольку эти операции уже реализованы в функциях
-	// `get-list-item-start` и `get-list-item-end`.
-
-	// ВОЗВРАТ РЕЗУЛЬТАТА
-	// - Если были ошибки валидации, вернется пустая строка
-	// 	  (инициализированное значение)
-	// - Если валидация прошла, вернется результат соответствующей
-	// 	  функции
-	// (!) Важно: функция `log-invalid-type` и `log-invalid-value`
-	// возвращают `null`, но здесь мы его не используем, поэтому
-	// ошибки только логируются, но не влияют на поток выполнения.
 	@return $-result;
 
 }

package/modules/utilities/getters/number/_get-number-from-percent.scss

@@ -1,6 +1,4 @@
 @use 'sass:math';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-number' as *;
 
 /// Вычисляет абсолютное значение по проценту от целого.
 ///
@@ -19,7 +17,7 @@
 /// ---
 /// @name get-number-from-percent
 /// @group utilities-getters
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -99,41 +97,5 @@
 /// 	не содержит единицы измерения '%' или если параметры
 /// 	не являются числами.
 @function get-number-from-percent($percentage, $whole) {
-
-	// ВАЛИДАЦИЯ ВХОДНЫХ ПАРАМЕТРОВ
-	// Проверяем, что `$percentage` является числом. Используем
-	// вспомогательную функцию `is-number` для проверки типа
-	@if not is-number($percentage) {
-
-		// Если `$percentage` не число, логируем ошибку типа.
-		// `log-invalid-type` выводит информативное сообщение об ошибке
-		@return log-invalid-type(
-			'get-number-from-percent',
-			$percentage,
-			'$percentage',
-			'number'
-		);
-
-	} @else if not is-number($whole) {
-
-		// Проверяем, что `$whole` является числом.
-		// Эта проверка выполняется только если первая проверка
-		// пройдена. Если `$percentage` не число, мы сюда не
-		// попадем из-за `@else if`
-		@return log-invalid-type(
-			'get-number-from-percent',
-			$whole,
-			'$whole',
-			'number'
-		);
-
-	} @else {
-
-		// ОСНОВНАЯ ЛОГИКА ФУНКЦИИ
-		// Оба параметра прошли валидацию
-		// Вычисляем результат: (процент / 100%) * целое
-		@return math.div($percentage, 100%) * $whole;
-
-	}
-
+	@return math.div($percentage, 100%) * $whole;
 }

package/modules/utilities/getters/number/_get-number-height-by-ratio.scss

@@ -1,6 +1,4 @@
 @use 'sass:math';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-number' as *;
 
 /// Вычисляет высоту на основе ширины и соотношения сторон.
 ///
@@ -44,7 +42,7 @@
 /// ---
 /// @name get-number-height-by-ratio
 /// @group utilities-getters
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -153,43 +151,13 @@
 /// 	`$ratio = 0`. Это соответствует математически невозможной
 /// 	ситуации, когда высота была бы бесконечной.
 @function get-number-height-by-ratio($width, $ratio) {
-
-	@if not is-number($width) {
-
-		// Логируем ошибку: неверный тип параметра $width
-		@return log-invalid-type(
-			'get-number-height-by-ratio',
-			$width,
-			'$width',
-			'number'
-		);
-
-	} @else if not is-number($ratio) {
-
-		// Логируем ошибку: неверный тип параметра $ratio
-		@return log-invalid-type(
-			'get-number-height-by-ratio',
-			$ratio,
-			'$ratio',
-			'number'
-		);
-
-	} @else {
-
-		// Оба параметра корректны, вычисляем высоту
-		// Используется функция math.div для деления ширины
-		// на соотношение (более безопасная альтернатива
-		// обычному оператору / в Sass)
-		@return math.div($width, $ratio);
-
-	}
-
+	@return math.div($width, $ratio);
 }
 
 /// @name get-height-by-ratio
 /// @alias get-number-height-by-ratio
 /// @group utilities-aliases
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

package/modules/utilities/getters/number/_get-number-max-safe.scss

@@ -0,0 +1,112 @@
+@use 'sass:math';
+@use 'sass:meta';
+@use '../../validators' as validators; // need type-of/is-number
+
+/// Безопасно находит максимальное числовое значение в
+/// списке с проверкой совместимости единиц.
+///
+/// Функция проходит по всем элементам списка и находит
+/// наибольшее числовое значение, при этом проверяя
+/// совместимость единиц измерения всех чисел с использованием
+/// функции `math.compatible()`. Числа с несовместимыми
+/// единицами измерения пропускаются с выводом предупреждения
+/// в консоль.
+///
+/// Ключевые особенности функции:
+/// - Использует `math.compatible()` для строгой проверки
+/// 	совместимости единиц
+/// - Принимает только числа с совместимыми единицами измерения
+/// - Использует первое найденное число как эталон для проверки
+/// 	совместимости
+/// - Пропускает числа с несовместимыми единицами с выводом
+/// 	предупреждения
+/// - Игнорирует нечисловые элементы без предупреждений
+/// - Возвращает `null` если нет совместимых числовых элементов
+/// - Использует локальные переменные с префиксом `$-` для
+/// 	избежания конфликтов
+/// - Безразмерные числа не совместимы с размерными (10 и 10px =
+/// 	несовместимы)
+/// ---
+/// @name get-number-max-safe
+/// @group utilities-getters
+/// @since 0.0.1
+/// @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/math#compatible См. также: Официальная документация Sass - Функция math.compatible()
+/// @link https://sass-lang.com/documentation/values/numbers#units См. также: Официальная документация Sass - Совместимость единиц измерения
+/// @link https://sass-lang.com/documentation/modules/math#max См. также: Официальная документация Sass - Функция math.max()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/max MDN Web Docs - CSS функция max()
+/// @link https://stackoverflow.com/questions/19088270/find-the-highest-number-in-a-list-with-sass Stack Overflow - Поиск наибольшего числа в списке Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#list-functions См. также: Sass Guidelines - Функции для работы со списками
+/// @link https://frontender.info/sass-lists/ См. также: 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 get-number-max-safe((10px, 20px, 30px));       // 30px
+/// 	@debug get-number-max-safe((1rem, 2.5rem, 0.5rem));   // 2.5rem
+/// 	@debug get-number-max-safe((50%, 30%, 80%));          // 80%
+/// 	@debug get-number-max-safe((10, 20, 30));             // 30
+/// @example scss - Обработка чисел с несовместимыми единицами
+/// 	@debug get-number-max-safe((10px, 2em, 30px));
+/// 	// [WARNING] Пропускаю элемент 2em: несовместимые единицы
+/// 	// Возвращает: 30px (максимум среди совместимых px значений)
+/// @example scss - Смешанные типы данных
+/// 	@debug get-number-max-safe((10, "текст", 30, #fff, 20)); // 30
+/// 	@debug get-number-max-safe((true, false, null, 5));     // 5
+/// 	@debug get-number-max-safe(("only", "strings"));        // null
+/// @example scss - Обработка разных систем единиц
+/// 	@debug get-number-max-safe((10px, 20px, 2cm));
+/// 	// [WARNING] Пропускаю элемент 2cm: несовместимые единицы
+/// 	// Возвращает: 20px (только совместимые px значения)
+///
+/// 	@debug get-number-max-safe((1in, 25.4mm, 2.54cm));      // 1in (все совместимы)
+/// @example scss - Пустые списки и крайние случаи
+/// 	@debug get-number-max-safe(());                        // null
+/// 	@debug get-number-max-safe(none);                      // null
+/// 	@debug get-number-max-safe((10px));                    // 10px
+/// 	@debug get-number-max-safe((-10, -5, -20));            // -5
+/// 	@debug get-number-max-safe((10px, 15));                // 15
+/// @example scss - Практическое использование для адаптивных размеров
+/// 	$breakpoints: 320px, 768px, 1024px, 1280px;
+/// 	@debug get-number-max-safe($breakpoints); // 1280px
+/// @example scss - Поиск максимального размера шрифта с разными единицами
+/// 	$font-sizes: 12px, 14px, 1rem, 16px, 1.2rem;
+/// 	@debug get-number-max-safe($font-sizes);
+/// 	// [WARNING] Пропускаю элемент 1rem: несовместимые единицы
+/// 	// [WARNING] Пропускаю элемент 1.2rem: несовместимые единицы
+/// 	// Возвращает: 16px (максимум среди px значений)
+/// @see get-number-max
+/// @param {List} $list - Список значений, который может
+/// 	содержать элементы разных типов. Функция будет
+/// 	обрабатывать только числовые элементы, нечисловые
+/// 	элементы игнорируются без предупреждений.
+/// @return {Number | Null} - Максимальное числовое значение
+/// 	из совместимых чисел в списке или `null`, если в списке
+/// 	нет совместимых числовых элементов. Сохраняет единицы
+/// 	измерения найденного максимального значения.
+/// @throws {Warning} - Выводит предупреждение в консоль при о
+/// 	бнаружении чисел с несовместимыми единицами измерения
+/// 	относительно первого найденного числа.
+/// 	Формат: `[WARNING] Пропускаю элемент {значение}:
+/// 	несовместимые единицы`
+@function get-number-max-safe($list) {
+
+	$-max: null;
+
+	@each $-item in $list {
+		@if validators.is-number($-item) {
+			@if $-max == null or math.compatible($-max, $-item) {
+				@if $-max == null or $-item > $-max {
+					$-max: $-item;
+				}
+			} @else {
+				@warn "⚠️  Пропускаю элемент «#{meta.inspect($-item)}»: несовместимые единицы";
+			}
+		}
+	}
+
+	@return $-max;
+}

package/modules/utilities/getters/number/_get-number-max.scss

@@ -1,6 +1,4 @@
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-number' as *;
-@use '../../validators/type-of/is-list' as *;
+@use '../../validators' as validators; // need type-of/is-number
 
 /// Находит максимальное числовое значение в списке.
 ///
@@ -23,7 +21,7 @@
 /// ---
 /// @name get-number-max
 /// @group utilities-getters
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -64,6 +62,7 @@
 /// @example scss - Поиск максимальной ширины контейнера
 /// 	$container-widths: 320px, 768px, 1024px, 1280px;
 /// 	@debug get-number-max($container-widths); // $max-width: 1280px
+/// @see get-number-max-safe
 /// @param {List} $list - Список значений, который может
 /// 	содержать элементы разных типов. Функция будет
 /// 	обрабатывать только числовые элементы.
@@ -75,94 +74,17 @@
 /// 	сравнить числа с несовместимыми единицами измерения.
 @function get-number-max($list) {
 
-	// Переменная для хранения текущего максимального значения.
-	// Инициализируется как null, чтобы отслеживать:
-	// 1. Пустые списки (результат останется null)
-	// 2. Первое найденное число (будет присвоено $-result)
-	$-result: null;
-
-	// Первичная валидация входных данных.
-	// Убеждаемся, что переданный аргумент является
-	// списком или arglist.
-	@if not is-list($list) {
-
-		// Если $list не является списком, логируем
-		// ошибку и прерываем выполнение.
-		@return log-invalid-type(
-			'get-number-max',
-			$list,
-			'$list',
-			('list', 'arglist')
-		);
-
-	}
-
-	// Основная логика выполняется только если валидация прошла
-	// успешно.
-	// Блок @else гарантирует, что код ниже выполняется только
-	// для корректных списков.
-	@else {
-
-		// Итерация по всем элементам списка.
-		@each $-item in $list {
-
-			// Проверка типа текущего элемента.
-			// Функция is-number возвращает true только для:
-			// - Целых чисел (42)
-			// - Дробных чисел (3.14)
-			// - Чисел с единицами измерения (10px, 2rem, 1.5em)
-			@if is-number($-item) {
-
-				// Обновление значения максимума.
-				// Условие проверяет два случая:
-				// 1. $-result == null: это первое найденное число
-				// 2. $-item > $-result: текущее число больше текущего
-				// 	   максимума
-				// Оператор > в Sass работает с учетом единиц измерения,
-				// но требует их совместимости (например, нельзя
-				// сравнить 10px и 2em).
-				@if $-result == null or $-item > $-result {
-					$-result: $-item;
-				}
+	$-max: null;
 
+	@each $-item in $list {
+		@if validators.is-number($-item) {
+			@if $-max == null or $-item > $-max {
+				$-max: $-item;
 			}
-
-			// Обработка нечисловых элементов.
-			// Если is-number($-item) вернул false, элемент имеет
-			// неподдерживаемый тип (строка, булево значение, null,
-			// карта и т.д.).
-			@else {
-
-				// Ветка обработки ошибок: элемент не является числом.
-				// Прерываем выполнение функции при первом же нечисловом
-				// элементе. Это "безопасный" подход - лучше явная
-				// ошибка, чем неявное некорректное поведение.
-				//
-				// (!) Важно: функция не пытается пропустить нечисловые
-				// элементы или преобразовать их - она строго требует
-				// числового ввода.
-				@return log-invalid-type(
-					'get-number-max',
-					$-item,
-					'$-item',
-					'number'
-				);
-
-			}
-
 		}
-
 	}
 
-	// Возвращаем результат.
-	// Возможные значения:
-	// - null: если список был пустой (не содержал элементов)
-	// - число: максимальное значение из списка
-	//
-	// Если функция дошла до этой точки, значит:
-	// 1. $list был корректным списком
-	// 2. Все элементы списка были числами
-	// 3. Не было вызвано ни одной ошибки через log-invalid-type
-	@return $-result;
+	@return $-max;
 
 }
+

package/modules/utilities/getters/number/_get-number-min-safe.scss

@@ -0,0 +1,114 @@
+@use 'sass:meta';
+@use 'sass:math';
+@use '../../validators' as validators; // need type-of/is-number
+
+/// Безопасно находит минимальное числовое значение в списке
+/// с проверкой совместимости единиц измерения.
+///
+/// Функция проходит по всем элементам списка и находит
+/// наименьшее числовое значение, при этом проверяя
+/// совместимость единиц измерения всех чисел с использованием
+/// функции `math.compatible()`. Числа с несовместимыми
+/// единицами измерения пропускаются с выводом предупреждения в
+/// консоль.
+///
+/// Важные особенности функции:
+/// - Использует `math.compatible()` для строгой проверки
+/// 	совместимости единиц
+/// - Принимает только числа с совместимыми единицами измерения
+/// - Использует первое найденное число как эталон для проверки
+/// 	совместимости
+/// - Пропускает числа с несовместимыми единицами с выводом
+/// 	предупреждения
+/// - Игнорирует нечисловые элементы без предупреждений
+/// - Возвращает `null` если нет совместимых числовых элементов
+/// - Использует локальные переменные с префиксом `$-` для
+/// 	избежания конфликтов
+/// - Безразмерные числа не совместимы с размерными (10 и 10px =
+/// 	несовместимы)
+/// ---
+/// @name get-number-min-safe
+/// @group utilities-getters
+/// @since 0.0.1
+/// @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/math#compatible См. также: Официальная документация Sass - Функция math.compatible()
+/// @link https://sass-lang.com/documentation/values/numbers#units См. также: Официальная документация Sass - Совместимость единиц измерения
+/// @link https://sass-lang.com/documentation/modules/math#min См. также: Официальная документация Sass - Функция math.min()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/min MDN Web Docs - CSS функция min()
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#list-functions См. также: Sass Guidelines - Функции для работы со списками
+/// @link https://frontender.info/sass-lists/ См. также: 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 get-number-min-safe((10px, 20px, 5px));       // 5px
+/// 	@debug get-number-min-safe((2.5rem, 0.8rem, 1rem));  // 0.8rem
+/// 	@debug get-number-min-safe((75%, 50%, 25%));         // 25%
+/// 	@debug get-number-min-safe((15, 8, 23));             // 8
+/// @example scss - Обработка несовместимых единиц с предупреждениями
+/// 	@debug get-number-min-safe((30px, 2em, 15px));
+/// 	// [WARNING] Пропускаю элемент «2em»: несовместимые единицы
+/// 	// Возвращает: 15px (только совместимые px)
+///
+/// 	@debug get-number-min-safe((100px, 5, 50px)); // 5
+/// @example scss - Разные единицы длины (совместимые)
+/// 	@debug get-number-min-safe((1in, 25.4mm, 2.54cm)); // 1in
+/// 	@debug get-number-min-safe((16px, 1pc, 12pt));     // 16px
+/// @example scss - Разные единицы длины (несовместимые)
+/// 	@debug get-number-min-safe((10vw, 20px, 5vh));
+/// 	// [WARNING] Пропускаю элемент «20px»: несовместимые единицы
+/// 	// [WARNING] Пропускаю элемент «5vh»: несовместимые единицы
+/// 	// Возвращает: 10vw (только viewport единицы между собой)
+/// @example scss - Смешанные типы данных
+/// 	@debug get-number-min-safe((45, "игнорируется", 15, #ff0000, 30)); // 15
+/// 	@debug get-number-min-safe((true, false, (1, 2), 8));              // 8
+/// 	@debug get-number-min-safe(("только", "строки", null));            // null
+/// @example scss - Отрицательные значения и ноль
+/// 	@debug get-number-min-safe((-10px, -25px, -5px)); // -25px
+/// 	@debug get-number-min-safe((0, -15, 10));         // -15
+/// 	@debug get-number-min-safe((0px, 10px, -5px));    // -5px
+/// @example scss - Практическое использование: минимальные отступы
+/// 	$margins: 20px, 15px, "auto", 10px, 25px;
+/// 	@debug get-number-min-safe($margins); // 10px ("auto" игнорируется)
+/// @example scss - Практическое использование: минимальный размер шрифта
+/// 	$font-sizes: 16px, 1.2rem, 14px, 1rem, 18px;
+/// 	@debug get-number-min-safe($font-sizes);
+/// 	// [WARNING] Пропускаю элемент «1.2rem»: несовместимые единицы
+/// 	// [WARNING] Пропускаю элемент «1rem»: несовместимые единицы
+/// 	// $min-font: 14px
+/// @example scss - Практическое использование: медиа-запросы
+/// 	$breakpoints: 320px, 480px, 768px, 1024px;
+/// 	@debug get-number-min-safe($breakpoints); // 320px
+/// @see get-number-min
+/// @param {List} $list - Список значений, который может
+/// 	содержать элементы разных типов. Функция будет
+/// 	обрабатывать только числовые элементы.
+/// @return {Number | Null} - Минимальное числовое значение из
+/// 	совместимых чисел в списке или `null`, если в списке
+/// 	нет совместимых числовых элементов. Сохраняет единицы
+/// 	измерения найденного минимального значения.
+/// @throws {Warning} - Выводит предупреждение в консоль при
+/// 	обнаружении чисел с несовместимыми единицами измерения
+/// 	относительно первого найденного числа. Формат:
+/// 	`[WARNING] Пропускаю элемент «{значение}»: несовместимые
+/// 	единицы`
+@function get-number-min-safe($list) {
+	$-min: null;
+
+	@each $-item in $list {
+		@if validators.is-number($-item) {
+			@if $-min == null or math.compatible($-min, $-item) {
+				@if $-min == null or $-item < $-min {
+					$-min: $-item;
+				}
+			} @else {
+				@warn "⚠️ Пропускаю элемент «#{meta.inspect($-item)}»: несовместимые единицы";
+			}
+		}
+	}
+
+	@return $-min;
+}