@omnisass/library 0.4.1 → 0.5.0

package/README.en.md

@@ -0,0 +1,99 @@
+[🇷🇺 Русский](./README.md )
+
+<p align="left">
+  <img src="https://sourcecraft.dev/file?owner=omnisass&repo=library&rev=anvil&path=.omnisass%2Fimages%2Fomnisass_logo_rounded.png" width="150" height="150" alt="Project logo">
+</p>
+
+# OmniSass
+> IMPORTANT: The library is currently undergoing testing. It is possible that API changes will be made or some functions will be removed before the final version 1.0.0. It is recommended to use it exclusively for informational purposes.
+
+A library of functions and mixins written in the CSS preprocessor language Sass. It is designed to simplify, speed up and improve the process of creating styles for websites.
+
+![NPM Version](https://img.shields.io/npm/v/%40omnisass%2Flibrary?logo=npm&label=%40omnisass%2Flibrary&labelColor=%23CB3837&color=white) ![NPM Downloads](https://img.shields.io/npm/dw/%40omnisass%2Flibrary?logo=npm&logoColor=white&labelColor=%23CB3837&color=white) ![NPM Last Update](https://img.shields.io/npm/last-update/%40omnisass%2Flibrary?logo=npm&logoColor=white&labelColor=%23CB3837&color=white) ![NPM Collaborators](https://img.shields.io/npm/collaborators/%40omnisass%2Flibrary?logo=npm&logoColor=white&labelColor=%23CB3837&color=white) ![NPM License](https://img.shields.io/npm/l/%40omnisass%2Flibrary?logo=ReadMe&logoColor=white&labelColor=%23018EF5&color=white) ![NPM (prod) Dependency Version](https://img.shields.io/npm/dependency-version/%40omnisass%2Flibrary/sass?logo=Sass&logoColor=white&labelColor=%23CC6699&color=white)
+
+OmniSass is an extensive, standardized, and carefully documented package that includes solutions built over the years by the community.
+
+Most of the features and mixins are the result of the work of many people who have been developing in the Sass language at various times. OmniSass Developer ([@therteenten](https://t.me/therteenten )) He focused on qualitative standardization, documentation, and the creation of a single tool based on disparate elements.
+
+## Installing the library
+1. For OmniSass to work, the [`sass`](https://www.npmjs.com/package/sass ) library must be installed:
+
+    ```shell
+    npm install sass
+    ```
+
+2. After the installation is complete, you can add the library [`@omnisass/library`](https://www.npmjs.com/package/@omnisass/library ):
+
+    ```shell
+    npm install @omnisass/library
+    ```
+
+3. It's done! OmniSass is ready to use.
+
+## Usage
+You can embed the module in your style file after installing the necessary libraries.:
+
+```scss
+@use '@omnisass/library' as omnisass;
+```
+
+1. We're messing up the `@omnisass/library` module
+2. The entire "stuffing" of the module is available in the omnisass space
+
+Then we apply one of the functions from the library. For example, `is-boolean`:
+
+```scss
+@debug omnisass.is-boolean(true);
+```
+
+In the console, we get:
+
+```shell
+src/styles/main.scss:3 Debug: true
+```
+
+Done. We have successfully installed, imported, and used the library in the project.
+
+> When compiling Sass without the `--load-path=node_modules` key, you must specify the full path to the library folder to import the module. In our case, if the styles.scss file is located in the ./src/styles/ directory, the following construction should be used: `@use'../../node_modules/@omnisass/library'as omnisass;`.
+
+## Useful links
+- [API Documentation (SassDoc)](https://omnisass.sourcecraft.site/sassdocs/)
+- [Organization on SourceCraft](https://sourcecraft.dev/omnisass/overview )
+- [Telegram Channel](https://t.me/omnisass )
+- [List of changes](https://sourcecraft.dev/omnisass/library/browse/CHANGELOG.md?rev=develop )
+
+## Thanks
+- [github@takamoso](https://github.com/takamoso ) - for the functions `is-boolean`, `is-list`, etc.
+- [github@KittyGiraudel](https://github.com/KittyGiraudel ) - for the functions `color-shade`, `color-tint`, etc.
+- [github@sindresorhus](https://github.com/sindresorhus ) - for the functions `get-list-item-end`, `get-list-item-start`, etc.
+- [github@selfishprimate](https://github.com/selfishprimate ) - for the [`is-time`] function(https://github.com/selfishprimate/gerillass/blob/master/scss/utilities/_is-time.scss ) and others.
+- [github@pentzzsolt](https://github.com/pentzzsolt ) - for the `is-int` function, etc.
+
+> If I forgot to mention you in this list, please write to me on [Telegram](https://t.me/therteenten ).
+
+## License
+This project is licensed under the MIT license - for details, see the [LICENSE](LICENSE) file.
+
+```
+MIT License
+
+Copyright (c) 2025, Murad Rustamov (therteenten) <therteenten@ya.ru>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/README.md

@@ -1,3 +1,5 @@
+[🇬🇧 English](./README.en.md)
+
 <p align="left">
   <img src="https://sourcecraft.dev/file?owner=omnisass&repo=library&rev=anvil&path=.omnisass%2Fimages%2Fomnisass_logo_rounded.png" width="150" height="150" alt="Логотип проекта">
 </p>

package/_configs.scss

@@ -25,7 +25,7 @@
 /// @name set-strict-mode
 /// @access public
 /// @example scss Отключение режима
-/// 	@use 'omnisass' as libomnisass with (
+/// 	@use 'omnisass' as omnisass with (
 /// 		$set-strict-mode: false
 /// 	);
 /// @type Boolean

package/index.scss

@@ -3,7 +3,7 @@
 @forward 'configs';
 @forward 'package';
 
-/// Converters
+// Utilities: Converters
 @forward 'modules/utilities/converters/convert-camel2kebab';
 @forward 'modules/utilities/converters/convert-em2px';
 @forward 'modules/utilities/converters/convert-hex2rgb';
@@ -15,12 +15,13 @@
 @forward 'modules/utilities/converters/convert-rem2px';
 @forward 'modules/utilities/converters/convert-snake2kebab';
 
-// Getters
+// Utilities: Getters
 @forward 'modules/utilities/getters/color/get-color-brightness';
 @forward 'modules/utilities/getters/color/get-color-darkest';
 @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/map/get-map-item';
 @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';
@@ -31,7 +32,7 @@
 @forward 'modules/utilities/getters/number/get-number-width-by-ratio';
 @forward 'modules/utilities/getters/string/get-string-hash';
 
-// Helpers
+// Utilities: Helpers
 @forward 'modules/utilities/helpers/color/color-blend';
 @forward 'modules/utilities/helpers/color/color-blend-steps';
 @forward 'modules/utilities/helpers/color/color-hue-shift';
@@ -45,6 +46,7 @@
 @forward 'modules/utilities/helpers/list/list-remove-at';
 @forward 'modules/utilities/helpers/list/list-sum-numbers';
 @forward 'modules/utilities/helpers/list/list-sum-numbers-safe';
+@forward 'modules/utilities/helpers/map/map-remove-keys';
 @forward 'modules/utilities/helpers/misc/url-encode';
 @forward 'modules/utilities/helpers/number/number-ceil-to';
 @forward 'modules/utilities/helpers/number/number-clamp';
@@ -71,11 +73,15 @@
 @forward 'modules/utilities/helpers/string/string-trim-end';
 @forward 'modules/utilities/helpers/string/string-trim-start';
 
-// Loggers
+// Utilities: Loggers
 @forward 'modules/utilities/loggers/log-invalid-type';
 @forward 'modules/utilities/loggers/log-invalid-value';
+@forward 'modules/utilities/loggers/log';
 
-// Validators
+// Utilities: Setters
+@forward 'modules/utilities/setters/map/set-map-item';
+
+// Utilities: Validators
 @forward 'modules/utilities/validators/color/is-color-light';
 @forward 'modules/utilities/validators/color/is-color-list';
 @forward 'modules/utilities/validators/list/is-list-contained';

package/modules/utilities/getters/map/_get-map-item.scss

@@ -0,0 +1,159 @@
+@use 'sass:map';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-map' as *;
+
+/// Безопасно извлекает значение из карты по цепочке ключей.
+///
+/// Функция последовательно проходит по переданным ключам,
+/// углубляясь во вложенные карты, и возвращает значение,
+/// соответствующее последнему ключу. Если на любом уровне
+/// ключ отсутствует, функция возвращает `null`. Это позволяет
+/// избежать ошибок при работе со сложными структурами данных
+/// и избавляет от необходимости писать громоздкие проверки.
+///
+/// Для проверки типа входного параметра используется служебная
+/// функция `log-invalid-type`, которая при несоответствии типа
+/// генерирует предупреждение (или ошибку) и возвращает `null`.
+/// ---
+/// @name get-map-item
+/// @group utilities-getters
+/// @since 2026.03.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/maps См. также: Официальная документация Sass - Тип данных "Карты" (`maps`)
+/// @link https://sass-lang.com/documentation/modules/map См. также: Официальная документация Sass - Модуль `sass:map`
+/// @link https://sass-lang.com/documentation/modules/map#get См. также: Официальная документация Sass - Функция `map.get()`
+/// @link https://sass-lang.com/documentation/modules/map#has-key См. также: Официальная документация Sass - Функция `map.has-key()`
+/// @link https://sass-lang.com/documentation/at-rules/function См. также: Официальная документация Sass - Правило `@function`
+/// @link https://sass-guidelin.es/ru/#maps См. также: Sass Guidelines (рус.) - Работа с картами
+/// @link https://www.sitepoint.com/using-sass-maps/ См. также: SitePoint - Using Sass Maps
+/// @link https://css-tricks.com/snippets/sass/deep-getset-maps/ См. также: CSS-Tricks - Deep Get/Set for Sass Maps
+/// @link https://www.smashingmagazine.com/2015/07/real-work-sass-maps/ См. также: Smashing Magazine - Real Work with Sass Maps
+/// @link https://dev.to/sarah_chima/working-with-sass-maps-5cm5 См. также: Dev.to - Working with Sass Maps
+/// @link https://code.tutsplus.com/tutorials/an-introduction-to-sass-maps--cms-22138 См. также: Envato Tuts+ - An Introduction to Sass Maps
+/// @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 - Карты (maps) в Sass
+/// @link https://www.youtube.com/watch?v=6kUo6lBF0Cc См. также: YouTube - Уроки Sass #5: Карты данных (Maps)
+/// @link https://www.youtube.com/watch?v=dN_rpAoy8I0 См. также: YouTube - Sass Maps Tutorial (LevelUp Tuts)
+/// @link https://stackoverflow.com/questions/28548587/sass-check-if-key-exists-in-multi-level-map См. также: Stack Overflow - Проверка существования ключа во вложенной карте
+/// @link https://stackoverflow.com/questions/37705095/sass-get-value-from-nested-map См. также: Stack Overflow - Получение значения из вложенной карты
+/// @link https://www.npmjs.com/package/sass См. также: npm - Документация пакета Dart Sass
+/// @link https://github.com/sass/sass/tree/main/spec См. также: GitHub - Спецификация языка Sass
+/// @example scss - Извлечение значения из плоской карты
+///   $breakpoints: (
+///     mobile: 480px,
+///     tablet: 768px,
+///     desktop: 1024px
+///   );
+/// 
+///   @debug get-map-item($breakpoints, desktop); // 1024px
+///
+/// @example scss - Доступ к вложенным данным конфигурации
+///   $theme: (
+///     colors: (
+///       primary: #3498db,
+///       secondary: #2ecc71
+///     ),
+///     fonts: (
+///       base: 16px,
+///       headings: (
+///         h1: 2rem,
+///         h2: 1.5rem
+///       )
+///     )
+///   );
+///
+///   @debug get-map-item($theme, colors, primary);        // #3498db
+///   @debug get-map-item($theme, fonts, headings, h2);    // 1.5rem
+///
+/// @example scss - Возврат `null` при отсутствии ключа
+///   @debug get-map-item($theme, colors, accent);         // null
+///   @debug get-map-item($theme, missing, key);           // null
+///
+/// @example scss - Использование с переменным числом ключей
+///   $keys: ('fonts', 'headings', 'h1');
+///   @debug get-map-item($theme, $keys...);               // 2rem
+///
+/// @example scss - Применение для получения параметров темы
+///   @mixin button($color-key) {
+///     $bg: get-map-item($theme, colors, $color-key);
+///     background: $bg;
+///   }
+///
+///   .button-primary { @include button(primary); }
+///
+/// @example css - Результат выполнения
+/// 	.button-primary {
+/// 		background: #3498db;
+/// 	}
+/// @example scss - Защита от ошибок при отсутствии карты
+///   $not-a-map: 'string';
+///   @debug get-map-item($not-a-map, any);  // вызывает log-invalid-type и возвращает null
+///
+/// @param {Map} $map - Карта, из которой извлекается значение.
+///   Должна быть типа `map`. В случае передачи другого типа
+///   вызывается `log-invalid-type` и возвращается его результат.
+/// @param {String...} $keys - Один или несколько ключей,
+///   образующих путь к искомому значению. Ключи могут быть
+///   любого типа, поддерживаемого картами Sass (обычно строки).
+/// @return {*} - Значение, находящееся по указанному пути,
+///   или `null`, если хотя бы один из ключей отсутствует,
+///   либо если входная карта имеет неверный тип.
+/// @throws {Error} - Выбрасывает ошибку (или предупреждение)
+///   через функцию `log-invalid-type`, если параметр `$map`
+///   не является картой. Текст ошибки зависит от реализации
+///   `log-invalid-type`, но в стандартном случае возвращается
+///   `null`.
+@function get-map-item($map, $keys...) {
+
+	// Проверяем, что первый аргумент действительно
+	// является картой.
+	@if not is-map($map) {
+
+		// Если это не так, вызываем функцию логирования ошибки
+		// и возвращаем её результат.
+		// Функция log-invalid-type должна обработать некорректный
+		// тип и вернуть null (или выбросить ошибку в зависимости
+		// от настроек).
+		@return log-invalid-type(
+			'get-map-item',
+			$map,
+			'$map',
+			'map'
+		);
+
+	} @else {
+
+		// Проходим по всем переданным ключам последовательно.
+		// На каждом шаге проверяем, существует ли текущий ключ
+		// в текущей карте.
+		@each $-key in $keys {
+
+			@if map.has-key($map, $-key) {
+
+				// Если ключ существует — переходим на уровень глубже,
+				// заменяя $map на полученное значение (которое может
+				// быть как картой, так и любым другим типом).
+				$map: map.get($map, $-key);
+
+			} @else {
+
+				// Если на любом уровне ключ не найден — прерываем
+				// выполнение и возвращаем null.
+				@return null;
+
+			}
+
+		}
+
+		// После успешного прохождения всех ключей возвращаем
+		// итоговое значение. Оно может быть чем угодно: картой,
+		// строкой, числом, списком и т.д.
+		@return $map;
+
+	}
+
+}

package/modules/utilities/helpers/map/_map-remove-keys.scss

@@ -0,0 +1,153 @@
+@use 'sass:map';
+@use '../../loggers/log-invalid-type' as *;
+@use '../../validators/type-of/is-map' as *;
+
+/// Удаляет указанные ключи из карты.
+///
+/// Функция позволяет удалить один или несколько ключей
+/// из карты за один вызов. В отличие от стандартной
+/// функции `map.remove()`, которая принимает только один
+/// ключ для удаления, эта функция принимает список ключей
+/// и последовательно удаляет их все. Это значительно
+/// упрощает код при необходимости удалить несколько
+/// ключей из одной карты, избавляя от необходимости
+/// писать цепочку вызовов `map.remove()`.
+///
+/// Функция работает путём итеративного обхода списка
+/// удаляемых ключей и применения встроенной функции
+/// `map.remove()` к каждому из них. Исходная карта
+/// остаётся неизменной — функция возвращает новую карту,
+/// из которой удалены указанные ключи. Если переданный
+/// ключ отсутствует в карте, он просто игнорируется,
+/// что делает функцию безопасной в использовании.
+///
+/// Важные особенности функции:
+/// - Удаляет несколько ключей за один вызов
+/// - Возвращает новую карту, не мутируя исходную
+/// - Безопасно игнорирует отсутствующие ключи
+/// - Поддерживает удаление любого количества ключей
+/// - Интегрируется с системой валидации типов
+/// - Позволяет создавать чистые конфигурации
+/// - Упрощает фильтрацию данных
+/// ---
+/// @name map-remove-keys
+/// @group utilities-helpers
+/// @since 2026.03.28
+/// @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/maps См. также: Официальная документация Sass - Тип данных "Карты" (`maps`)
+/// @link https://sass-lang.com/documentation/modules/map См. также: Официальная документация Sass - Модуль `sass:map`
+/// @link https://sass-lang.com/documentation/modules/map#remove См. также: Официальная документация Sass - Функция `map.remove()`
+/// @link https://sass-lang.com/documentation/modules/map#merge См. также: Официальная документация Sass - Функция `map.merge()`
+/// @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/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @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/sarah_chima/working-with-sass-maps-5cm5 См. также: 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 #5: Карты данных (Maps)
+/// @link https://stackoverflow.com/questions/42841580/remove-multiple-keys-from-sass-map См. также: Stack Overflow - Удаление нескольких ключей из карты Sass
+/// @link https://stackoverflow.com/questions/36586774/sass-remove-map-value См. также: Stack Overflow - Удаление значения из карты Sass
+/// @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/delete См. также: MDN Web Docs - JavaScript метод Map.delete()
+/// @link https://en.wikipedia.org/wiki/Associative_array См. также: Wikipedia - Ассоциативный массив
+/// @link https://ru.wikipedia.org/wiki/Ассоциативный_массив См. также: Wikipedia - Ассоциативный массив (рус.)
+/// @link https://www.php.net/manual/en/function.unset.php См. также: PHP Manual - Функция unset()
+/// @example scss - Удаление одного ключа из карты
+/// 	$config: (
+/// 		debug: true,
+/// 		theme: 'dark',
+/// 		language: 'ru'
+/// 	);
+///
+/// 	$clean-config: map-remove-keys($config, debug); // Результат: (theme: 'dark', language: 'ru')
+///
+/// @example scss - Безопасное удаление (игнорирование отсутствующих ключей)
+/// 	$colors: (
+/// 		primary: #3498db,
+/// 		secondary: #2ecc71
+/// 	);
+///
+/// 	// Ключ 'tertiary' отсутствует, но ошибки не будет
+/// 	$filtered: map-remove-keys($colors, (secondary, tertiary)); // Результат: (primary: #3498db)
+///
+/// @example scss - Динамическое удаление на основе списка
+/// 	$theme: (
+/// 		colors: (
+/// 			primary: #3498db,
+/// 			secondary: #2ecc71
+/// 		),
+/// 		spacing: (sm: 8px, md: 16px),
+/// 		typography: (base: 16px, h1: 2rem)
+/// 	);
+///
+/// 	$keys-to-remove: (spacing, typography);
+/// 	$simplified-theme: map-remove-keys($theme, $keys-to-remove); // Результат: (colors: (primary: #3498db, secondary: #2ecc71))
+///
+/// @example scss - Использование в цикле для удаления из нескольких карт
+/// 	@function prepare-for-output($data) {
+/// 		$sensitive-keys: (password, token, credit_card);
+/// 		@return map-remove-keys($data, $sensitive-keys);
+/// 	}
+///
+/// 	$user-data: (
+/// 		name: 'Alice',
+/// 		email: 'alice@example.com',
+/// 		password: 'secret123',
+/// 		token: 'jwt_token_xyz'
+/// 	);
+///
+/// 	$public-data: prepare-for-output($user-data); // Результат: (name: 'Alice', email: 'alice@example.com')
+/// 
+/// @param {Map} $map - Исходная карта, из которой
+///   удаляются ключи. Остаётся неизменной, функция
+///   возвращает новую карту. Должна быть типа `map`.
+/// @param {List} $remove-keys - Список ключей, которые
+///   нужно удалить из карты. Может быть как одиночным
+///   значением, так и списком. Отсутствующие в карте
+///   ключи безопасно игнорируются.
+/// @return {Map} - Новая карта, из которой удалены
+///   указанные ключи. Если удалены все ключи, возвращает
+///   пустую карту `()`.
+/// @throws {Error} - Выбрасывает ошибку через функцию
+///   `log-invalid-type`, если параметр `$map` не является
+///   картой. Сообщение об ошибке локализовано и содержит
+///   информацию об ожидаемом типе данных.
+@function map-remove-keys($map, $remove-keys) {
+
+	// Проверяем, что первый аргумент действительно является картой.
+	// Если это не так, вызываем функцию логирования ошибки
+	// и возвращаем её результат.
+	@if not is-map($map) {
+
+		@return log-invalid-type(
+			'map-remove-keys',
+			$map,
+			'$map',
+			'map'
+		);
+
+	} @else {
+
+		// Проходим по всем ключам из списка удаляемых ключей.
+		// Для каждого ключа применяем встроенную функцию map.remove().
+		// Если ключ отсутствует в карте, map.remove() просто
+		// возвращает карту без изменений — это безопасное поведение.
+		@each $key in $remove-keys {
+			$map: map.remove($map, $key);
+		}
+
+		// Возвращаем новую карту без удалённых ключей.
+		// Исходная карта остаётся неизменной.
+		@return $map;
+
+	}
+
+}

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

@@ -39,8 +39,6 @@
 /// @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"

package/modules/utilities/loggers/_log.scss

@@ -0,0 +1,219 @@
+@use 'sass:map';
+@use '../../../package' as package;
+@use '../../../configs' as libconfigs;
+@use './log-invalid-value' as *;
+
+/// Универсальная функция логирования с поддержкой
+/// локализации и трёх уровней важности.
+///
+/// Функция предоставляет единый интерфейс для вывода
+/// отладочной информации, предупреждений и ошибок в
+/// процессе компиляции Sass-кода.
+///
+/// Поддерживает два языка (русский и английский), что
+/// делает её неплохим решением для многоязычных
+/// проектов и библиотек, распространяемых среди
+/// разработчиков из разных стран (если они у проекта
+/// будут вообще).
+///
+/// Сообщения для логирования передаются в виде карты
+/// с ключами 'ru' и 'en', что позволяет гибко
+/// управлять контентом без изменения кода функции.
+///
+/// Функция автоматически определяет язык сообщения на 4
+/// основе глобальной конфигурации проекта
+/// (`$set-loglang`). Если язык установлен как
+/// 'en' — используется англоязычное сообщение, во
+/// всех остальных случаях  — русскоязычное. Это
+/// обеспечивает обратную совместимость и
+/// предсказуемое поведение.
+///
+/// В зависимости от переданного типа логирования (`$type`)
+/// функция использует разные директивы Sass:
+/// - `debug` — выводит сообщение синим цветом через `@debug`
+/// - `warn` — выводит предупреждение жёлтым цветом через `@warn`
+/// - `error` — выбрасывает критическую ошибку красным цветом
+/// 	через `@error`, которая останавливает компиляцию
+///
+/// Если передан неподдерживаемый тип логирования, функция
+/// делегирует обработку ошибки вспомогательной функции
+/// `log-invalid-value`, которая сгенерирует соответствующее
+/// сообщение о недопустимом значении параметра.
+///
+/// Функция всегда возвращает `null`, что позволяет использовать
+/// её в выражениях, не влияя на возвращаемые значения других
+/// функций, но при этом гарантируя выполнение побочного эффекта
+/// (вывод сообщения в консоль).
+/// ---
+/// @name log
+/// @group utilities-loggers
+/// @since 2026.03.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/at-rules/debug См. также: Официальная документация Sass - Директива @debug
+/// @link https://sass-lang.com/documentation/at-rules/warn См. также: Официальная документация Sass - Директива @warn
+/// @link https://sass-lang.com/documentation/at-rules/error См. также: Официальная документация Sass - Директива @error
+/// @link https://sass-lang.com/documentation/values/maps См. также: Официальная документация Sass - Тип данных "Карты" (`maps`)
+/// @link https://sass-lang.com/documentation/modules/map#get См. также: Официальная документация Sass - Функция `map.get()`
+/// @link https://developer.mozilla.org/en-US/docs/Web/API/console См. также: MDN Web Docs - Консоль браузера (console)
+/// @link https://developer.mozilla.org/en-US/docs/Web/API/console/debug См. также: MDN Web Docs - console.debug()
+/// @link https://developer.mozilla.org/en-US/docs/Web/API/console/warn См. также: MDN Web Docs - console.warn()
+/// @link https://developer.mozilla.org/en-US/docs/Web/API/console/error См. также: MDN Web Docs - console.error()
+/// @link https://sass-guidelin.es/ru/#debugging См. также: Sass Guidelines - Отладка и логирование
+/// @link https://css-tricks.com/debugging-sass/ См. также: CSS-Tricks - Отладка Sass
+/// @link https://www.sitepoint.com/sass-basics-debug-warn-error/ См. также: SitePoint - Основы Sass: @debug, @warn и @error
+/// @link https://dev.to/kennethlum/using-sass-s-map-for-logging-2c1d См. также: Dev.to - Использование карт Sass для логирования
+/// @link https://stackoverflow.com/questions/20333659/sass-debug-warnings-and-errors См. также: Stack Overflow - Отладка, предупреждения и ошибки в Sass
+/// @link https://habr.com/ru/post/449342/ См. также: Habr - Sass: @debug, @warn, @error для отладки
+/// @link https://www.youtube.com/watch?v=9G2TlF1j6sM См. также: YouTube - Отладка Sass с помощью @debug и @warn
+/// @link https://www.npmjs.com/package/sass См. также: npm - Документация пакета Dart Sass
+/// @link https://github.com/sass/sass/tree/main/spec См. также: GitHub - Спецификация языка Sass
+/// @link https://en.wikipedia.org/wiki/Log_level См. также: Wikipedia - Уровни логирования
+/// @link https://www.atatus.com/blog/log-levels-explained/ См. также: Atatus Blog - Объяснение уровней логирования
+/// @link https://www.marshall.edu/at/wp-content/uploads/AT-Logging-Levels-Explained.pdf См. также: Marshall University - Уровни логирования (PDF)
+/// @link https://www.w3.org/TR/css3-color/ См. также: W3C - Спецификация CSS Color Module
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/color См. также: MDN Web Docs - CSS свойство color
+/// @example scss - Базовая отладка на разных языках
+///   // Конфигурация: libconfigs.$set-loglang: 'ru'
+///   $message-ru: (
+///     ru: 'Начало компиляции темы',
+///     en: 'Theme compilation started'
+///   );
+///   @debug log($message-ru); // 🟦 Начало компиляции темы
+///
+///   // Конфигурация: libconfigs.$set-loglang: 'en'
+///   @debug log($message-ru); // 🟦 Theme compilation started
+///
+/// @example scss - Использование в миксине с предупреждением
+///   @mixin deprecated($old-name, $new-name) {
+///     $warning: (
+///       ru: 'Миксин #{$old-name} устарел. Используйте #{$new-name}',
+///       en: 'Mixin #{$old-name} is deprecated. Use #{$new-name} instead'
+///     );
+///     @debug log($warning, 'warn');
+///     @content;
+///   }
+///
+///   @include deprecated('border-radius-old', 'border-radius') {
+///     border-radius: 4px;
+///   }
+///
+/// @example scss - Сложное сообщение с динамическими данными
+///   @function validate-color($color, $context) {
+///     @if type-of($color) != 'color' {
+///       $message: (
+///         ru: 'В контексте "#{$context}" передано невалидное значение цвета: #{$color}',
+///         en: 'Invalid color value "#{$color}" passed in context: #{$context}'
+///       );
+///       @return log($message, 'error');
+///     }
+///     @return $color;
+///   }
+///
+///   $primary: validate-color(#ff0000, 'theme'); // нормально
+///   $primary: validate-color('red', 'theme');   // 🟥 Invalid color value...
+///
+/// @example scss - Неподдерживаемый тип логирования
+///   $message: (
+///     ru: 'Тестовое сообщение',
+///     en: 'Test message'
+///   );
+///   @debug log($message, 'invalid-type'); // вызовет log-invalid-value
+///
+/// @param {Map} $message-map - Карта с сообщениями для разных языков.
+///   Должна содержать ключи 'ru' и 'en' со строковыми значениями.
+///   Пример: `(ru: 'Привет', en: 'Hello')`.
+/// @param {String} $type ['debug'] - Тип логирования.
+///   Поддерживаемые значения: 'debug', 'warn', 'error'.
+///   По умолчанию используется 'debug'.
+/// @return {Null} - Всегда возвращает `null`. Это позволяет
+///   использовать функцию в выражениях, где ожидается возврат
+///   значения, но при этом необходим побочный эффект в виде
+///   вывода сообщения в консоль.
+/// @throws {Error} - Выбрасывает ошибку через директиву `@error`,
+///   если передан тип `'error'`. Ошибка содержит локализованное
+///   сообщение из карты с префиксом в виде красного квадрата.
+/// @throws {Warning} - Выводит предупреждение через директиву
+///   `@warn`, если передан тип `'warn'`. Предупреждение содержит
+///   локализованное сообщение с префиксом в виде жёлтого квадрата.
+/// @require {variable} $set-loglang - Глобальная переменная,
+/// 	определяющая язык сообщений. Поддерживает значения `'ru'`
+/// 	(русский) и другие (английский).
+@function log(
+	$message-map,
+	$type: 'debug') {
+
+	// Получаем язык сообщений из глобальной конфигурации.
+	// Поддерживаются два режима: 'ru' (русский) и
+	// 'en' — английский.
+	$-loglang: libconfigs.$set-loglang;
+
+	// Переменная для хранения финального сообщения
+	// после выбора языка.
+	$-log-message: null;
+
+	// Выбираем сообщение в зависимости от языка.
+	// Если язык 'en' — используем английский текст из карты,
+	// для всех остальных случаев — русский.
+	@if $-loglang == 'en' {
+
+		// Извлекаем английскую версию сообщения из карты.
+		// Ключ 'en' должен присутствовать в карте обязательно.
+		$-log-message: map.get($message-map, en);
+
+	} @else {
+
+		// Извлекаем русскую версию сообщения из карты.
+		// Ключ 'ru' должен присутствовать в карте обязательно.
+		$-log-message: map.get($message-map, ru);
+
+	}
+
+	// Отображаем в консоли название и версию библиотеки.
+	@debug '⬛ #{package.$title} v#{package.$version} (#{package.$package})';
+
+	// Обрабатываем тип логирования и выводим сообщение
+	// соответствующим способом.
+	@if $type == 'debug' {
+
+		// Отладочное сообщение — не останавливает компиляцию,
+		// выводится только при включённом режиме отладки.
+		// Синий квадрат используется для визуального отличия.
+		@debug '🟦 #{$-log-message}';
+
+	} @else if $type == 'warn' {
+
+		// Предупреждение — не останавливает компиляцию,
+		// но выводится всегда, показывая потенциальные проблемы.
+		// Жёлтый квадрат привлекает внимание к предупреждению.
+		@warn '🟨 #{$-log-message}';
+
+	} @else if $type == 'error' {
+
+		// Критическая ошибка — ПОЛНОСТЬЮ ОСТАНАВЛИВАЕТ компиляцию.
+		// Красный квадрат сигнализирует о серьёзной проблеме.
+		@error '🟥 #{$-log-message}';
+
+	} @else {
+
+		// Если передан неподдерживаемый тип логирования,
+		// делегируем обработку ошибки вспомогательной функции.
+		// log-invalid-value сгенерирует сообщение о том,
+		// какие типы логирования допустимы.
+		@return log-invalid-value(
+			'log',
+			$type,
+			'$type',
+			('debug', 'warn', 'error')
+		);
+
+	}
+
+	// Функция всегда возвращает null, чтобы не влиять
+	// на возвращаемые значения вызывающих функций,
+	// но при этом гарантировать выполнение побочного эффекта.
+	@return null;
+
+}

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/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.1",
 	"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
 ////
@@ -53,7 +56,14 @@ $description: "Набор утилит, миксинов, расширений
 /// @name version
 /// @access private
 /// @type String | Number
-$version: "0.4.1";
+$version: "0.5.0";
+
+/// Цвет бренда проекта. Может быть использована открыто.
+/// ---
+/// @name color
+/// @access private
+/// @type Color
+$color: #e91e63;
 
 /// Тип лицензии библиотеки - используется для указания
 /// условий использования и распространения.

package/CHANGELOG.md

@@ -1,122 +0,0 @@
-# История изменений 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 "Примечание" %}
-
-В списке изменений к версии 0.3.0 будут указаны все изменения, внесённые в предыдущих версиях, поскольку ранее они не фиксировались в документации.
-
-{% endnote %}
-
-### Добавленные новые Sass-функции
-#### Конверторы значений
-- **convert-camel2kebab** - Конвертирует строку из `camelCase` (верблюжья нотация) в `kebab-case` (кебаб-нотация или дефисная нотация).
-- **convert-em2px** - Конвертирует значения из относительных единиц (`em`) в пиксели (`px`).
-- **convert-hex2rgba** - Преобразует цвет в строку формата RGBA с поддержкой прозрачности.
-- **convert-hex2rgb** - Преобразует цвет из HEX формата в строку формата RGB.
-- **convert-kebab2camel** - Конвертирует строку из `kebab-case` (кебаб-нотация) в `camelCase` (верблюжья нотация).
-- **convert-kebab2snake** - Преобразует строку из `kebab-case` (кебаб-нотация) в `snake_case` (змеиная нотация).
-- **convert-px2em** - Конвертирует значения из пикселей (`px`) в относительные единицы (`em`).
-- **convert-px2rem** - Конвертирует значения из пикселей (`px`) в относительные единицы (`rem`).
-- **convert-rem2px** - Конвертирует значения из относительных единиц (`rem`) в пиксели (`px`).
-- **convert-snake2kebab** - Преобразует строку из `snake_case` (змеиная нотация) в `kebab-case` (кебаб-нотация).
-
-#### Функции для получения значений
-- **get-color-brightness** - Рассчитывает яркость (светлоту) цвета.
-- **get-color-darkest** - Находит самый темный цвет в списке по значению lightness в HSL-пространстве.
-- **get-list-item-end** - Возвращает последний элемент списка.
-- **get-list-item-start** - Возвращает первый элемент списка.
-- **get-list-item** - Возвращает первый или последний элемент списка.
-- **get-number-from-percent** - Вычисляет абсолютное значение по проценту от целого.
-- **get-number-height-by-ratio** - Вычисляет высоту на основе ширины и соотношения сторон.
-- **get-number-max** - Находит максимальное числовое значение в списке.
-- **get-number-min** - Находит минимальное числовое значение в списке.
-- **get-number-percentage-of** - Вычисляет процентное отношение части к целому.
-- **get-number-unit** - Возвращает единицы измерения числа в виде строки.
-- **get-number-width-by-ratio** - Вычисляет ширину на основе высоты и соотношения сторон.
-
-#### Вспомогательные функции
-- **color-blend** - Линейная интерполяция (смешивание) между двумя цветами.
-- **color-blend-steps** - Создает последовательность равномерно распределенных цветов между двумя точками.
-- **color-hue-shift** - Поворачивает цветовой тон (hue) цвета на заданное количество градусов.
-- **color-scale** - Генерирует монохромную шкалу оттенков путем затемнения базового цвета.
-- **color-shade** - Создает затемненную версию цвета, добавляя к нему черный цвет.
-- **color-tint** - Осветляет исходный цвет, смешивая его с белым.
-- **color-triad** - Генерирует триадную цветовую схему из трех равноудаленных цветов.
-- **list-dedupe** - Удаляет дублирующиеся значения из списка.
-- **list-insert-at** - Вставляет значение в список по указанному индексу.
-- **list-merge** - Объединяет несколько списков в один плоский список.
-- **list-remove-at** - Удаляет элемент из списка по указанному индексу.
-- **list-sum-numbers-safe** - Безопасно суммирует числовые значения в списке с проверкой единиц измерения.
-- **list-sum-numbers** - Суммирует все числовые значения в списке.
-- **url-encode** - Кодирует строку для безопасного использования в URL.
-- **number-ceil-to** - Округляет число вверх до ближайшего кратного значения.
-- **number-clamp-max** - Ограничивает число сверху, обеспечивая максимальное значение.
-- **number-clamp-min** - Ограничивает число снизу, обеспечивая минимальное значение.
-- **number-clamp** - Ограничивает число заданным диапазоном значений.
-- **number-denormalize** - Денормализует число из единичного интервала [0, 1] в исходный диапазон.
-- **number-fibonacci** - Генерирует последовательность чисел Фибоначчи.
-- **number-floor-to** - Округляет число вниз до ближайшего кратного значения.
-- **number-format-with-separator** - Форматирует число, добавляя разделители тысяч для улучшения читаемости больших чисел.
-- **number-normalize** - Нормализует число к единичному интервалу [0, 1].
-- **number-random-between-int** - Генерирует случайное целое число в заданном диапазоне.
-- **number-random-between** - Генерирует случайное число в заданном диапазоне.
-- **number-range** - Генерирует последовательность чисел в заданном диапазоне с определенным шагом.
-- **number-round-to-nearest** - Округляет число до ближайшего кратного значения с использованием стандартного математического округления (половинки в сторону от нуля).
-- **number-round-to** - Округляет число до указанного количества знаков после запятой.
-- **number-strip-unit** - Удаляет единицы измерения из числа, возвращая безразмерное значение.
-- **string-capitalize** - Преобразует первый символ строки в верхний регистр, остальные оставляет без изменений.
-- **string-replace** - Заменяет все вхождения подстроки в строке на другую подстроку.
-- **string-trim-end** - Удаляет пробелы с конца строки (справа).
-- **string-trim-start** - Удаляет пробелы с начала строки (слева).
-- **string-trim** - Удаляет пробелы с начала и конца строки.
-
-#### Функции для логгирования
-- **log-invalid-type** - Логирует ошибку или предупреждение о несоответствии типа параметра ожидаемым типам.
-- **log-invalid-value** - Логирует ошибку или предупреждение о недопустимом значении параметра, когда передано значение, не входящее в список разрешенных.
-
-#### Функции для валидации значений
-- **is-color-light** - Определяет, является ли цвет светлым (по пороговому значению светлоты).
-- **is-color-list** - Проверяет, что все элементы в списке являются цветами.
-- **is-list-contained** - Проверяет, содержится ли значение в указанном списке.
-- **is-time** - Проверяет, является ли значение корректным временным значением.
-- **is-int-even** - Проверяет, является ли целое число четным.
-- **is-int-odd** - Проверяет, является ли целое число нечетным.
-- **is-int** - Проверяет, является ли число целым (integer).
-- **is-number-has-unit** - Проверяет, имеет ли число единицы измерения.
-- **is-number-negative** - Проверяет, является ли значение отрицательным числом.
-- **is-number-positive** - Проверяет, является ли значение положительным числом.
-- **is-number-unitless** - Проверяет, является ли число безразмерным.
-- **is-number-zero** - Проверяет, является ли значение нулем (числовым нулем).
-- **is-string-contained** - Проверяет, содержится ли подстрока в указанной строке.
-- **is-string-empty** - Проверяет, является ли строка пустой.
-- **is-string-ending-with** - Проверяет, заканчивается ли строка указанной подстрокой.
-- **is-string-starting-with** - Проверяет, начинается ли строка с указанной подстроки.
-- **is-boolean** - Проверяет, является ли переданное значение логическим типом (boolean).
-- **is-color** - Проверяет, является ли значение допустимым цветом.
-- **is-list** - Проверяет, является ли значение списком (list) или списком аргументов (arglist).
-- **is-map** - Проверяет, является ли значение ассоциативным массивом (map).
-- **is-number** - Проверяет, является ли значение числом
-- **is-string** - Проверяет, является ли значение строкой (string)
-- **is-type** - Возвращает тип данных переданного значения.
-
-> Чтобы получить подробные сведения об API новых функций, посетите веб-сайт по адресу [https://omnisass.sourcecraft.site/sassdocs/](https://omnisass.sourcecraft.site/sassdocs/).