@omnisass/library 0.2.0 → 2026.1.0-alpha.1

package/modules/utilities/helpers/color/_color-hue-shift.scss

@@ -1,7 +1,4 @@
 @use 'sass:color';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-color' as *;
-@use '../../validators/type-of/is-number' as *;
 
 /// Поворачивает цветовой тон (hue) цвета на заданное
 /// количество градусов.
@@ -23,7 +20,7 @@
 /// ---
 /// @name color-hue-shift
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -86,63 +83,12 @@
 /// 	насыщенности и светлоты.
 @function color-hue-shift($color, $degrees) {
 
-	// Проверка типа первого параметра: ожидается цветовое значение.
-	// Функция is-color() проверяет, является ли $color валидным цветом CSS.
-	@if not is-color($color) {
+	$-new-hue: (color.channel($color, "hue", $space: hsl) + $degrees) % 360;
 
-		// Если $color не является цветом, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с нецветовыми данными.
-		@return log-invalid-type(
-			'color-hue-shift',
-			$color,
-			'$color',
-			'color'
-		);
-
-	}
-
-	// Проверка типа второго параметра: ожидается числовое значение
-	// угла поворота в градусах. Положительные значения вращают цвет
-	// по часовой стрелке на цветовом круге, отрицательные - против.
-	@else if not is-number($degrees) {
-
-		// Если $degrees не является числом, возвращаем ошибку.
-		@return log-invalid-type(
-			'color-hue-shift',
-			$degrees,
-			'$degrees',
-			'number'
-		);
-
-	}
-
-	// Все параметры прошли валидацию - выполняем изменение оттенка.
-	@else {
-
-		// Вычисление нового значения оттенка (hue).
-		// Формула: (текущий оттенок + угол поворота) по модулю 360.
-		// Оператор % 360 гарантирует, что результат всегда будет
-		// в диапазоне от 0 до 359 градусов (цветовой круг).
-		// color.channel() извлекает компонент оттенка из цвета
-		// в пространстве HSL.
-		$-new-hue: (color.channel($color, "hue", $space: hsl) + $degrees) % 360;
-
-		// Создание нового цвета с измененным оттенком.
-		// Используем функцию hsl() для создания цвета в формате HSL.
-		// Компоненты:
-		// - $-new-hue: новый оттенок после поворота
-		// - saturation: насыщенность исходного цвета (сохраняется)
-		// - lightness: яркость исходного цвета (сохраняется)
-		//
-		// Таким образом, меняется только положение цвета на
-		// цветовом круге, сохраняя его насыщенность и яркость.
-		@return hsl(
-			$-new-hue,
-			color.channel($color, "saturation", $space: hsl),
-			color.channel($color, "lightness", $space: hsl)
-		);
-
-	}
+	@return hsl(
+		$-new-hue,
+		color.channel($color, "saturation", $space: hsl),
+		color.channel($color, "lightness", $space: hsl)
+	);
 
 }

package/modules/utilities/helpers/color/_color-scale.scss

@@ -2,9 +2,6 @@
 @use 'sass:list';
 @use 'sass:math';
 @use './color-shade' as *;
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-color' as *;
-@use '../../validators/type-of/is-number' as *;
 
 /// Генерирует монохромную шкалу оттенков путем затемнения
 /// базового цвета.
@@ -19,7 +16,7 @@
 /// ---
 /// @name color-scale
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -131,78 +128,14 @@
 /// - Длина списка = `$steps + 1`
 @function color-scale($color, $steps: 5) {
 
-	// Проверка типа первого параметра: ожидается базовый цвет.
-	// Функция is-color() проверяет, является ли $color валидным цветом CSS.
-	@if not is-color($color) {
-
-		// Если $color не является цветом, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с нецветовыми данными.
-		@return log-invalid-type(
-			'color-scale',
-			$color,
-			'$color',
-			'color'
-		);
+	$-palette: ();
 
+	@for $-i from 0 through $steps {
+		$-percentage: math.div($-i * 100, $steps);
+		$-shade: color-shade($color, $-percentage);
+		$-palette: list.append($-palette, $-shade);
 	}
 
-	// Проверка типа второго параметра: ожидается количество шагов
-	// (уровней) в цветовой шкале. Определяет, сколько оттенков
-	// будет сгенерировано на основе базового цвета.
-	@else if not is-number($steps) {
-
-		// Если $steps не является числом, возвращаем ошибку.
-		@return log-invalid-type(
-			'color-scale',
-			$steps,
-			'$steps',
-			'number'
-		);
-
-	}
-
-	// Все параметры прошли валидацию - выполняем генерацию шкалы.
-	@else {
-
-		// Инициализация списка для хранения цветовой палитры.
-		// Результатом функции будет список (массив) цветов,
-		// представляющих шкалу оттенков базового цвета.
-		$-palette: ();
-
-		// Цикл генерации цветов шкалы.
-		// Переменная $i принимает значения от 0 до $steps включительно.
-		// Это создает $steps + 1 цвет в итоговом списке.
-		@for $i from 0 through $steps {
-
-			// Вычисление процентного значения для текущего шага.
-			// Формула: (текущий шаг) × (100 / общее количество шагов)
-			// Пример для 5 шагов: значения будут 0%, 20%, 40%, 60%,
-			// 80%, 100%.
-			$-percentage: math.div($i * 100, $steps);
-
-			// Генерация оттенка с помощью вспомогательной функции
-			// color-shade().
-			// Предполагается, что color-shade($color, $percentage)
-			// создает оттенок базового цвета с указанной интенсивностью.
-			// - При $percentage = 0% → самый светлый оттенок (близкий
-			//   к белому)
-			// - При $percentage = 100% → самый темный оттенок (близкий
-			//   к черному)
-			$-shade: color-shade($color, $-percentage);
-
-			// Добавление сгенерированного оттенка в палитру.
-			// Функция list.append() добавляет новый элемент в
-			// конец списка.
-			$-palette: list.append($-palette, $-shade);
-
-		}
-
-		// Возвращаем список сгенерированных оттенков.
-		// Список содержит $steps + 1 элементов, равномерно распределенных
-		// по шкале от самого светлого к самому темному оттенку.
-		@return $-palette;
-
-	}
+	@return $-palette;
 
 }

package/modules/utilities/helpers/color/_color-shade.scss

@@ -1,7 +1,4 @@
 @use 'sass:color';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-color' as *;
-@use '../../validators/type-of/is-number' as *;
 
 /// Создает затемненную версию цвета, добавляя к нему
 /// черный цвет.
@@ -16,7 +13,7 @@
 /// ---
 /// @name color-shade
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Kitty Giraudel
 /// @author Murad Rustamov (therteenten) [адаптация]
@@ -54,60 +51,5 @@
 /// @return {Color} - Затемненный цвет в том же формате,
 /// 	что и исходный.
 @function color-shade($color, $percentage) {
-
-	// Проверка типа первого параметра: ожидается базовый цвет.
-	// Функция is-color() проверяет, является ли $color валидным цветом CSS.
-	@if not is-color($color) {
-
-		// Если $color не является цветом, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с нецветовыми данными.
-		@return log-invalid-type(
-			'color-shade',
-			$color,
-			'$color',
-			'color'
-		);
-
-	}
-
-	// Проверка типа второго параметра: ожидается процентное значение
-	// интенсивности затемнения. Определяет, насколько темным будет
-	// итоговый цвет относительно базового.
-	@else if not is-number($percentage) {
-
-		// Если $percentage не является числом, возвращаем ошибку.
-		@return log-invalid-type(
-			'color-shade',
-			$percentage,
-			'$percentage',
-			'number'
-		);
-
-	}
-
-	// Все параметры прошли валидацию - выполняем затемнение цвета.
-	@else {
-
-		// Формула затемнения: смешивание базового цвета с черным
-		// в указанной пропорции.
-		//
-		// Используем встроенную функцию color.mix():
-		// Параметры:
-		// - black: первый цвет для смешивания (черный)
-		// - $color: второй цвет для смешивания (базовый цвет)
-		// - $percentage * 1%: процентное соотношение
-		//   (сколько процентов черного цвета в смеси)
-		//
-		// Математика смешивания:
-		// - При $percentage = 0% → 100% $color, 0% black (исходный цвет)
-		// - При $percentage = 50% → 50% $color, 50% black (среднее затемнение)
-		// - При $percentage = 100% → 0% $color, 100% black (полностью черный)
-		//
-		// Результат: цвет, который является затемненной версией
-		// исходного цвета, где процент определяет степень затемнения.
-		@return color.mix(black, $color, $percentage * 1%);
-
-	}
-
+	@return color.mix(black, $color, $percentage * 1%);
 }

package/modules/utilities/helpers/color/_color-tint.scss

@@ -1,7 +1,4 @@
 @use 'sass:color';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-color' as *;
-@use '../../validators/type-of/is-number' as *;
 
 /// Осветляет исходный цвет, смешивая его с белым.
 ///
@@ -12,7 +9,7 @@
 /// ---
 /// @name color-tint
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Kitty Giraudel
 /// @author Murad Rustamov (therteenten) [адаптация]
@@ -59,60 +56,5 @@
 /// @return {Color} - Осветленный цвет в том же формате,
 /// 	что и входной.
 @function color-tint($color, $percentage) {
-
-	// Проверка типа первого параметра: ожидается базовый цвет.
-	// Функция is-color() проверяет, является ли $color валидным цветом CSS.
-	@if not is-color($color) {
-
-		// Если $color не является цветом, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с нецветовыми данными.
-		@return log-invalid-type(
-			'color-tint',
-			$color,
-			'$color',
-			'color'
-		);
-
-	}
-
-	// Проверка типа второго параметра: ожидается процентное значение
-	// интенсивности осветления. Определяет, насколько светлым будет
-	// итоговый цвет относительно базового.
-	@else if not is-number($percentage) {
-
-		// Если $percentage не является числом, возвращаем ошибку.
-		@return log-invalid-type(
-			'color-tint',
-			$percentage,
-			'$percentage',
-			'number'
-		);
-
-	}
-
-	// Все параметры прошли валидацию - выполняем осветление цвета.
-	@else {
-
-		// Формула осветления: смешивание базового цвета с белым
-		// в указанной пропорции.
-		//
-		// Используем встроенную функцию color.mix():
-		// Параметры:
-		// - white: первый цвет для смешивания (белый)
-		// - $color: второй цвет для смешивания (базовый цвет)
-		// - $percentage * 1%: процентное соотношение
-		//   (сколько процентов белого цвета в смеси)
-		//
-		// Математика смешивания:
-		// - При $percentage = 0% → 100% $color, 0% white (исходный цвет)
-		// - При $percentage = 50% → 50% $color, 50% white (среднее осветление)
-		// - При $percentage = 100% → 0% $color, 100% white (полностью белый)
-		//
-		// Результат: цвет, который является осветленной версией
-		// исходного цвета, где процент определяет степень осветления.
-		@return color.mix(white, $color, $percentage * 1%);
-
-	}
-
+	@return color.mix(white, $color, $percentage * 1%);
 }

package/modules/utilities/helpers/color/_color-triad.scss

@@ -1,7 +1,5 @@
 @use 'sass:color';
 @use 'sass:meta';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-color' as *;
 
 /// Генерирует триадную цветовую схему из трех
 /// равноудаленных цветов.
@@ -27,7 +25,7 @@
 /// ---
 /// @name color-triad
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -86,56 +84,14 @@
 /// - Третий элемент: цвет со смещением +240° по цветовому кругу
 @function color-triad($color) {
 
-	// Проверка типа входного параметра: ожидается цветовое значение.
-	// Функция is-color() проверяет, является ли $color валидным цветом CSS.
-	@if not is-color($color) {
+	$-hue: color.channel($color, "hue", $space: hsl);
+	$-saturation: color.channel($color, "saturation", $space: hsl);
+	$-lightness: color.channel($color, "lightness", $space: hsl);
 
-		// Если $color не является цветом, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с нецветовыми данными.
-		@return log-invalid-type(
-			'color-triad',
-			$color,
-			'$color',
-			'color'
-		);
-
-	}
-
-	// Основная логика выполняется только если $color является
-	// корректным цветом.
-	@else {
-
-		// Извлечение компонентов цвета из входного параметра
-		// в пространстве HSL (Hue, Saturation, Lightness).
-		// Функция color.channel() возвращает конкретный канал цвета:
-		$-hue: color.channel($color, "hue", $space: hsl);        // Оттенок: 0-360 градусов
-		$-saturation: color.channel($color, "saturation", $space: hsl); // Насыщенность: 0-100%
-		$-lightness: color.channel($color, "lightness", $space: hsl);   // Яркость: 0-100%
-
-		// Создание триадной цветовой схемы.
-		// Триада - это три цвета, равномерно распределенных
-		// по цветовому кругу (разделенных 120 градусами).
-		//
-		// Формула триады:
-		// 1. Исходный цвет: $color (оттенок = $-hue)
-		// 2. Второй цвет: оттенок = ($-hue + 120) % 360
-		//    (120 градусов по часовой стрелке от исходного)
-		// 3. Третий цвет: оттенок = ($-hue + 240) % 360
-		//    (240 градусов по часовой стрелке от исходного)
-		//
-		// Оператор % 360 гарантирует, что значение оттенка всегда
-		// остается в диапазоне 0-359 градусов (полный круг).
-		//
-		// Функция meta.inspect() преобразует цветовые значения
-		// в строки, чтобы они могли быть корректно представлены
-		// в возвращаемом списке.
-		@return (
-			meta.inspect($color),  // Исходный цвет
-			meta.inspect(hsl(($-hue + 120) % 360, $-saturation, $-lightness)),  // Второй цвет триады
-			meta.inspect(hsl(($-hue + 240) % 360, $-saturation, $-lightness))   // Третий цвет триады
-		);
-
-	}
+	@return (
+		meta.inspect($color),
+		meta.inspect(hsl(($-hue + 120) % 360, $-saturation, $-lightness)),
+		meta.inspect(hsl(($-hue + 240) % 360, $-saturation, $-lightness))
+	);
 
 }

package/modules/utilities/helpers/list/_list-dedupe.scss

@@ -1,7 +1,5 @@
 @use 'sass:list';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/list/is-list-contained' as *;
-@use '../../validators/type-of/is-list' as *;
+@use '../../validators' as validators; // need validators/is-list-contained
 
 /// Удаляет дублирующиеся значения из списка.
 ///
@@ -25,7 +23,7 @@
 /// ---
 /// @name list-dedupe
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -91,56 +89,17 @@
 /// 	вхождение каждого значения. Если исходный список
 /// 	пустой, возвращает пустой список.
 @function list-dedupe($list) {
+	$-result: ();
 
-	// Проверка типа входного параметра: ожидается список или arglist.
-	// Функция is-list() проверяет, является ли $list валидным списком
-	// или arglist (специальный тип для переменного числа аргументов).
-	@if not is-list($list) {
-
-		// Если $list не является списком, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с некорректными данными.
-		@return log-invalid-type(
-			'list-dedupe',
-			$list,
-			'$list',
-			('list', 'arglist')
-		);
-
+	@each $-item in $list {
+		@if not validators.is-list-contained($-result, $-item) {
+			$-result: list.append($-result, $-item);
+		}
 	}
 
-	// Основная логика выполняется только если $list является
-	// корректным списком или arglist.
-	@else {
-
-		// Инициализация переменной для хранения результата.
-		// $-result будет содержать список без дубликатов.
-		$-result: ();
-
-		// Итерация по всем элементам исходного списка.
-		// Переменная $-item содержит текущий обрабатываемый элемент.
-		@each $-item in $list {
-
-			// Проверка: содержится ли текущий элемент уже в результате.
-			// Используется вспомогательная функция is-list-contained(),
-			// которая должна возвращать true, если элемент уже присутствует
-			// в списке $-result.
-			@if not is-list-contained($-result, $-item) {
-
-				// Если элемент еще не содержится в результате,
-				// добавляем его в конец списка $-result.
-				// Функция list.append() добавляет новый элемент в список.
-				$-result: list.append($-result, $-item);
-
-			}
+	@return $-result;
+}
 
-		}
 
-		// Возвращаем список без дубликатов.
-		// Порядок элементов сохраняется (первое вхождение каждого элемента
-		// сохраняет свою позицию, последующие дубликаты игнорируются).
-		@return $-result;
 
-	}
 
-}

package/modules/utilities/helpers/list/_list-insert-at.scss

@@ -1,7 +1,4 @@
 @use 'sass:list';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-list' as *;
-@use '../../validators/type-of/is-number' as *;
 
 /// Вставляет значение в список по указанному индексу.
 ///
@@ -24,7 +21,7 @@
 /// ---
 /// @name list-insert-at
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -63,7 +60,7 @@
 /// 	любых типов и может быть пустым.
 /// @param {*} $value - Значение для вставки в список.
 /// 	Может быть любого типа (строка, число, цвет, список и т.д.).
-/// @param {Number} $index - Позиция для вставки значения.
+/// @param {Number} $-index - Позиция для вставки значения.
 /// 	Используется 1-based индексация. Если индекс находится
 /// 	в пределах списка (1 ≤ индекс ≤ длина), значение
 /// 	вставляется перед элементом с этим индексом. Если
@@ -73,94 +70,27 @@
 /// 	позиции. Если список был пустым, возвращается список
 /// 	из одного элемента (вставленного значения).
 /// @throws {Error | Warning} - Может выбросить ошибку если
-/// 	`$index` не является числом или если индекс меньше 1,
+/// 	`$-index` не является числом или если индекс меньше 1,
 /// 	а также предупреждение, если индекс превышает длину
 /// 	списка.
-@function list-insert-at($list, $value, $index) {
+@function list-insert-at($list, $value, $-index) {
 
-	// Проверка типа первого параметра: ожидается список или arglist.
-	// Функция is-list() проверяет, является ли $list валидным списком
-	// или arglist (специальный тип для переменного числа аргументов).
-	@if not is-list($list) {
+	$-result: ();
+	$-length: list.length($list);
 
-		// Если $list не является списком, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с некорректными данными.
-		@return log-invalid-type(
-			'list-insert-at',
-			$list,
-			'$list',
-			('list', 'arglist')
-		);
-
-	}
-
-	// Проверка типа третьего параметра: ожидается числовое значение индекса.
-	// $index определяет позицию, на которую нужно вставить значение в список.
-	// Индексация в Sass начинается с 1, а не с 0.
-	@else if not is-number($index) {
-
-		// Если $index не является числом, возвращаем ошибку.
-		// Проверка выполняется только если $list прошел валидацию.
-		@return log-invalid-type(
-			'list-insert-at',
-			$index,
-			'$index',
-			'number'
-		);
-
-	}
-
-	// Все параметры прошли валидацию - выполняем вставку значения.
-	@else {
-
-		// Инициализация переменной для хранения результата.
-		// $-result будет содержать новый список с вставленным значением.
-		$-result: ();
-
-		// Определение длины исходного списка.
-		// Функция list.length() возвращает количество элементов в списке.
-		$-length: list.length($list);
-
-		// Цикл по всем элементам исходного списка.
-		// Переменная $i принимает значения от 1 до $-length включительно.
-		@for $i from 1 through $-length {
-
-			// Проверка: достигли ли мы позиции для вставки.
-			@if $i == $index {
-
-				// Если текущий индекс равен целевому индексу вставки,
-				// добавляем новое значение в результат перед текущим элементом.
-				$-result: list.append($-result, $value);
-
-			}
-
-			// Добавляем текущий элемент исходного списка в результат.
-			// Функция list.nth() извлекает элемент списка по указанному индексу.
-			$-result: list.append($-result, list.nth($list, $i));
-
-		}
-
-		// Обработка случая, когда индекс вставки больше длины списка.
-		// В этом случае значение добавляется в конец списка.
-		@if $index > $-length {
-
-			// Выводим предупреждение о том, что индекс превышает длину списка.
-			// Это помогает обнаружить потенциальные ошибки в логике программы.
-			@warn '$index (#{$index}) > $-length (#{$-length}): Индекс больше длины списка. Значение будет добавлено в конец!';
-
-			// Добавляем значение в конец списка результата.
+	@for $-i from 1 through $-length {
+		@if $-i == $-index {
 			$-result: list.append($-result, $value);
-
 		}
+		$-result: list.append($-result, list.nth($list, $-i));
+	}
 
-		// Возвращаем новый список с вставленным значением.
-		// Если индекс был в пределах длины списка, значение вставлено
-		// на указанную позицию. Если индекс превышал длину, значение
-		// добавлено в конец. Если индекс меньше 1, поведение не определено
-		// (в текущей реализации значение не будет добавлено).
-		@return $-result;
-
+	// Если индекс больше длины, добавляем в конец
+	@if $-index > $-length {
+		@warn '⚠️  Индекс больше длины списка. Значение будет добавлено в конец!';
+		$-result: list.append($-result, $value);
 	}
 
+	@return $-result;
+
 }

package/modules/utilities/helpers/list/_list-merge.scss

@@ -20,7 +20,7 @@
 /// ---
 /// @name list-merge
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten