@omnisass/library 0.4.0 → 0.4.1

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

@@ -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) {
 
 	// Проверка типа первого параметра: ожидается числовое значение.

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

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

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

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

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

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

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

@@ -58,9 +58,12 @@
 /// 	`$replaceable` не найдена, возвращается оригинальная строка.
 /// @throws {Error} - Может вызвать ошибку глубины рекурсии при очень
 /// 	длинных строках с множественными заменами.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+/// - `$replaceable` → `string`
+/// - `$replacement` → `string`
 @function string-replace($string, $replaceable, $replacement: '') {
 
 	// Проверка типа первого параметра: ожидается исходная строка.

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

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

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

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

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

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

package/modules/utilities/validators/color/_is-color-light.scss

@@ -127,10 +127,11 @@
 /// 	используется значение 50%, которое является
 /// 	общепринятым разделением между светлыми и темными
 /// 	тонами. Можно изменить для тонкой настройки.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `color` ($color) или
-/// 	`number` (`$threshold`). Компиляция Sass будет остановлена
-/// 	с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$color` → `color`
+/// - `$threshold` → `number`
 @function is-color-light($color, $threshold: 50) {
 
 	// Проверка типа первого параметра: ожидается цветовое значение.

package/modules/utilities/validators/color/_is-color-list.scss

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

package/modules/utilities/validators/list/_is-list-contained.scss

@@ -56,13 +56,14 @@
 ///
 /// 		position: $position;
 /// 	}
-/// @param {*} $value - Значение для поиска в списке
 /// @param {List} $list - Список, в котором выполняется поиск
+/// @param {*} $value - Значение для поиска в списке
 /// @return {Boolean} - Возвращает `true`, если значение
 /// 	найдено в списке, иначе возвращает `false`.
-/// @throws {Error} - Выбрасывает ошибку, если параметру `$list` передано
-/// 	значение, не соответствующее типу `list`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$list` → `list`
 @function is-list-contained($list, $value) {
 
 	// Проверка типа первого параметра: ожидается список или arglist.

package/modules/utilities/validators/number/_is-int-even.scss

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

package/modules/utilities/validators/number/_is-int-odd.scss

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

package/modules/utilities/validators/number/_is-int.scss

@@ -120,9 +120,11 @@
 /// 	строгой проверки типов.
 /// @return {Boolean} - `true` если значение является
 /// 	целым числом, `false` во всех остальных случаях.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$set-strict-mode-local` → `boolean`
 @function is-int($value, $set-strict-mode-local: true) {
 
 	// Проверка строгого режима: если включен, выполняется

package/modules/utilities/validators/number/_is-number-has-unit.scss

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

package/modules/utilities/validators/number/_is-number-negative.scss

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

package/modules/utilities/validators/number/_is-number-positive.scss

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

package/modules/utilities/validators/number/_is-number-unitless.scss

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

package/modules/utilities/validators/number/_is-number-zero.scss

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

package/modules/utilities/validators/string/_is-string-contained.scss

@@ -102,9 +102,11 @@
 /// 	и `false` в противном случае. Возвращаемые значения:
 /// - `true`: подстрока существует в строке (хотя бы одно вхождение)
 /// - `false`: подстрока не найдена или является пустой строкой
-/// @throws {Error} - Выбрасывает ошибку, если параметрам передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+/// - `$substring` → `string`
 @function is-string-contained($string, $substring) {
 
 	// Проверка типа первого параметра: ожидается строка для поиска.

package/modules/utilities/validators/string/_is-string-empty.scss

@@ -50,9 +50,10 @@
 /// @return {Boolean} - Возвращает `true`, если длина строки
 /// 	равна нулю. Возвращает `false` для любой строки
 /// 	ненулевой длины, а также для значений других типов.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
 @function is-string-empty($string) {
 
 	// Проверка типа входного параметра: ожидается строковое значение.

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

@@ -56,9 +56,11 @@
 /// 	указанной подстрокой. Возвращает `false`, если строка не заканчивается
 /// 	подстрокой, если подстрока длиннее строки, или если регистр
 /// 	символов не совпадает.
-/// @throws {Error} - Выбрасывает ошибку, если параметрам передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+/// - `$substring` → `string`
 @function is-string-ending-with($string, $substring) {
 
 	// Проверка типа первого параметра: ожидается строка для проверки.

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

@@ -56,9 +56,11 @@
 /// 	с указанной подстроки. Возвращает `false`, если строка не
 /// 	начинается с подстроки, если подстрока длиннее строки, или
 /// 	если регистр символов не совпадает.
-/// @throws {Error} - Выбрасывает ошибку, если параметрам передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+/// - `$substring` → `string`
 @function is-string-starting-with($string, $substring) {
 
 	// Проверка типа первого параметра: ожидается строка для проверки.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@omnisass/library",
-	"version": "0.4.0",
+	"version": "0.4.1",
 	"description": "Библиотека функций и миксинов, написанная на языке CSS-препроцессора Sass. Она предназначена для того, чтобы упростить, ускорить и улучшить процесс создания стилей для веб-сайтов.",
 	"main": "index.scss",
 	"scripts": {

package/package.scss

@@ -42,7 +42,7 @@ $title: "OmniSass";
 /// @name description
 /// @access private
 /// @type String
-$description:  "Набор утилит, миксинов, расширений на языке препроцессора Sass для помощи в ускорении, упрощении и улучщения процесса написания CSS-стилей.";
+$description: "Набор утилит, миксинов, расширений на языке препроцессора Sass для помощи в ускорении, упрощении и улучщения процесса написания CSS-стилей.";
 
 /// Текущая версия библиотеки - используется для контроля
 /// версий и отслеживания изменений.
@@ -53,7 +53,7 @@ $description:  "Набор утилит, миксинов, расширений
 /// @name version
 /// @access private
 /// @type String | Number
-$version: "0.4.0";
+$version: "0.4.1";
 
 /// Тип лицензии библиотеки - используется для указания
 /// условий использования и распространения.

package/test2.sh

@@ -1,158 +0,0 @@
-#!/bin/bash
-
-# Скрипт для генерации changes.md с изменениями с последнего тега
-
-set -e
-
-OUTPUT_FILE="changes.md"
-TEMP_FILE=".git_changes.tmp"
-
-# Функция для очистки временных файлов
-cleanup() {
-    if [ -f "$TEMP_FILE" ]; then
-        rm -f "$TEMP_FILE"
-    fi
-}
-
-trap cleanup EXIT
-
-# Получаем последний тег
-echo "🔍 Поиск последнего тега..."
-LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
-
-if [ -z "$LAST_TAG" ]; then
-    echo "⚠️  Теги не найдены. Используется первый коммит."
-    TAG_HASH=$(git rev-list --max-parents=0 HEAD)
-    LAST_TAG="начала репозитория"
-else
-    TAG_HASH=$(git rev-list -n 1 "$LAST_TAG")
-fi
-
-# Получаем текущую ветку и хэш HEAD
-CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
-CURRENT_HASH=$(git rev-parse --short HEAD)
-CURRENT_DATE=$(date '+%Y-%m-%d %H:%M:%S')
-
-# Получаем количество коммитов
-COMMIT_COUNT=$(git rev-list --count "$TAG_HASH"..HEAD)
-
-echo "📊 Найдено $COMMIT_COUNT коммитов с тега $LAST_TAG"
-
-# Генерируем файл changes.md
-echo "# Список изменений" > "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-echo "## 📋 Информация" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-echo "- **Последний тег:** \`$LAST_TAG\`" >> "$OUTPUT_FILE"
-echo "- **Текущая ветка:** \`$CURRENT_BRANCH\`" >> "$OUTPUT_FILE"
-echo "- **Хэш HEAD:** \`$CURRENT_HASH\`" >> "$OUTPUT_FILE"
-echo "- **Дата генерации:** $CURRENT_DATE" >> "$OUTPUT_FILE"
-echo "- **Количество коммитов:** $COMMIT_COUNT" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-if [ $COMMIT_COUNT -eq 0 ]; then
-    echo "## 📭 Изменения отсутствуют" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    echo "Нет новых коммитов с тега \`$LAST_TAG\`" >> "$OUTPUT_FILE"
-
-    echo "✅ Файл $OUTPUT_FILE создан (без изменений)"
-    exit 0
-fi
-
-echo "## 📈 Сводка изменений" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-# Статистика по авторам
-echo "### 👥 Авторы изменений" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-git shortlog -s -n --no-merges "$TAG_HASH"..HEAD | while read line; do
-    count=$(echo "$line" | awk '{print $1}')
-    author=$(echo "$line" | awk '{$1=""; print substr($0,2)}')
-    echo "- **$author:** $count коммит(ов)" >> "$OUTPUT_FILE"
-done
-echo "" >> "$OUTPUT_FILE"
-
-# Статистика изменений файлов
-echo "### 📊 Изменения файлов" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-echo '```diff' >> "$OUTPUT_FILE"
-git diff --stat "$TAG_HASH" HEAD >> "$TEMP_FILE" 2>/dev/null || echo "Статистика изменений недоступна" > "$TEMP_FILE"
-cat "$TEMP_FILE" >> "$OUTPUT_FILE"
-echo '```' >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-# Группировка по типу коммитов (Conventional Commits)
-echo "## 🗂️  Изменения по категориям" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-# Новые возможности
-feat_count=$(git log --oneline --grep="^feat" "$TAG_HASH"..HEAD | wc -l)
-if [ $feat_count -gt 0 ]; then
-    echo "### 🚀 Новые возможности ($feat_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^feat" "$TAG_HASH"..HEAD | sed 's/^feat:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Исправления ошибок
-fix_count=$(git log --oneline --grep="^fix" "$TAG_HASH"..HEAD | wc -l)
-if [ $fix_count -gt 0 ]; then
-    echo "### 🐛 Исправления ошибок ($fix_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^fix" "$TAG_HASH"..HEAD | sed 's/^fix:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Документация
-docs_count=$(git log --oneline --grep="^docs" "$TAG_HASH"..HEAD | wc -l)
-if [ $docs_count -gt 0 ]; then
-    echo "### 📚 Документация ($docs_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^docs" "$TAG_HASH"..HEAD | sed 's/^docs:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Рефакторинг
-refactor_count=$(git log --oneline --grep="^refactor" "$TAG_HASH"..HEAD | wc -l)
-if [ $refactor_count -gt 0 ]; then
-    echo "### ♻️  Рефакторинг ($refactor_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^refactor" "$TAG_HASH"..HEAD | sed 's/^refactor:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Тесты
-test_count=$(git log --oneline --grep="^test" "$TAG_HASH"..HEAD | wc -l)
-if [ $test_count -gt 0 ]; then
-    echo "### ✅ Тесты ($test_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^test" "$TAG_HASH"..HEAD | sed 's/^test:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Остальные коммиты
-other_count=$(git log --oneline --invert-grep --grep="^feat\|^fix\|^docs\|^refactor\|^test" "$TAG_HASH"..HEAD | wc -l)
-if [ $other_count -gt 0 ]; then
-    echo "### 🔧 Прочие изменения ($other_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- %s (\`%h\`)" --invert-grep --grep="^feat\|^fix\|^docs\|^refactor\|^test" "$TAG_HASH"..HEAD >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Полный список коммитов
-echo "## 📝 Полный список коммитов" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-git log --pretty=format:"- **%s**%n  - Хэш: \`%h\`%n  - Автор: %an%n  - Дата: %ad" --date=short "$TAG_HASH"..HEAD >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-# Команда для сравнения
-echo "## 🔗 Ссылки" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-echo "Для просмотра всех изменений выполните:" >> "$OUTPUT_FILE"
-echo '```bash' >> "$OUTPUT_FILE"
-echo "git log --oneline $LAST_TAG..HEAD" >> "$OUTPUT_FILE"
-echo '```' >> "$OUTPUT_FILE"
-
-echo "✅ Файл $OUTPUT_FILE успешно создан!"
-echo "📄 Просмотр: cat $OUTPUT_FILE | head -30"