@omnisass/library 0.2.0 → 2026.1.0-alpha.1

package/modules/utilities/validators/{misc/_is-time.scss → _is-time.scss}

@@ -13,7 +13,7 @@
 /// ---
 /// @name is-time
 /// @group utilities-validators
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Halil İbrahim Çakıroğlu
 /// @author Murad Rustamov (therteenten) [адаптация]
@@ -105,7 +105,7 @@
 /// @return {Boolean} - Возвращает `true`, если значение является
 /// 	корректным временным значением, иначе возвращает `false`.
 @function is-time($value) {
-	@for $i from 1 through list.length($value) {
+	@for $-i from 1 through list.length($value) {
 		@if (meta.type-of($value) == 'number' and list.index('ms' 's' 'h', math.unit($value)) != null) or $value == 0 {
 			@return true;
 		} @else {

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

@@ -12,7 +12,7 @@
 /// ---
 /// @name is-color-light
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -20,7 +20,7 @@
 /// ---
 /// @name is-color-list
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -18,7 +18,7 @@
 /// ---
 /// @name is-list-contained
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten) [адаптация]
 /// @author Неизвестный автор [идея не моя, но автора исходной функции не помню уже]

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

@@ -19,7 +19,7 @@
 /// ---
 /// @name is-int-even
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -20,7 +20,7 @@
 /// ---
 /// @name is-int-odd
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -23,7 +23,7 @@
 /// ---
 /// @name is-int
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Zsolt Pentz
 /// @author Murad Rustamov (therteenten) [адаптация]

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

@@ -26,7 +26,7 @@
 /// ---
 /// @name is-number-has-unit
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -20,7 +20,7 @@
 /// ---
 /// @name is-number-negative
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -19,7 +19,7 @@
 /// ---
 /// @name is-number-positive
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -22,7 +22,7 @@
 /// ---
 /// @name is-number-unitless
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -20,7 +20,7 @@
 /// ---
 /// @name is-number-zero
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -45,7 +45,7 @@
 /// ---
 /// @name is-string-contained
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
@@ -61,35 +61,35 @@
 /// @link https://webdevblog.ru/sass-strokovye-funkcii/ См. также: WebDevBlog - Строковые функции в Sass
 /// @link https://stackoverflow.com/questions/32376461/how-to-check-if-a-string-contains-a-substring-in-sass Stack Overflow - Как проверить наличие подстроки в строке в Sass
 /// @example scss - Базовая проверка наличия подстроки
-/// 	@debug is-string-contained("Hello, world!", "world");    // true
-/// 	@debug is-string-contained("Hello, world!", "planet");   // false
-/// 	@debug is-string-contained("Hello, world!", "hello");    // false (регистрозависимо)
-/// 	@debug is-string-contained("Hello, world!", "WORLD");    // false (регистрозависимо)
+/// @debug is-string-contained("Hello, world!", "world");    // true
+/// @debug is-string-contained("Hello, world!", "planet");   // false
+/// @debug is-string-contained("Hello, world!", "hello");    // false (регистрозависимо)
+/// @debug is-string-contained("Hello, world!", "WORLD");    // false (регистрозависимо)
 /// @example scss - Проверка с учетом регистра (рекомендуемый подход)
-/// 	@debug is-string-contained(string.to-lower-case("Hello, world!"), "world");  // true
-/// 	@debug is-string-contained(string.to-lower-case("Hello, world!"), "WORLD");  // false
-/// 	// Для регистронезависимой проверки:
-/// 	@function contains-ignore-case($string, $substring) {
-/// 		@return is-string-contained(
-/// 			string.to-lower-case($string),
-/// 			string.to-lower-case($substring)
-/// 		);
-/// 	}
+/// @debug is-string-contained(string.to-lower-case("Hello, world!"), "world");  // true
+/// @debug is-string-contained(string.to-lower-case("Hello, world!"), "WORLD");  // false
+/// // Для регистронезависимой проверки:
+/// @function contains-ignore-case($string, $substring) {
+/// 	@return is-string-contained(
+/// 		string.to-lower-case($string),
+/// 		string.to-lower-case($substring)
+/// 	);
+/// }
 /// @example scss - Проверка с пустыми строками
-/// 	@debug is-string-contained("Hello", "");         // true
-/// 	@debug is-string-contained("", "Hello");         // false
-/// 	@debug is-string-contained("", "");              // true
+/// @debug is-string-contained("Hello", "");         // true
+/// @debug is-string-contained("", "Hello");         // false
+/// @debug is-string-contained("", "");              // true
 /// @example scss - Использование с генерацией классов
-/// 	$button-variants: "primary", "secondary", "danger";
-/// 	@each $variant in $button-variants {
-/// 		.button--#{$variant} {
-/// 			@if is-string-contained($variant, "danger") {
-/// 				background-color: red;
-/// 			} @else {
-/// 				background-color: blue;
-/// 			}
+/// $button-variants: "primary", "secondary", "danger";
+/// @each $variant in $button-variants {
+/// 	.button--#{$variant} {
+/// 		@if is-string-contained($variant, "danger") {
+/// 			background-color: red;
+/// 		} @else {
+/// 			background-color: blue;
 /// 		}
 /// 	}
+/// }
 /// @param {String} $string - Строка, в которой выполняется
 /// 	поиск. Может быть любой строкой, включая пустую строку.
 /// 	Значение приводится к строковому типу, если это необходимо.

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

@@ -16,7 +16,7 @@
 /// ---
 /// @name is-string-empty
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -17,7 +17,7 @@
 /// ---
 /// @name is-string-ending-with
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -17,7 +17,7 @@
 /// ---
 /// @name is-string-starting-with
 /// @group utilities-validators
-/// @since 2026.01.03
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -12,7 +12,7 @@
 /// ---
 /// @name is-boolean
 /// @group utilities-validators
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author takamoso
 /// @author Murad Rustamov (therteenten) [адаптация]

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

@@ -21,7 +21,7 @@
 /// ---
 /// @name is-color
 /// @group utilities-validators
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -13,7 +13,7 @@
 /// ---
 /// @name is-list
 /// @group utilities-validators
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author takamoso
 /// @author Murad Rustamov (therteenten) [адаптация]

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

@@ -11,7 +11,7 @@
 /// ---
 /// @name is-map
 /// @group utilities-validators
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author takamoso
 /// @author Murad Rustamov (therteenten) [адаптация]

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

@@ -8,7 +8,7 @@
 /// ---
 /// @name is-number
 /// @group utilities-validators
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

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

@@ -11,7 +11,7 @@
 /// ---
 /// @name is-string
 /// @group utilities-validators
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author takamoso
 /// @author Murad Rustamov (therteenten) [адаптация]

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

@@ -17,7 +17,7 @@
 /// ---
 /// @name is-type
 /// @group utilities-validators
-/// @since 2025.12.27
+/// @since 0.0.1
 /// @access public
 /// @author Murad Rustamov (therteenten)
 /// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten

package/package.json

@@ -1,8 +1,9 @@
 {
 	"name": "@omnisass/library",
-	"version": "0.2.0",
+	"version": "2026.01.0-alpha.1",
 	"description": "Библиотека функций и миксинов, написанная на языке CSS-препроцессора Sass. Она предназначена для того, чтобы упростить, ускорить и улучшить процесс создания стилей для веб-сайтов.",
 	"main": "index.scss",
+	
 	"scripts": {
 		"test": "sass playground/:playground/",
 		"test-with-docs": "sass playground/:playground/ && npm run sassdoc",
@@ -12,8 +13,8 @@
 	},
 	"exports": {
 		".": {
-			"sass": "./index.scss"
-		}
+      "sass": "./index.scss"
+    }
 	},
 	"keywords": [
 		"sass",
@@ -46,9 +47,7 @@
 	},
 	"homepage": "https://sourcecraft.dev/therteenten",
 	"devDependencies": {
+		"sass": "^1.94.2",
 		"sassdoc": "^2.7.4"
-	},
-	"dependencies": {
-		"sass": "^1.97.2"
 	}
 }

package/package.scss

@@ -1,5 +1,5 @@
 @use 'sass:map';
-@use './configs' as libconfigs;
+@use './configs' as libconf;
 
 ////
 /// В данном файле представлены переменные, описывающие
@@ -53,7 +53,7 @@ $description: "Набор утилит, миксинов, расширений
 /// @name version
 /// @access private
 /// @type String | Number
-$version: "0.2.0";
+$version: "2026.01.0-alpha.1";
 
 /// Тип лицензии библиотеки - используется для указания
 /// условий использования и распространения.
@@ -130,7 +130,7 @@ $author: (
 	$-author-name: map.get($author, name);
 	$-author-email: map.get($author, email);
 
-	@if libconfigs.$set-fingerprint == true {
+	@if libconf.$set-fingerprint == true {
 
 		/*
 		* @package:

package/playground/index.scss

@@ -0,0 +1,8 @@
+@use 'sass:math';
+@use 'sass:list';
+@use 'sass:meta';
+@use 'sass:map';
+@use 'sass:color';
+@use 'sass:string';
+@use '../index.scss' as *;
+

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

@@ -1,186 +0,0 @@
-@use 'sass:string';
-@use '../loggers/log-invalid-type' as *;
-@use '../validators/type-of/is-string' as *;
-
-/// Конвертирует строку из `camelCase` (верблюжья нотация) в
-/// `kebab-case` (кебаб-нотация или дефисная нотация).
-///
-/// Функция проходит по каждому символу входной строки и
-/// преобразует заглавные буквы в строчные с добавлением дефиса
-/// перед ними (кроме первого символа). Это позволяет
-/// преобразовывать имена переменных JavaScript/TypeScript или
-/// названия классов в формате, совместимом с CSS-нотацией.
-///
-/// Важные особенности функции:
-/// - Сохраняет регистр исходных символов (преобразует к нижнему)
-/// - Добавляет дефис перед заглавными буквами (кроме первой)
-/// - Итеративно обрабатывает каждый символ строки
-/// - Возвращает строку в нижнем регистре с дефисами
-/// - Полезно для генерации CSS-классов из JS-объектов
-/// - Используется для консистентного именования стилей
-/// - Обрабатывает строки любой длины
-/// - Не изменяет цифры и специальные символы в строке
-/// - Учитывает граничные случаи (пустая строка, одиночный символ)
-/// - Обеспечивает двустороннюю совместимость naming convention
-/// ---
-/// @name convert-camel2kebab
-/// @group utilities-converters
-/// @since 2026.01.13
-/// @access public
-/// @author Murad Rustamov (therteenten)
-/// @link https://sourcecraft.dev/users/therteenten/overview SourceCraft - therteenten
-/// @link https://sourcecraft.dev/omnisass/library SourceCraft - OmniSass
-/// @link https://sass-lang.com/documentation/modules/string См. также: Официальная документация Sass - Модуль String
-/// @link https://sass-lang.com/documentation/values/strings См. также: Официальная документация Sass - Тип данных "Строки"
-/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Object_initializer См. также: MDN Web Docs - Object initializer
-/// @link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Grammar_and_types#variable_names См. также: MDN Web Docs - Имена переменных в JavaScript
-/// @link https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_nesting/Using_CSS_nesting См. также: MDN Web Docs - Использование CSS Nesting
-/// @link https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web/JavaScript_basics См. также: MDN Web Docs - Основы JavaScript
-/// @link https://css-tricks.com/snippets/sass/string-case-conversion-functions/ См. также: CSS-Tricks - Функции преобразования регистра строк в Sass
-/// @link https://css-tricks.com/sass-techniques-from-the-trenches/ См. также: CSS-Tricks - Sass техники из практики
-/// @link https://sass-guidelin.es/ru/#section-42 См. также: Sass Guidelines - Раздел про строки
-/// @link https://www.w3schools.com/js/js_conventions.asp См. также: W3Schools - Соглашения по коду JavaScript
-/// @example scss - Базовые преобразования
-/// 	@debug convert-camel2kebab('camelCase');      // 'camel-case'
-/// 	@debug convert-camel2kebab('backgroundColor'); // 'background-color'
-/// 	@debug convert-camel2kebab('fontSize');       // 'font-size'
-/// 	@debug convert-camel2kebab('borderRadius');   // 'border-radius'
-/// 	@debug convert-camel2kebab('paddingLeft');    // 'padding-left'
-/// 	@debug convert-camel2kebab('marginBottom');   // 'margin-bottom'
-/// @example scss - Граничные случаи
-/// 	@debug convert-camel2kebab('single');         // 'single'
-/// 	@debug convert-camel2kebab('');               // '' (пустая строка)
-/// 	@debug convert-camel2kebab('A');              // 'a'
-/// 	@debug convert-camel2kebab('AB');             // 'a-b'
-/// 	@debug convert-camel2kebab('AlreadyKebab');   // 'already-kebab'
-/// 	@debug convert-camel2kebab('lowercase');      // 'lowercase'
-/// @example scss - Компоненты и классы
-/// 	@debug convert-camel2kebab('ButtonPrimary');  // 'button-primary'
-/// 	@debug convert-camel2kebab('ModalHeader');    // 'modal-header'
-/// 	@debug convert-camel2kebab('CardContent');    // 'card-content'
-/// 	@debug convert-camel2kebab('InputGroup');     // 'input-group'
-/// 	@debug convert-camel2kebab('NavBar');         // 'nav-bar'
-/// 	@debug convert-camel2kebab('SideMenu');       // 'side-menu'
-/// @example scss - Интеграция с JavaScript объектами
-/// 	// Преобразование ключей объекта JS в CSS-классы
-/// 	$js-config: (
-/// 	  primaryColor: 'blue',
-/// 	  secondaryColor: 'gray',
-/// 	  fontSizeSmall: 12px,
-/// 	  borderRadiusLarge: 8px
-/// 	);
-///
-/// 	@each $key, $value in $js-config {
-/// 	  .#{convert-camel2kebab($key)} {
-/// 	    content: $value;
-/// 	  }
-/// 	}
-/// @example css - Результат
-/// 	.primary-color {
-/// 	  content: "blue";
-/// 	}
-///
-/// 	.secondary-color {
-/// 	  content: "gray";
-/// 	}
-///
-/// 	.font-size-small {
-/// 	  content: 12px;
-/// 	}
-///
-/// 	.border-radius-large {
-/// 	  content: 8px;
-/// 	}
-/// @param {String} $value - Строка в `camelCase` нотации для
-/// 	конвертации. Может содержать буквы (верхний и нижний
-/// 	регистр), цифры и специальные символы. Функция
-/// 	преобразует заглавные буквы в строчные и добавляет
-/// 	дефисы перед ними.
-/// @return {String} - Строка в kebab-case нотации, где все
-/// 	символы преобразованы к нижнему регистру, а перед
-/// 	заглавными буквами (кроме первой) добавлены дефисы.
-/// 	Результат готов к использованию как CSS-класс или
-/// 	часть селектора.
-/// @throws {Error} - Может выбросить ошибку при передаче
-/// 	нестроковых значений. Аргумент должен быть строкой
-/// 	для корректной работы строковых функций Sass.
-@function convert-camel2kebab($value) {
-
-	// Переменная для накопления результата преобразования.
-	// Инициализируется пустой строкой.
-	$-result: '';
-
-	// Проверка типа входного параметра: ожидается строковое значение.
-	// Функция is-string() проверяет, является ли $value строкой
-	// (тип данных string).
-	@if not is-string($value) {
-
-		// Если $value не является строкой, возвращаем ошибку через
-		// стандартную функцию логирования. Это предотвращает
-		// выполнение операции преобразования с некорректными данными.
-		@return log-invalid-type(
-			'convert-camel2kebab',
-			$value,
-			'$value',
-			'string'
-		);
-
-	}
-
-	// Основная логика выполняется только если $value является
-	// корректной строкой.
-	@else {
-
-		// Определение длины входной строки для организации цикла.
-		// Функция string.length() возвращает количество символов
-		// в строке.
-		$-length: string.length($value);
-
-		// Цикл по всем символам строки от первого до последнего.
-		// Индекс $i последовательно принимает значения от 1 до $-length.
-		@for $i from 1 through $-length {
-
-			// Извлечение текущего символа строки по индексу $i.
-			// Функция string.slice() возвращает подстроку,
-			// в данном случае - один символ.
-			$-char: string.slice($value, $i, $i);
-
-			// Проверка: является ли текущий символ заглавной буквой
-			// и не является ли он первым символом в строке.
-			// Условие $-char == string.to-upper-case($-char) проверяет,
-			// что символ в верхнем регистре (сравнивая его с его же
-			// версией в верхнем регистре).
-			// Условие $i > 1 гарантирует, что мы не добавляем дефис
-			// перед первым символом (даже если он заглавный).
-			@if $-char == string.to-upper-case($-char) and $i > 1 {
-
-				// Если символ - заглавная буква и не первый в строке:
-				// 1. Добавляем дефис "-" к результату
-				// 2. Добавляем символ, преобразованный в нижний регистр
-				//
-				// Это преобразует camelCase в kebab-case:
-				// Пример: "camelCase" → "camel-case"
-				//         "C" (на позиции 6) → "-c"
-				$-result: $-result + '-' + string.to-lower-case($-char);
-
-			} @else {
-
-				// Если символ не является заглавной буквой ИЛИ
-				// это первый символ в строке:
-				// Добавляем символ, преобразованный в нижний регистр.
-				//
-				// Это гарантирует, что вся строка будет в нижнем регистре
-				// и первый символ никогда не получит дефис перед собой.
-				$-result: $-result + string.to-lower-case($-char);
-
-			}
-
-		}
-
-		// Возвращаем итоговую строку после преобразования
-		// всех символов.
-		@return $-result;
-
-	}
-
-}