@omnisass/library 0.3.0 → 0.4.0

package/CHANGELOG.md

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

package/index.scss

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

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

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

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

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

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

@@ -1,6 +1,6 @@
-@forward 'url-encode.configs';
+@forward './url-encode.configs';
 
-@use 'url-encode.configs' as configs;
+@use './url-encode.configs' as configs;
 @use '../string/string-replace' as *;
 @use '../../loggers/log-invalid-type' as *;
 @use '../../validators/type-of/is-map' as *;

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

@@ -0,0 +1,173 @@
+@use 'sass:string';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-string' as *;
+
+/// Подсчитывает количество вхождений подстроки в строку.
+///
+/// Функция принимает строку и подстроку, затем возвращает
+/// количество непересекающихся вхождений подстроки в строку.
+/// Поиск чувствителен к регистру и выполняется слева направо.
+/// Это полезно для анализа текста, подсчета символов или слов,
+/// проверки частоты встречаемости определенных паттернов в
+/// строковых данных.
+///
+/// Важные особенности функции:
+/// - Выполняет регистрозависимый поиск подстроки
+/// - Подсчитывает только непересекающиеся вхождения
+/// - Выполняет строгую проверку типов обоих параметров
+/// - Использует цикл while для последовательного поиска
+/// - Возвращает 0, если подстрока не найдена ни разу
+/// - Работает с любыми строками, включая пустые
+/// - Обрабатывает Unicode-символы и многосимвольные подстроки
+/// - Полезна для текстового анализа и статистики
+/// - Может использоваться для подсчета слов или символов
+/// - Подходит для валидации форматов строк
+/// - Эффективна для строк средней длины
+/// - Для пустой подстроки всегда возвращает 0 (поскольку
+///   поиск пустой строки в Sass возвращает null)
+/// - Функция использует алгоритм последовательного поиска
+///   через `string.index()` и усечение строки после каждого
+///   найденного вхождения
+/// - Для длинных строк и часто встречающихся подстрок
+///   производительность может снижаться из-за многократного
+///   вызова `string.slice()`
+/// - Поиск чувствителен к регистру: "Hello" и "hello"
+///   считаются разными подстроками
+/// - Функция корректно обрабатывает многосимвольные
+///   подстроки и Unicode-последовательности
+/// ---
+/// @name string-count
+/// @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/String/includes См. также: MDN Web Docs - Метод String.includes()
+/// @link https://en.wikipedia.org/wiki/String_(computer_science) См. также: Wikipedia - Строка (информатика)
+/// @link https://en.wikipedia.org/wiki/Substring См. также: Wikipedia - Подстрока
+/// @link https://css-tricks.com/snippets/sass/string-count-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-count См. также: 30 seconds of code - Функция string-count
+/// @example scss - Подсчет одиночных символов
+/// 	@debug string-count("hello", "l");      // 2
+/// 	@debug string-count("banana", "a");     // 3
+/// 	@debug string-count("test", "t");       // 2
+/// 	@debug string-count("abc", "z");        // 0
+/// 	@debug string-count("", "a");           // 0
+/// 	@debug string-count("aaa", "aa");       // 1 (непересекающиеся)
+/// @example scss - Подсчет многосимвольных подстрок
+/// 	@debug string-count("hello world", "lo");      // 1
+/// 	@debug string-count("test test test", "test"); // 3
+/// 	@debug string-count("ababab", "ab");           // 3
+/// 	@debug string-count("one two one", "one");     // 2
+/// 	@debug string-count("hello hello", "hello");   // 2
+/// @example scss - Регистрозависимый поиск
+/// 	@debug string-count("Hello World", "hello");   // 0
+/// 	@debug string-count("Hello World", "Hello");   // 1
+/// 	@debug string-count("ABC abc ABC", "ABC");     // 2
+/// 	@debug string-count("Test test", "test");      // 1
+/// @example scss - Граничные случаи
+/// 	@debug string-count("aaaa", "aa");       // 2
+/// 	@debug string-count("aaaaa", "aa");      // 2
+/// 	@debug string-count("a", "a");           // 1
+/// 	@debug string-count("abc", "");          // 0
+/// 	@debug string-count("", "");             // 0
+/// @param {String} $string - Исходная строка, в которой
+///   выполняется поиск. Может быть любой строкой: пустой,
+///   односимвольной, содержащей пробелы, Unicode-символы
+///   или специальные символы.
+/// @param {String} $substring - Подстрока, количество
+///   вхождений которой нужно подсчитать. Может быть любой
+///   строкой, включая пустую, односимвольную или
+///   многосимвольную. Поиск регистрозависимый.
+/// @return {Number} - Целое неотрицательное число,
+///   представляющее количество непересекающихся вхождений
+///   подстроки `$substring` в строку `$string`.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр
+///   передано значение, не соответствующее необходимому типу:
+///
+///   - `$string` → `string`
+///   - `$substring` → `string`
+@function string-count($string, $substring) {
+
+	// Проверка типа первого параметра: ожидается строковое значение.
+	// Исходная строка должна быть строкой для выполнения поиска
+	// подстроки с помощью функции string.index().
+	@if not is-string($string) or $string == '' {
+
+		// Если $string не является строкой, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные операции с нестроковыми типами данных.
+		@return log-invalid-type(
+			'string-count',
+			$string,
+			'$string',
+			'string'
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается строковое значение.
+	// Подстрока также должна быть строкой, так как string.index()
+	// работает только со строковыми аргументами.
+	@else if not is-string($substring) or $substring == '' {
+
+		// Если $substring не является строкой, возвращаем ошибку.
+		// Проверка выполняется только если $string прошел валидацию.
+		@return log-invalid-type(
+			'string-count',
+			$substring,
+			'$substring',
+			'string'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - подсчитываем вхождения.
+	@else {
+
+		// Инициализация счетчика вхождений.
+		// Начальное значение 0 соответствует случаю, когда подстрока
+		// не найдена ни разу.
+		$-count: 0;
+
+		// Поиск первого вхождения подстроки в строку.
+		// string.index() возвращает позицию первого вхождения
+		// подстроки или null, если подстрока не найдена.
+		$-index: string.index($string, $substring);
+
+		// Цикл поиска всех вхождений подстроки.
+		// Цикл продолжается, пока находятся новые вхождения
+		// подстроки ($-index != null).
+		@while $-index != null {
+
+			// Увеличение счетчика найденных вхождений.
+			// Каждое найденное вхождение увеличивает счетчик на 1.
+			$-count: $-count + 1;
+
+			// Усечение строки после найденного вхождения.
+			// Новая строка начинается с символа, следующего за
+			// концом найденной подстроки, чтобы исключить
+			// пересекающиеся вхождения.
+			$string: string.slice($string, $-index + string.length($substring));
+
+			// Поиск следующего вхождения подстроки в усеченной строке.
+			// Если подстрока найдена снова, цикл продолжится,
+			// иначе $-index станет null, и цикл завершится.
+			$-index: string.index($string, $substring);
+
+		}
+
+		// Возвращаем общее количество найденных вхождений.
+		// Если подстрока не была найдена ни разу, $-count останется 0.
+		@return $-count;
+
+	}
+
+}

package/modules/utilities/helpers/string/_string-lorips.config.scss

@@ -0,0 +1,81 @@
+/// Глобальная переменная с набором слов Lorem Ipsum.
+///
+/// Список содержит 35 стандартных слов классического текста-
+/// заполнителя Lorem Ipsum в нижнем регистре. Переменная
+/// используется функциями для генерации текста-заполнителя
+/// и может быть переопределена для использования кастомного
+/// набора слов или другого языка.
+///
+/// - Переменная объявлена с флагом `!default`, что
+///   позволяет переопределить ее в проекте перед импортом
+///   библиотеки. Это полезно для локализации или
+///   использования кастомного набора слов.
+/// - Для генерации корректного текста-заполнителя
+///   рекомендуется использовать функции, которые учитывают
+///   капитализацию первого слова и добавление пунктуации.
+/// - Многострочное форматирование списка улучшает
+///   читаемость кода, но не влияет на содержимое переменной.
+///   Каждое слово находится на отдельной строке для удобства
+///   просмотра и редактирования.
+/// - Все слова приведены к нижнему регистру.
+///   Функции, использующие эту переменную, должны сами
+///   заботиться о капитализации при необходимости.
+/// ---
+/// @name set-lorem-ipsum-words
+/// @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/values/lists См. также: Официальная документация Sass - Тип данных "Списки"
+/// @link https://sass-lang.com/documentation/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
+/// @link https://en.wikipedia.org/wiki/Lorem_ipsum См. также: Wikipedia - Lorem ipsum
+/// @link https://en.wikipedia.org/wiki/Latin См. также: Wikipedia - Латинский язык
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/content См. также: MDN Web Docs - CSS свойство content
+/// @link https://css-tricks.com/snippets/sass/lorem-ipsum-generator/ См. также: CSS-Tricks - Генератор Lorem Ipsum на Sass
+/// @link https://css-tricks.com/design-systems-with-sass-placeholders/ См. также: CSS-Tricks - Дизайн-системы с заполнителями
+/// @link https://sass-guidelin.es/ru/#section-23 См. также: Sass Guidelines - Раздел про переменные
+/// @link https://loremipsum.io/generator/ См. также: Lorem Ipsum - Генератор с настройками
+/// @link https://www.lipsum.com/feed/html См. также: Lipsum.com - Генератор HTML Lorem Ipsum
+/// @link https://github.com/sass/sass/issues/2871 См. также: GitHub - Обсуждение текстовых утилит в Sass
+/// @see string-lorips - Функция для генерации текста-
+///   заполнителя на основе этого набора слов.
+/// @type List
+$set-lorem-ipsum-words: "lorem"
+                        "ipsum"
+                        "dolor"
+                        "sit"
+                        "amet"
+                        "consectetur"
+                        "adipiscing"
+                        "elit"
+                        "sed"
+                        "do"
+                        "eiusmod"
+                        "tempor"
+                        "incididunt"
+                        "ut"
+                        "labore"
+                        "et"
+                        "dolore"
+                        "magna"
+                        "aliqua"
+                        "ut"
+                        "enim"
+                        "ad"
+                        "minim"
+                        "veniam"
+                        "quis"
+                        "nostrud"
+                        "exercitation"
+                        "ullamco"
+                        "laboris"
+                        "nisi"
+                        "ut"
+                        "aliquip"
+                        "ex"
+                        "ea"
+                        "commodo"
+                        "consequat"
+                        !default;