@omnisass/library 0.4.0 → 0.5.0

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/).

package/test2.sh

@@ -1,158 +0,0 @@
-#!/bin/bash
-
-# Скрипт для генерации changes.md с изменениями с последнего тега
-
-set -e
-
-OUTPUT_FILE="changes.md"
-TEMP_FILE=".git_changes.tmp"
-
-# Функция для очистки временных файлов
-cleanup() {
-    if [ -f "$TEMP_FILE" ]; then
-        rm -f "$TEMP_FILE"
-    fi
-}
-
-trap cleanup EXIT
-
-# Получаем последний тег
-echo "🔍 Поиск последнего тега..."
-LAST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
-
-if [ -z "$LAST_TAG" ]; then
-    echo "⚠️  Теги не найдены. Используется первый коммит."
-    TAG_HASH=$(git rev-list --max-parents=0 HEAD)
-    LAST_TAG="начала репозитория"
-else
-    TAG_HASH=$(git rev-list -n 1 "$LAST_TAG")
-fi
-
-# Получаем текущую ветку и хэш HEAD
-CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
-CURRENT_HASH=$(git rev-parse --short HEAD)
-CURRENT_DATE=$(date '+%Y-%m-%d %H:%M:%S')
-
-# Получаем количество коммитов
-COMMIT_COUNT=$(git rev-list --count "$TAG_HASH"..HEAD)
-
-echo "📊 Найдено $COMMIT_COUNT коммитов с тега $LAST_TAG"
-
-# Генерируем файл changes.md
-echo "# Список изменений" > "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-echo "## 📋 Информация" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-echo "- **Последний тег:** \`$LAST_TAG\`" >> "$OUTPUT_FILE"
-echo "- **Текущая ветка:** \`$CURRENT_BRANCH\`" >> "$OUTPUT_FILE"
-echo "- **Хэш HEAD:** \`$CURRENT_HASH\`" >> "$OUTPUT_FILE"
-echo "- **Дата генерации:** $CURRENT_DATE" >> "$OUTPUT_FILE"
-echo "- **Количество коммитов:** $COMMIT_COUNT" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-if [ $COMMIT_COUNT -eq 0 ]; then
-    echo "## 📭 Изменения отсутствуют" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    echo "Нет новых коммитов с тега \`$LAST_TAG\`" >> "$OUTPUT_FILE"
-
-    echo "✅ Файл $OUTPUT_FILE создан (без изменений)"
-    exit 0
-fi
-
-echo "## 📈 Сводка изменений" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-# Статистика по авторам
-echo "### 👥 Авторы изменений" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-git shortlog -s -n --no-merges "$TAG_HASH"..HEAD | while read line; do
-    count=$(echo "$line" | awk '{print $1}')
-    author=$(echo "$line" | awk '{$1=""; print substr($0,2)}')
-    echo "- **$author:** $count коммит(ов)" >> "$OUTPUT_FILE"
-done
-echo "" >> "$OUTPUT_FILE"
-
-# Статистика изменений файлов
-echo "### 📊 Изменения файлов" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-echo '```diff' >> "$OUTPUT_FILE"
-git diff --stat "$TAG_HASH" HEAD >> "$TEMP_FILE" 2>/dev/null || echo "Статистика изменений недоступна" > "$TEMP_FILE"
-cat "$TEMP_FILE" >> "$OUTPUT_FILE"
-echo '```' >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-# Группировка по типу коммитов (Conventional Commits)
-echo "## 🗂️  Изменения по категориям" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-# Новые возможности
-feat_count=$(git log --oneline --grep="^feat" "$TAG_HASH"..HEAD | wc -l)
-if [ $feat_count -gt 0 ]; then
-    echo "### 🚀 Новые возможности ($feat_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^feat" "$TAG_HASH"..HEAD | sed 's/^feat:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Исправления ошибок
-fix_count=$(git log --oneline --grep="^fix" "$TAG_HASH"..HEAD | wc -l)
-if [ $fix_count -gt 0 ]; then
-    echo "### 🐛 Исправления ошибок ($fix_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^fix" "$TAG_HASH"..HEAD | sed 's/^fix:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Документация
-docs_count=$(git log --oneline --grep="^docs" "$TAG_HASH"..HEAD | wc -l)
-if [ $docs_count -gt 0 ]; then
-    echo "### 📚 Документация ($docs_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^docs" "$TAG_HASH"..HEAD | sed 's/^docs:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Рефакторинг
-refactor_count=$(git log --oneline --grep="^refactor" "$TAG_HASH"..HEAD | wc -l)
-if [ $refactor_count -gt 0 ]; then
-    echo "### ♻️  Рефакторинг ($refactor_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^refactor" "$TAG_HASH"..HEAD | sed 's/^refactor:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Тесты
-test_count=$(git log --oneline --grep="^test" "$TAG_HASH"..HEAD | wc -l)
-if [ $test_count -gt 0 ]; then
-    echo "### ✅ Тесты ($test_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- **%s** (\`%h\`)" --grep="^test" "$TAG_HASH"..HEAD | sed 's/^test:*//i' >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Остальные коммиты
-other_count=$(git log --oneline --invert-grep --grep="^feat\|^fix\|^docs\|^refactor\|^test" "$TAG_HASH"..HEAD | wc -l)
-if [ $other_count -gt 0 ]; then
-    echo "### 🔧 Прочие изменения ($other_count)" >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-    git log --pretty=format:"- %s (\`%h\`)" --invert-grep --grep="^feat\|^fix\|^docs\|^refactor\|^test" "$TAG_HASH"..HEAD >> "$OUTPUT_FILE"
-    echo "" >> "$OUTPUT_FILE"
-fi
-
-# Полный список коммитов
-echo "## 📝 Полный список коммитов" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-git log --pretty=format:"- **%s**%n  - Хэш: \`%h\`%n  - Автор: %an%n  - Дата: %ad" --date=short "$TAG_HASH"..HEAD >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-
-# Команда для сравнения
-echo "## 🔗 Ссылки" >> "$OUTPUT_FILE"
-echo "" >> "$OUTPUT_FILE"
-echo "Для просмотра всех изменений выполните:" >> "$OUTPUT_FILE"
-echo '```bash' >> "$OUTPUT_FILE"
-echo "git log --oneline $LAST_TAG..HEAD" >> "$OUTPUT_FILE"
-echo '```' >> "$OUTPUT_FILE"
-
-echo "✅ Файл $OUTPUT_FILE успешно создан!"
-echo "📄 Просмотр: cat $OUTPUT_FILE | head -30"