@omnisass/library 0.2.0

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

@@ -0,0 +1,131 @@
+@use 'sass:math';
+
+/// Округляет число до ближайшего кратного значения с
+/// использованием стандартного математического округления
+/// (половинки в сторону от нуля).
+///
+/// Функция выполняет округление числа до ближайшего значения,
+/// кратного указанному числу, используя математическое
+/// округление (round half away from zero). Эта функция
+/// полезна для привязки значений к сетке, создания
+/// равномерных интервалов и дискретизации непрерывных величин.
+///
+/// Важные особенности функции:
+/// - Использует математическое округление (половинки в сторону
+/// 	от нуля)
+/// - Работает с положительными и отрицательными числами
+/// - Сохраняет единицы измерения исходного числа
+/// - Использует `math.round()` для округления до ближайшего
+/// 	целого
+/// - Поддерживает дробные значения для `$nearest`
+/// - Использует математически корректное деление через
+/// 	`math.div()`
+/// - Следует правилу "банковского округления" для граничных
+/// 	случаев
+/// ---
+/// @name number-round-to-nearest
+/// @group utilities-helpers
+/// @since 2025.12.27
+/// @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#round См. также: Официальная документация Sass - Функция math.round()
+/// @link https://sass-lang.com/documentation/modules/math#div См. также: Официальная документация Sass - Функция math.div()
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/round MDN Web Docs - Math.round()
+/// @link https://en.wikipedia.org/wiki/Rounding См. также: Википедия - Округление чисел
+/// @link https://en.wikipedia.org/wiki/Rounding#Round_half_away_from_zero См. также: Википедия - Округление половинок от нуля
+/// @link https://mathworld.wolfram.com/Round.html См. также: Wolfram MathWorld - Функция округления
+/// @link https://www.britannica.com/science/rounding См. также: Britannica - Округление в математике
+/// @link https://www.khanacademy.org/math/cc-third-grade-math/imp-addition-and-subtraction/imp-rounding/v/rounding-to-the-nearest-10 См. также: Khan Academy - Округление до ближайшего
+/// @link https://www.mathsisfun.com/numbers/rounding-methods.html См. также: Maths is Fun - Методы округления
+/// @link https://www.mathsisfun.com/numbers/rounding-decimals.html См. также: Maths is Fun - Округление десятичных дробей
+/// @link https://www.nist.gov/pml/special-publication-811/nist-guide-si-chapter-7 См. также: NIST Guide to SI - Глава 7: Округление чисел
+/// @link https://ieeexplore.ieee.org/document/4610935 См. также: IEEE Standard 754 - Округление чисел с плавающей запятой
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#math-functions См. также: Sass Guidelines - Математические функции
+/// @link https://frontender.info/sass-numbers/ См. также: Frontender Magazine - Работа с числами в Sass
+/// @link https://www.w3schools.com/sass/sass_functions_numeric.php См. также: W3Schools - Числовые функции в Sass
+/// @link https://habr.com/ru/post/247887/ См. также: Habr - Статья "Sass для верстальщика: числа и математика"
+/// @example scss - Округление до ближайшего кратного
+/// 	@debug number-round-to-nearest(13, 5);        // 15
+/// 	@debug number-round-to-nearest(12, 5);        // 10
+/// 	@debug number-round-to-nearest(17, 10);       // 20
+/// 	@debug number-round-to-nearest(15, 10);       // 20 (половинка вверх)
+/// 	@debug number-round-to-nearest(100, 50);      // 100
+/// 	@debug number-round-to-nearest(125, 50);      // 150
+/// @example scss - Округление дробных чисел
+/// 	@debug number-round-to-nearest(12.3, 5);      // 10
+/// 	@debug number-round-to-nearest(12.7, 5);      // 15
+/// 	@debug number-round-to-nearest(3.14, 1);      // 3
+/// 	@debug number-round-to-nearest(7.89, 2.5);    // 7.5
+/// 	@debug number-round-to-nearest(8.12, 2.5);    // 7.5
+/// @example scss - Округление отрицательных чисел
+/// 	@debug number-round-to-nearest(-13, 5);       // -15
+/// 	@debug number-round-to-nearest(-12, 5);       // -10
+/// 	@debug number-round-to-nearest(-15, 10);      // -20 (половинка от нуля)
+/// 	@debug number-round-to-nearest(-3.5, 1);      // -4
+/// @example scss - Округление чисел с единицами измерения
+/// 	@debug number-round-to-nearest(13px, 5px);    // 15px
+/// 	@debug number-round-to-nearest(12px, 5px);    // 10px
+/// 	@debug number-round-to-nearest(1.7rem, 0.5rem); // 1.5rem
+/// 	@debug number-round-to-nearest(45%, 10%);     // 50%
+/// 	@debug number-round-to-nearest(43%, 10%);     // 40%
+/// @example scss - Практическое использование для выравнивания по сетке
+/// 	$element-width: 137px;
+/// 	$grid-step: 12px;
+/// 	$aligned-width: number-round-to-nearest($element-width, $grid-step);
+/// 	// $aligned-width: 144px (137/12≈11.42→12*12=144)
+/// 	.grid-item {
+/// 		width: $aligned-width;
+/// 	}
+/// @example css - Результат
+/// 	.grid-item {
+/// 		width: 132px;
+/// 	}
+/// @example scss - Практическое использование для типографики
+/// 	$calculated-size: 17.3px;
+/// 	$type-scale: 2px;
+/// 	$harmonized-size: number-round-to-nearest($calculated-size, $type-scale);
+/// 	// $harmonized-size: 18px (17.3/2=8.65→9*2=18)
+/// 	.heading {
+/// 		font-size: $harmonized-size;
+/// 	}
+/// @example css - Результат
+/// 	.heading {
+/// 		font-size: 18px;
+/// 	}
+/// @example scss - Практическое использование для временных интервалов
+/// 	$duration: 3700ms;
+/// 	$time-step: 500ms;
+/// 	$rounded-duration: number-round-to-nearest($duration, $time-step);
+/// 	// $rounded-duration: 3500ms (3700/500=7.4→7*500=3500)
+/// 	.animation {
+/// 		animation-duration: $rounded-duration;
+/// 	}
+/// @example css - Результат
+/// 	.animation {
+/// 		animation-duration: 3500ms;
+/// 	}
+/// @example scss - Математическое применение для квантования
+/// 	// Квантование аналогового значения в цифровое
+/// 	$analog-value: 3.7;
+/// 	$quantum-step: 0.5;
+/// 	@debug number-round-to-nearest($analog-value, $quantum-step); //  3.5 (3.7/0.5=7.4→7*0.5=3.5)
+/// @param {Number} $value - Число для округления. Может быть
+/// 	любым числом: положительным, отрицательным, целым,
+/// 	дробным, с единицами измерения или без них.
+/// @param {Number} $nearest - Кратное значение, до которого
+/// 	нужно округлить. Определяет шаг округления. Может быть
+/// 	дробным числом. Рекомендуется использовать те же единицы
+/// 	измерения, что и у `$value`.
+/// @return {Number} - Число, округленное до ближайшего
+/// 	значения, кратного `$nearest`. Сохраняет единицы
+/// 	измерения исходного числа `$value`. Использует
+/// 	правило округления половинок в сторону от нуля.
+/// @throws {Error} - Может выбросить ошибку если `$value` или
+/// 	`$nearest` не являются числами, или если происходит
+/// 	деление на ноль.
+@function number-round-to-nearest($value, $nearest) {
+	@return math.round(math.div($value, $nearest)) * $nearest;
+}

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

@@ -0,0 +1,118 @@
+@use 'sass:math';
+
+/// Округляет число до указанного количества знаков после
+/// запятой.
+///
+/// Функция выполняет математическое округление числа до
+/// заданной точности (количества знаков после десятичной
+/// точки). Использует стандартное математическое округление
+/// (half away from zero).
+///
+/// Важные особенности функции:
+/// - Использует математическое округление (половинки в сторону
+/// 	от нуля)
+/// - Поддерживает отрицательные числа
+/// - Сохраняет единицы измерения (если они есть)
+/// - Использует `math.pow()` для вычисления множителя
+/// - Работает с любыми числами (целыми, дробными, с единицами
+/// 	измерения)
+/// - Использует локальные переменные с префиксом `$-` для
+/// 	избежания конфликтов
+/// ---
+/// @name number-round-to
+/// @group utilities-helpers
+/// @since 2025.12.27
+/// @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#round См. также: Официальная документация Sass - Функция math.round()
+/// @link https://sass-lang.com/documentation/modules/math#pow См. также: Официальная документация Sass - Функция math.pow()
+/// @link https://sass-lang.com/documentation/modules/math#div См. также: Официальная документация Sass - Функция math.div()
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/round MDN Web Docs - Math.round()
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#math-functions См. также: Sass Guidelines - Математические функции
+/// @link https://frontender.info/sass-numbers/ См. также: Frontender Magazine - Работа с числами в Sass
+/// @link https://www.w3schools.com/sass/sass_functions_numeric.php См. также: W3Schools - Числовые функции в Sass
+/// @link https://habr.com/ru/post/247887/ См. также: Habr - Статья "Sass для верстальщика: числа и математика"
+/// @example scss - Округление до двух знаков (по умолчанию)
+/// 	@debug number-round-to(3.14159);      // 3.14
+/// 	@debug number-round-to(2.71828);      // 2.72
+/// 	@debug number-round-to(1.005);        // 1
+/// 	@debug number-round-to(0.999);        // 1
+/// 	@debug number-round-to(123.456);      // 123.46
+/// @example scss - Округление до разного количества знаков
+/// 	@debug number-round-to(3.14159, 0);   // 3
+/// 	@debug number-round-to(3.14159, 1);   // 3.1
+/// 	@debug number-round-to(3.14159, 2);   // 3.14
+/// 	@debug number-round-to(3.14159, 3);   // 3.142
+/// 	@debug number-round-to(3.14159, 4);   // 3.1416
+/// @example scss - Округление отрицательных чисел
+/// 	@debug number-round-to(-3.14159, 2);  // -3.14
+/// 	@debug number-round-to(-2.71828, 2);  // -2.72
+/// 	@debug number-round-to(-1.005, 2);    // -1
+/// 	@debug number-round-to(-0.999, 2);    // -1
+/// @example scss - Округление чисел с единицами измерения
+/// 	@debug number-round-to(3.14159px, 2); // 3.14px
+/// 	@debug number-round-to(2.5rem, 1);    // 2.5rem
+/// 	@debug number-round-to(1.33333em, 3); // 1.333em
+/// 	@debug number-round-to(0.666666%, 2); // 0.67%
+/// @example scss - Граничные случаи и целые числа
+/// 	@debug number-round-to(10, 2);        // 10
+/// 	@debug number-round-to(10.0, 2);      // 10
+/// 	@debug number-round-to(0, 2);         // 0
+/// 	@debug number-round-to(0.000, 2);     // 0
+/// 	@debug number-round-to(100.001, 2);   // 100.0
+/// @example scss - Практическое использование для финансовых расчетов
+/// 	$price: 19.994;
+/// 	$rounded-price: number-round-to($price, 2);
+/// 	// $rounded-price: 19.99
+/// 	.price {
+/// 		content: "#{$rounded-price}€";
+/// 	}
+/// @example css - Результат
+/// 	.price {
+/// 		content: "19.99€";
+/// 	}
+/// @example scss - Практическое использование для типографики
+/// 	$line-height: 1.666666;
+/// 	$rounded-line-height: number-round-to($line-height, 3);
+/// 	// $rounded-line-height: 1.667
+/// 	.typography {
+/// 		line-height: $rounded-line-height;
+/// 	}
+/// @example css - Результат
+/// 	.typography {
+/// 		line-height: 1.667;
+/// 	}
+/// @example scss - Практическое использование для процентных значений
+/// 	$percentage: 33.333333%;
+/// 	$rounded-percentage: number-round-to($percentage, 1);
+/// 	// $rounded-percentage: 33.3%
+/// 	.progress-bar {
+/// 		width: $rounded-percentage;
+/// 	}
+/// @example css - Результат
+/// 	.progress-bar {
+/// 		width: 33.3%;
+/// 	}
+/// @param {Number} $value - Число для округления. Может быть
+/// 	любым числом: целым, дробным, положительным, отрицательным,
+/// 	с единицами измерения или без них.
+/// @param {Number} $precision [2] - Количество знаков после
+/// 	десятичной точки, до которых нужно округлить. Должно быть
+/// 	неотрицательным целым числом. При значении `0` округляет до
+/// 	целого числа.
+/// @return {Number} - Округленное число с сохранением единиц
+/// 	измерения (если они были). Количество знаков после запятой
+/// 	соответствует указанной точности.
+/// @throws {Error} - Может выбросить ошибку если `$precision`
+/// 	не является целым неотрицательным числом или если
+/// 	`$value` не является числом.
+@function number-round-to($value, $precision: 2) {
+
+	$-multiplier: math.pow(10, $precision);
+
+	@return math.div(math.round($value * $-multiplier), $-multiplier);
+
+}

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

@@ -0,0 +1,97 @@
+@use 'sass:math';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-number' as *;
+
+/// Удаляет единицы измерения из числа, возвращая
+/// безразмерное значение.
+///
+/// Функция принимает число с единицами измерения (например,
+/// `16px`, `2rem`, `50%`) и возвращает то же числовое
+/// значение без привязанных к нему единиц измерения.
+///
+/// Это полезно для математических операций, где необходимо
+/// работать только с числовыми значениями, игнорируя единицы
+/// измерения.
+///
+/// Математический принцип работы функции:
+/// - `$value * 0` преобразует значение в `0` с сохранением
+/// 	единиц измерения
+/// - `0 + 1` создает значение `1` с теми же единицами измерения
+/// - Деление `$value / 1` эффективно удаляет единицы измерения,
+/// 	оставляя только числовую часть
+///
+/// Важные особенности функции:
+/// - Сохраняет точность исходного числового значения
+/// - Работает с любыми единицами измерения CSS
+/// - Не изменяет само значение, только удаляет единицы
+/// - Возвращает то же число, что и на входе, но без единиц
+/// - Не выполняет преобразования между единицами измерения
+/// ---
+/// @name number-strip-unit
+/// @group utilities-helpers
+/// @since 2025.12.27
+/// @access public
+/// @author Sindre Sorhus
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @link https://github.com/sindresorhus GitHub - Sindre Sorhus
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
+/// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа"
+/// @link https://sass-lang.com/documentation/values/numbers#units См. также: Официальная документация Sass - Единицы измерения в числах
+/// @link https://sass-lang.com/documentation/operators/numeric См. также: Официальная документация Sass - Числовые операторы
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Values_and_Units См. также: MDN Web Docs - CSS значения и единицы измерения
+/// @link https://css-tricks.com/snippets/sass/strip-unit-function/ См. также: CSS-Tricks - Функция strip-unit() в Sass
+/// @link https://sass-guidelin.es/ru/#section-41 См. также: Sass Guidelines - Раздел про математические операции
+/// @link https://www.w3schools.com/sass/sass_operators_numeric.php См. также: W3Schools - Числовые операторы в Sass
+/// @example scss - Пиксели и относительные единицы
+/// 	@debug number-strip-unit(16px);     // 16
+/// 	@debug number-strip-unit(0px);      // 0
+/// 	@debug number-strip-unit(2.5rem);   // 2.5
+/// 	@debug number-strip-unit(1.25em);   // 1.25
+/// 	@debug number-strip-unit(0.75ch);   // 0.75
+/// @example scss - Процентные и угловые единицы
+/// 	@debug number-strip-unit(50%);      // 50
+/// 	@debug number-strip-unit(100%);     // 100
+/// 	@debug number-strip-unit(0.5%);     // 0.5
+/// 	@debug number-strip-unit(90deg);    // 90
+/// 	@debug number-strip-unit(3.14rad);  // 3.14
+/// 	@debug number-strip-unit(0.5turn);  // 0.5
+/// @example scss - Временные и частотные единицы
+/// 	@debug number-strip-unit(1s);       // 1
+/// 	@debug number-strip-unit(250ms);    // 250
+/// 	@debug number-strip-unit(60Hz);     // 60
+/// 	@debug number-strip-unit(2.4kHz);   // 2.4
+/// @example scss - Разрешение и прочие единицы
+/// 	@debug number-strip-unit(96dpi);    // 96
+/// 	@debug number-strip-unit(2.5dppx);  // 2.5
+/// 	@debug number-strip-unit(10vw);     // 10
+/// 	@debug number-strip-unit(50vh);     // 50
+/// 	@debug number-strip-unit(20vmin);   // 20
+/// @example scss - Безразмерные числа (без изменений)
+/// 	@debug number-strip-unit(10);       // 10 (остается 10)
+/// 	@debug number-strip-unit(3.14);     // 3.14 (остается 3.14)
+/// 	@debug number-strip-unit(0);        // 0 (остается 0)
+/// 	@debug number-strip-unit(-5);       // -5 (остается -5)
+/// @param {Number} $value - Число с единицами измерения.
+/// 	Может быть любым числом CSS с любыми единицами измерения
+/// 	или безразмерным числом. Если передано безразмерное число,
+/// 	функция вернет его без изменений.
+/// @return {Number} - Безразмерное числовое значение, равное
+/// 	числовой части входного значения. Если входное значение
+/// 	уже было безразмерным, возвращается то же самое значение.
+/// @throws {Error} - Может выбросить ошибку, если передано
+/// 	нечисловое значение, так как математические операции
+/// 	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;
+
+}

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

@@ -0,0 +1,84 @@
+@use 'sass:string';
+
+/// Преобразует первый символ строки в верхний регистр, остальные
+/// оставляет без изменений.
+///
+/// Функция извлекает первый символ строки, преобразует его в
+/// верхний регистр с помощью `string.to-upper-case()`, затем
+/// объединяет с оставшейся частью строки. Удобна для
+/// форматирования имен, заголовков и других текстовых элементов,
+/// требующих капитализации только первого символа.
+///
+/// Важные особенности функции:
+/// - Преобразует только первый символ строки в верхний регистр
+/// - Не изменяет регистр остальных символов строки
+/// - Работает корректно с однобуквенными строками
+/// - Обрабатывает пустые строки, возвращая пустую строку
+/// - Сохраняет все пробелы и специальные символы в исходном виде
+/// - Чувствительна к регистру только для первого символа
+///
+/// > Первый символ преобразуется независимо от того, является
+/// > ли он буквой. Цифры, специальные символы и пробелы остаются
+/// > без изменений, но функция все равно выполнит попытку
+/// > преобразования регистра.
+///
+/// > Для строк, начинающихся с пробела, пробел остается
+/// > первым символом, а первая буква (если есть) преобразуется
+/// > в верхний регистр.
+/// > Функция использует встроенные методы Sass и работает
+/// > эффективно даже с длинными строками.
+/// ---
+/// @name string-capitalize
+/// @group utilities-helpers
+/// @since 2026.01.12
+/// @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#to-upper-case См. также: Официальная документация Sass - Функция string.to-upper-case()
+/// @link https://sass-lang.com/documentation/modules/string#slice См. также: Официальная документация Sass - Функция string.slice()
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase См. также: MDN Web Docs - JavaScript метод toUpperCase()
+/// @link https://css-tricks.com/snippets/sass/capitalize-function/ См. также: CSS-Tricks - Sass-функция capitalize()
+/// @link https://sass-guidelin.es/ru/#section-37 См. также: Sass Guidelines - Работа со строками
+/// @link https://www.w3schools.com/sass/sass_functions_string.php См. также: W3Schools - Строковые функции в Sass
+/// @link https://stackoverflow.com/questions/1026069/how-do-i-make-the-first-letter-of-a-string-uppercase-in-javascript См. также: Stack Overflow - Как сделать первую букву строки заглавной в JavaScript
+/// @link https://frontender.info/sass-text-transformations/ См. также: Frontender Magazine - Трансформации текста в Sass
+/// @link https://habr.com/ru/post/247879/ См. также: Habr - Статья "Sass для верстальщика: строковые операции"
+/// @example scss - Базовая капитализация
+/// 	@debug string-capitalize('hello');       // "Hello"
+/// 	@debug string-capitalize('hello world'); // "Hello world"
+/// 	@debug string-capitalize('HELLO');       // "HELLO"
+/// 	@debug string-capitalize('123abc');      // "123abc"
+/// @example scss - Специальные символы и пробелы
+/// 	@debug string-capitalize(' hello');      // " hello"
+/// 	@debug string-capitalize('-webkit-box'); // "-webkit-box"
+/// 	@debug string-capitalize('_variable');   // "_variable"
+/// 	@debug string-capitalize('.class-name'); // ".class-name"
+/// @example scss - Граничные случаи
+/// 	@debug string-capitalize('');            // "" (пустая строка)
+/// 	@debug string-capitalize('a');           // "A"
+/// 	@debug string-capitalize('A');           // "A"
+/// 	@debug string-capitalize(' ');           // " " (пробел)
+/// @example scss - Использование в реальных сценариях
+/// 	@debug string-capitalize('firstName');    // "FirstName"
+/// 	@debug string-capitalize('user-name');    // "User-name"
+/// 	@debug string-capitalize('css selector'); // "Css selector"
+/// 	@debug string-capitalize('php function'); // "Php function"
+/// @param {String} $string - Исходная строка, первый символ
+/// 	которой нужно преобразовать в верхний регистр.
+/// 	Может быть пустой строкой, однобуквенной строкой или
+/// 	строкой любой длины.
+/// @return {String} - Возвращает новую строку, в которой
+/// 	первый символ преобразован в верхний регистр, а все
+/// 	остальные символы остаются без изменений. Для пустой
+/// 	строки возвращает пустую строку.
+/// @throws Не выбрасывает ошибок, корректно обрабатывает строки
+/// 	любой длины и содержания.
+@function string-capitalize($string) {
+
+	$-first: string.to-upper-case(string.slice($string, 1, 1));
+	$-rest: string.slice($string, 2);
+
+	@return $-first + $-rest;
+
+}

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

@@ -0,0 +1,69 @@
+@use 'sass:string';
+
+/// Заменяет все вхождения подстроки в строке на другую подстроку.
+///
+/// Функция рекурсивно ищет первое вхождение заменяемой подстроки в строке,
+/// заменяет его на указанную подстроку-замену, и продолжает поиск
+/// в оставшейся части строки. Процесс повторяется, пока не будут
+/// заменены все вхождения.
+///
+/// Важные особенности функции:
+/// - Использует рекурсивный алгоритм для замены всех вхождений
+/// - Применяет `string.index()` для поиска позиции подстроки
+/// - Использует `string.slice()` для разделения строки на части
+/// - Чувствительна к регистру символов при поиске
+/// - Поддерживает замену на пустую строку (удаление подстроки)
+/// - Обрабатывает множественные вхождения подстроки
+/// ---
+/// @name string-replace
+/// @group utilities-helpers
+/// @since 2026.01.03
+/// @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/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://sass-lang.com/documentation/modules/string#index См. также: Официальная документация Sass - Функция string.index()
+/// @link https://sass-lang.com/documentation/modules/string#slice См. также: Официальная документация Sass - Функция string.slice()
+/// @link https://sass-lang.com/documentation/modules/string#length См. также: Официальная документация Sass - Функция string.length()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/string_value См. также: MDN Web Docs - CSS-тип <string>
+/// @link https://sass-lang.com/documentation/at-rules/function См. также: Официальная документация Sass - Функции
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replaceAll См. также: MDN Web Docs - JavaScript метод replaceAll()
+/// @example scss - Замена подстроки
+/// 	@debug string-replace('hello world', 'world', 'universe'); // "hello universe"
+/// 	@debug string-replace('test test', 'test', 'example');     // "example example"
+/// 	@debug string-replace('abc abc abc', 'abc', 'xyz');       // "xyz xyz xyz"
+/// @example scss - Удаление подстроки
+/// 	@debug string-replace('hello-world', '-', '');            // "helloworld"
+/// 	@debug string-replace('some text here', ' ', '');         // "sometexthere"
+/// 	@debug string-replace('abc123def', '123', '');            // "abcdef"
+/// @example scss - Граничные случаи
+/// 	@debug string-replace('', 'abc', 'xyz');                  // "" (пустая строка)
+/// 	@debug string-replace('hello', 'x', 'y');                 // "hello" (подстрока не найдена)
+/// 	@debug string-replace('aaaa', 'aa', 'b');                 // "bb" (перекрывающиеся замены)
+/// @example scss - Специальные символы
+/// 	@debug string-replace('width: 100px;', '100px', '200px'); // "width: 200px;"
+/// 	@debug string-replace('class1 class2', 'class', 'cls');   // "cls1 cls2"
+/// 	@debug string-replace('url(image.jpg)', 'image', 'logo'); // "url(logo.jpg)"
+/// @param {String} $string - Исходная строка, в которой
+/// 	выполняется замена.
+/// @param {String} $replaceable - Подстрока, которую нужно
+/// 	заменить.
+/// @param {String} $replacement [''] - Подстрока для замены.
+/// 	По умолчанию - пустая строка (удаление).
+/// @return {String} - Возвращает новую строку, в которой все
+/// 	вхождения `$replaceable` заменены на `$replacement`. Если
+/// 	`$replaceable` не найдена, возвращается оригинальная строка.
+/// @throws {Error} - Может вызвать ошибку глубины рекурсии при очень
+/// 	длинных строках с множественными заменами.
+@function string-replace($string, $replaceable, $replacement: '') {
+
+	$-index: string.index($string, $replaceable);
+
+	@if $-index {
+		@return string.slice($string, 1, $-index - 1) + $replacement + string-replace(string.slice($string, $-index + string.length($replaceable)), $replaceable, $replacement);
+	}
+
+	@return $string;
+
+}

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

@@ -0,0 +1,62 @@
+@use 'sass:string';
+
+/// Удаляет пробелы с конца строки (справа).
+///
+/// Функция последовательно проверяет и удаляет пробелы с конца
+/// строки, пока не встретит непробельный символ.
+///
+/// Возвращает строку без конечных пробелов.
+///
+/// Важные особенности функции:
+/// - Использует цикл `@while` для последовательного удаления конечных пробелов
+/// - Проверяет последний символ строки на равенство пробелу
+/// - Использует `string.slice()` для создания подстрок без конечных пробелов
+/// - Удаляет только пробелы (символ " "), не удаляет другие whitespace-символы
+/// - Сохраняет все пробелы в начале строки и между словами
+/// - Полезен для обработки значений с выравниванием по правому краю или trailing spaces
+/// ---
+/// @name string-trim-end
+/// @group utilities-helpers
+/// @since 2026.01.03
+/// @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/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://sass-lang.com/documentation/modules/string#slice См. также: Официальная документация Sass - Функция string.slice()
+/// @link https://sass-lang.com/documentation/at-rules/control См. также: Официальная документация Sass - Управляющие директивы
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/string_value См. также: MDN Web Docs - CSS-тип <string>
+/// @link https://sass-lang.com/documentation/values/strings#interpolation См. также: Официальная документация Sass - Интерполяция строк
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/trimEnd См. также: MDN Web Docs - JavaScript метод trimEnd()
+/// @example scss - Удаление конечных пробелов
+/// 	@debug string-trim-end('hello  ');      // "hello"
+/// 	@debug string-trim-end('world   ');     // "world"
+/// 	@debug string-trim-end('  test  ');     // "  test" (начальные пробелы сохраняются)
+/// @example scss - Строки без конечных пробелов
+/// 	@debug string-trim-end('hello');        // "hello"
+/// 	@debug string-trim-end('  hello');      // "  hello"
+/// 	@debug string-trim-end('');             // ""
+/// @example scss - Граничные случаи
+/// 	@debug string-trim-end('   ');          // "" (только пробелы)
+/// 	@debug string-trim-end(' a b ');        // " a b" (сохраняет начальные и внутренние пробелы)
+/// 	@debug string-trim-end('hello world  '); // "hello world"
+/// @example scss - Сравнение с полным trim
+/// 	@debug string-trim-end('  text  ');     // "  text"
+/// 	@debug string-trim('  text  ');         // "text" (удаляет и начальные пробелы)
+/// @param {String} $string - Строка, из которой нужно удалить
+/// 	конечные пробелы.
+/// @return {String} - Возвращает новую строку, в которой удалены
+/// 	все пробелы с конца оригинальной строки.
+/// 	Если строка состоит только из пробелов, возвращается пустая строка.
+/// @throws {Error} - Не выбрасывает ошибок. Если передано нестроковое
+/// 	значение, функция может вернуть неожиданный результат или вызвать
+/// 	ошибку выполнения.
+@function string-trim-end($string) {
+
+	@while string.slice($string, -1) == " " {
+		$string: string.slice($string, 1, -2);
+	}
+
+	@return $string;
+
+}