@omnisass/library 0.3.0 → 0.4.1

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

@@ -0,0 +1,147 @@
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-string' as *;
+@use '../../validators/type-of/is-number' as *;
+
+/// Повторяет строку указанное количество раз.
+///
+/// Функция создает новую строку путем конкатенации исходной
+/// строки с собой заданное количество раз. Это полезно для
+/// генерации повторяющихся паттернов, заполнителей, рамок
+/// или любых других конструкций, требующих дублирования
+/// строковых элементов.
+///
+/// Важные особенности функции:
+/// - Выполняет строгую проверку типов обоих параметров
+/// - Возвращает пустую строку при нулевом количестве повторов
+/// - Обрабатывает целые положительные числа повторений
+/// - Использует эффективный цикл для построения результата
+/// - Сохраняет исходную строку без изменений
+/// - Полезна для создания визуальных разделителей
+/// - Может использоваться для генерации тестовых данных
+/// - Подходит для построения ASCII-графики или рамок
+/// - Обеспечивает детерминированный результат
+/// - Совместима с многострочными строками и Unicode
+/// - Функция использует простой цикл `for` для
+///   конкатенации строк. Для большого количества повторов
+///   (>1000) производительность может снижаться.
+/// - Для работы с очень большими строками или
+///   количеством повторов рекомендуется использовать
+///   рекурсивную реализацию или мемоизацию.
+/// ---
+/// @name string-repeat
+/// @group utilities-helpers
+/// @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/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа"
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/repeat См. также: MDN Web Docs - Метод String.repeat()
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/concat См. также: MDN Web Docs - Метод String.concat()
+/// @link https://en.wikipedia.org/wiki/String_(computer_science)#Concatenation См. также: Wikipedia - Конкатенация строк
+/// @link https://en.wikipedia.org/wiki/Iteration См. также: Wikipedia - Итерация (программирование)
+/// @link https://css-tricks.com/snippets/sass/string-repetition-function/ См. также: CSS-Tricks - Функция повторения строк в Sass
+/// @link https://css-tricks.com/sass-string-manipulation-functions/ См. также: CSS-Tricks - Функции для работы со строками в Sass
+/// @link https://sass-guidelin.es/ru/#section-44 См. также: Sass Guidelines - Раздел про функции
+/// @link https://github.com/sass/sass/issues/1402 См. также: GitHub - Обсуждение строковых операций в Sass
+/// @link https://www.30secondsofcode.org/sass/p/1/string-repeat См. также: 30 seconds of code - Функция string-repeat
+/// @example scss - Базовое повторение строк
+/// 	@debug string-repeat('a', 5);       // "aaaaa"
+/// 	@debug string-repeat('ab', 3);      // "ababab"
+/// 	@debug string-repeat('test', 2);    // "testtest"
+/// 	@debug string-repeat('', 10);       // ""
+/// @example scss - Создание разделителей и рамок
+/// 	@debug string-repeat('-', 20);      // "--------------------"
+/// 	@debug string-repeat('* ', 10);     // "* * * * * * * * * * "
+/// 	@debug string-repeat('=-', 8);      // "-=-=-=-=-=-=-=-=-=-="
+/// 	@debug string-repeat('▮', 5);       // "▮▮▮▮▮"
+/// @example scss - Граничные случаи
+/// 	@debug string-repeat('abc', 0);     // ""
+/// 	@debug string-repeat('abc', 1);     // "abc"
+/// 	@debug string-repeat(' ', 10);      // "          "
+/// 	@debug string-repeat('\n', 3);      // "nnn"
+/// @param {String} $string - Исходная строка для повторения.
+///   Может быть любой строкой, включая пустую строку,
+///   многострочные строки, строки с пробелами и Unicode-
+///   символами. Каждое повторение будет точной копией
+///   исходной строки.
+/// @param {Number} $repetitions - Количество повторений
+///   строки. Должно быть целым неотрицательным числом.
+///   При значении 0 возвращается пустая строка. При
+///   значении 1 возвращается исходная строка без изменений.
+/// @return {String} - Новая строка, состоящая из исходной
+///   строки, повторенной указанное количество раз. Если
+///   $repetitions равно 0, возвращается пустая строка.
+///   Если $repetitions равно 1, возвращается исходная
+///   строка. Для отрицательных чисел поведение не определено.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+/// - `$repetitions` → `number`
+@function string-repeat($string, $repetitions) {
+
+	// Проверка типа первого параметра: ожидается строковое значение.
+	// Функция предназначена для повторения именно строк, так как
+	// операция конкатенации определена только для строковых значений.
+	@if not is-string($string) {
+
+		// Если $string не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// попытки конкатенации нестроковых значений.
+		@return log-invalid-type(
+			'string-repeat',
+			$string,
+			'$string',
+			'string'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение.
+	// Количество повторений должно быть числом, чтобы можно было
+	// использовать его в цикле for.
+	@else if not is-number($repetitions) {
+
+		// Если $repetitions не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $string прошел валидацию.
+		@return log-invalid-type(
+			'string-repeat',
+			$repetitions,
+			'$repetitions',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - выполняем повторение строки.
+	@else {
+
+		// Инициализация переменной результата.
+		// Начальное значение null позволяет начать конкатенацию
+		// с первой итерации цикла без специальной обработки.
+		$-result: null;
+
+		// Цикл повторения строки заданное количество раз.
+		// Цикл выполняется от 1 до $repetitions включительно.
+		// Каждая итерация добавляет исходную строку к результату.
+		@for $i from 1 through $repetitions {
+
+			// Конкатенация текущего результата с исходной строкой.
+			// При первой итерации $-result равен null, что приводит
+			// к начальному значению, равному $string.
+			$-result: $-result + $string;
+
+		}
+
+		// Возвращаем итоговую строку после всех повторений.
+		// Если $repetitions было 0, цикл не выполнится ни разу,
+		// и функция вернет null, который в контексте строки
+		// преобразуется в пустую строку.
+		@return $-result;
+
+	}
+
+}

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-reverse.scss

@@ -0,0 +1,139 @@
+@use 'sass:string';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-string' as *;
+
+/// Переворачивает строку (меняет порядок символов на обратный).
+///
+/// Функция принимает строку и возвращает новую строку, в которой
+/// все символы расположены в обратном порядке. Например, строка
+/// "hello" превращается в "olleh". Это полезно для различных
+/// текстовых манипуляций, создания зеркальных эффектов в дизайне
+/// или обработки строк в специфичных сценариях.
+///
+/// Важные особенности функции:
+/// - Сохраняет все символы исходной строки без изменений
+/// - Работает с любыми символами, включая Unicode, пробелы, цифры
+/// - Выполняет строгую проверку типа входного параметра
+/// - Использует цикл для итерации по символам строки в обратном порядке
+/// - Возвращает пустую строку для пустого входного значения
+/// - Полезна для создания палиндромов или проверки симметрии текста
+/// - Может использоваться для зеркального отображения текста в CSS
+/// - Подходит для шифрования простых текстовых преобразований
+/// - Обрабатывает строки любой длины
+/// - Совместима с многострочными строками
+/// - Сохраняет пробелы и специальные символы
+/// - Функция использует цикл for с обратным порядком
+///   итерации `(from $-length through 1)`. Это эффективный
+///   способ перевернуть строку в Sass.
+/// - Для палиндромов (строк, которые читаются одинаково
+///   слева направо и справа налево) функция вернет исходную
+///   строку без изменений.
+/// - Функция корректно работает с Unicode-символами
+///   (например, эмодзи или символами нелатинских алфавитов),
+///   так как `string.slice()` в Sass правильно обрабатывает
+///   Unicode.
+/// - Производительность функции снижается для очень
+///   длинных строк (сотни символов), так как каждый символ
+///   обрабатывается в отдельной итерации цикла.
+/// ---
+/// @name string-reverse
+/// @group utilities-helpers
+/// @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/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String См. также: MDN Web Docs - Объект String
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/reverse См. также: MDN Web Docs - Метод Array.reverse()
+/// @link https://en.wikipedia.org/wiki/Palindrome См. также: Wikipedia - Палиндром
+/// @link https://en.wikipedia.org/wiki/String_(computer_science) См. также: Wikipedia - Строка (информатика)
+/// @link https://css-tricks.com/snippets/sass/string-reverse-function/ См. также: CSS-Tricks - Функция реверса строк в Sass
+/// @link https://css-tricks.com/sass-string-manipulation-functions/ См. также: CSS-Tricks - Функции для работы со строками в Sass
+/// @link https://sass-guidelin.es/ru/#section-44 См. также: Sass Guidelines - Раздел про функции
+/// @link https://github.com/sass/sass/issues/1402 См. также: GitHub - Обсуждение строковых операций в Sass
+/// @link https://www.30secondsofcode.org/sass/p/1/string-reverse См. также: 30 seconds of code - Функция string-reverse
+/// @example scss - Базовое использование
+/// 	@debug string-reverse("hello");      // "olleh"
+/// 	@debug string-reverse("world");      // "dlrow"
+/// 	@debug string-reverse("12345");      // "54321"
+/// 	@debug string-reverse("");           // ""
+/// 	@debug string-reverse("a");          // "a"
+/// @example scss - Работа с пробелами и специальными символами
+/// 	@debug string-reverse("hello world");   // "dlrow olleh"
+/// 	@debug string-reverse("a b c");         // "c b a"
+/// 	@debug string-reverse("test!");         // "!tset"
+/// 	@debug string-reverse("привет");        // "тевирп"
+/// @example scss - Создание зеркальных эффектов
+/// 	@debug string-reverse("CSS");          // "SSC"
+/// 	@debug string-reverse("level");        // "level" (палиндром)
+/// 	@debug string-reverse("radar");        // "radar" (палиндром)
+/// 	@debug string-reverse("madam");        // "madam" (палиндром)
+/// @param {String} $string - Исходная строка для переворачивания.
+///   Может быть любой строкой: пустой, односимвольной,
+///   многосимвольной, содержащей пробелы, Unicode-символы,
+///   цифры или специальные символы. Все символы сохраняются
+///   и меняют только порядок следования.
+/// @return {String} - Новая строка, содержащая все символы
+///   исходной строки в обратном порядке. Для пустой строки
+///   возвращается пустая строка. Для строки из одного символа
+///   возвращается та же строка (так как порядок не меняется).
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+@function string-reverse($string) {
+
+	// Проверка типа входного параметра: ожидается строковое значение.
+	// Функция предназначена для работы исключительно со строками,
+	// так как операция реверса имеет смысл только для последовательности
+	// символов.
+	@if not is-string($string) {
+
+		// Если $string не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные операции с нестроковыми типами данных.
+		@return log-invalid-type(
+			'string-reverse',
+			$string,
+			'$string',
+			'string'
+		);
+
+	}
+
+	// Параметр прошел валидацию - переворачиваем строку.
+	@else {
+
+		// Инициализация переменной результата.
+		// Начальное значение null позволяет начать конкатенацию
+		// с первого символа без специальной обработки.
+		$-result: null;
+
+		// Определение длины входной строки.
+		// Длина используется для итерации по символам строки
+		// в обратном порядке.
+		$-length: string.length($string);
+
+		// Цикл итерации по символам строки в обратном порядке.
+		// Начинаем с последнего символа (индекс $-length) и
+		// движемся к первому символу (индекс 1).
+		@for $i from $-length through 1 {
+
+			// Извлечение текущего символа строки по индексу.
+			// string.slice($string, $i, $i) возвращает один символ
+			// на позиции $i. Индексация в Sass начинается с 1.
+			$-result: $-result + string.slice($string, $i, $i);
+
+		}
+
+		// Возвращаем перевернутую строку.
+		// Если исходная строка была пустой, $-length = 0,
+		// цикл не выполнится ни разу, и функция вернет null,
+		// который в контексте строки преобразуется в пустую строку.
+		@return $-result;
+
+	}
+
+}

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.3.0",
+	"version": "0.4.1",
 	"description": "Библиотека функций и миксинов, написанная на языке CSS-препроцессора Sass. Она предназначена для того, чтобы упростить, ускорить и улучшить процесс создания стилей для веб-сайтов.",
 	"main": "index.scss",
 	"scripts": {