@omnisass/library 0.2.0 → 2026.1.0-alpha.1

package/modules/utilities/helpers/list/_list-remove-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 *;
 
 /// Удаляет элемент из списка по указанному индексу.
 ///
@@ -23,7 +20,7 @@
 /// ---
 /// @name list-remove-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
@@ -86,75 +83,16 @@
 /// 	является числом.
 @function list-remove-at($list, $index) {
 
-	// Проверка типа первого параметра: ожидается список или arglist.
-	// Функция is-list() проверяет, является ли $list валидным списком
-	// или arglist (специальный тип для переменного числа аргументов).
-	@if not is-list($list) {
-
-		// Если $list не является списком, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с некорректными данными.
-		@return log-invalid-type(
-			'list-remove-at',
-			$list,
-			'$list',
-			('list', 'arglist')
-		);
-
-	}
-
-	// Проверка типа второго параметра: ожидается числовое значение индекса.
-	// $index определяет позицию элемента, который нужно удалить из списка.
-	@else if not is-number($index) {
-
-		// Если $index не является числом, возвращаем ошибку.
-		// Проверка выполняется только если $list прошел валидацию.
-		@return log-invalid-type(
-			'list-remove-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 {
-
-				// Если текущий индекс НЕ равен индексу удаления,
-				// добавляем элемент в результат.
-				// - Функция list.nth() извлекает элемент списка по
-				//   указанному индексу.
-				// - Функция list.append() добавляет элемент в конец
-				//   списка результата.
-				$-result: list.append($-result, list.nth($list, $i));
-
-			}
+	$-result: ();
+	$-length: list.length($list);
 
+	@for $-i from 1 through $-length {
+		@if $-i != $index {
+			$-result: list.append($-result, list.nth($list, $-i));
 		}
-
-		// Возвращаем новый список без удаленного элемента.
-		// Если индекс был в пределах длины списка (1 ≤ $index ≤ $-length),
-		// соответствующий элемент будет пропущен. Если индекс вне диапазона,
-		// исходный список вернется без изменений. Порядок оставшихся
-		// элементов сохраняется.
-		@return $-result;
-
 	}
 
+	@return $-result;
+
 }
+

package/modules/utilities/helpers/list/_list-sum-numbers-safe.scss

@@ -1,8 +1,6 @@
 @use 'sass:math';
 @use 'sass:meta';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-list' as *;
-@use '../../validators/type-of/is-number' as *;
+@use '../../validators' as validators; // need type-of/is-number
 
 /// Безопасно суммирует числовые значения в списке с
 /// проверкой единиц измерения.
@@ -31,7 +29,7 @@
 /// ---
 /// @name list-sum-numbers-safe
 /// @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,90 +84,28 @@
 /// 	чисел с несовместимыми единицами измерения.
 @function list-sum-numbers-safe($list) {
 
-	// Проверка типа входного параметра: ожидается список или arglist.
-	// Функция is-list() проверяет, является ли $list валидным списком
-	// или arglist (специальный тип для переменного числа аргументов).
-	@if not is-list($list) {
+	$-sum: 0;
+	$-first-unit: null;
 
-		// Если $list не является списком, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с некорректными данными.
-		@return log-invalid-type(
-			'list-sum-numbers-safe',
-			$list,
-			'$list',
-			('list', 'arglist')
-		);
+	@each $-item in $list {
 
-	}
-
-	// Основная логика выполняется только если $list является
-	// корректным списком или arglist.
-	@else {
-
-		// Инициализация переменной для хранения суммы чисел.
-		// $-sum будет содержать итоговую сумму совместимых числовых элементов.
-		$-sum: 0;
-
-		// Переменная для хранения единицы измерения первого найденного числа.
-		// Используется для проверки совместимости единиц измерения
-		// всех последующих чисел.
-		$-first-unit: null;
-
-		// Итерация по всем элементам исходного списка.
-		// Переменная $-item содержит текущий обрабатываемый элемент.
-		@each $-item in $list {
-
-			// Проверка: является ли текущий элемент числом.
-			// Функция is-number() возвращает true для числовых значений.
-			@if is-number($-item) {
-
-				// Проверка: является ли это первым найденным числом в списке.
-				@if $-first-unit == null {
-
-					// Если это первое число:
-					// 1. Сохраняем его единицу измерения для последующей проверки
-					//    Функция math.unit() возвращает единицу измерения числа как строку.
-					// 2. Инициализируем сумму значением этого числа
-					$-first-unit: math.unit($-item);
-					$-sum: $-item;
-
-				}
-
-				// Проверка: совместимы ли единицы измерения текущего числа
-				// с единицей измерения первого числа.
-				// Условие выполняется, если:
-				// 1. Единицы измерения совпадают (math.unit($-item) == $-first-unit)
-				// 2. Текущее число безразмерное (math.unit($-item) == '')
-				@else if math.unit($-item) == $-first-unit or math.unit($-item) == '' {
-
-					// Если единицы измерения совместимы, добавляем число к сумме.
-					// Оператор + в Sass автоматически проверяет совместимость единиц,
-					// но мы уже выполнили проверку выше для безопасности.
-					$-sum: $-sum + $-item;
-
-				} @else {
-
-					// Если единицы измерения не совместимы:
-					// Выводим предупреждение в консоль с информацией о пропущенном элементе.
-					// Функция meta.inspect() преобразует значение в читаемую строку.
-					// Функция math.unit() возвращает единицу измерения числа.
-					// Это предупреждение помогает выявить потенциальные ошибки в данных.
-					@warn "Пропускаю элемент «#{meta.inspect($-item)}»: единица «#{math.unit($-item)}» несовместима с «#{$-first-unit}»!";
-
-				}
+		@if validators.is-number($-item) {
 
+			@if $-first-unit == null {
+				$-first-unit: math.unit($-item);
+				$-sum: $-item;
+			} @else if math.unit($-item) == $-first-unit or math.unit($-item) == '' {
+				$-sum: $-sum + $-item;
+			} @else {
+				@warn "⚠️  Пропускаю элемент «#{meta.inspect($-item)}»: единица «#{math.unit($-item)}» несовместима с «#{$-first-unit}»!";
 			}
 
 		}
 
-		// Возвращаем итоговую сумму совместимых числовых элементов.
-		// Если в списке не было чисел или все числа были пропущены из-за
-		// несовместимости единиц измерения, возвращается 0 (начальное значение).
-		// Единица измерения результата соответствует единице измерения
-		// первого добавленного числа.
-		@return $-sum;
-
 	}
 
+	@return $-sum;
+
 }
+
+

package/modules/utilities/helpers/list/_list-sum-numbers.scss

@@ -1,6 +1,4 @@
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-list' as *;
-@use '../../validators/type-of/is-number' as *;
+@use '../../validators' as validators; // need type-of/is-number
 
 /// Суммирует все числовые значения в списке.
 ///
@@ -19,7 +17,7 @@
 /// ---
 /// @name list-sum-numbers
 /// @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
@@ -68,61 +66,15 @@
 /// 	(например, px + em).
 @function list-sum-numbers($list) {
 
-	// Проверка типа входного параметра: ожидается список или arglist.
-	// Функция is-list() проверяет, является ли $list валидным списком
-	// или arglist (специальный тип для переменного числа аргументов).
-	@if not is-list($list) {
-
-		// Если $list не является списком, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// некорректные вычисления с некорректными данными.
-		@return log-invalid-type(
-			'list-sum-numbers',
-			$list,
-			'$list',
-			('list', 'arglist')
-		);
-
-	}
-
-	// Основная логика выполняется только если $list является
-	// корректным списком или arglist.
-	@else {
-
-		// Инициализация переменной для хранения суммы чисел.
-		// $-sum будет содержать итоговую сумму всех числовых элементов
-		// в списке. Начальное значение 0 гарантирует корректный результат
-		// даже для пустых списков или списков без числовых элементов.
-		$-sum: 0;
-
-		// Итерация по всем элементам исходного списка.
-		// Переменная $-item содержит текущий обрабатываемый элемент.
-		@each $-item in $list {
-
-			// Проверка: является ли текущий элемент числом.
-			// Функция is-number() возвращает true для числовых значений,
-			// включая числа с единицами измерения (px, rem, em и т.д.)
-			// и безразмерные числа.
-			@if is-number($-item) {
-
-				// Если элемент является числом, добавляем его к общей сумме.
-				// Оператор + в Sass автоматически складывает числа,
-				// учитывая их единицы измерения. Если единицы измерения
-				// несовместимы (например, px + em), Sass вызовет ошибку
-				// компиляции на этом этапе.
-				$-sum: $-sum + $-item;
-
-			}
+	$-sum: 0;
 
+	@each $-item in $list {
+		@if validators.is-number($-item) {
+			$-sum: $-sum + $-item;
 		}
-
-		// Возвращаем итоговую сумму всех числовых элементов.
-		// Если в списке не было чисел, возвращается 0 (начальное значение).
-		// Если были числа с единицами измерения, результат будет иметь
-		// те же единицы измерения, что и первое найденное число
-		// (при условии совместимости всех единиц).
-		@return $-sum;
-
 	}
 
+	@return $-sum;
+
 }
+

package/modules/utilities/helpers/number/_number-ceil-to.scss

@@ -20,7 +20,7 @@
 /// ---
 /// @name number-ceil-to
 /// @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

package/modules/utilities/helpers/number/_number-clamp-max.scss

@@ -26,7 +26,7 @@
 /// ---
 /// @name number-clamp-max
 /// @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

package/modules/utilities/helpers/number/_number-clamp-min.scss

@@ -34,7 +34,7 @@
 /// ---
 /// @name number-clamp-min
 /// @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

package/modules/utilities/helpers/number/_number-clamp.scss

@@ -37,7 +37,7 @@
 /// ---
 /// @name number-clamp
 /// @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

package/modules/utilities/helpers/number/_number-denormalize.scss

@@ -36,7 +36,7 @@
 /// ---
 /// @name number-denormalize
 /// @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

package/modules/utilities/helpers/number/_number-fibonacci.scss

@@ -25,7 +25,7 @@
 /// ---
 /// @name number-fibonacci
 /// @group utilities-helpers
-/// @since 2025.12.28
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -221,7 +221,7 @@
 	$-a: 0;
 	$-b: 1;
 
-	@for $i from 1 through $n {
+	@for $-i from 1 through $n {
 
 		$-result: list.append($-result, $-b);
 		$-temp: $-a + $-b;

package/modules/utilities/helpers/number/_number-floor-to.scss

@@ -21,7 +21,7 @@
 /// ---
 /// @name number-floor-to
 /// @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

package/modules/utilities/helpers/number/_number-format-with-separator.scss

@@ -25,7 +25,7 @@
 /// ---
 /// @name number-format-with-separator
 /// @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
@@ -100,13 +100,13 @@
 	$-length: string.length($-str);
 	$-counter: 0;
 
-	@for $i from $-length through 1 {
+	@for $-i from $-length through 1 {
 
-		$char: string.slice($-str, $i, $i);
+		$char: string.slice($-str, $-i, $-i);
 		$-result: $char + $-result;
 		$-counter: $-counter + 1;
 
-		@if $-counter == 3 and $i > 1 {
+		@if $-counter == 3 and $-i > 1 {
 			$-result: $separator + $-result;
 			$-counter: 0;
 		}

package/modules/utilities/helpers/number/_number-normalize.scss

@@ -39,7 +39,7 @@
 /// ---
 /// @name number-normalize
 /// @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

package/modules/utilities/helpers/number/_number-random-between-int.scss

@@ -33,7 +33,7 @@
 /// ---
 /// @name number-random-between-int
 /// @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

package/modules/utilities/helpers/number/_number-random-between.scss

@@ -36,7 +36,7 @@
 /// ---
 /// @name number-random-between
 /// @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

package/modules/utilities/helpers/number/_number-range.scss

@@ -22,7 +22,7 @@
 /// ---
 /// @name number-range
 /// @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
@@ -246,18 +246,18 @@
 	$-result: ();
 
 	@if $from < $to {
-		@for $i from $from through $to {
-			@if ($i - $from) % $step == 0 {
+		@for $-i from $from through $to {
+			@if ($-i - $from) % $step == 0 {
 
-				$-result: list.append($-result, $i);
+				$-result: list.append($-result, $-i);
 
 			}
 		}
 	} @else {
-		@for $i from $from through $to {
-			@if ($from - $i) % $step == 0 {
+		@for $-i from $from through $to {
+			@if ($from - $-i) % $step == 0 {
 
-				$-result: list.append($-result, $i);
+				$-result: list.append($-result, $-i);
 
 			}
 		}

package/modules/utilities/helpers/number/_number-round-to-nearest.scss

@@ -25,7 +25,7 @@
 /// ---
 /// @name number-round-to-nearest
 /// @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

package/modules/utilities/helpers/number/_number-round-to.scss

@@ -21,7 +21,7 @@
 /// ---
 /// @name number-round-to
 /// @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

package/modules/utilities/helpers/number/_number-strip-unit.scss

@@ -1,6 +1,4 @@
 @use 'sass:math';
-@use '../../loggers/log-invalid-type' as *;
-@use '../../validators/type-of/is-number' as *;
 
 /// Удаляет единицы измерения из числа, возвращая
 /// безразмерное значение.
@@ -29,7 +27,7 @@
 /// ---
 /// @name number-strip-unit
 /// @group utilities-helpers
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Sindre Sorhus
 /// @author Murad Rustamov (therteenten) [адаптация]
@@ -83,15 +81,5 @@
 /// 	нечисловое значение, так как математические операции
 /// 	Sass требуют числовых операндов.
 @function number-strip-unit($value) {
-
-	$-result: 'null';
-
-	@if is-number($value) {
-		$-result: math.div($value, $value * 0 + 1);
-	} @else {
-		@debug log-invalid-type('number-strip-unit', $value, '$value', 'number');
-	}
-
-	@return $-result;
-
+  @return math.div($value, $value * 0 + 1);
 }

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

@@ -30,7 +30,7 @@
 /// ---
 /// @name string-capitalize
 /// @group utilities-helpers
-/// @since 2026.01.12
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -17,7 +17,7 @@
 /// ---
 /// @name string-replace
 /// @group utilities-helpers
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -17,7 +17,7 @@
 /// ---
 /// @name string-trim-end
 /// @group utilities-helpers
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -58,5 +58,5 @@
 	}
 
 	@return $string;
-
+	
 }

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

@@ -17,7 +17,7 @@
 /// ---
 /// @name string-trim-start
 /// @group utilities-helpers
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -58,5 +58,5 @@
 	}
 
 	@return $string;
-
+	
 }

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

@@ -17,7 +17,7 @@
 /// ---
 /// @name string-trim
 /// @group utilities-helpers
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

package/modules/utilities/loggers/_index.scss

@@ -0,0 +1,6 @@
+////
+/// @group utilities-loggers
+////
+
+@forward 'log-invalid-type';
+@forward 'log-invalid-value';

package/modules/utilities/validators/_index.scss

@@ -0,0 +1,38 @@
+////
+/// @group utilities-validators
+////
+
+// Colors
+@forward 'color/is-color-light';
+@forward 'color/is-color-list';
+
+// List
+@forward 'list/is-list-contained';
+
+// Number
+@forward 'number/is-int';
+@forward 'number/is-int-even';
+@forward 'number/is-int-odd';
+@forward 'number/is-number-has-unit';
+@forward 'number/is-number-negative';
+@forward 'number/is-number-positive';
+@forward 'number/is-number-unitless';
+@forward 'number/is-number-zero';
+
+// String
+@forward 'string/is-string-contained';
+@forward 'string/is-string-empty';
+@forward 'string/is-string-ending-with';
+@forward 'string/is-string-starting-with';
+
+// Type-of
+@forward 'type-of/is-boolean';
+@forward 'type-of/is-color';
+@forward 'type-of/is-list';
+@forward 'type-of/is-map';
+@forward 'type-of/is-number';
+@forward 'type-of/is-string';
+@forward 'type-of/is-type';
+
+// Other
+@forward 'is-time';