@omnisass/library 0.2.0

package/modules/utilities/helpers/list/_list-remove-at.scss

@@ -0,0 +1,160 @@
+@use 'sass:list';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-list' as *;
+@use '../../validators/type-of/is-number' as *;
+
+/// Удаляет элемент из списка по указанному индексу.
+///
+/// Функция создает новый список, копируя все элементы
+/// исходного списка, за исключением элемента с указанным
+/// индексом. Исходный список не изменяется. Индексация в
+/// Sass начинается с 1 (1-based indexing).
+///
+/// Важные особенности функции:
+/// - Использует 1-based индексацию (первый элемент имеет
+/// 	индекс 1)
+/// - Не изменяет исходный список, возвращает новый
+/// - Не проверяет валидность индекса (выход за границы
+/// 	игнорируется)
+/// - Поддерживает любые типы элементов в списке
+/// - Сохраняет порядок оставшихся элементов
+/// - Использует локальные переменные с префиксом `$-` для
+/// 	избежания конфликтов
+/// ---
+/// @name list-remove-at
+/// @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/list#nth См. также: Официальная документация Sass - Функция list.nth()
+/// @link https://sass-lang.com/documentation/modules/list#length См. также: Официальная документация Sass - Функция list.length()
+/// @link https://sass-lang.com/documentation/values/lists См. также: Официальная документация Sass - Тип данных "Списки"
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/splice MDN Web Docs - Array.splice()
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#list-functions См. также: Sass Guidelines - Функции для работы со списками
+/// @link https://frontender.info/sass-lists/ См. также: Frontender Magazine - Работа со списками в Sass
+/// @link https://www.w3schools.com/sass/sass_functions_list.php См. также: W3Schools - Функции для работы со списками в Sass
+/// @link https://habr.com/ru/post/156549/ См. также: Habr - Статья "Sass для верстальщика: списки и циклы"
+/// @example scss - Удаление элемента по индексу
+/// 	@debug list-remove-at((a, b, c, d, e), 3);    // (a, b, d, e)
+/// 	@debug list-remove-at((10, 20, 30, 40), 1);   // (20, 30, 40)
+/// 	@debug list-remove-at((red, blue, green), 2); // (red, green)
+/// @example scss - Удаление первого и последнего элементов
+/// 	@debug list-remove-at((a, b, c, d), 1);     // (b, c, d)
+/// 	@debug list-remove-at((a, b, c, d), 4);     // (a, b, c)
+/// 	$colors: (#ff0000, #00ff00, #0000ff);
+/// 	@debug list-remove-at($colors, list.length($colors)); // (#ff0000, #00ff00)
+/// @example scss - Граничные случаи и невалидные индексы
+/// 	@debug list-remove-at((a, b, c), 0);        // (a, b, c) (индекс 0 игнорируется)
+/// 	@debug list-remove-at((a, b, c), 5);        // (a, b, c) (индекс > длины)
+/// 	@debug list-remove-at((), 1);               // Error: $n: List index may not be 0.
+/// 	@debug list-remove-at((single), 1);         // () (удаление единственного элемента)
+/// @example scss - Сохранение оригинального списка
+/// 	$original: (apple, banana, cherry);
+/// 	$modified: list-remove-at($original, 2);
+/// 	@debug $original;  // (apple, banana, cherry)
+/// 	@debug $modified;  // (apple, cherry)
+/// @example scss - Практическое использование для удаления классов
+/// 	$button-classes: (btn, btn-primary, btn-lg, active, disabled);
+/// 	$clean-classes: list-remove-at($button-classes, 5); // Удаляем 'disabled'
+/// 	// .button { @each $class in $clean-classes { ... } }
+/// @example scss - Удаление значения из списка медиа-запросов
+/// 	$breakpoints: (320px, 768px, 1024px, 1280px);
+/// 	$mobile-breakpoints: list-remove-at($breakpoints, 4); // Удаляем 1280px
+/// 	// @include media($mobile-breakpoints) { ... }
+/// @example scss - Создание подсписка с пропуском элемента
+/// 	$days: (mon, tue, wed, thu, fri, sat, sun);
+/// 	$weekdays: list-remove-at(list-remove-at($days, 7), 6); // Удаляем выходные
+/// 	@debug $weekdays;  // (mon, tue, wed, thu, fri)
+/// @param {List} $list - Исходный список, из которого
+/// 	нужно удалить элемент. Может содержать элементы
+/// 	любых типов и может быть пустым.
+/// @param {Number} $index - Индекс элемента для удаления.
+/// 	Используется 1-based индексация (первый элемент = 1).
+/// 	Если индекс выходит за границы списка (меньше 1 или
+/// 	больше длины списка), функция вернет исходный список
+/// 	без изменений.
+/// @return {List} - Новый список, содержащий все элементы
+/// 	исходного списка, кроме элемента с указанным индексом.
+/// 	Если индекс невалиден, возвращается исходный список.
+/// 	Если удаляется единственный элемент, возвращается
+/// 	пустой список `()`.
+/// @throws {Error} - Не выбрасывает ошибок при невалидных
+/// 	индексах, но может выбросить ошибку если `$index` не
+/// 	является числом.
+@function list-remove-at($list, $index) {
+
+	// Проверка типа первого параметра: ожидается список или arglist.
+	// Функция is-list() проверяет, является ли $list валидным списком
+	// или arglist (специальный тип для переменного числа аргументов).
+	@if not is-list($list) {
+
+		// Если $list не является списком, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с некорректными данными.
+		@return log-invalid-type(
+			'list-remove-at',
+			$list,
+			'$list',
+			('list', 'arglist')
+		);
+
+	}
+
+	// Проверка типа второго параметра: ожидается числовое значение индекса.
+	// $index определяет позицию элемента, который нужно удалить из списка.
+	@else if not is-number($index) {
+
+		// Если $index не является числом, возвращаем ошибку.
+		// Проверка выполняется только если $list прошел валидацию.
+		@return log-invalid-type(
+			'list-remove-at',
+			$index,
+			'$index',
+			'number'
+		);
+
+	}
+
+	// Все параметры прошли валидацию - выполняем удаление элемента.
+	@else {
+
+		// Инициализация переменной для хранения результата.
+		// $-result будет содержать новый список без удаленного элемента.
+		$-result: ();
+
+		// Определение длины исходного списка.
+		// Функция list.length() возвращает количество элементов в списке.
+		$-length: list.length($list);
+
+		// Цикл по всем элементам исходного списка.
+		// Переменная $i принимает значения от 1 до $-length включительно.
+		@for $i from 1 through $-length {
+
+			// Проверка: не является ли текущий индекс целевым индексом удаления.
+			@if $i != $index {
+
+				// Если текущий индекс НЕ равен индексу удаления,
+				// добавляем элемент в результат.
+				// - Функция list.nth() извлекает элемент списка по
+				//   указанному индексу.
+				// - Функция list.append() добавляет элемент в конец
+				//   списка результата.
+				$-result: list.append($-result, list.nth($list, $i));
+
+			}
+
+		}
+
+		// Возвращаем новый список без удаленного элемента.
+		// Если индекс был в пределах длины списка (1 ≤ $index ≤ $-length),
+		// соответствующий элемент будет пропущен. Если индекс вне диапазона,
+		// исходный список вернется без изменений. Порядок оставшихся
+		// элементов сохраняется.
+		@return $-result;
+
+	}
+
+}

package/modules/utilities/helpers/list/_list-sum-numbers-safe.scss

@@ -0,0 +1,175 @@
+@use 'sass:math';
+@use 'sass:meta';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-list' as *;
+@use '../../validators/type-of/is-number' as *;
+
+/// Безопасно суммирует числовые значения в списке с
+/// проверкой единиц измерения.
+///
+/// Функция проходит по всем элементам списка и суммирует
+/// только числовые элементы, при этом проверяя совместимость
+/// единиц измерения. Все числовые элементы должны иметь
+/// одинаковые единицы измерения или быть безразмерными.
+///
+/// Элементы с несовместимыми единицами пропускаются с
+/// выводом предупреждения.
+///
+/// Ключевые особенности функции:
+/// - Проверяет совместимость единиц измерения всех чисел
+/// - Принимает только числа с одинаковыми единицами или
+/// 	безразмерные
+/// - Безразмерные числа (без единиц) совместимы с любыми
+/// 	единицами
+/// - Использует единицы измерения первого найденного числа
+/// 	как эталон
+/// - Игнорирует нечисловые элементы без предупреждений
+/// - Выводит предупреждение для чисел с несовместимыми
+/// 	единицами
+/// - Использует локальные переменные с префиксом `$-` для
+/// 	избежания конфликтов
+/// ---
+/// @name list-sum-numbers-safe
+/// @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/values/numbers#units См. также: Официальная документация Sass - Числа и единицы измерения
+/// @link https://sass-lang.com/documentation/modules/math#unit См. также: Официальная документация Sass - Функция math.unit()
+/// @link https://sass-lang.com/documentation/modules/math#compatible См. также: Официальная документация Sass - Функция math.compatible()
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/calc MDN Web Docs - CSS функция calc()
+/// @link https://stackoverflow.com/questions/16455752/sass-sum-up-a-list-of-numbers Stack Overflow - Суммирование списка чисел в Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#list-functions См. также: Sass Guidelines - Функции для работы со списками
+/// @link https://frontender.info/sass-lists/ См. также: 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 list-sum-numbers-safe((10px, 20px, 30px));   // 60px
+/// 	@debug list-sum-numbers-safe((1rem, 2rem, 0.5rem)); // 3.5rem
+/// 	@debug list-sum-numbers-safe((50%, 30%, 20%));      // 100%
+/// @example scss - Суммирование безразмерных чисел
+/// 	@debug list-sum-numbers-safe((10, 20, 30));    // 60
+/// 	@debug list-sum-numbers-safe((0.1, 0.2, 0.3)); // 0.6
+/// 	@debug list-sum-numbers-safe((1, 2px, 3));     // 4 (пропускает 2px)
+/// @example scss - Обработка смешанных единиц измерения
+/// 	@debug list-sum-numbers-safe((10px, 2em, 30px));
+/// 	// Предупреждение: "Пропускаю элемент 2em: несовместимые единицы (em vs px)"
+/// 	// Возвращает: 40px (только 10px + 30px)
+/// @example scss - Смешанные типы данных
+/// 	@debug list-sum-numbers-safe((10px, "текст", 20px, #fff, 5px)); // 35px
+/// 	@debug list-sum-numbers-safe((1, true, 2, null, 3));              // 6
+/// 	@debug list-sum-numbers-safe(("only", "strings"));                // 0
+/// @example scss - Пустые списки и крайние случаи
+/// 	@debug list-sum-numbers-safe(());                  // 0
+/// 	@debug list-sum-numbers-safe(none);                // 0
+/// 	@debug list-sum-numbers-safe((10px));              // 10px
+/// 	@debug list-sum-numbers-safe((10px, 20em, 30rem)); // 10px (только первый элемент)
+/// @example scss - Практическое использование для margin/padding
+/// 	$margins: 10px, 20px, 15px, 5px;
+/// 	@debug list-sum-numbers-safe($margins); // 50px
+/// @example scss - Суммирование процентных значений
+/// 	$widths: 25%, 25%, 25%, 25%;
+/// 	@debug list-sum-numbers-safe($widths); // 100%
+/// @see list-sum-numbers
+/// @param {List} $list - Список значений, который может
+/// 	содержать элементы разных типов. Функция будет
+/// 	обрабатывать только числовые элементы.
+/// @return {Number} - Сумма всех числовых элементов с
+/// 	совместимыми единицами измерения. Если в списке нет
+/// 	числовых элементов или все они имеют несовместимые
+/// 	единицы, возвращает `0`. Возвращает сумму в единицах
+/// 	измерения первого найденного числа.
+/// @throws {Warning} - Выводит предупреждение при обнаружении
+/// 	чисел с несовместимыми единицами измерения.
+@function list-sum-numbers-safe($list) {
+
+	// Проверка типа входного параметра: ожидается список или arglist.
+	// Функция is-list() проверяет, является ли $list валидным списком
+	// или arglist (специальный тип для переменного числа аргументов).
+	@if not is-list($list) {
+
+		// Если $list не является списком, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с некорректными данными.
+		@return log-invalid-type(
+			'list-sum-numbers-safe',
+			$list,
+			'$list',
+			('list', 'arglist')
+		);
+
+	}
+
+	// Основная логика выполняется только если $list является
+	// корректным списком или arglist.
+	@else {
+
+		// Инициализация переменной для хранения суммы чисел.
+		// $-sum будет содержать итоговую сумму совместимых числовых элементов.
+		$-sum: 0;
+
+		// Переменная для хранения единицы измерения первого найденного числа.
+		// Используется для проверки совместимости единиц измерения
+		// всех последующих чисел.
+		$-first-unit: null;
+
+		// Итерация по всем элементам исходного списка.
+		// Переменная $-item содержит текущий обрабатываемый элемент.
+		@each $-item in $list {
+
+			// Проверка: является ли текущий элемент числом.
+			// Функция is-number() возвращает true для числовых значений.
+			@if is-number($-item) {
+
+				// Проверка: является ли это первым найденным числом в списке.
+				@if $-first-unit == null {
+
+					// Если это первое число:
+					// 1. Сохраняем его единицу измерения для последующей проверки
+					//    Функция math.unit() возвращает единицу измерения числа как строку.
+					// 2. Инициализируем сумму значением этого числа
+					$-first-unit: math.unit($-item);
+					$-sum: $-item;
+
+				}
+
+				// Проверка: совместимы ли единицы измерения текущего числа
+				// с единицей измерения первого числа.
+				// Условие выполняется, если:
+				// 1. Единицы измерения совпадают (math.unit($-item) == $-first-unit)
+				// 2. Текущее число безразмерное (math.unit($-item) == '')
+				@else if math.unit($-item) == $-first-unit or math.unit($-item) == '' {
+
+					// Если единицы измерения совместимы, добавляем число к сумме.
+					// Оператор + в Sass автоматически проверяет совместимость единиц,
+					// но мы уже выполнили проверку выше для безопасности.
+					$-sum: $-sum + $-item;
+
+				} @else {
+
+					// Если единицы измерения не совместимы:
+					// Выводим предупреждение в консоль с информацией о пропущенном элементе.
+					// Функция meta.inspect() преобразует значение в читаемую строку.
+					// Функция math.unit() возвращает единицу измерения числа.
+					// Это предупреждение помогает выявить потенциальные ошибки в данных.
+					@warn "Пропускаю элемент «#{meta.inspect($-item)}»: единица «#{math.unit($-item)}» несовместима с «#{$-first-unit}»!";
+
+				}
+
+			}
+
+		}
+
+		// Возвращаем итоговую сумму совместимых числовых элементов.
+		// Если в списке не было чисел или все числа были пропущены из-за
+		// несовместимости единиц измерения, возвращается 0 (начальное значение).
+		// Единица измерения результата соответствует единице измерения
+		// первого добавленного числа.
+		@return $-sum;
+
+	}
+
+}

package/modules/utilities/helpers/list/_list-sum-numbers.scss

@@ -0,0 +1,128 @@
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-list' as *;
+@use '../../validators/type-of/is-number' as *;
+
+/// Суммирует все числовые значения в списке.
+///
+/// Функция проходит по всем элементам переданного списка и
+/// суммирует только те элементы, которые являются числами.
+/// Нечисловые элементы (строки, цвета, списки, карты и т.д.)
+/// игнорируются без вывода ошибок.
+///
+/// Важные особенности функции:
+/// - Игнорирует все нечисловые элементы без предупреждений
+/// - Возвращает 0 для пустых списков или списков без чисел
+/// - Использует локальные переменные с префиксом `$-` для
+/// 	избежания конфликтов
+/// - Сохраняет единицы измерения первого числового элемента
+/// - Может вызвать ошибку при сложении несовместимых единиц
+/// ---
+/// @name list-sum-numbers
+/// @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/values/numbers#units См. также: Официальная документация Sass - Числа и единицы измерения
+/// @link https://sass-lang.com/documentation/modules/math См. также: Официальная документация Sass - Модуль math
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/calc MDN Web Docs - CSS функция calc()
+/// @link https://stackoverflow.com/questions/16455752/sass-sum-up-a-list-of-numbers Stack Overflow - Суммирование списка чисел в Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#list-functions См. также: Sass Guidelines - Функции для работы со списками
+/// @link https://frontender.info/sass-lists/ См. также: 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 list-sum-numbers((10, 20, 30, 40)); // 100
+/// 	@debug list-sum-numbers((1, 2, 3, 4, 5));  // 15
+/// 	@debug list-sum-numbers((0.1, 0.2, 0.3));  // 0.6
+/// @example scss - Суммирование чисел с единицами измерения
+/// 	@debug list-sum-numbers((10px, 20px, 30px));   // 60px
+/// 	@debug list-sum-numbers((1rem, 2rem, 0.5rem)); // 3.5rem
+/// 	@debug list-sum-numbers((50%, 30%));           // 80%
+/// @example scss - Обработка смешанных типов данных
+/// 	@debug list-sum-numbers((10, "text", 20, #fff, 30)); // 10text20#fff30
+/// 	@debug list-sum-numbers((true, false, null, 5));     // 0truefalse5
+/// 	@debug list-sum-numbers((1px, 2em, 3rem));        // Ошибка: несовместимые единицы
+/// @example scss - Пустые списки и отсутствие чисел
+/// 	@debug list-sum-numbers(());              // 0
+/// 	@debug list-sum-numbers(("a", "b", "c")); // 0abc
+/// 	@debug list-sum-numbers(none);            // 0none
+/// @example scss - Практическое использование
+/// 	$margins: 10px, 20px, 15px, 5px;
+/// 	@debug list-sum-numbers($margins); // $total-margin: 50px
+/// @example scss - Суммирование с разными единицами (осторожно!)
+/// 	// Будет работать только если единицы совместимы
+/// 	@debug list-sum-numbers((10px, 2cm, 3mm));          // 96.9291338582677px, но может вызвать ошибку
+/// @see list-sum-numbers-safe
+/// @param {List} $list - Список значений, который может
+/// 	содержать элементы разных типов. Функция будет
+/// 	обрабатывать только числовые элементы.
+/// @return {Number} - Сумма всех числовых элементов списка.
+/// 	Если в списке нет числовых элементов, возвращает `0`.
+/// 	Единицы измерения сохраняются, но могут быть
+/// 	несовместимыми (например, 10px + 2em вызовет ошибку).
+/// @throws {Error} - Может выбросить ошибку при попытке
+/// 	сложить числа с несовместимыми единицами измерения
+/// 	(например, px + em).
+@function list-sum-numbers($list) {
+
+	// Проверка типа входного параметра: ожидается список или arglist.
+	// Функция is-list() проверяет, является ли $list валидным списком
+	// или arglist (специальный тип для переменного числа аргументов).
+	@if not is-list($list) {
+
+		// Если $list не является списком, возвращаем ошибку через
+		// стандартную функцию логирования. Это предотвращает
+		// некорректные вычисления с некорректными данными.
+		@return log-invalid-type(
+			'list-sum-numbers',
+			$list,
+			'$list',
+			('list', 'arglist')
+		);
+
+	}
+
+	// Основная логика выполняется только если $list является
+	// корректным списком или arglist.
+	@else {
+
+		// Инициализация переменной для хранения суммы чисел.
+		// $-sum будет содержать итоговую сумму всех числовых элементов
+		// в списке. Начальное значение 0 гарантирует корректный результат
+		// даже для пустых списков или списков без числовых элементов.
+		$-sum: 0;
+
+		// Итерация по всем элементам исходного списка.
+		// Переменная $-item содержит текущий обрабатываемый элемент.
+		@each $-item in $list {
+
+			// Проверка: является ли текущий элемент числом.
+			// Функция is-number() возвращает true для числовых значений,
+			// включая числа с единицами измерения (px, rem, em и т.д.)
+			// и безразмерные числа.
+			@if is-number($-item) {
+
+				// Если элемент является числом, добавляем его к общей сумме.
+				// Оператор + в Sass автоматически складывает числа,
+				// учитывая их единицы измерения. Если единицы измерения
+				// несовместимы (например, px + em), Sass вызовет ошибку
+				// компиляции на этом этапе.
+				$-sum: $-sum + $-item;
+
+			}
+
+		}
+
+		// Возвращаем итоговую сумму всех числовых элементов.
+		// Если в списке не было чисел, возвращается 0 (начальное значение).
+		// Если были числа с единицами измерения, результат будет иметь
+		// те же единицы измерения, что и первое найденное число
+		// (при условии совместимости всех единиц).
+		@return $-sum;
+
+	}
+
+}

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

@@ -0,0 +1,64 @@
+/// Это карта соответствий между специальными символами 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;