Версіонування та стабільність

Volt UI досяг 1.0.0 — публічний API зафіксовано, і далі він дотримується звичайного семантичного версіонування .

Обіцянка semver

Мажорна — `2.0.0`

Єдине місце, де стаються зміни, що ламають сумісність: перейменовані чи вилучені входи, виходи й селектори, змінена типова поведінка, припинена підтримка мажорної версії Angular.

Мінорна — `1.1.0`

Нові компоненти, нові необов'язкові входи й виходи, нові варіанти CVA. Завжди сумісна з попередньою мінорною версією.

Патч — `1.0.1`

Виправлення помилок, доступності та внутрішній рефакторинг. Ніколи не змінює публічний контракт.

Саму заморожену поверхню описано у [specs/api-freeze-0.9.md](https://github.com/Andersseen/volt-ui/blob/main/specs/api-freeze-0.9.md) — кожен вхід, вихід і селектор, наявний на момент заморозки 1.0.0. Оновлюєтесь із версії 0.x? Дивіться [нотатки міграції 0.x](/docs/migration-notes).

Що тепер означають позначки стану

Кожен компонент у 1.0.0 має стан stable — позначку кожного дивіться у каталозі компонентів . beta та experimental лишаються визначеними нижче, бо компоненти, додані після 1.0, можуть починати звідти; сьогодні жодної з них не має ніхто. Позначка — це сигнал упевненості, а не бар'єр доступності: кожен компонент постачається через npm-пакет і CLI незалежно від позначки.

Стабільний

Рекомендовано для продакшену. Задокументований API, змістовні тести, відомі застереження щодо доступності (якщо є) записані.

Бета

Можна користуватися вже сьогодні, але у мінорному чи патч-випуску компонент ще може отримати підсилення форм, роботи з клавіатурою чи доступності — таке підсилення ніколи не ламає наявний публічний API, тож перехід із бети у стабільний стан є зміною документації, а не окремим підняттям версії. У 1.0 не використовується.

Експериментальний

Зарезервовано для майбутніх попередніх версій, API яких ще може змінитися. Наразі не використовується — станом на 1.0.0 жоден випущений компонент не має цієї позначки.

Підтримка версій Angular

Лінійка 1.x розрахована на Angular ^21.2 і Node 20 або новіший. Volt UI підтримує лише останню заявлену мажорну версію Angular — розширення цього діапазону потребує перевірки на реальних споживчих проєктах, а не просто успішної збірки, тож його ніколи не припускають наперед.

Коли виходить нова мажорна версія Angular, перехід на неї є мінорним випуском із нотатками міграції або випуску, де описано все, що змінилося. Підтримувану мажорну версію ніколи не прибирають мовчки.

Куди проєкт рухається далі: Дорожня карта . Повна таблиця стану кожного компонента: каталог компонентів . Оновлюєте наявну копію? Нотатки міграції 0.x . Повна історія випусків: CHANGELOG.md .