@omnisass/library 0.2.0

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

@@ -0,0 +1,103 @@
+@use 'sass:meta';
+
+/// Проверяет, является ли значение числом
+///
+/// Функция определяет тип данных переданного
+/// значения и возвращает `true`, если значение
+/// является числом (включая числа с единицами измерения).
+/// ---
+/// @name is-number
+/// @group utilities-validators
+/// @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/meta#type-of См. также: Официальная документация Sass - Функция meta.type-of()
+/// @link https://sass-lang.com/documentation/modules/meta См. также: Официальная документация Sass - Модуль meta
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Официальная документация Sass - Тип данных "Числа" (Numbers)
+/// @link https://sass-lang.com/documentation/values/numbers#units См. также: Официальная документация Sass - Числа и единицы измерения
+/// @link https://sass-lang.com/documentation/at-rules/function См. также: Официальная документация Sass - Правило @function
+/// @link https://sass-lang.com/documentation/style-rules/declarations#custom-properties См. также: Документация Sass - Пользовательские функции
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/number См. также: MDN Web Docs - CSS тип данных <number>
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Values_and_Units См. также: MDN Web Docs - CSS значения и единицы измерения
+/// @link https://www.w3schools.com/sass/sass_functions_numeric.php См. также: W3Schools - Числовые функции в Sass
+/// @link https://www.sass.hk/docs/ См. также: Китайская документация Sass - Полное руководство
+/// @link https://sass-guidelin.es/ru/#section-39 См. также: Sass Guidelines - Раздел про проверку типов данных
+/// @link https://github.com/sass/sass/blob/main/accepted/module-system.md См. также: GitHub - Документация по модульной системе Sass
+/// @link https://stackoverflow.com/questions/30867526/how-to-check-the-type-of-a-variable-is-a-string-or-a-number-in-scss См. также: Stack Overflow - Как проверить, является ли переменная числом в Sass
+/// @link https://stackoverflow.com/questions/12328259/how-do-you-strip-the-unit-from-any-number-in-sass См. также: Stack Overflow - Как удалить единицы измерения из числа в Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://web.dev/learn/css/numbers/ См. также: web.dev - Изучение чисел в CSS
+/// @link https://frontender.info/sass-numbers/ См. также: Frontender Magazine - Работа с числами в Sass
+/// @link https://habr.com/ru/post/247887/ См. также: Habr - Статья "Sass для верстальщика: числа и математика"
+/// @link https://www.sitepoint.com/sass-basics-operators/ См. также: SitePoint - Основы Sass: операторы
+/// @link https://www.freecodecamp.org/news/sass-data-types/ См. также: freeCodeCamp - Типы данных в Sass
+/// @link https://code.tutsplus.com/tutorials/understanding-sass-data-types--cms-22110 См. также: Envato Tuts+ - Понимание типов данных в Sass
+/// @link https://dev.to/kathryngrayson/sass-type-checking-1p6c См. также: Dev.to - Проверка типов в Sass
+/// @link https://css-live.ru/articles/uskorenie-razrabotki-s-pomoshhyu-sass.html См. также: CSS-Live - Ускорение разработки с помощью Sass
+/// @link https://itchief.ru/sass/data-types См. также: itchief - Типы данных в Sass
+/// @link https://htmlacademy.ru/blog/boost/tools/sass-2 См. также: HTML Academy - Sass: переменные и типы данных
+/// @link https://metanit.com/web/html5/13.3.php См. также: Metanit - Типы данных в Sass
+/// @link https://ru.hexlet.io/courses/sass-basics/lessons/data-types/theory_unit См. также: Hexlet - Типы данных в Sass
+/// @link https://www.youtube.com/watch?v=Zz6eOVaaelI См. также: YouTube - Sass Tutorial #4 - Data Types (The Net Ninja)
+/// @link https://www.youtube.com/watch?v=URtUXqOQq0k См. также: YouTube - Типы данных в Sass (на русском)
+/// @link https://codelabs.developers.google.com/codelabs/cloud-sass-cli#5 См. также: Google Codelabs - Создание пользовательских функций в Sass
+/// @link https://www.npmjs.com/package/sass См. также: npm - Документация пакета Dart Sass
+/// @link https://marketplace.visualstudio.com/items?itemName=Syler.sass-indented См. также: VS Code Marketplace - Поддержка синтаксиса Sass
+/// @link https://stylelint.io/user-guide/rules/length-zero-no-unit/ См. также: Stylelint - Правила для единиц измерения
+/// @link https://sass-lang.com/documentation/js-api См. также: JavaScript API - Работа с Sass через JavaScript
+/// @link https://sass-lang.com/documentation/cli/dart-sass См. также: CLI - Командная строка Dart Sass
+/// @link https://sass-lang.com/documentation/breaking-changes/module-system См. также: Breaking Changes - Изменения в модульной системе
+/// @link https://sass-lang.com/documentation/values/booleans См. также: Документация Sass - Логические значения
+/// @link https://sass-lang.com/documentation/values/strings См. также: Документация Sass - Строки
+/// @link https://sass-lang.com/documentation/values/colors См. также: Документация Sass - Цвета
+/// @link https://sass-lang.com/documentation/values/lists См. также: Документация Sass - Списки
+/// @link https://sass-lang.com/documentation/values/null См. также: Документация Sass - Значение null
+/// @link https://sass-lang.com/documentation/values/maps См. также: Документация Sass - Карты
+/// @link https://sass-lang.com/documentation/interpolation См. также: Документация Sass - Интерполяция
+/// @link https://sass-lang.com/documentation/modules/math См. также: Официальная документация Sass - Модуль math
+/// @link https://sass-lang.com/documentation/modules/math#abs См. также: Документация Sass - Функция math.abs()
+/// @link https://sass-lang.com/documentation/modules/math#ceil См. также: Документация Sass - Функция math.ceil()
+/// @link https://sass-lang.com/documentation/modules/math#floor См. также: Документация Sass - Функция math.floor()
+/// @link https://sass-lang.com/documentation/modules/math#max См. также: Документация Sass - Функция math.max()
+/// @link https://sass-lang.com/documentation/modules/math#min См. также: Документация Sass - Функция math.min()
+/// @link https://sass-lang.com/documentation/modules/math#percentage См. также: Документация Sass - Функция math.percentage()
+/// @link https://sass-lang.com/documentation/modules/math#random См. также: Документация Sass - Функция math.random()
+/// @link https://sass-lang.com/documentation/modules/math#round См. также: Документация Sass - Функция math.round()
+/// @example scss - Проверка числовых значений
+/// 	@debug is-number(10);          // true
+/// 	@debug is-number(3.14);        // true
+/// 	@debug is-number(1px);         // true
+/// 	@debug is-number(2em);         // true
+/// 	@debug is-number(0);           // true
+/// 	@debug is-number(-5rem);       // true
+/// @example scss - Проверка нечисловых значений
+/// 	@debug is-number("text");      // false
+/// 	@debug is-number(#fff);        // false
+/// 	@debug is-number(true);        // false
+/// 	@debug is-number(null);        // false
+/// 	@debug is-number((1, 2, 3));   // false
+/// 	@debug is-number(red);         // false
+/// @example scss - Использование для валидации
+/// 	@function calculate-margin($value) {
+/// 		@if not is-number($value) {
+/// 			@error "Ожидается числовое значение, получено: number";
+/// 		}
+/// 		@return $value * 2;
+/// 	}
+/// @example scss - Условная обработка
+/// 	.test {
+/// 		$spacing: 1px;
+/// 		@if is-number($spacing) {
+/// 			padding: $spacing;
+/// 		} @else {
+/// 			padding: 1rem;
+/// 		}
+/// 	}
+/// @param {*} $value - Проверяемое значение любого типа
+/// @return {Boolean} - Возвращает `true`, если значение является
+/// 	числом, иначе возвращает `false`.
+@function is-number($value) {
+	@return meta.type-of($value) == number;
+}

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

@@ -0,0 +1,110 @@
+@use 'sass:meta';
+
+/// Проверяет, является ли значение строкой (string)
+///
+/// Функция определяет, относится ли переданное значение
+/// к строковому типу данных в Sass. Строки могут быть
+/// заключены в кавычки (`""` или `''`) или без них, но тип
+/// всегда определяется как `string`.
+/// Полезно для валидации текстовых параметров,
+/// обработки контента и проверки входных данных.
+/// ---
+/// @name is-string
+/// @group utilities-validators
+/// @since 2025.12.27
+/// @access public
+/// @author takamoso
+/// @author Murad Rustamov (therteenten) [адаптация]
+/// @link https://github.com/takamoso GitHub - takamoso
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
+/// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
+/// @link https://sass-lang.com/documentation/modules/meta#type-of См. также: Официальная документация Sass - Функция meta.type-of()
+/// @link https://sass-lang.com/documentation/modules/meta См. также: Официальная документация Sass - Модуль meta
+/// @link https://sass-lang.com/documentation/values/strings См. также: Официальная документация Sass - Тип данных "Строки" (Strings)
+/// @link https://sass-lang.com/documentation/values/strings#escapes См. также: Официальная документация Sass - Экранирование символов в строках
+/// @link https://sass-lang.com/documentation/at-rules/function См. также: Официальная документация Sass - Правило @function
+/// @link https://sass-lang.com/documentation/style-rules/declarations#custom-properties См. также: Документация Sass - Пользовательские функции
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/string См. также: MDN Web Docs - CSS тип данных <string>
+/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/attr См. также: MDN Web Docs - CSS функция attr()
+/// @link https://www.w3schools.com/sass/sass_functions_string.php См. также: W3Schools - Строковые функции в Sass
+/// @link https://www.sass.hk/docs/ См. также: Китайская документация Sass - Полное руководство
+/// @link https://sass-guidelin.es/ru/#section-39 См. также: Sass Guidelines - Раздел про проверку типов данных
+/// @link https://github.com/sass/sass/blob/main/accepted/module-system.md См. также: GitHub - Документация по модульной системе Sass
+/// @link https://stackoverflow.com/questions/30867526/how-to-check-the-type-of-a-variable-is-a-string-or-a-number-in-scss См. также: Stack Overflow - Как проверить, является ли переменная строкой в Sass
+/// @link https://stackoverflow.com/questions/19456143/sass-if-a-variable-is-a-string См. также: Stack Overflow - Проверка строковой переменной в Sass
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://web.dev/learn/css/strings/ См. также: web.dev - Изучение строк в CSS
+/// @link https://frontender.info/sass-strings/ См. также: Frontender Magazine - Работа со строками в Sass
+/// @link https://habr.com/ru/post/247882/ См. также: Habr - Статья "Sass для верстальщика: строки"
+/// @link https://www.sitepoint.com/sass-basics-operators/ См. также: SitePoint - Основы Sass: операторы
+/// @link https://www.freecodecamp.org/news/sass-data-types/ См. также: freeCodeCamp - Типы данных в Sass
+/// @link https://code.tutsplus.com/tutorials/understanding-sass-data-types--cms-22110 См. также: Envato Tuts+ - Понимание типов данных в Sass
+/// @link https://dev.to/kathryngrayson/sass-type-checking-1p6c См. также: Dev.to - Проверка типов в Sass
+/// @link https://css-live.ru/articles/uskorenie-razrabotki-s-pomoshhyu-sass.html См. также: CSS-Live - Ускорение разработки с помощью Sass
+/// @link https://itchief.ru/sass/data-types См. также: itchief - Типы данных в Sass
+/// @link https://htmlacademy.ru/blog/boost/tools/sass-2 См. также: HTML Academy - Sass: переменные и типы данных
+/// @link https://metanit.com/web/html5/13.3.php См. также: Metanit - Типы данных в Sass
+/// @link https://ru.hexlet.io/courses/sass-basics/lessons/data-types/theory_unit См. также: Hexlet - Типы данных в Sass
+/// @link https://www.youtube.com/watch?v=Zz6eOVaaelI См. также: YouTube - Sass Tutorial #4 - Data Types (The Net Ninja)
+/// @link https://www.youtube.com/watch?v=URtUXqOQq0k См. также: YouTube - Типы данных в Sass (на русском)
+/// @link https://codelabs.developers.google.com/codelabs/cloud-sass-cli#5 См. также: Google Codelabs - Создание пользовательских функций в Sass
+/// @link https://www.npmjs.com/package/sass См. также: npm - Документация пакета Dart Sass
+/// @link https://marketplace.visualstudio.com/items?itemName=Syler.sass-indented См. также: VS Code Marketplace - Поддержка синтаксиса Sass
+/// @link https://stylelint.io/user-guide/rules/string-quotes/ См. также: Stylelint - Правила для кавычек в строках
+/// @link https://sass-lang.com/documentation/js-api См. также: JavaScript API - Работа с Sass через JavaScript
+/// @link https://sass-lang.com/documentation/cli/dart-sass См. также: CLI - Командная строка Dart Sass
+/// @link https://sass-lang.com/documentation/breaking-changes/module-system См. также: Breaking Changes - Изменения в модульной системе
+/// @link https://sass-lang.com/documentation/values/booleans См. также: Документация Sass - Логические значения
+/// @link https://sass-lang.com/documentation/values/numbers См. также: Документация Sass - Числа
+/// @link https://sass-lang.com/documentation/values/colors См. также: Документация Sass - Цвета
+/// @link https://sass-lang.com/documentation/values/lists См. также: Документация Sass - Списки
+/// @link https://sass-lang.com/documentation/values/null См. также: Документация Sass - Значение null
+/// @link https://sass-lang.com/documentation/values/maps См. также: Документация Sass - Карты
+/// @link https://sass-lang.com/documentation/interpolation См. также: Документация Sass - Интерполяция
+/// @link https://sass-lang.com/documentation/modules/string См. также: Официальная документация Sass - Модуль string
+/// @link https://sass-lang.com/documentation/modules/string#index См. также: Документация Sass - Функция string.index()
+/// @link https://sass-lang.com/documentation/modules/string#slice См. также: Документация Sass - Функция string.slice()
+/// @link https://sass-lang.com/documentation/modules/string#to-upper-case См. также: Документация Sass - Функция string.to-upper-case()
+/// @link https://sass-lang.com/documentation/modules/string#to-lower-case См. также: Документация Sass - Функция string.to-lower-case()
+/// @link https://sass-lang.com/documentation/modules/string#unique-id См. также: Документация Sass - Функция string.unique-id()
+/// @link https://sass-lang.com/documentation/modules/string#quote См. также: Документация Sass - Функция string.quote()
+/// @link https://sass-lang.com/documentation/modules/string#unquote См. также: Документация Sass - Функция string.unquote()
+/// @example scss - Проверка строковых значений
+/// 	@debug is-string("Hello World");		// true
+/// 	@debug is-string('Single quotes');	// true
+/// 	@debug is-string(without-quotes);		// true
+/// 	@debug is-string("");								// true (пустая строка)
+/// @example scss - Проверка других типов
+/// 	@debug is-string(42);						// false
+/// 	@debug is-string(true);					// false
+/// 	@debug is-string(#fff);					// false
+/// 	@debug is-string((1, 2, 3));		// false
+/// 	@debug is-string((key: value));	// false
+/// @example scss - Использование для валидации текстовых параметров
+/// 	@function to-uppercase($text) {
+/// 		@if not is-string($text) {
+/// 			@error "Параметр $text должен быть строкой";
+/// 		}
+/// 		@return to-upper-case($text);
+/// 	}
+///
+/// @example scss - Обработка контента
+/// 	@mixin generate-icon($name) {
+/// 		@if not is-string($name) {
+/// 			@warn "Название иконки должно быть строкой";
+/// 		}
+/// 		content: $name;
+/// 	}
+///
+/// @example scss - Условная логика для разных типов
+/// 	@if is-string($value) {
+/// 		@debug "Текстовое значение: #{$value}";
+/// 	} @else if is-number($value) {
+/// 		@debug "Числовое значение: #{$value}";
+/// 	}
+/// @param {*} $value - Проверяемое значение
+/// @return {Boolean} - `true` если значение является
+/// 	строкой, `false` во всех остальных случаях.
+@function is-string($value) {
+  @return meta.type-of($value) == string;
+}

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

@@ -0,0 +1,77 @@
+@use 'sass:meta';
+
+/// Возвращает тип данных переданного значения.
+///
+/// Функция является оберткой над встроенной функцией
+/// `meta.type-of()` для удобства использования и лучшей
+/// читаемости кода. Возвращает строку, содержащую название
+/// типа данных переданного значения.
+///
+/// Важные особенности функции:
+/// - Является оберткой над `meta.type-of()` для улучшения
+/// 	читаемости
+/// - Возвращает строковое представление типа данных
+/// - Поддерживает все типы данных Sass
+/// - Не выполняет дополнительных преобразований или проверок
+/// - Возвращает стандартные названия типов Sass
+/// ---
+/// @name is-type
+/// @group utilities-validators
+/// @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/meta#type-of См. также: Официальная документация Sass - Функция meta.type-of()
+/// @link https://sass-lang.com/documentation/values См. также: Официальная документация Sass - Типы данных
+/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/typeof MDN Web Docs - Оператор typeof
+/// @link https://css-tricks.com/snippets/sass/ См. также: CSS-Tricks - Коллекция сниппетов Sass
+/// @link https://sass-guidelin.es/ru/#section-39 См. также: Sass Guidelines - Раздел про проверку типов
+/// @link https://frontender.info/sass-type-checking/ См. также: Frontender Magazine - Проверка типов в Sass
+/// @link https://www.w3schools.com/sass/sass_functions_meta.php См. также: W3Schools - Мета-функции в Sass
+/// @link https://habr.com/ru/post/247879/ См. также: Habr - Статья "Sass для верстальщика: проверки и валидация"
+/// @example scss - Определение типа чисел
+/// 	@debug is-type(10);           // "number"
+/// 	@debug is-type(3.14);         // "number"
+/// 	@debug is-type(10px);         // "number"
+/// 	@debug is-type(-5rem);        // "number"
+/// 	@debug is-type(0);            // "number"
+/// @example scss - Определение типа строк
+/// 	@debug is-type("text");       // "string"
+/// 	@debug is-type('single');     // "string"
+/// 	@debug is-type("");           // "string"
+/// 	@debug is-type("123");        // "string"
+/// @example scss - Определение типа цветов
+/// 	@debug is-type(#ff0000);           // "color"
+/// 	@debug is-type(red);               // "color"
+/// 	@debug is-type(rgb(255, 0, 0));    // "color"
+/// 	@debug is-type(hsl(0, 100%, 50%)); // "color"
+/// @example scss - Определение типа списков и карт
+/// 	@debug is-type((a, b, c));    // "list"
+/// 	@debug is-type((1 2 3));      // "list"
+/// 	@debug is-type(());           // "list"
+/// 	@debug is-type((key: value)); // "map"
+/// 	@debug is-type((1: a, 2: b)); // "map"
+/// @example scss - Определение типа логических значений и null
+/// 	@debug is-type(true);         // "bool"
+/// 	@debug is-type(false);        // "bool"
+/// 	@debug is-type(null);         // "null"
+/// @param {*} $value - Значение, тип которого нужно определить.
+/// 	Может быть любого типа: число, строка, цвет, список,
+/// 	карта, логическое значение, null, arglist или function.
+/// @return {String} - Строка, содержащая название типа данных
+/// 	переданного значения. Возможные значения:
+///   - `"number"` - для чисел (с единицами или без)
+///   - `"string"` - для строк
+///   - `"color"` - для цветов
+///   - `"list"` - для списков
+///   - `"map"` - для карт (ассоциативных массивов)
+///   - `"bool"` - для логических значений (true/false)
+///   - `"null"` - для значения null
+///   - `"arglist"` - для списков аргументов
+///   - `"function"` - для функций
+/// @throws Не выбрасывает ошибок, корректно обрабатывает
+/// 	значения любого типа.
+@function is-type($value) {
+	@return meta.type-of($value);
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+	"name": "@omnisass/library",
+	"version": "0.2.0",
+	"description": "Библиотека функций и миксинов, написанная на языке CSS-препроцессора Sass. Она предназначена для того, чтобы упростить, ускорить и улучшить процесс создания стилей для веб-сайтов.",
+	"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"
+	},
+	"exports": {
+		".": {
+			"sass": "./index.scss"
+		}
+	},
+	"keywords": [
+		"sass",
+		"scss",
+		"omnisass",
+		"therteenten",
+		"css",
+		"mixin",
+		"function",
+		"sass-mixin",
+		"sass-function",
+		"scss-minix",
+		"scss-function",
+		"web-development",
+		"colors"
+	],
+	"repository": {
+		"type": "git",
+		"url": "https://git@git.sourcecraft.dev/omnisass/library.git"
+	},
+	"author": {
+		"name": "Murad Rustamov (therteenten)",
+		"email": "therteenten@ya.ru",
+		"url": "https://sourcecraft.dev/users/therteenten/overview"
+	},
+	"license": "MIT",
+	"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"
+	}
+}

package/package.scss

@@ -0,0 +1,156 @@
+@use 'sass:map';
+@use './configs' as libconfigs;
+
+////
+/// В данном файле представлены переменные, описывающие
+/// библиотеку, и, как правило, не требуют модификации
+/// (за исключением переменной `$version`, которая подлежит
+/// обновлению посредством скрипта bump-version.sh).
+/// ---
+/// @group package
+////
+
+/// Библиотека функций и миксинов, написанная на языке
+/// CSS-препроцессора Sass. Она предназначена для того,
+/// чтобы упростить, ускорить и улучшить процесс создания
+/// стилей для веб-сайтов.
+/// ---
+/// @ignore
+/// @name package
+/// @access private
+/// @author Murad Rustamov (therteenten)
+/// @link https://t.me/therteenten Telegram
+/// @link https://t.me/omnisass Telegram (OmniSass)
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft
+/// @link https://sourcecraft.dev/omnisass/library SourceCraft (OmniSass)
+/// @type String
+$package: '@omnisass/library';
+
+/// Название библиотеки - используется для идентификации и
+/// ссылок в документации.
+/// ---
+/// @ignore
+/// @name title
+/// @access private
+/// @type String
+$title: "OmniSass";
+
+/// Описание библиотеки - краткое пояснение назначения и
+/// преимуществ использования данного набора.
+/// ---
+/// @ignore
+/// @name description
+/// @access private
+/// @type String
+$description: "Набор утилит, миксинов, расширений на языке препроцессора @sass для помощи в ускорении, упрощении и улучщения процесса написания CSS-стилей.";
+
+/// Текущая версия библиотеки - используется для контроля
+/// версий и отслеживания изменений.
+/// ---
+/// @ignore Данная переменная не важна для кода. Она дублирует
+/// 	версию проекта из package.json, благодаря скрипту
+/// 	bump-version.sh.
+/// @name version
+/// @access private
+/// @type String | Number
+$version: "0.2.0";
+
+/// Тип лицензии библиотеки - используется для указания
+/// условий использования и распространения.
+/// ---
+/// @ignore
+/// @name license
+/// @access private
+/// @type String
+$license: "MIT";
+
+/// URL исходного кода библиотеки OmniSass - используется
+/// для атрибуции и ссылок на документацию.
+/// ---
+/// @ignore
+/// @name sources
+/// @access private
+/// @type String
+$sources: "https://sourcecraft.dev/omnisass/library";
+
+/// )))
+/// ---
+/// @ignore
+/// @name author
+/// @access private
+/// @link https://t.me/therteenten Telegram
+/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft
+/// @prop {String} author.name [Murad Rustamov (therteenten)] - Автор проекта
+/// @prop {String} author.email [therteenten@ya.ru] - Адрес электронной почты автора проекта
+/// @type Map
+$author: (
+	name: "Murad Rustamov (therteenten)",
+	email: "therteenten@ya.ru"
+);
+
+/// Миксин создающий комментарий с основной информацией о
+/// библиотеке в итоговом CSS-файле.
+/// ---
+/// @name genOmniSassFingerprint
+/// @access public
+/// @example scss - Базовое использование
+/// 	@include genOmniSassFingerprint();
+/// @example scss - Использование без лога в консоль
+/// 	@include genOmniSassFingerprint(false);
+/// @example css - Примерный итоговый результат
+/// 	/*
+/// 	 * @package:
+/// 	   └─ name: @therteenten/omnisass
+/// 		 └─ version: 0.0.0
+/// 		 └─ project: OmniSass
+/// 		 └─ description: Набор утилит, миксинов, расширений на языке препроцессора @sass для помощи в ускорении, упрощении и улучщения процесса написания CSS-стилей.
+/// 	 * @license
+/// 	   └─ MIT
+/// 	 * @author:
+/// 	   └─ name: Murad Rustamov (therteenten)
+/// 		 └─ email: therteenten@ya.ru
+/// 	 * @links:
+/// 	   └─ sources: https://sourcecraft.dev/omnisass/library
+/// 	 */
+/// @output На выходе в итоговом скомпилированном CSS-файле
+/// 	будет находиться блок комментария с краткой информацией
+/// 	о проекте OmniSass (имя пакета, версия, автор и etc).
+/// @param {Boolean} $show-console-log [true] - переменная логического
+/// 	типа (true/false), влияющая на отображение лога об использовании
+/// 	OmniSass в консоль при компиляции Sass в CSS.
+/// @require {Variable} $package
+/// @require {Variable} $version
+/// @require {Variable} $description
+/// @require {Variable} $sources
+/// @require {Variable} $title
+/// @require {Variable} $author
+/// @require {Variable} $license
+@mixin genOmniSassFingerprint($show-console-log: true) {
+
+	$-author-name: map.get($author, name);
+	$-author-email: map.get($author, email);
+
+	@if libconfigs.$set-fingerprint == true {
+
+		/*
+		* @package:
+			└─ name: #{$package}
+			└─ version: #{$version}
+			└─ project: #{$title}
+			└─ description: #{$description}
+		* @license
+			└─ #{$license}
+		* @author:
+			└─ name: #{$-author-name}
+			└─ email: #{$-author-email}
+		* @links:
+			└─ sources: #{$sources}
+		*/
+
+		@if ($show-console-log) == true {
+			@debug "#{$title} #{$version} using!";
+		}
+
+	}
+
+}