@omnisass/library 0.2.0 → 2026.1.0-alpha.1

package/modules/utilities/converters/_convert-kebab2camel.scss

@@ -1,232 +0,0 @@
-@use 'sass:string';
-@use '../loggers/log-invalid-type' as *;
-@use '../validators/type-of/is-string' as *;
-
-/// Конвертирует строку из `kebab-case` (кебаб-нотация) в
-/// `camelCase` (верблюжья нотация).
-///
-/// Функция проходит по каждому символу входной строки,
-/// игнорируя дефисы и преобразуя символы, следующие за
-/// дефисами, в верхний регистр. Это позволяет преобразовывать
-/// CSS-классы и HTML-атрибуты в формате kebab-case в имена
-/// переменных JavaScript/TypeScript в camelCase.
-///
-/// Важные особенности функции:
-/// - Сохраняет исходный регистр символов (кроме следующих за
-/// 	дефисами)
-/// - Игнорирует дефисы в исходной строке
-/// - Преобразует символы после дефисов в верхний регистр
-/// - Итеративно обрабатывает каждый символ строки
-/// - Возвращает строку в camelCase нотации
-/// - Полезно для преобразования CSS-селекторов в JS-свойства
-/// - Используется для консистентного именования в коде
-/// - Обрабатывает строки любой длины
-/// - Не изменяет цифры и специальные символы (кроме дефисов)
-/// - Учитывает граничные случаи (пустая строка, несколько
-/// 	дефисов подряд)
-/// - Обеспечивает обратное преобразование к `convert-camel2kebab`
-/// ---
-/// @name convert-kebab2camel
-/// @group utilities-converters
-/// @since 2026.01.13
-/// @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/Operators/Object_initializer См. также: MDN Web Docs - Object initializer
-/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Grammar_and_types#variable_names См. также: MDN Web Docs - Имена переменных в JavaScript
-/// @link https://developer.mozilla.org/en-US/docs/Learn/HTML/Howto/Use_data_attributes См. также: MDN Web Docs - Использование data-атрибутов
-/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_selectors См. также: MDN Web Docs - CSS селекторы
-/// @link https://css-tricks.com/snippets/sass/string-case-conversion-functions/ См. также: CSS-Tricks - Функции преобразования регистра строк в Sass
-/// @link https://css-tricks.com/whats-the-difference-between-kebab-case-camel-case-and-snake-case/ См. также: CSS-Tricks - Разница между kebab-case, camelCase и snake_case
-/// @link https://sass-guidelin.es/ru/#section-42 См. также: Sass Guidelines - Раздел про строки
-/// @link https://www.w3schools.com/js/js_conventions.asp См. также: W3Schools - Соглашения по коду JavaScript
-/// @example scss - Базовые преобразования
-/// 	@debug convert-kebab2camel('camel-case');      // 'camelCase'
-/// 	@debug convert-kebab2camel('background-color'); // 'backgroundColor'
-/// 	@debug convert-kebab2camel('font-size');       // 'fontSize'
-/// 	@debug convert-kebab2camel('border-radius');   // 'borderRadius'
-/// 	@debug convert-kebab2camel('padding-left');    // 'paddingLeft'
-/// 	@debug convert-kebab2camel('margin-bottom');   // 'marginBottom'
-/// @example scss - Множественные дефисы
-/// 	@debug convert-kebab2camel('border-top-left-radius');  // 'borderTopLeftRadius'
-/// 	@debug convert-kebab2camel('font-weight-bold');        // 'fontWeightBold'
-/// 	@debug convert-kebab2camel('text-decoration-line');    // 'textDecorationLine'
-/// 	@debug convert-kebab2camel('background-image-url');    // 'backgroundImageUrl'
-/// 	@debug convert-kebab2camel('grid-template-columns');   // 'gridTemplateColumns'
-/// 	@debug convert-kebab2camel('transition-property-all'); // 'transitionPropertyAll'
-/// @example scss - Преобразование CSS-классов в JS-свойства
-/// 	// Конвертация CSS-классов для использования в JavaScript
-/// 	$css-classes: 'modal-header', 'btn-primary', 'input-disabled';
-///
-/// 	@each $class in $css-classes {
-/// 		$js-property: convert-kebab2camel($class);
-/// 		@debug $js-property;
-/// 		// modal-header → modalHeader
-/// 		// btn-primary → btnPrimary
-/// 		// input-disabled → inputDisabled
-/// 	}
-/// @example scss - Интеграция с конфигурационными объектами
-/// 	// Конвертация CSS-свойств в имена JS-переменных
-/// 	$css-properties: (
-/// 		'primary-color': #3498db,
-/// 		'secondary-color': #2ecc71,
-/// 		'font-size-base': 16px,
-/// 		'border-radius-sm': 4px
-/// 	);
-///
-/// 	// Создание JS-объекта конфигурации
-/// 	$js-config: ();
-///
-/// 	@each $key, $value in $css-properties {
-/// 		$js-key: convert-kebab2camel($key);
-/// 		$js-config: map.merge($js-config, ($js-key: $value));
-/// 	}
-///
-/// 	@debug $js-config;
-/// 	// (primaryColor: #3498db, secondaryColor: #2ecc71,
-/// 	//  fontSizeBase: 16px, borderRadiusSm: 4px)
-/// @example css - Практическое применение в Sass/SCSS
-/// 	// Использование функции для генерации CSS-переменных
-/// 	$theme-colors: (
-/// 		primary-color: #3498db,
-/// 		secondary-color: #2ecc71,
-/// 		accent-color: #e74c3c
-/// 	);
-///
-/// 	:root {
-/// 		@each $name, $color in $theme-colors {
-/// 			--#{convert-kebab2camel($name)}: #{$color};
-/// 		}
-/// 	}
-/// @example css - Результат
-/// 	:root {
-/// 		--primaryColor: #3498db;
-/// 		--secondaryColor: #2ecc71;
-/// 		--accentColor: #e74c3c;
-/// 	}
-/// @example scss - Обратное преобразование данных из CSS
-/// 	// Получение данных из data-атрибутов и преобразование в camelCase
-/// 	$data-attributes: (
-/// 		'data-user-id': '12345',
-/// 		'data-is-active': 'true',
-/// 		'data-role-name': 'admin'
-/// 	);
-///
-/// 	@each $attr, $value in $data-attributes {
-/// 		// Убираем префикс 'data-' и преобразуем в camelCase
-/// 		$attr-name: string.slice($attr, 6); // 'user-id', 'is-active', 'role-name'
-/// 		$js-property: convert-kebab2camel($attr-name);
-/// 		@debug $js-property + ': ' + $value;
-/// 		// userId: 12345
-/// 		// isActive: true
-/// 		// roleName: admin
-/// 	}
-/// @example css - Применение для data-атрибутов
-/// 	// Генерация CSS для элементов с data-атрибутами
-/// 	.user-profile[data-user-id="12345"] {
-/// 		color: blue;
-/// 	}
-///
-/// 	.button[data-is-active="true"] {
-/// 		background-color: green;
-/// 	}
-///
-/// 	.admin-panel[data-role-name="admin"] {
-/// 		border: 2px solid red;
-/// 	}
-/// @param {String} $value - Строка в kebab-case нотации для
-/// 	конвертации. Может содержать буквы, цифры, дефисы и
-/// 	другие символы. Функция игнорирует дефисы и
-/// 	преобразует символы, следующие за дефисами, в верхний
-/// 	регистр.
-/// @return {String} - Строка в camelCase нотации, где все
-/// 	дефисы удалены, а символы, которые следовали за
-/// 	дефисами, преобразованы в верхний регистр. Первый
-/// 	символ остается в исходном регистре.
-/// @throws {Error} - Может выбросить ошибку при передаче
-/// 	нестроковых значений. Аргумент должен быть строкой
-/// 	для корректной работы строковых функций Sass.
-@function convert-kebab2camel($value) {
-
-	// Переменная для накопления результата преобразования.
-	$-result: "";
-
-	// Проверка типа входного параметра: ожидается строковое значение.
-	// Функция is-string() проверяет, является ли $value строкой
-	// (тип данных string).
-	@if not is-string($value) {
-
-		// Если $value не является строкой, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// выполнение операции замены с некорректными данными.
-		@return log-invalid-type(
-			'convert-kebab2camel',
-			$value,
-			'$value',
-			'string'
-		);
-
-	}
-
-	// Основная логика выполняется только если $value является
-	// корректной строкой.
-	@else {
-
-		// Флаг, указывающий, что следующий символ должен быть
-		// преобразован в верхний регистр. Устанавливается в true,
-		// когда встречается дефис "-" в исходной строке.
-		$-capitalize-next: false;
-
-		// Определение длины входной строки для организации цикла.
-		// Функция string.length() возвращает количество символов
-		// в строке.
-		$-length: string.length($value);
-
-		// Цикл по всем символам строки от первого до последнего.
-		// Индекс $i последовательно принимает значения от 1 до $-length.
-		@for $i from 1 through $-length {
-
-			// Извлечение текущего символа строки по индексу $i.
-			// Функция string.slice() возвращает подстроку,
-			// в данном случае - один символ.
-			$-char: string.slice($value, $i, $i);
-
-			// Проверка: является ли текущий символ дефисом "-".
-			@if $-char == "-" {
-
-				// Если символ - дефис, устанавливаем флаг, что
-				// следующий символ должен быть заглавным.
-				// Сам дефис не добавляется к результату.
-				$-capitalize-next: true;
-
-			}
-
-			// Проверка: установлен ли флаг заглавного регистра
-			// для текущего символа.
-			@else if $-capitalize-next {
-
-				// Если флаг установлен, добавляем символ в верхнем
-				// регистре к результату и сбрасываем флаг.
-				$-result: $-result + string.to-upper-case($-char);
-				$-capitalize-next: false;
-
-			} @else {
-
-				// Если символ не дефис и флаг не установлен,
-				// добавляем символ как есть (в исходном регистре).
-				$-result: $-result + $-char;
-
-			}
-
-		}
-
-		// Возвращаем итоговую строку после преобразования всех
-		// символов.
-		@return $-result;
-
-	}
-
-}

package/modules/utilities/converters/_convert-kebab2snake.scss

@@ -1,118 +0,0 @@
-@use '../helpers/string/string-replace' as *;
-@use '../loggers/log-invalid-type' as *;
-@use '../validators/type-of/is-string' as *;
-
-/// Преобразует строку из `kebab-case` (кебаб-нотация) в
-/// `snake_case` (змеиная нотация).
-///
-/// Функция заменяет все дефисы (`-`) на символы нижнего
-/// подчеркивания (`_`) в переданной строке. Это преобразование
-/// позволяет конвертировать CSS-классы и имена переменных из
-/// frontend-разработки в формат, используемый в backend-языках
-/// программирования, таких как Python, Ruby и PHP.
-///
-/// Важные особенности функции:
-/// - Заменяет все вхождения дефисов на нижние подчеркивания
-/// - Сохраняет все остальные символы без изменений
-/// - Не изменяет регистр символов
-/// - Работает с любыми строками, содержащими дефисы
-/// - Простая и эффективная реализация через замену символов
-/// - Полезно для конвертации имен из frontend в backend
-/// - Используется для унификации именования в full-stack проектах
-/// - Поддерживает строки любой длины и сложности
-/// - Обрабатывает множественные дефисы подряд
-/// - Учитывает граничные случаи (пустая строка, отсутствие
-/// 	дефисов)
-/// ---
-/// @name convert-kebab2snake
-/// @group utilities-converters
-/// @since 2026.01.13
-/// @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/replace См. также: MDN Web Docs - Метод String.replace()
-/// @link https://developer.mozilla.org/en-US/docs/Glossary/Snake_case См. также: MDN Web Docs - Глоссарий: Snake_case
-/// @link https://developer.mozilla.org/en-US/docs/Glossary/Kebab-case См. также: MDN Web Docs - Глоссарий: Kebab-case
-/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_selectors См. также: MDN Web Docs - CSS селекторы
-/// @link https://css-tricks.com/snippets/sass/string-replace-function/ См. также: CSS-Tricks - Функция замены строк в Sass
-/// @link https://css-tricks.com/whats-the-difference-between-kebab-case-camel-case-and-snake-case/ См. также: CSS-Tricks - Разница между kebab-case, camelCase и snake_case
-/// @link https://sass-guidelin.es/ru/#section-42 См. также: Sass Guidelines - Раздел про строки
-/// @link https://www.python.org/dev/peps/pep-0008/ См. также: PEP 8 - Style Guide for Python Code
-/// @link https://rubystyle.guide/#naming См. также: Ruby Style Guide - Именование
-/// @example scss - Базовые преобразования
-/// 	@debug convert-kebab2snake('kebab-case');       // 'kebab_case'
-/// 	@debug convert-kebab2snake('background-color'); // 'background_color'
-/// 	@debug convert-kebab2snake('font-size');        // 'font_size'
-/// 	@debug convert-kebab2snake('border-radius');    // 'border_radius'
-/// 	@debug convert-kebab2snake('padding-left');     // 'padding_left'
-/// 	@debug convert-kebab2snake('margin-bottom');    // 'margin_bottom'
-/// @example scss - Множественные дефисы
-/// 	@debug convert-kebab2snake('border-top-left-radius');    // 'border_top_left_radius'
-/// 	@debug convert-kebab2snake('font-weight-bold');          // 'font_weight_bold'
-/// 	@debug convert-kebab2snake('text-decoration-line');      // 'text_decoration_line'
-/// 	@debug convert-kebab2snake('background-image-url');      // 'background_image_url'
-/// 	@debug convert-kebab2snake('grid-template-columns');     // 'grid_template_columns'
-/// 	@debug convert-kebab2snake('transition-property-all');   // 'transition_property_all'
-/// @example scss - Сложные случаи с цифрами и аббревиатурами
-/// 	@debug convert-kebab2snake('xml-http-request');          // 'xml_http_request'
-/// 	@debug convert-kebab2snake('css-animation');             // 'css_animation'
-/// 	@debug convert-kebab2snake('html5-canvas');              // 'html5_canvas'
-/// 	@debug convert-kebab2snake('ui-component');              // 'ui_component'
-/// 	@debug convert-kebab2snake('api-endpoint');              // 'api_endpoint'
-/// 	@debug convert-kebab2snake('user-id');                   // 'user_id'
-/// @example scss - Граничные случаи
-/// 	@debug convert-kebab2snake('single');                   // 'single'
-/// 	@debug convert-kebab2snake('');                         // '' (пустая строка)
-/// 	@debug convert-kebab2snake('already_snake');           // 'already_snake' (без изменений)
-/// 	@debug convert-kebab2snake('multiple---hyphens');      // 'multiple___hyphens'
-/// 	@debug convert-kebab2snake('-leading-hyphen');         // '_leading_hyphen'
-/// 	@debug convert-kebab2snake('trailing-hyphen-');        // 'trailing_hyphen_'
-/// @param {String} $value - Строка в kebab-case нотации для
-/// 	конвертации. Может содержать буквы, цифры, дефисы и
-/// 	другие символы. Функция заменяет все вхождения `-` на
-/// 	`_`, сохраняя остальные символы без изменений.
-/// @return {String} - Строка в snake_case нотации, где все
-/// 	дефисы заменены на символы нижнего подчеркивания.
-/// 	Результат подходит для использования в backend-языках
-/// 	программирования, конфигурационных файлах и API-запросах.
-/// @throws {Error} - Может выбросить ошибку при передаче
-/// 	нестроковых значений или если функция `string-replace`
-/// 	не определена. Требуется наличие функции `string-replace`
-/// 	в модуле `helpers` для корректной работы.
-/// @requires {function} string-replace - Вспомогательная
-/// 	функция замены подстрок в строке.
-/// 	Должна быть определена и доступна для корректной работы
-/// 	данной функции.
-@function convert-kebab2snake($value) {
-
-	// Проверка типа входного параметра: ожидается строковое значение.
-	// Функция is-string() проверяет, является ли $value строкой
-	// (тип данных string).
-	@if not is-string($value) {
-
-		// Если $value не является строкой, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// выполнение операции замены с некорректными данными.
-		@return log-invalid-type(
-			'convert-kebab2snake',
-			$value,
-			'$value',
-			'string'
-		);
-
-	}
-
-	// Основная логика выполняется только если $value является
-	// корректной строкой.
-	@else {
-
-		// Формула преобразования: заменяем все дефисы "-" на
-		// нижние подчеркивания "_".
-		@return string-replace($value, "-", "_");
-
-	}
-
-}

package/modules/utilities/converters/_convert-snake2kebab.scss

@@ -1,173 +0,0 @@
-@use '../helpers/string/string-replace' as *;
-@use '../loggers/log-invalid-type' as *;
-@use '../validators/type-of/is-string' as *;
-
-/// Преобразует строку из `snake_case` (змеиная нотация) в
-/// `kebab-case` (кебаб-нотация).
-///
-/// Функция заменяет все символы нижнего подчеркивания (`_`)
-/// на дефисы (`-`) в переданной строке. Это простое
-/// преобразование позволяет конвертировать имена переменных
-/// из языков программирования, использующих snake_case
-/// (Python, Ruby, PHP) в CSS-совместимый kebab-case формат.
-///
-/// Важные особенности функции:
-/// - Заменяет все вхождения нижнего подчеркивания на дефисы
-/// - Сохраняет все остальные символы без изменений
-/// - Не изменяет регистр символов
-/// - Работает с любыми строками, содержащими подчеркивания
-/// - Простая и эффективная реализация через замену символов
-/// - Полезно для конвертации имен из backend в frontend
-/// - Используется для унификации именования в full-stack проектах
-/// - Поддерживает строки любой длины и сложности
-/// - Обрабатывает множественные подчеркивания подряд
-/// - Учитывает граничные случаи (пустая строка, отсутствие
-/// 	подчеркиваний)
-/// ---
-/// @name convert-snake2kebab
-/// @group utilities-converters
-/// @since 2026.01.13
-/// @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/replace См. также: MDN Web Docs - Метод String.replace()
-/// @link https://developer.mozilla.org/en-US/docs/Glossary/Snake_case См. также: MDN Web Docs - Глоссарий: Snake_case
-/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_selectors См. также: MDN Web Docs - CSS селекторы
-/// @link https://css-tricks.com/snippets/sass/string-replace-function/ См. также: CSS-Tricks - Функция замены строк в Sass
-/// @link https://css-tricks.com/whats-the-difference-between-kebab-case-camel-case-and-snake-case/ См. также: CSS-Tricks - Разница между kebab-case, camelCase и snake_case
-/// @link https://sass-guidelin.es/ru/#section-42 См. также: Sass Guidelines - Раздел про строки
-/// @link https://www.python.org/dev/peps/pep-0008/ См. также: PEP 8 - Style Guide for Python Code
-/// @link https://rubystyle.guide/#naming См. также: Ruby Style Guide - Именование
-/// @example scss - Базовые преобразования
-/// 	@debug convert-snake2kebab('snake_case');           // 'snake-case'
-/// 	@debug convert-snake2kebab('background_color');     // 'background-color'
-/// 	@debug convert-snake2kebab('font_size');           // 'font-size'
-/// 	@debug convert-snake2kebab('border_radius');       // 'border-radius'
-/// 	@debug convert-snake2kebab('padding_left');        // 'padding-left'
-/// 	@debug convert-snake2kebab('margin_bottom');       // 'margin-bottom'
-/// @example scss - Множественные подчеркивания
-/// 	@debug convert-snake2kebab('border_top_left_radius');    // 'border-top-left-radius'
-/// 	@debug convert-snake2kebab('font_weight_bold');          // 'font-weight-bold'
-/// 	@debug convert-snake2kebab('text_decoration_line');      // 'text-decoration-line'
-/// 	@debug convert-snake2kebab('background_image_url');      // 'background-image-url'
-/// 	@debug convert-snake2kebab('grid_template_columns');     // 'grid-template-columns'
-/// 	@debug convert-snake2kebab('transition_property_all');   // 'transition-property-all'
-/// @example scss - Сложные случаи с цифрами и аббревиатурами
-/// 	@debug convert-snake2kebab('xml_http_request');          // 'xml-http-request'
-/// 	@debug convert-snake2kebab('css_animation');             // 'css-animation'
-/// 	@debug convert-snake2kebab('html5_canvas');              // 'html5-canvas'
-/// 	@debug convert-snake2kebab('ui_component');              // 'ui-component'
-/// 	@debug convert-snake2kebab('api_endpoint');              // 'api-endpoint'
-/// 	@debug convert-snake2kebab('user_id');                   // 'user-id'
-/// @example scss - Граничные случаи
-/// 	@debug convert-snake2kebab('single');                   // 'single'
-/// 	@debug convert-snake2kebab('');                         // '' (пустая строка)
-/// 	@debug convert-snake2kebab('already-kebab');           // 'already-kebab' (без изменений)
-/// 	@debug convert-snake2kebab('multiple___underscores');  // 'multiple---hyphens'
-/// 	@debug convert-snake2kebab('_leading_underscore');     // '-leading-underscore'
-/// 	@debug convert-snake2kebab('trailing_underscore_');    // 'trailing-underscore-'
-/// @example scss - Интеграция с Python/Ruby конфигурациями
-/// 	// Конвертация переменных из backend (Python/Ruby) в CSS
-/// 	$backend-variables: (
-/// 	  'primary_color': #3498db,
-/// 	  'secondary_color': #2ecc71,
-/// 	  'font_size_base': 16px,
-/// 	  'border_radius_small': 4px,
-/// 	  'max_width_container': 1200px
-/// 	);
-///
-/// 	:root {
-/// 	  @each $name, $value in $backend-variables {
-/// 	    --#{convert-snake2kebab($name)}: #{$value};
-/// 	  }
-/// 	}
-/// @example css - Результат интеграции с backend
-/// 	:root {
-/// 	  --primary-color: #3498db;
-/// 	  --secondary-color: #2ecc71;
-/// 	  --font-size-base: 16px;
-/// 	  --border-radius-small: 4px;
-/// 	  --max-width-container: 1200px;
-/// 	}
-/// @example scss - Работа с API-ответами
-/// 	// Преобразование ключей JSON из snake_case в kebab-case
-/// 	$api-response: (
-/// 	  'user_name': 'John Doe',
-/// 	  'email_address': 'john@example.com',
-/// 	  'is_active': true,
-/// 	  'created_at': '2023-01-15',
-/// 	  'updated_at': '2023-12-28'
-/// 	);
-///
-/// 	.user-data {
-/// 	  @each $key, $value in $api-response {
-/// 	    data-#{convert-snake2kebab($key)}: "#{$value}";
-/// 	  }
-/// 	}
-/// @example css - Результат для data-атрибутов
-/// 	.user-data {
-/// 	  data-user-name: "John Doe";
-/// 	  data-email-address: "john@example.com";
-/// 	  data-is-active: true;
-/// 	  data-created-at: "2023-01-15";
-/// 	  data-updated-at: "2023-12-28";
-/// 	}
-/// @param {String} $value - Строка в snake_case нотации для
-/// 	конвертации. Может содержать буквы, цифры, символы
-/// 	нижнего подчеркивания и другие символы. Функция заменяет
-/// 	все вхождения `_` на `-`, сохраняя остальные символы
-/// 	без изменений.
-/// @return {String} - Строка в kebab-case нотации, где все
-/// 	символы нижнего подчеркивания заменены на дефисы.
-/// 	Результат готов к использованию как CSS-класс, часть
-/// 	селектора или имя CSS-переменной.
-/// @throws {Error} - Может выбросить ошибку при передаче
-/// 	нестроковых значений или если функция `string-replace`
-/// 	не определена. Требуется наличие функции `string-replace`
-/// 	в доступном scope.
-/// @require {function} string-replace - Вспомогательная
-/// 	функция замены подстрок в строке из модуля `helpers`.
-/// 	Должна быть определена и доступна для корректной работы
-/// 	данной функции.
-@function convert-snake2kebab($value) {
-
-	// Проверка типа входного параметра: ожидается
-	// строковое значение.
-	// Функция is-string() проверяет, является ли $value
-	// строкой (тип данных string).
-	@if not is-string($value) {
-
-		// Если $value не является строкой, возвращаем ошибку
-		// через стандартную функцию логирования.
-		// Это предотвращает выполнение операции замены с
-		// некорректными данными.
-		@return log-invalid-type(
-			'convert-snake2kebab',
-			$value,
-			'$value',
-			'string'
-		);
-
-	} @else {
-
-		// Основная логика выполняется только если $value
-		// является корректной строкой.
-		//
-		// Используем вспомогательную функцию string-replace()
-		// для замены символов:
-		// - Первый параметр: $value - исходная строка для
-		// 	  преобразования
-		// - Второй параметр: "_" - искомый символ (нижнее
-		// 	  подчеркивание, snake_case разделитель)
-		// - Третий параметр: "-" - заменяющий символ (дефис,
-		// 	  kebab-case разделитель)
-		//
-		// Результат: строка, в которой все символы "_" заменены на "-".
-		@return string-replace($value, "_", "-");
-
-	}
-
-}

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

@@ -1,64 +0,0 @@
-/// Это карта соответствий между специальными символами URL и
-/// их кодированием (например, '#' → '%23'). Используется для
-/// автоматического корректного кодирования URL в SCSS.
-///
-/// Использование этой карты помогает избежать ручного
-/// кодирования, предотвращает ошибки и обеспечивает единообразие
-/// при генерации URL-адресов в проекте. Флаг `!default` означает,
-/// что переменная будет использована только если ранее не была
-/// определена, что позволяет её переопределить при необходимости.
-/// ---
-/// @name set-url-reserved-chars
-/// @group utilities-helpers
-/// @since 2026.01.13
-/// @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
-/// @prop {String} ' ' ['%20'] - Пробел
-/// @prop {String} '!' ['%21'] - Восклицательный знак
-/// @prop {String} '#' ['%23'] - Символ решетки
-/// @prop {String} '$' ['%24'] - Знак доллара
-/// @prop {String} '&' ['%26'] - Амперсанд
-/// @prop {String} '\'' ['%27'] - Одинарная кавычка
-/// @prop {String} '(' ['%28'] - Открывающая скобка
-/// @prop {String} ')' ['%29'] - Закрывающая скобка
-/// @prop {String} '*' ['%2A'] - Звездочка
-/// @prop {String} '+' ['%2B'] - Знак плюса
-/// @prop {String} ',' ['%2C'] - Запятая
-/// @prop {String} '/' ['%2F'] - Слеш
-/// @prop {String} ':' ['%3A'] - Двоеточие
-/// @prop {String} ';' ['%3B'] - Точка с запятой
-/// @prop {String} '=' ['%3D'] - Знак равенства
-/// @prop {String} '?' ['%3F'] - Вопросительный знак
-/// @prop {String} '@' ['%40'] - Символ "собака"
-/// @prop {String} '[' ['%5B'] - Открывающая квадратная скобка
-/// @prop {String} ']' ['%5D'] - Закрывающая квадратная скобка
-/// @prop {String} '"' ['%22'] - Двойная кавычка
-/// @see url-encode
-/// @type Map
-$set-url-reserved-chars: (
-	' ': '%20',
-	'!': '%21',
-	'#': '%23',
-	'$': '%24',
-	'&': '%26',
-	'\'': '%27',
-	'(': '%28',
-	')': '%29',
-	'*': '%2A',
-	'+': '%2B',
-	',': '%2C',
-	'/': '%2F',
-	':': '%3A',
-	';': '%3B',
-	'=': '%3D',
-	'?': '%3F',
-	'@': '%40',
-	'[': '%5B',
-	']': '%5D',
-	// Если результат заключен в двойные кавычки
-	'"': '%22'
-) !default;