@webeach/gl-circular-progress-react
v0.1.2
Published
Beautiful WebGL circular progress bars React library (Fire and Liquid effects).
Maintainers
Readme
💎 Особенности
- React Компоненты. Готовые компоненты для простой интеграции.
- WebGL Рендеринг. Высокая производительность и плавные анимации шейдеров на базе
@webeach/gl-circular-progress. - Эффектные стили. Готовые пресеты для имитации огня (
Fire) и жидкости (Liquid). - Полная кастомизация. Настройка цветов, толщины, скорости, интенсивности через пропсы.
- TypeScript. Полная типизация "из коробки".
📦 Установка
npm install @webeach/gl-circular-progress-reactили
pnpm install @webeach/gl-circular-progress-reactили
yarn add @webeach/gl-circular-progress-react📥 Использование
import { CircularProgressFire } from '@webeach/gl-circular-progress-react';
function App() {
return (
<div style={{ width: 200, height: 200 }}>
<CircularProgressFire
aria-label="Прогресс"
options={{
colors: [0xff5a00, 0xff9a00],
progress: 0.5,
speed: 1.5,
thickness: 15,
}}
/>
</div>
);
}🛠 Компоненты и Документация
Библиотека предоставляет два основных компонента с различными визуальными эффектами:
🔥 CircularProgressFire
Круговой прогресс с динамичным эффектом пламени. Поддерживает настройку интенсивности огня и цветовых градиентов.
💧 CircularProgressLiquid
Круговой прогресс с эффектом текучей жидкости и метаболлов. Поддерживает настройку "объема" (volume) для создания 3D-эффекта линзы.
🧩 Зависимости
Библиотека является оберткой над @webeach/gl-circular-progress и использует @webeach/react-hooks для эффективного управления ресурсами WebGL.
🔖 Выпуск новой версии
Релизы обрабатываются автоматически с помощью semantic-release.
Перед публикацией новой версии убедись, что:
- Все изменения закоммичены и запушены в ветку
main. - Сообщения коммитов соответствуют формату Conventional Commits:
feat: ...— для новых фичfix: ...— для исправлений баговchore: ...,refactor: ...и другие типы — по необходимости
- Версионирование определяется автоматически на основе типа коммитов (
patch,minor,major).
👨💻 Автор
Разработка и поддержка: Руслан Мартынов
Если у тебя есть предложения или найден баг, открывай issue или отправляй pull request.
📄 Лицензия
Этот пакет распространяется под лицензией MIT.
