1. Docs
2. Erste Schritte
3. Aktualisieren

Aktualisieren 1.2.0

Aktuelles Ziel ist 1.2.0. Semver und CHANGELOG beachten, wenn Sie velinstyle in package.json oder Ihrem CDN-Pin erhöhen. English: Upgrading

Wann aktualisieren

• Von 1.1.0 — Overlay-Lifecycle-Fixes und optionale DI-Befehle übernehmen, ohne Klassen umzubenennen.
• Von <1.2 — @1.2.0 pinnen, 1.2.0-Hinweise skimmen, ältere Abschnitte bei Bedarf nachziehen.

Wann nicht

• Migration von Tailwind/Bootstrap ist ein anderer Pfad — siehe Migration Guide.
• Beta-Plan/Review nicht als Pflicht für ein reines CSS-Upgrade behandeln.

Semver

Patch — Bugfixes, Update ist sicher. Minor — neue Utilities oder Komponenten, rückwärtskompatibel. Major — Breaking Class- oder Token-Umbenennungen; Migrationshinweise in den GitHub-Releases nutzen.

Checkliste

1. Release Notes auf GitHub Releases lesen
2. npm aktualisieren: npm install @birdapi/velinstyle@latest oder Version pinnen
3. Visuelle Tests und npx velinstyle scan auf Templates erneut ausführen
4. Token-Änderungen in CSS Variables vergleichen

Legacy-Hinweise (0.7.0)

0.7.0 ergänzte WCAG-orientierte CSS-Module (focus-not-obscured, Target Size, optional verstärkter Kontrast).

• Neues CSS: focus-not-obscured.css, target-size.css, high-contrast-aaa.css; security.css ist jetzt ein separates @layer security.
• Web Components: verbessertes Keyboard/ARIA für Collapse, Popover, Tooltip, Carousel, Dropdown, Drawer, Accordion; Modal/Drawer setzen inert auf den Hintergrund.
• CLI: vier neue a11y/*-Scanner-Regeln; Framework ergänzt npm run test:contrast.

WCAG 2.2 AAA (0.9+)

• Tokens: AAA-Kontrast ist Standard in :root, Dark und 13 Themes — data-velin-contrast="aa" nur bei leichterem Mute-Text.
• Komponenten: 38 Web Components in core/a11y/component-contracts.json (alle bestehen); im Framework-Repo npm run test:a11y:coverage.
• Runtime: import { initA11y } from '@birdapi/velinstyle/a11y' — Announcer + Scroll-Padding für fixe Nav.
• Dialoge: leere <velin-dialog> / <velin-modal> brauchen aria-label oder einen betitelten Header.
• Docs: AAA-Matrix · Barrierefreiheit

Aktualisieren innerhalb 0.9.x

• Runtime: Default-Export @birdapi/velinstyle — möglichst register() + bootFromDOM() statt voller IIFE.
• Component-Tags: velin-tooltip und velin-stepper bevorzugen; velin-tooltip-wc / velin-stepper-wc sind veraltete Aliase.
• Spacing: .velin-mb-* ist margin-bottom; für Block-Achse .velin-my-* nutzen.
• Security: sanitizeSearchUrl, DOMPurify für SVG — siehe Security.
• WCAG: Token-Defaults und Komponentenverträge sind auf WCAG 2.2 Level AAA ausgerichtet — die Zertifizierung Ihrer App bleibt Ihre Verantwortung — Matrix.

Aktualisieren innerhalb 1.0.x

• Runtime: Default-Export @birdapi/velinstyle — möglichst register() + bootFromDOM() statt voller IIFE.
• Aliase: velin-tooltip-wc und velin-stepper-wc sind veraltet — velin-tooltip / velin-stepper nutzen.
• Spacing: .velin-mb-* ist margin-bottom; Block-Achse mit .velin-my-*.
• Security: sanitizeSearchUrl, DOMPurify für SVG — siehe Security.
• WCAG: Token-Defaults sind auf WCAG 2.2 Level AAA ausgerichtet — AAA-Matrix.

Aktualisieren auf 1.1.0

Minor-Release: keine Klassen, Tokens oder Tags entfernt — eine bestehende 1.0.x-Integration bleibt nach dem Versionsbump lauffähig. Die veralteten Aliase velin-tooltip-wc und velin-stepper-wc werden weiterhin ausgeliefert.

• Neue Komponenten: <velin-data-table> und <velin-form-summary>. Beide erweitern bestehendes Markup — nichts ändert sich, bis Sie eine <table> oder ein <form> wrappen.
• Form Summary übernimmt Validierung: ohne native-validation setzt das Element noValidate am Formular und ersetzt Browser-Bubbles durch eine fokussierbare Zusammenfassung. Eigene Submit-Validierung für dieses Formular entfernen.
• React-Adapter: @velinstyle/react ist offiziell und deckt jede kanonische Komponente ab. Eigene Wrapper ersetzen — siehe Vite & React.
• Highlighting: Python-, YAML-, Go- und Rust-Lexer laden lazy wie bestehende Sprachen; an <velin-code-block> nichts ändern.
• Release-Guard: npm run release:check im Framework-Repo prüft Versions- und Komponenten-Counts über Framework und Site. Bei Docs-Fork in die eigene CI aufnehmen.

Aktualisieren auf 1.2.0

Minor-Foundation-Release: CSS, Web Components und Runtime bleiben stable. Neue Design-Intelligence-Oberflächen erscheinen als beta / foundation — nutzbar, Schemas und Heuristiken expandieren noch. Studio und die vollständige Utility Engine bleiben planned.

• Plan-first Pages: velinstyle plan / scaffold nutzen das Page/Section-Registry vor HTML. Fragment-Rezepte (Navbar, Modal, …) unverändert. Siehe Prompt scaffolding.
• Review-Gate (beta): velinstyle review bewertet Design / a11y / SEO / Performance / Conversion heuristisch — kein perzeptuelles QA.
• Agent-Metadaten (beta): velin-agent.json enthält Knowledge Graph, Pages, Sections und Design-Constraints. Siehe Velin-Meta.
• Overlay-Lifecycle: Modal / Drawer / Sheet / Lightbox nutzen nur focus-manager für inert + Scroll-Lock; velin-dialog dispatcht kanonisches velin-close.
• Keine Breaking Class-Renames in diesem Minor — bei Bereitschaft @birdapi/velinstyle@1.2.0 pinnen.

Changelog

Das kanonische Changelog liegt in CHANGELOG.md im Framework-Repository.

Migration von Tailwind oder Bootstrap? Siehe den Migration Guide (anders als Versions-Upgrades).