@omnisass/library 0.3.0 → 0.4.1

package/CHANGELOG.md

@@ -1,6 +1,25 @@
 # История изменений OmniSass
 Обратите внимание, что данный текст представляет собой краткое изложение истории разработки проекта по версиям. Для более детального ознакомления с изменениями рекомендуется обратиться к соответствующему [разделу](https://sourcecraft.dev/omnisass/library/commits/?rev=master) в SourceCraft.
 
+## v0.4.0 - Public Alpha Release
+{% note info %}
+
+Данная версия библиотеки включает завершённую реализацию функций, построенных на основе встроенного модуля `sass:string`. В фокусе следующего релиза — разработка функциональности с использованием модуля `sass:map`.
+
+{% endnote %}
+
+### Добавленные новые Sass-функции
+#### Вспомогательные функции
+- **string-count** - Подсчитывает количество вхождений подстроки в строку.
+- **string-reverse** - Переворачивает строку (меняет порядок символов на обратный).
+- **string-lorips** - Генерирует текст-заполнитель на основе указанного списка слов.
+- **string-repeat** - Повторяет строку указанное количество раз.
+
+#### Функции для получения значений
+- **get-string-hash** - Вычисляет числовой хеш-код для строки по алгоритму DJB2.
+- **get-uid** - Генерирует уникальный строковый идентификатор с префиксом.
+
+
 ## v0.3.0 - Public Alpha Release
 {% note warning "Примечание" %}
 

package/index.scss

@@ -21,6 +21,7 @@
 @forward 'modules/utilities/getters/list/get-list-item';
 @forward 'modules/utilities/getters/list/get-list-item-end';
 @forward 'modules/utilities/getters/list/get-list-item-start';
+@forward 'modules/utilities/getters/misc/get-uid';
 @forward 'modules/utilities/getters/number/get-number-from-percent';
 @forward 'modules/utilities/getters/number/get-number-height-by-ratio';
 @forward 'modules/utilities/getters/number/get-number-max';
@@ -28,6 +29,7 @@
 @forward 'modules/utilities/getters/number/get-number-percentage-of';
 @forward 'modules/utilities/getters/number/get-number-unit';
 @forward 'modules/utilities/getters/number/get-number-width-by-ratio';
+@forward 'modules/utilities/getters/string/get-string-hash';
 
 // Helpers
 @forward 'modules/utilities/helpers/color/color-blend';
@@ -60,7 +62,11 @@
 @forward 'modules/utilities/helpers/number/number-round-to-nearest';
 @forward 'modules/utilities/helpers/number/number-strip-unit';
 @forward 'modules/utilities/helpers/string/string-capitalize';
+@forward 'modules/utilities/helpers/string/string-count';
+@forward 'modules/utilities/helpers/string/string-lorips';
+@forward 'modules/utilities/helpers/string/string-repeat';
 @forward 'modules/utilities/helpers/string/string-replace';
+@forward 'modules/utilities/helpers/string/string-reverse';
 @forward 'modules/utilities/helpers/string/string-trim';
 @forward 'modules/utilities/helpers/string/string-trim-end';
 @forward 'modules/utilities/helpers/string/string-trim-start';

package/modules/utilities/getters/misc/_get-uid.scss

@@ -0,0 +1,135 @@
+@use 'sass:math';
+@use 'sass:string';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-number' as *;
+@use '../../validators/type-of/is-string' as *;
+
+/// Генерирует уникальный строковый идентификатор с префиксом.
+///
+/// Функция создает гарантированно уникальный идентификатор,
+/// комбинируя пользовательский префикс, случайное число и
+/// встроенный уникальный временной штамп Sass. Это позволяет
+/// создавать идентификаторы, которые практически исключают
+/// вероятность коллизий даже при массовой генерации в разных
+/// контекстах выполнения.
+///
+/// Важные особенности функции:
+/// - Поддерживает настраиваемый префикс для семантического
+///   обозначения типа идентификатора
+/// - Использует криптографически безопасный генератор
+///   случайных чисел Sass
+/// - Добавляет встроенный временной штамп для уникальности
+/// - Выполняет строгую проверку типов входных параметров
+/// - Возвращает строку, готовую к использованию как CSS ID
+///   или имя класса
+/// - Полезна для генерации уникальных имен в CSS-in-JS
+///   решениях
+/// - Может использоваться для создания ключей в картах
+/// - Обеспечивает уникальность в пределах одной компиляции
+/// - Совместима с модульной системой Sass
+/// ---
+/// @name get-uid
+/// @group utilities-getters
+/// @since 2026.01.18
+/// @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 См. также: Официальная документация Sass - Модуль Math
+/// @link https://sass-lang.com/documentation/modules/string См. также: Официальная документация Sass - Модуль String
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа"
+/// @link https://sass-lang.com/documentation/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://developer.mozilla.org/en-US/docs/Web/API/Crypto/randomUUID См. также: MDN Web Docs - Метод Crypto.randomUUID()
+/// @link https://developer.mozilla.org/en-US/docs/Glossary/CSS_keyword См. также: MDN Web Docs - Глоссарий: CSS Keyword
+/// @link https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/id См. также: MDN Web Docs - Глобальный атрибут id
+/// @link https://css-tricks.com/snippets/sass/unique-id-function/ См. также: CSS-Tricks - Функция уникального ID в Sass
+/// @link https://css-tricks.com/sass-generate-ids-classes/ См. также: CSS-Tricks - Генерация ID и классов в Sass
+/// @link https://sass-guidelin.es/ru/#section-44 См. также: Sass Guidelines - Раздел про функции
+/// @link https://github.com/sass/sass/issues/2848 См. также: GitHub - Обсуждение уникальных ID в Sass
+/// @example scss - Базовое использование с префиксом по умолчанию
+/// 	@debug get-uid();                    // "id-384756-uasgd7234"
+/// 	@debug get-uid();                    // "id-928173-kjhasd872"
+/// 	@debug get-uid();                    // "id-102938-poiuy1234"
+/// @example scss - Использование с кастомным префиксом
+/// 	@debug get-uid('user-');             // "user-473829-oiuyt9876"
+/// 	@debug get-uid('modal-');            // "modal-192837-zxcvb4567"
+/// 	@debug get-uid('component-');        // "component-564738-mnbvc0987"
+/// @example scss - Использование с разным диапазоном случайных чисел
+/// 	@debug get-uid('id-', 1000);         // "id-423-iuyt6543"
+/// 	@debug get-uid('id-', 9999999);      // "id-7823491-zxcv5432"
+/// 	@debug get-uid('id-', 100);          // "id-87-asdfg1234"
+/// @param {String} $prefix ["id-"] - Префикс для
+///   идентификатора. Добавляется в начало строки ID,
+///   позволяя семантически группировать идентификаторы
+///   по назначению. Должен быть строковым значением.
+/// @param {Number} $random-max [1000000] - Максимальное
+///   значение для генерации случайного числа. Определяет
+///   диапазон случайной части идентификатора (от 1 до
+///   указанного значения). Должен быть числовым значением.
+/// @return {String} - Уникальный строковый идентификатор
+///   в формате "префикс-случайное_число-временной_штамп".
+///   Гарантирует уникальность в пределах текущей сессии
+///   компиляции Sass.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$prefix` → `string`
+/// - `$random-max` → `number`
+@function get-uid($prefix: "id-", $random-max: 1000000) {
+
+	// Проверка типа первого параметра: ожидается строковый префикс.
+	// Префикс позволяет семантически обозначать тип идентификатора
+	// (например, 'user-', 'modal-', 'component-'), что улучшает
+	// читаемость и отладку сгенерированных идентификаторов.
+	@if not is-string($prefix) {
+
+		// Если $prefix не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректную конкатенацию с нестроковыми значениями.
+		@return log-invalid-type(
+			'get-uid',
+			$prefix,
+			'$prefix',
+			'string'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение
+	// для диапазона случайных чисел. Параметр определяет верхнюю
+	// границу для генератора случайных чисел (math.random).
+	@else if not is-number($random-max) {
+
+		// Если $random-max не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $prefix прошел валидацию.
+		@return log-invalid-type(
+			'get-uid',
+			$random-max,
+			'$random-max',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - генерируем уникальный ID.
+	@else {
+
+		// Генерация случайного числа в диапазоне от 1 до $random-max.
+		// Функция math.random() использует криптографически безопасный
+		// генератор, обеспечивающий хорошее распределение значений.
+		$-random: math.random($random-max);
+
+		// Генерация уникального временного штампа.
+		// Функция string.unique-id() возвращает гарантированно
+		// уникальную строку в пределах текущей компиляции Sass,
+		// основанную на времени и случайных факторах.
+		$-timestamp: string.unique-id();
+
+		// Конкатенация всех компонентов в финальный идентификатор.
+		// Формат: префикс + случайное_число + разделитель + штамп.
+		// Разделитель '-' улучшает читаемость и парсинг при отладке.
+		@return $prefix + $-random + "-" + $-timestamp;
+
+	}
+
+}

package/modules/utilities/getters/string/_get-string-hash.scss

@@ -0,0 +1,143 @@
+@use 'sass:string';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-string' as *;
+
+/// Вычисляет числовой хеш-код для строки по алгоритму DJB2.
+///
+/// Функция преобразует произвольную строку в числовой хеш-код
+/// фиксированной длины (до 6 знаков). Алгоритм использует
+/// мультипликативный подход с множителем 31 и модульной
+/// арифметикой, что обеспечивает хорошее распределение
+/// значений при минимальных коллизиях для коротких строк.
+///
+/// Важные особенности функции:
+/// - Реализует упрощенную версию алгоритма хеширования DJB2
+/// - Использует множитель 31 для оптимального распределения
+/// - Ограничивает результат модулем 1,000,000 (6 знаков)
+/// - Работает только с алфавитно-цифровыми символами
+/// - Возвращает 0 для пустой строки или некорректных символов
+/// - Выполняет строгую проверку типа входного параметра
+/// - Подходит для создания коротких уникальных идентификаторов
+/// - Может использоваться для быстрого сравнения строк
+/// - Полезна для генерации ключей в картах или массивах
+/// - Обеспечивает детерминированный результат для одинаковых
+///   входных данных
+/// - Алгоритм использует ограниченный набор символов
+///   (a-z, A-Z, 0-9). Символы вне этого набора игнорируются
+///   и не влияют на итоговый хеш. Для поддержки Unicode или
+///   расширенных символов потребуется модификация функции.
+/// - Множитель 31 выбран как простое число, что
+///   способствует хорошему распределению хеш-значений.
+///   Этот множитель используется в реализации hashCode()
+///   языка Java для строк.
+/// - Модуль 1000000 ограничивает результат 6 знаками,
+///   что удобно для генерации коротких идентификаторов.
+///   При необходимости большего диапазона значение модуля
+///   можно увеличить.
+/// ---
+/// @name get-string-hash
+/// @group utilities-getters
+/// @since 2026.01.18
+/// @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/string См. также: Официальная документация Sass - Модуль String
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа"
+/// @link https://sass-lang.com/documentation/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/charCodeAt См. также: MDN Web Docs - Метод String.charCodeAt()
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/hashCode См. также: MDN Web Docs - Метод String.hashCode()
+/// @link https://en.wikipedia.org/wiki/Hash_function См. также: Wikipedia - Хеш-функция
+/// @link https://en.wikipedia.org/wiki/Java_hashCode() См. также: Wikipedia - Метод hashCode() в Java
+/// @link https://en.wikipedia.org/wiki/DJB2 См. также: Wikipedia - Алгоритм хеширования DJB2
+/// @link https://css-tricks.com/snippets/sass/string-hashing-function/ См. также: CSS-Tricks - Функция хеширования строк в Sass
+/// @link https://css-tricks.com/sass-generate-unique-ids/ См. также: CSS-Tricks - Генерация уникальных ID в Sass
+/// @link https://sass-guidelin.es/ru/#section-44 См. также: Sass Guidelines - Раздел про функции
+/// @link https://github.com/sass/sass/issues/2864 См. также: GitHub - Обсуждение хеш-функций в Sass
+/// @link https://www.strchr.com/hash_functions См. также: strchr.com - Сравнение хеш-функций
+/// @example scss - Хеширование простых строк
+/// 	@debug get-string-hash('hello');   // 549042
+/// 	@debug get-string-hash('world');   // 705522
+/// 	@debug get-string-hash('test');    // 601234
+/// 	@debug get-string-hash('');        // 32
+/// @example scss - Хеширование строк с разным регистром
+/// 	@debug get-string-hash('Hello');   // 560588
+/// 	@debug get-string-hash('HELLO');   // 360972
+/// 	@debug get-string-hash('hElLo');   // 324414
+/// @example scss - Хеширование алфавитно-цифровых строк
+/// 	@debug get-string-hash('abc123');  // 619221
+/// 	@debug get-string-hash('ABC123');  // 763259
+/// 	@debug get-string-hash('user42');  // 927145
+/// @param {String} $string - Строка для хеширования.
+///   Функция ожидает строку, содержащую символы из набора
+///   a-z, A-Z, 0-9. Для символов вне этого набора функция
+///   string.index() вернет null, что приведет к нулевому
+///   вкладу в хеш-значение. Пустая строка вернет 0.
+/// @return {Number} - Числовой хеш-код в диапазоне от 0 до
+///   999999 (включительно). Результат детерминирован - одна
+///   и та же строка всегда дает одинаковый хеш-код в
+///   пределах одной версии функции.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+@function get-string-hash($string) {
+
+	// Проверка типа входного параметра: ожидается строковое значение.
+	// Функция предназначена для работы исключительно со строками,
+	// так как алгоритм хеширования оперирует последовательностью символов.
+	@if not is-string($string) {
+
+		// Если $string не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные операции с нестроковыми типами данных.
+		@return log-invalid-type(
+			'get-string-hash',
+			$string,
+			'$string',
+			'string'
+		);
+
+	}
+
+	// Параметр прошел валидацию - вычисляем хеш-код строки.
+	@else {
+
+		// Инициализация переменной для хранения хеш-значения.
+		// Начальное значение 0 обеспечивает корректную работу
+		// алгоритма для пустых строк и первого символа.
+		$-hash: 0;
+
+		// Определение длины входной строки.
+		// Длина используется для итерации по всем символам строки
+		// в цикле for.
+		$-length: string.length($string);
+
+		// Итерация по всем символам строки от первого до последнего.
+		// Каждый символ вносит свой вклад в итоговое хеш-значение
+		// согласно алгоритму DJB2.
+		@for $i from 1 through $-length {
+
+			// Извлечение текущего символа строки по индексу.
+			// Индексация в Sass начинается с 1 (не с 0).
+			$-char: string.slice($string, $i, $i);
+
+			// Вычисление нового значения хеша по формуле:
+			// hash = ((hash * 31) + char_index) % 1000000
+			// Где:
+			// - hash * 31: сдвиг предыдущего значения
+			// - char_index: позиция символа в алфавите (1-62)
+			// - % 1000000: ограничение результата 6 знаками
+			// string.index() возвращает позицию символа в строке
+			// алфавита или null для отсутствующих символов.
+			$-hash: (($-hash * 31) + string.index("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789", $-char)) % 1000000;
+
+		}
+
+		// Возвращаем вычисленный хеш-код строки.
+		// Значение всегда будет в диапазоне 0-999999 включительно.
+		@return $-hash;
+
+	}
+
+}

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

@@ -84,9 +84,10 @@
 /// 	измерения первого найденного числа.
 /// @throws {Warning} - Выводит предупреждение при обнаружении
 /// 	чисел с несовместимыми единицами измерения.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `list`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$list` → `list`
 @function list-sum-numbers-safe($list) {
 
 	// Проверка типа входного параметра: ожидается список или arglist.

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

@@ -66,9 +66,10 @@
 /// @throws {Error} - Может выбросить ошибку при попытке
 /// 	сложить числа с несовместимыми единицами измерения
 /// 	(например, px + em).
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `list`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$list` → `list`
 @function list-sum-numbers($list) {
 
 	// Проверка типа входного параметра: ожидается список или arglist.

package/modules/utilities/helpers/misc/_url-encode.scss

@@ -1,6 +1,6 @@
-@forward 'url-encode.configs';
+@forward './url-encode.configs';
 
-@use 'url-encode.configs' as configs;
+@use './url-encode.configs' as configs;
 @use '../string/string-replace' as *;
 @use '../../loggers/log-invalid-type' as *;
 @use '../../validators/type-of/is-map' as *;
@@ -67,10 +67,11 @@
 /// @return {String} - Закодированная строка, где все символы
 /// 	из карты замены преобразованы в их процентное
 /// 	представление.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `string` (`$value`) или
-/// 	`map` (`$chars-map`). Компиляция Sass будет остановлена
-/// 	с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `string`
+/// - `$chars-map` → `map`
 /// @require {function} string-replace - Вспомогательная
 /// 	функция замены подстрок в строке. Должна быть определена
 /// 	и доступна для корректной работы данной функции.

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

@@ -105,9 +105,11 @@
 /// @return {Number} - Число, округленное вверх до ближайшего
 /// 	значения, кратного `$nearest`. Сохраняет единицы
 /// 	измерения исходного числа `$value`.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$nearest` → `number`
 @function number-ceil-to($value, $nearest) {
 
 	// Проверка типа первого параметра: ожидается числовое значение.

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

@@ -86,9 +86,11 @@
 /// 	или `$value-max`. Если `$value` меньше или равно `$value-max`,
 /// 	возвращается `$value`. В противном случае возвращается
 /// 	`$value-max`.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$value-max` → `number`
 @function number-clamp-max($value, $value-max) {
 
 	// Проверка типа первого параметра: ожидается числовое значение.

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

@@ -94,9 +94,11 @@
 /// 	или `$value-min`. Если `$value` больше или равно `$value-min`,
 /// 	возвращается `$value`. В противном случае возвращается
 /// 	`$value-min`.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$value-min` → `number`
 @function number-clamp-min($value, $value-min) {
 
 	// Проверка типа первого параметра: ожидается числовое значение.

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

@@ -105,9 +105,12 @@
 /// 	диапазона.
 /// @throws {Warning} - когда `$value-min > $value-max` поведение
 /// 	функции может быть неинтуитивным.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$value-min` → `number`
+/// - `$value-max` → `number`
 @function number-clamp($value, $value-min, $value-max) {
 
 	// Проверка типа первого параметра: ожидается числовое значение.

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

@@ -170,9 +170,12 @@
 /// @throws Не выбрасывает ошибок, безопасно обрабатывает все
 /// 	числовые значения. Формула математически корректна для
 /// 	любых числовых аргументов.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$value-min` → `number`
+/// - `$value-max` → `number`
 @function number-denormalize($value, $value-min, $value-max) {
 
 	// Проверка типа первого параметра: ожидается нормализованное числовое значение.

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

@@ -218,9 +218,10 @@
 /// - Второй элемент: всегда 1 (если `$n > 1`)
 /// - Каждый последующий элемент: сумма двух предыдущих
 /// - Все элементы: целые положительные числа
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$n` → `number`
 @function number-fibonacci($n) {
 
 	// Проверка типа входного параметра: ожидается числовое значение.

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

@@ -110,9 +110,11 @@
 /// 	измерения исходного числа `$value`.
 /// @throws {Error} - Может выбросить ошибку если происходит
 /// 	деление на ноль.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$nearest` → `number`
 @function number-floor-to($value, $nearest) {
 
 	// Проверка типа первого параметра: ожидается числовое значение.

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

@@ -96,10 +96,11 @@
 /// 	часть исходного числа игнорируется.
 /// @throws {Error} - Может выбросить ошибку если `$value`
 /// 	не является числом или если `$separator` не является строкой.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number (`$value`) или
-/// 	`string` (`$separator`). Компиляция Sass будет остановлена
-/// 	с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$separator` → `string`
 @function number-format-with-separator($value, $separator: ",") {
 
 	// Проверка типа первого параметра: ожидается числовое значение.

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

@@ -157,9 +157,12 @@
 /// @throws {Error} - Может выбросить ошибку деления на ноль, если
 /// 	`$value-min == $value-max`. В этом случае знаменатель формулы становится
 /// 	нулем, что приводит к математической неопределенности.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$value-min` → `number`
+/// - `$value-max` → `number`
 @function number-normalize($value, $value-min, $value-max) {
 
 	// Проверка типа первого параметра: ожидается числовое значение.

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

@@ -78,9 +78,11 @@
 ///   Должно быть больше или равно `$value-min` для корректных результатов.
 /// @return {Number} - Случайное целое число в диапазоне [`$value-min`, `$value-max`].
 ///   Всегда возвращает целое число без единиц измерения.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value-min` → `number`
+/// - `$value-max` → `number`
 /// @throws {Warning} - При `$value-max < $value-min` результат
 /// 	может быть неожиданным.
 @function number-random-between-int($value-min, $value-max) {

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

@@ -117,9 +117,11 @@
 /// 	быть неожиданным (возможны отрицательные значения длины
 /// 	диапазона). Рекомендуется всегда передавать
 /// 	`$value-min ≤ $value-max`.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value-min` → `number`
+/// - `$value-max` → `number`
 @function number-random-between($value-min, $value-max) {
 
 	// Проверка типа первого параметра: ожидается числовое значение

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

@@ -244,9 +244,12 @@
 ///   - Последний элемент: ближайшее к `$end` значение, кратное шагу
 ///   - Все элементы: равномерно распределены с шагом `$step`
 ///   - Направление: соответствует соотношению `$start` и `$end`
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$from` → `number`
+/// - `$to` → `number`
+/// - `$step` → `number`
 @function number-range($from, $to, $step: 1) {
 
 	// Проверка типа первого параметра: ожидается числовое значение

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

@@ -128,9 +128,11 @@
 /// @throws {Error} - Может выбросить ошибку если `$value` или
 /// 	`$nearest` не являются числами, или если происходит
 /// 	деление на ноль.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$nearest` → `number`
 @function number-round-to-nearest($value, $nearest) {
 
 	// Проверка типа первого параметра: ожидается числовое значение.