@omnisass/library 0.4.0 → 0.5.0

package/modules/utilities/setters/map/_set-map-item.scss

@@ -0,0 +1,243 @@
+@use 'sass:map';
+@use 'sass:list';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../loggers/log' as *;
+@use '../../validators/type-of/is-map' as *;
+
+/// Устанавливает значение во вложенную карту по цепочке ключей.
+///
+/// Функция позволяет безопасно обновить значение в глубоко
+/// вложенной структуре карт, создавая недостающие уровни
+/// автоматически. В отличие от стандартного `map.merge()`,
+/// эта функция работает с произвольной вложенностью и
+/// сохраняет неизменёнными все остальные части структуры.
+/// Это особенно полезно при работе с темами, конфигурациями
+/// и другими сложными древовидными данными.
+///
+/// Функция использует двухпроходной алгоритм:
+/// 1. Сначала собирает все уровни карты по пути следования
+/// 2. Затем рекурсивно собирает новую карту, подставляя
+///    обновлённое значение на нужном уровне
+///
+/// Важные особенности функции:
+/// - Сохраняет неизменными все не затронутые обновлением части
+/// - Автоматически создаёт недостающие уровни карты
+/// - Предупреждает о переопределении карты значением
+/// - Останавливается с ошибкой при отсутствии ключа
+/// - Работает с любым уровнем вложенности
+/// - Возвращает полностью новую карту, не мутируя исходную
+/// - Поддерживает любые типы значений (строки, числа, списки)
+/// - Интегрируется с системой логирования для отладки
+/// - Позволяет безопасно обновлять конфигурации тем
+/// - Упрощает работу с глубокими структурами данных
+/// ---
+/// @name set-map-item
+/// @group utilities-setters
+/// @since 2026.01.14
+/// @access public
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @author Kitty Giraudel
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
+/// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
+/// @link https://github.com/KittyGiraudel GitHub - Kitty Giraudel
+/// @link https://sass-lang.com/documentation/values/maps См. также: Официальная документация Sass - Тип данных "Карты" (`maps`)
+/// @link https://sass-lang.com/documentation/modules/map См. также: Официальная документация Sass - Модуль `sass:map`
+/// @link https://sass-lang.com/documentation/modules/map#merge См. также: Официальная документация Sass - Функция `map.merge()`
+/// @link https://sass-lang.com/documentation/modules/map#get См. также: Официальная документация Sass - Функция `map.get()`
+/// @link https://sass-lang.com/documentation/modules/list См. также: Официальная документация Sass - Модуль `sass:list`
+/// @link https://sass-lang.com/documentation/at-rules/function См. также: Официальная документация Sass - Правило `@function`
+/// @link https://sass-guidelin.es/ru/#maps-1 См. также: Sass Guidelines - Манипуляции с картами
+/// @link https://css-tricks.com/snippets/sass/deep-getset-maps/ См. также: CSS-Tricks - Deep Get/Set для Sass Maps
+/// @link https://www.sitepoint.com/using-sass-maps/ См. также: SitePoint - Использование карт Sass
+/// @link https://www.smashingmagazine.com/2015/07/real-work-sass-maps/ См. также: Smashing Magazine - Реальная работа с картами Sass
+/// @link https://dev.to/marcelle/understanding-sass-maps-3fhj См. также: Dev.to - Понимание карт Sass
+/// @link https://code.tutsplus.com/tutorials/an-introduction-to-sass-maps--cms-22138 См. также: Envato Tuts+ - Введение в карты Sass
+/// @link https://habr.com/ru/post/309656/ См. также: Habr - Карты данных (maps) в Sass
+/// @link https://htmlacademy.ru/blog/boost/tools/sass-maps См. также: HTML Academy - Sass-карты: практическое руководство
+/// @link https://ru.hexlet.io/courses/sass-basics/lessons/maps/theory_unit См. также: Hexlet - Карты в Sass
+/// @link https://www.youtube.com/watch?v=6kUo6lBF0Cc См. также: YouTube - Работа с картами в Sass
+/// @link https://www.youtube.com/watch?v=WSfRZjyUTgg См. также: YouTube - Продвинутая работа с картами Sass
+/// @link https://stackoverflow.com/questions/37705095/sass-get-value-from-nested-map См. также: Stack Overflow - Получение значения из вложенной карты
+/// @link https://stackoverflow.com/questions/40774889/sass-update-nested-map-value См. также: Stack Overflow - Обновление значения во вложенной карте
+/// @link https://stackoverflow.com/questions/47802171/sass-merge-nested-maps См. также: Stack Overflow - Слияние вложенных карт
+/// @link https://github.com/sass/sass/tree/main/spec См. также: GitHub - Спецификация языка Sass
+/// @link https://www.npmjs.com/package/sass См. также: npm - Пакет Dart Sass
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map См. также: MDN Web Docs - JavaScript объект Map
+/// @link https://en.wikipedia.org/wiki/Associative_array См. также: Wikipedia - Ассоциативный массив
+/// @link https://en.wikipedia.org/wiki/Tree_(data_structure) См. также: Wikipedia - Древовидные структуры данных
+/// @link https://ru.wikipedia.org/wiki/%D0%90%D1%81%D1%81%D0%BE%D1%86%D0%B8%D0%B0%D1%82%D0%B8%D0%B2%D0%BD%D1%8B%D0%B9_%D0%BC%D0%B0%D1%81%D1%81%D0%B8%D0%B2 См. также: Wikipedia - Ассоциативный массив (рус.)
+/// @example scss - Базовое использование с плоской картой
+/// 	$breakpoints: (
+/// 	  mobile: 480px,
+/// 	  tablet: 768px
+/// 	);
+///
+/// 	@debug set-map-item($breakpoints, (desktop), 1024px); // Результат: (mobile: 480px, tablet: 768px, desktop: 1024px)
+///
+/// @example scss - Обновление значения во вложенной карте
+/// 	$theme: (
+/// 	  colors: (
+/// 	    primary: #3498db,
+/// 	    secondary: #2ecc71
+/// 	  ),
+/// 	  fonts: (
+/// 	    base: 16px,
+/// 	    headings: (
+/// 	      h1: 2rem,
+/// 	      h2: 1.5rem
+/// 	    )
+/// 	  )
+/// 	);
+///
+/// 	@debug set-map-item($theme, (colors, primary), #e74c3c); // Debug: (colors: (primary: #e74c3c, secondary: #2ecc71), fonts: (base: 16px, headings: (h1: 2rem, h2: 1.5rem)))
+///
+/// @example scss - Создание новых уровней вложенности
+/// 	$config: (
+/// 	  api: (
+/// 	    version: 'v1'
+/// 	  )
+/// 	);
+///
+/// 	@debug set-map-item(
+/// 	  $config,
+/// 	  (api, endpoints, users),
+/// 	  '/api/v1/users'
+/// 	); // Error: "🟥 Ключ «endpoints» не существует на текущем уровне карты."
+///
+/// @param {Map} $map - Исходная карта, в которую
+///   устанавливается значение. Остаётся неизменной,
+///   функция возвращает новую карту.
+/// @param {List} $keys - Список ключей, образующих путь
+///   к месту установки значения. Ключи перечисляются
+///   последовательно, от внешнего уровня к внутреннему.
+/// @param {*} $value - Значение, которое нужно установить
+///   по указанному пути. Может быть любого типа: строка,
+///   число, список, карта и т.д.
+/// @return {Map} - Новая карта с установленным значением.
+///   Исходная карта остаётся неизменной.
+/// @throws {Error} - Выбрасывает ошибку через функцию
+///   `log()`, если промежуточный ключ не существует
+///   на своём уровне карты.
+/// @throws {Warning} - Выводит предупреждение через
+///   функцию `log()`, если последний ключ является картой.
+///   Предупреждение информирует о том, что карта будет
+///   переопределена новым значением.
+@function set-map-item($map, $keys, $value) {
+
+	// Создаём список для хранения всех уровней карты,
+	// которые мы встретим при прохождении по ключам.
+	// Начинаем с исходной карты.
+	$-maps: ($map,);
+
+	$key: null;
+
+	// Переменная для хранения результата сборки.
+	// Будет заполнена на втором проходе.
+	$-result: null;
+
+	// Проверяем, не пытается ли пользователь переопределить
+	// карту значением. Если последний ключ — это карта,
+	// предупреждаем об этом, потому что карта будет заменена
+	// на новое значение, что может привести к потере данных.
+	@if is-map(list.nth($keys, -1)) {
+
+		// Сообщение предупреждения о переопределении карты.
+		// Содержит значение, которым будет заменена карта.
+		$-log-map-key-override: (
+			en: 'The last key you specified is a map; it will be redefined using «#{$value}».',
+			ru: 'Последний указанный вами ключ — это карта; он будет переопределен с помощью «#{$value}».'
+		);
+
+		// Выводим предупреждение через систему логирования
+		// и возвращаем null (логирование само вернёт null).
+		@return log($-log-map-key-override, 'warn');
+
+	}
+
+	// Проверяем, что первый аргумент действительно
+	// является картой.
+	@if not is-map($map) {
+
+		// Если это не так, вызываем функцию логирования ошибки
+		// и возвращаем её результат.
+		// Функция log-invalid-type должна обработать некорректный
+		// тип и вернуть null (или выбросить ошибку в зависимости
+		// от настроек).
+		@return log-invalid-type(
+			'set-map-item',
+			$map,
+			'$map',
+			'map'
+		);
+
+	}
+
+	// Если передан только один ключ, используем простой map.merge().
+	// Это оптимизация для частного случая плоской карты.
+	@if list.length($keys) == 1 {
+		@return map.merge($map, ($keys: $value));
+	}
+
+	// ПЕРВЫЙ ПРОХОД: Собираем все уровни карты
+	// Проходим по всем ключам, кроме последнего (последний
+	// будет заменён новым значением).
+	@for $-i from 1 through list.length($keys) - 1 {
+
+		// Текущий ключ из списка ключей
+		$-current-key: list.nth($keys, $-i);
+
+		// Текущая карта (последняя добавленная в $-maps)
+		$-current-map: list.nth($-maps, -1);
+
+		// Пытаемся получить значение по текущему ключу
+		$-current-get: map.get($-current-map, $-current-key);
+
+		// Если ключ не существует на текущем уровне,
+		// это критическая ошибка — мы не можем продолжить.
+		@if $-current-get == null {
+
+			// Сообщение об ошибке отсутствия ключа.
+			// Указывает, какой именно ключ не найден.
+			$-log-map-key-missing: (
+				en: 'The key «#{$-current-key}» does not exist at the current map level.',
+				ru: 'Ключ «#{$-current-key}» не существует на текущем уровне карты.'
+			);
+
+			// Выбрасываем ошибку через систему логирования.
+			// Ошибка остановит компиляцию.
+			@return log($-log-map-key-missing, 'error');
+
+		}
+
+		// Добавляем найденное значение в список карт.
+		// Оно станет текущей картой для следующей итерации.
+		$-maps: list.append($-maps, $-current-get);
+
+	}
+
+	// ВТОРОЙ ПРОХОД: Собираем новую карту снизу вверх
+	// Идём от последнего уровня к первому, встраивая
+	// обновлённые значения.
+	@for $-i from list.length($-maps) through 1 {
+
+		// Текущая карта для этого уровня
+		$-current-map: list.nth($-maps, $-i);
+
+		// Ключ для этого уровня
+		$-current-key: list.nth($keys, $-i);
+
+		// Определяем значение, которое нужно установить:
+		// - Если это последний уровень, используем переданное $value
+		// - Иначе используем результат предыдущей сборки ($-result)
+		$-current-val: if(sass($-i == list.length($-maps)): $value; else: $-result);
+
+		// Объединяем текущую карту с новым значением по ключу
+		// Результат сохраняем в $-result для следующего уровня
+		$-result: map.merge($-current-map, ($-current-key: $-current-val));
+
+	}
+
+	// Возвращаем полностью собранную новую карту
+	@return $-result;
+
+}

package/modules/utilities/validators/color/_is-color-light.scss

@@ -127,10 +127,11 @@
 /// 	используется значение 50%, которое является
 /// 	общепринятым разделением между светлыми и темными
 /// 	тонами. Можно изменить для тонкой настройки.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `color` ($color) или
-/// 	`number` (`$threshold`). Компиляция Sass будет остановлена
-/// 	с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$color` → `color`
+/// - `$threshold` → `number`
 @function is-color-light($color, $threshold: 50) {
 
 	// Проверка типа первого параметра: ожидается цветовое значение.

package/modules/utilities/validators/color/_is-color-list.scss

@@ -103,9 +103,10 @@
 /// 	в списке являются цветами. Возвращает `false`, если
 /// 	хотя бы один элемент не является цветом. Для пустого
 /// 	списка возвращает `true`.
-/// @throws {Error} - Выбрасывает ошибку, если параметру `$list` передано
-/// 	значение, не соответствующее типу `list`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$list` → `list`
 @function is-color-list($list) {
 
 	// Проверка типа входного параметра: ожидается список или arglist.

package/modules/utilities/validators/list/_is-list-contained.scss

@@ -56,13 +56,14 @@
 ///
 /// 		position: $position;
 /// 	}
-/// @param {*} $value - Значение для поиска в списке
 /// @param {List} $list - Список, в котором выполняется поиск
+/// @param {*} $value - Значение для поиска в списке
 /// @return {Boolean} - Возвращает `true`, если значение
 /// 	найдено в списке, иначе возвращает `false`.
-/// @throws {Error} - Выбрасывает ошибку, если параметру `$list` передано
-/// 	значение, не соответствующее типу `list`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$list` → `list`
 @function is-list-contained($list, $value) {
 
 	// Проверка типа первого параметра: ожидается список или arglist.

package/modules/utilities/validators/number/_is-int-even.scss

@@ -64,9 +64,10 @@
 /// 	является целым числом и делится на 2 без остатка.
 /// 	Во всех остальных случаях возвращает `false`,
 /// 	включая нецелые числа и значения других типов.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
 @function is-int-even($value) {
 
 	// Проверка типа входного параметра: ожидается числовое значение.

package/modules/utilities/validators/number/_is-int-odd.scss

@@ -65,9 +65,10 @@
 /// 	является целым числом и не делится на 2 без остатка.
 /// 	Во всех остальных случаях возвращает `false`,
 /// 	включая нецелые числа и значения других типов.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
 @function is-int-odd($value) {
 
 	// Проверка типа входного параметра: ожидается числовое значение.

package/modules/utilities/validators/number/_is-int.scss

@@ -120,9 +120,11 @@
 /// 	строгой проверки типов.
 /// @return {Boolean} - `true` если значение является
 /// 	целым числом, `false` во всех остальных случаях.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
+/// - `$set-strict-mode-local` → `boolean`
 @function is-int($value, $set-strict-mode-local: true) {
 
 	// Проверка строгого режима: если включен, выполняется

package/modules/utilities/validators/number/_is-number-has-unit.scss

@@ -78,9 +78,10 @@
 /// 	`math.unit($value)` не является пустой строкой).
 /// 	Возвращает `false` для безразмерных чисел и всех
 /// 	нечисловых значений.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
 @function is-number-has-unit($value) {
 
 	// Проверка типа входного параметра: ожидается числовое значение.

package/modules/utilities/validators/number/_is-number-negative.scss

@@ -70,9 +70,10 @@
 /// 	является числом и строго меньше нуля. Во всех
 /// 	остальных случаях возвращает `false`, включая
 /// 	ноль, положительные числа и значения других типов.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
 @function is-number-negative($value) {
 
 	// Проверка типа входного параметра: ожидается числовое значение.

package/modules/utilities/validators/number/_is-number-positive.scss

@@ -68,9 +68,10 @@
 /// 	является числом и строго больше нуля. Во всех
 /// 	остальных случаях возвращает `false`, включая
 /// 	ноль, отрицательные числа и значения других типов.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
 @function is-number-positive($value) {
 
 	// Проверка типа входного параметра: ожидается числовое значение.

package/modules/utilities/validators/number/_is-number-unitless.scss

@@ -81,9 +81,10 @@
 /// 	`math.unit($value)` является пустой строкой).
 /// 	Возвращает `false` для чисел с единицами измерения и всех
 /// 	нечисловых значений.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
 @function is-number-unitless($value) {
 
 	// Проверка типа входного параметра: ожидается числовое значение.

package/modules/utilities/validators/number/_is-number-zero.scss

@@ -69,9 +69,10 @@
 /// 	является числом и строго равно нулю. Во всех
 /// 	остальных случаях возвращает `false`, включая
 /// 	ненулевые числа и значения других типов.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `number`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$value` → `number`
 @function is-number-zero($value) {
 
 	// Проверка типа входного параметра: ожидается числовое значение.

package/modules/utilities/validators/string/_is-string-contained.scss

@@ -102,9 +102,11 @@
 /// 	и `false` в противном случае. Возвращаемые значения:
 /// - `true`: подстрока существует в строке (хотя бы одно вхождение)
 /// - `false`: подстрока не найдена или является пустой строкой
-/// @throws {Error} - Выбрасывает ошибку, если параметрам передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+/// - `$substring` → `string`
 @function is-string-contained($string, $substring) {
 
 	// Проверка типа первого параметра: ожидается строка для поиска.

package/modules/utilities/validators/string/_is-string-empty.scss

@@ -50,9 +50,10 @@
 /// @return {Boolean} - Возвращает `true`, если длина строки
 /// 	равна нулю. Возвращает `false` для любой строки
 /// 	ненулевой длины, а также для значений других типов.
-/// @throws {Error} - Выбрасывает ошибку, если в параметры передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
 @function is-string-empty($string) {
 
 	// Проверка типа входного параметра: ожидается строковое значение.

package/modules/utilities/validators/string/_is-string-ending-with.scss

@@ -56,9 +56,11 @@
 /// 	указанной подстрокой. Возвращает `false`, если строка не заканчивается
 /// 	подстрокой, если подстрока длиннее строки, или если регистр
 /// 	символов не совпадает.
-/// @throws {Error} - Выбрасывает ошибку, если параметрам передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+/// - `$substring` → `string`
 @function is-string-ending-with($string, $substring) {
 
 	// Проверка типа первого параметра: ожидается строка для проверки.

package/modules/utilities/validators/string/_is-string-starting-with.scss

@@ -56,9 +56,11 @@
 /// 	с указанной подстроки. Возвращает `false`, если строка не
 /// 	начинается с подстроки, если подстрока длиннее строки, или
 /// 	если регистр символов не совпадает.
-/// @throws {Error} - Выбрасывает ошибку, если параметрам передано
-/// 	значение, не соответствующее типу `string`. Компиляция Sass
-/// 	будет остановлена с ошибкой.
+/// @throws {Error} - Выбрасывает ошибку, если в параметр передано
+/// 	значение, не соответствующее необходимому типу:
+///
+/// - `$string` → `string`
+/// - `$substring` → `string`
 @function is-string-starting-with($string, $substring) {
 
 	// Проверка типа первого параметра: ожидается строка для проверки.

package/modules/utilities/validators/type-of/_is-color.scss

@@ -90,7 +90,3 @@
 @function is-color($value) {
 	@return meta.type-of($value) == color;
 }
-
-
-
-

package/package.json

@@ -1,14 +1,14 @@
 {
 	"name": "@omnisass/library",
-	"version": "0.4.0",
 	"description": "Библиотека функций и миксинов, написанная на языке CSS-препроцессора Sass. Она предназначена для того, чтобы упростить, ускорить и улучшить процесс создания стилей для веб-сайтов.",
+	"version": "0.5.0",
 	"main": "index.scss",
 	"scripts": {
-		"test": "sass playground/:playground/",
-		"test-with-docs": "sass playground/:playground/ && npm run sassdoc",
-		"serve": "sass --watch playground/:playground/",
-		"sassdoc": "npx sassdoc ./ --config ./.sassdoc.yaml",
-		"omni:bump-version": "sh .omnisass/scripts/bump-version.sh"
+		"test:sass": "sass playground/:playground/",
+		"test:sass-watch": "sass playground/:playground/ --watch",
+		"test:sassdoc": "npx sassdoc ./ --config ./.sassdoc.yaml",
+		"test": "npm run test:sass && npm run test:sassdoc",
+		"script:bump-version": "sh .omnisass/scripts/bump-version.sh"
 	},
 	"exports": {
 		".": {
@@ -17,18 +17,27 @@
 	},
 	"keywords": [
 		"sass",
-		"scss",
-		"omnisass",
-		"therteenten",
-		"css",
-		"mixin",
-		"function",
 		"sass-mixin",
 		"sass-function",
-		"scss-minix",
+		"sass-utilities",
+		"sass-framework",
+		"scss",
+		"scss-mixin",
 		"scss-function",
+		"scss-utilities",
+		"scss-framework",
+		"css",
+		"web",
 		"web-development",
-		"colors"
+		"web-design",
+		"web-frontend",
+		"colors",
+		"mixin",
+		"function",
+		"omnisass",
+		"sassify",
+		"kalium19",
+		"therteenten"
 	],
 	"repository": {
 		"type": "git",
@@ -40,15 +49,15 @@
 		"url": "https://sourcecraft.dev/users/therteenten/overview"
 	},
 	"license": "MIT",
+	"homepage": "https://sourcecraft.dev/therteenten",
 	"bugs": {
 		"url": "https://sourcecraft.dev/omnisass/library/issues",
 		"email": "therteenten@ya.ru"
 	},
-	"homepage": "https://sourcecraft.dev/therteenten",
 	"devDependencies": {
 		"sassdoc": "^2.7.4"
 	},
 	"dependencies": {
-		"sass": "^1.97.2"
+		"sass": "^1.98.0"
 	}
 }

package/package.scss

@@ -6,6 +6,9 @@
 /// библиотеку, и, как правило, не требуют модификации
 /// (за исключением переменной `$version`, которая подлежит
 /// обновлению посредством скрипта bump-version.sh).
+///
+/// При использовании этого модуля пространство имён для этих
+/// конфигов рекомендуется указывать как `package`.
 /// ---
 /// @group package
 ////
@@ -42,7 +45,7 @@ $title: "OmniSass";
 /// @name description
 /// @access private
 /// @type String
-$description:  "Набор утилит, миксинов, расширений на языке препроцессора Sass для помощи в ускорении, упрощении и улучщения процесса написания CSS-стилей.";
+$description: "Набор утилит, миксинов, расширений на языке препроцессора Sass для помощи в ускорении, упрощении и улучщения процесса написания CSS-стилей.";
 
 /// Текущая версия библиотеки - используется для контроля
 /// версий и отслеживания изменений.
@@ -53,7 +56,14 @@ $description:  "Набор утилит, миксинов, расширений
 /// @name version
 /// @access private
 /// @type String | Number
-$version: "0.4.0";
+$version: "0.5.0";
+
+/// Цвет бренда проекта. Может быть использована открыто.
+/// ---
+/// @name color
+/// @access private
+/// @type Color
+$color: #e91e63;
 
 /// Тип лицензии библиотеки - используется для указания
 /// условий использования и распространения.