Changelog 1.3.0
All notable changes to this project are documented in this file. The format follows Keep a Changelog and Semantic Versioning. Current line: 1.3.0 (Motion Clips). Series: Security 1.2.3 · Debt 1.2.8 · RC 1.2.9 · Clip Motion 1.3.0. Overview: Release notes. Upgrade: Upgrading. Deutsch: Änderungsprotokoll
Open full changelog (Markdown) GitHub Upgrading guide
Release history
23 releases v1.3.0Expand a release for Added / Changed / Fixed from the framework changelog. Use A+ / A− in the header to resize the text. Newest releases open by default.
v1.3.0 Velin Motion Clips AddedChangedFixed 13 notes 2026-08-09
Velin Motion Clips. Package @birdapi/velinstyle-motion + CLI image→clip pipeline (local + optional PixVerse AI provider).
Added
- Package
@birdapi/velinstyle-motion/ export@birdapi/velinstyle/motion-clip - Local clip engine:zoompanrotateparticlesintro/outrotransitions → HTML/CSS
- Clip presets:soft-zoomcinematicatelierrotateparticle-revealrotate-explodeai-reveal
- CLI:
motion createateliertransitionsequenceusageproviderssetup pixverseeffect shortcutspresets --clips - Interactive wizard + mini-prompt → motion profile
- AiProvider interface + PixVerse provider (models/capabilities; cost gate; dry-run)
- PixVerse onboarding: affiliate open once (
pixverse.setup_completed) · key in.velin/motion/.env· never logged - Hard CI rule:
--yes+ AI + no key → exit 1 (no browser / prompts) .velin/motion/configjobscacheusage- Docs EN/DE: Clip guide, Page-Motion update, PixVerse setup, package README
Changed
- Motion CLI help / registry lists clip subcommands (1.3)
- Version pin 1.3.0
Fixed
- Clip inputs: reject empty files, unsupported extensions (only
.webp/.png/.jpg/.jpeg), and non-image payloads (magic-byte check) before local/AI processing
v1.2.9 Release Candidate ChangedFixedKnown limits 7 notes 2026-08-06
Release Candidate. Versions, site badges, and docs aligned on one line after Technical Debt 1.2.8.
Changed
- Monorepo / workspace / Site / CLI registry version surfaces synchronized to 1.2.9
- CHANGELOG / UPGRADING narrative: Security → Debt → RC; Motion drafts marked WIP vs GA claims
- Motion guide: V1 triggers stable; V2 planned + visible fallback documented
Fixed
- Site home (
velinstyle-site):verify:homeagain green —core-countignores optionalvelin-signature;lang-switchmatches multi-classexpo-lang; What’s New title/CTA pinned to 1.2.9 (EN/DE); sitepackage.jsonversion aligned
Known limits (RC)
- No live
npm outdatednetwork rule - Production report images still “coming soon”
- Motion V2 triggers / Physics / Studio UI not first-class
v1.2.8 Technical Debt — audit follow-up from Code audit AddedChangedFixed 9 notes 2026-08-06
Technical Debt — audit follow-up from Code audit.
Added
velinstyle checksecurity step (securityCheckStep)- Publish rule
publish.pack-dry-run(npm pack --dry-run, timeout-safe) - Experience help category
design(Motion visible in--help)
Changed
- Lockfile finding uses
code: no-lockfile(not “outdated”) - Dependency Health reports no-lockfile + heuristic outdated note (no live
npm outdated) - Malware rules (
lifecycle-hooks,typosquat) usecategory: malware; empty malware score is n/a - Planned Motion V2 triggers:
runtime: false+ documented visible fallback test:securityincludestests/security.test.js
Fixed
- Engine
deps/repo/consumer/publishcategory maps include malware so malware rules actually run
v1.2.7 Velin Motion — Engine Surface (in-tree draft) Motion EngineDocs 9 notes 2026-08-05
Velin Motion — Engine Surface (in-tree draft). Timeline/Composer runtime, motion metrics, review/optimize, blueprint kinds. Status: Draft / WIP in the working tree — not claimed as npm GA. V2 triggers listed below are planned (runtime falls back to visible).
Motion Engine
- Timeline Registry +
velin-timeline/runTimeline - Composer
Motion.sequence+velin-motion-sequence - Transition helpers (
runViewTransition, modal/drawer hints) - Triggers (planned V2, fallback visible):
hiddenidlemediacontainerthemecustom - CLI:
motion analyze|review|report|optimize|blueprint - Blueprints:landingdashboardpricingportfolioshopforumdocsblogcrmlogin
checkintegrates motion doctor step- Gallery timeline/sequence sections
Docs
- Extended Velin Motion guide; RELEASE_NOTES 1.2.7; UPGRADING; Site EN/DE
v1.2.6 Velin Motion — Foundation (in-tree draft) Motion Regis…Docs 10 notes 2026-08-05
Velin Motion — Foundation (in-tree draft). Motion Design System subsystem: full Registry (all building blocks) + Trigger Engine (Studio-ready data).
Motion Registry & Trigger Engine
- Registry namespaces:PresetsTimelinesTransitionsPhysicsComposersTriggersPoliciesBlueprints
- Compatibility + categories + descriptions on every record
- Trigger Engine +
velin-trigger(loadvisiblehoverfocusclickscroll) - Unified attrs
velin-motionvelin-durationvelin-delayvelin-ease - Policies:safereducedmarketingminimalaccessibilityperformancedisabled
- Token aliases
--velin-motion-*,--velin-bounce,--velin-spring - Scroll slide-down/left/right CSS; Production bare-attr detection
- CLI:
motion list|presets|doctor|scan|policy|demo - Playground:
samples/motion-gallery.html
Docs
- Product guide Velin Motion; RELEASE_NOTES 1.2.6; Experience cross-links
v1.2.5 Product Surface Velin Experi…Docs 6 notes 2026-08-05
Product Surface. Velin Experience ships dashboard, --record + replay, plugin registry skeleton, and local analytics hints.
Velin Experience — Product Surface
velinstyle dashboard— multi-signal project overview (doctor · review · scan · production folder)--recordwrites JSON / Markdown / HTML / ASCII under.velin/records/;velinstyle replay <record.json>- Plugin skeleton:
registerPluginCommandon the Experience Registry - Local analytics hints (opt-in via
velinstyle-cli.json/--analytics) — no cloud telemetry - Layout / Perf / Scan audit paths render through the Output Contract
Docs
- Product guide Velin Experience; Landing What’s New; Site CLI / Production guides EN/DE
v1.2.4 Engine Experience Content Scan…Production R…Modes & Noti… 6 notes 2026-08-05
Engine Experience. Production / Review / Check on the Output Contract; Content Scanner (Blade first-class); Production Report breakdown.
Content Scanner
- Scan your project, not only HTML:
.html,.blade.php(first-class),.twig,.vue,.jsx/.tsx,.astro,.md/.mdx - Template delimiters stripped so Blade/Twig noise is not tokenized as classes
Production Report Breakdown
- Structured before→after rows:CSSRuntimeIconsThemesMotionComponents + Savings %
- Terminal / Markdown / JSON (additive Contract fields); Experience widgets
bundle/savings
Modes & Notifications
- Modes:compactstandarddashboardverbosedebugjsonsarifmarkdown
- Notification / suggestion widgets on Result surfaces
v1.2.3 Security Suite SecurityCLINote 9 notes 2026-08-06
Security Suite. Introduces Velin Security Suite (CLI) on Velin Security Engine (core/security/).
Security Engine
- Rule registry:
registerSecurityRule— categories repoconsumercipublishdepssecrets - Scores: overall Security Score, Dependency Health, Release Health
- Security Timeline persisted under
.velin/security/timeline.json - Export:
@birdapi/velinstyle/security
CLI
velinstyle security doctor|scan|audit|publish|ci|deps|secrets|report- Auto-detect maintainer vs consumer projects; flags
--repo·--consumer·--ci·--publish - Experience output +
--json·--strict - Guide: Security guide · Release notes
Note
- Earlier unpublished drafts for Experience packaging remain in the tree; 1.2.3 ship focus is Security. Motion Design System remains a later line (1.2.6+).
v1.2.2 Production Release Production B…Atelier CLINew components 18 notes 2026-08-04
Production Release. VelinStyle 1.2.2 focuses on production builds and developer workflow. The new Production Builder creates optimized output based on the actual project instead of shipping the complete framework. This release also introduces the first Atelier CLI integration and new production-ready components. Build only what your project actually uses.
Production Builder
- Do not ship the full framework blindly — analyze the project and emit an optimized production package
- CLI:
velinstyle build --productionandvelinstyle production [path] - CSS only for used components (graph closure + utility filter); runtime only for needed Web Components
- Themes / icons / motion / fonts only when used
- Report with size comparison;
--explainlists removals;--watch,--report,--safelist - Pipeline under
cli/production/;component-graph.json; configproduction: { out, safelist, themes } - Review:
scores.optimization+ softoptimization.*issues - Guides: Production Builder; Vitest
tests/production/production.test.js
Atelier CLI (Beta)
velinstyle atelier list·velinstyle atelier 24·velinstyle scaffold --atelier 24(alsoplan --atelier …)- Pull curated Atelier Library showcases (local
--from/VELINSTYLE_ATELIER_ROOTor HTTPS) --format html|blade|vue|react— blade/vue/react are integration wrappers, not native rewrites- Separates Atelier Library from Velin Studio (Studio remains planned)
- Guide: atelier cli; Vitest
tests/atelier.test.js
New components
<velin-otp-input>,<velin-password-strength>,<velin-empty-state>(Showcase P0 gaps)- Empty-state blueprint uses
<velin-empty-state>
Improvements
- Overlay title slot + reactive
titleon<velin-modal>,<velin-drawer>,<velin-sheet> - Data-table / table row severity modifiers (
velin-data-table__row--*,data-severity,.velin-table--*aliases) - CLI help /
cli-manifest.jsondocument Production Builder and Atelier; prefer Production output over blind full-bundle for publish (documented)
v1.2.1 VelinStyle 1 AddedChanged 9 notes 2026-08-02
VelinStyle 1.2.1 ships the Velin Transparency Framework foundation: labeling and provenance as a subsystem (not an AI badge).
Added
- Transparency subsystem at
@birdapi/velinstyle/transparency— Engine, Registry, Policy, Providers, Validator, Doctor, Reporter, Export, Migrate, Renderer - HTML bridge
velin-transparency/velin-disclosure+ provenance attributes - Claim taxonomy (
ai.generated,review.human,license.*, …) - CLI:
velinstyle transparency doctor|validate|report|export|migrate(scan alias) - Integration into
velinstyle check/ review scores (Transparency + pillars) - CSS marks (badge, overlay, ribbon, inline, footer, panel, tooltip, icon)
- Example policy
examples/transparency.policy.json - Docs guides EN/DE: Transparency Framework
Changed
- Soft default transparency policy so existing
checkruns stay non-breaking; strict media rules via policy file
v1.2.0 VelinStyle 1 HighlightsRelease StatusAdded 115 notes 2026-08-01
VelinStyle 1.2.0 ships Core + Design Intelligence Foundation and the Trust/Ship surface (create, check, serve, doctor), trust-oriented scan/review gates, AI skills registry tooling, and new app primitives (calendar, file dropzone, editable data table). Claims stay honest: excellent for landings and docs; not yet a primary multipage shop/enterprise-admin stack.
Highlights
- Framework
- Logical spacing honesty and denser padding steps for blueprint fidelity
- App-shell layout utilities
- Lite CSS preset for marketing budgets
- Design Intelligence (Beta)
- Review profiles (
marketing|app|docs|fragment|ecommerce) - Thin-content floors so junk pages cannot score conversion/SEO at 10
- AI Foundation (Beta)
- Skill engine + 40 official skill records, packs, bundles, templates, workflows
velinstyle skills/workflowCLI;skills doctorpath integrity- CLI
create landing|dashboard|docs|auth,check(--json/--sarif),serve,doctorwc api <tag>,build --preset lite,--out/-oaliases- Components
<velin-calendar>,<velin-file-dropzone>,<velin-data-table editable>- Blueprints
split-hero,pricing-band,app-chrome,ops-console- Quality
- Trust scan rules (nested interactive, contrast-inline, role=button, and more)
- Chaos + misses fixtures; blueprint
--strictCI - Windows ESM path fixes; vendor mini-docs on create
Added
- CLI
velinstyle serve,velinstyle doctor,velinstyle create landing|dashboard|docs|authblueprint --strict/npm run check:blueprintsCI gatevelinstyle check(doctor + blueprint--strict+ scan + review) with--json/--sarif- Aliases:
validate→check,documentation→docs velinstyle wc api <tag>(source-backed WC API + examples)velinstyle skills doctor/npm run skills:doctorpath integrityvelinstyle build --preset litemarketing layer subset;--out/--output/-oaliasesvelinstyle skills show <id> --humanMarkdown view- Components
<velin-calendar>(month picker)<velin-file-dropzone>(client upload UX)<velin-data-table editable>inline edit (velin-data-table-editevent)- Scanner / Review
- Scan rules:
a11y/duplicate-id,css/unknown-velin-class,wc/invalid-attribute, HTMLsecurity/no-document-write,a11y/target-size-min,a11y/nested-interactive,a11y/contrast-inline,a11y/role-button-contract check:chaoscovers chaos +misses.html(fixtures underfixtures/)- Review thin-content floors (SEO/conversion capped on junk pages)
- Review
--profile marketing|app|docs|fragment|ecommerce - Utilities / Layout
- Spacing:
velin-py-*(padding-block alias) and denservelin-pb-*/velin-pi-*steps 10 and 12 - Logical spacing honesty:
velin-mbe-1/3,velin-mbs-1/3,velin-pbe-*,velin-pbs-*,velin-border-inline-end/start - App-shell layout utilities
- Blueprints
split-hero,pricing-band,app-chrome,ops-console(validated classes only)- AI Skills
- AI Runtime foundation:
packages/skill-engineandpackages/velinstyle-skills(registry-first) - 40 official skill records across 16 categories (capabilities, compatibility, status, confidence, cost hints, dependency graph metadata, typed inputs/outputs)
- Workflow graph manifests (
landingpage,component-ship,release-gate), plus packs, bundles, project templates, and project skill chains - CLI:
velinstyle skills ...,velinstyle workflow ... - Schemas:
skill-record,skill-registry,skill-pack,skill-graph,skill-bundle,skill-template,skill-project - Documentation
- Guides:
landing-15-min,marketing-lite-css,docs/guides/ai-skills.html,docs/guides/ecommerce.html - Docgen minimal WC copy-paste examples (copy, tooltip, lightbox, icon, command, menubar, form-summary, data-table)
- Strategy/ADR deep-dives remain maintainer-local (monorepo
interne_docs/strategy/; not published) UPGRADING.mddraft for 1.1.0 → 1.2.0 (publish when cutting the minor)RELEASE_NOTES_1.2.0.mdcompanion overview
Changed
- Security
- Production dependency
isomorphic-dompurify3.13 → 3.21.0 (DOMPurify 3.4.x) sonpm audit --omit=devreports 0 vulnerabilities before the 1.2.0 upload - CLI
velinstyle scanandvelinstyle perfaccept a single HTML/CSS/JS file or a directory (no moreENOTDIRon file paths)velinstyle initcopies vendor assets when frameworkdist/is available and scaffolds starter HTML withdata-velin-reveal-auto+ icon sprite metavelinstyle createemits zero-warning HTML (no inline styles,label for/id), copies vendor into the target dir, boots viabootFromDOMwhen the package resolves (vendor full-bundle fallback)- Create vendor copy includes mini WC docs under
vendor/velinstyle/docs/ velinstyle buildinvokes locallightningcssfrom the packagenode_modules;--preset liteprints size vsdist/velinstyle.min.css- Unknown CLI commands exit 1 with "Did you mean ...?" instead of dumping help with a success-looking exit
- Top-level
--help/ README CLI tables list all create kinds andwc api/skills doctor velinstyle meta page --writemerges curatedgoals/intentand warns when dropping non-allowlisted keys- Review Engine
- Hero CTA heuristic strips scripts/styles/code-blocks and counts only real
<a>/<button>CTAs in hero scope - Components / Runtime
velin-icondefault sprite is relative/configurable (spriteattr → meta/data-velin-icon-sprite→VelinIcon.defaultSprite→velin-icons.svg) instead of hardcoded/dist/velin-icons.svg- AI Skills
- Skills templates/demos remap to existing files (
samples/ecommerce.html,samples/landing.html, ...) velin-agent.jsonandllms.txtinclude AI skills catalog and workflow discovery hints- Publish inputs include skills packages and schemas; prepublish runs
skills:generate,skills:validate,skills:doctor, andcheck:blueprints - Documentation
- Docs clarify
<velin-copy>(value/text+ Shadow button), tooltipcontent, lightbox, icon sprite, attribute vs WC vsbootFromDOM, flex--naming, breadcrumb__item/__link, Windows/vendor install, and review CTA semantics - README fit statement: landing/docs/simple admin yes; multipage shop + enterprise admin primary not yet; npm circulation note until 1.2.0 cut
Fixed
- Windows
velinstyle build: config import usespathToFileURL(noERR_UNSUPPORTED_ESM_URL_SCHEMEon drive-letter paths)- Scanner
- Duplicate IDs, unknown
velin-*classes, invalid WC attributes, and inlinedocument.writein HTML are detected - Nested interactive / inline contrast / role=button contract gaps from Round-4
misses.html scan/perfno longer fail withENOTDIRon a single.htmlfile- CLI
- Subcommand
--helpforskills,workflow,blueprint(no longer treated as unknown ids) build --outalias honored alongside--output/-o- Doctor resolves config from parent dir when given a file path
- Lite preset appeared larger than full min CSS when
npx lightningcssfailed in consumer CWDs (now uses package-local CLI) - Blueprints
- Class drift:
process-steps, notification/filter/settings flex naming, cookiembe, settings switch markup - Offline blueprints no longer reference
../../dist/... - Sample
velin-py-*classes had no CSS rules (section spacing appeared broken) - Components
- Offline/vendor icon installs broke when the sprite default pointed at absolute
/dist/... <velin-accordion>: summary/panel styles via light-DOM CSS (::slotted()cannot style descendants of slotted<details>);aria-expandedsync; panel background prefers--velin-color-surface-dim(dark-safe)<velin-command>: closed overlaypointer-events: none; backdrop click closes;toggle(); inert cleanup host-scoped<velin-calendar>day grid overflow in narrow sidebars; cells fluid withminmax(0,1fr)- Review Engine
design.hero-cta-maxfalse positives from Velin-Meta JSON and demo snippets in the HTML prefix- Empty/junk pages no longer score conversion/SEO at 10
app/docsprofiles no longer advise "H1 in the hero"; conversion soft-capped for app/docs- Review catches missing
lang, img withoutalt, and unlabeled placeholder-only inputs (static HTML) - AI Skills / Documentation
- Broken skills template paths (
samples/shop.html,examples/landing-demo.html, missing guides) remapped / guides added
Also included (Design Intelligence Foundation)
- Merged from the in-repo foundation draft previously dated 2026-07-28:
- Knowledge graph seed, page registry (17 types), section/blueprint system, design constraints (hero/FAQ/contact)
- Prompt Engine (
velinstyle plan) and Review Engine baseline (velinstyle review) - Schemas under
schemas/for design intelligence; intelligence twins underdocs/generated/intelligence/ - Overlay inert cleanup, dark shadow parity, dialog
velin-closecanonical event, responsive display ownership - Release framed as Core + Design Intelligence Foundation (Studio / full Utility Engine generator remain planned)
Breaking Changes
- No breaking changes in Unreleased relative to 1.1.0 public API contracts. Stricter scan/review may newly fail previously green pages (intentional trust improvement).
Migration Notes
- See Upgrading (1.1.0 → 1.2.0). After install: refresh vendor copies if vendored, run
doctor+check(use--profile appfor admin shells).
Developer Notes
- 1.2.0 prioritizes trust and ship DX: gates that catch real defects, scaffolds that pass
check, discoverable WC APIs offline, and honest maturity labels for Design Intelligence / AI foundation surfaces.
v1.1.0 VelinStyle 1 HighlightsRelease StatusAdded 39 notes 2026-07-27
VelinStyle 1.1 ships accessible form/table primitives, expands React wrappers to the full canonical set, and adds release-sync guards so docs, agent metadata, and package version cannot drift. No breaking changes; deprecated <velin-tooltip-wc> and <velin-stepper-wc> aliases still work.
Highlights
- Components
<velin-data-table>progressive enhancement<velin-form-summary>accessible error summary- Framework
- Official
@velinstyle/reactcoverage for all canonical tags - Release sync guard (
release:check/release:sync) - Quality
- Docs/version/count drift fixes across framework and site
- Highlight lexers: Python, YAML, Go, Rust
Added
- Components
<velin-data-table>: progressive enhancement for a light-DOM<table>-- sortable columns via real<button>headers witharia-sort, text/number/date sort types (data-sort,data-sort-value), substring filtering bound to any input (filter-input), optional pagination (page-size), and an empty state (empty-text). Sort, filter and page changes are announced; filtered and off-page rows usehiddenso they leave the accessibility tree. Requires a<caption>,aria-label, orlabelattribute.<velin-form-summary>: accessible error summary for any<form>. Replaces the transient native validation bubble with a focusablerole="alert"panel listing every invalid field, wiresaria-invalidandaria-describedbyto per-field messages, moves focus to the offending field from summary links, and clears each error as soon as the field becomes valid. Supportsdata-error-message,data-error-label,data-error-ignoreand author-supplied[data-velin-error-for]containers.- Runtime / Highlight
- Highlight languages: Python, YAML, Go and Rust lexers, lazy-loaded like the existing ones. Aliases
py,python3,yml,golang,rsresolve to them;yamlpreviously fell back to plain text. - Quality / Process
- Release sync guard:
npm run release:checkcompares every machine-readable version surface (CLI manifest, a11y contracts,velin-agent.json, doc header badges, landing-page version badges,velin-metablocks, JSON-LDsoftwareVersion, npm/CDN install pins, generated docs, changelog copies) againstpackage.json. It also checks the component counts quoted in prose across both repos -- English and German -- againstcomponents.count/components.loaderCountinvelin-agent.json, so adding a component cannot leave the docs claiming the old number.npm run release:syncrewrites the mechanical ones. Wired intoci:checksand the site build; site checks are skipped when the sibling repo is absent. - WCAG matrix: 3.3.1 Error Identification and 3.3.3 Error Suggestion are now tracked and owned by
velin-form-summary.
Changed
- React
@velinstyle/reactis official (1.1.0): wrappers now cover all 38 canonicalvelin-*elements instead of 12, generated from the component registry so CI fails when they drift. Props map correctly for custom elements -- booleans become presence attributes, objects and arrays are assigned as element properties instead of being stringified, andonVelin*handlers bind the matching custom event (onVelinSearchSelect→velin-search-select). Ships TypeScript definitions andcreateVelinComponentfor your own tags. Deprecated*-wcaliases are intentionally excluded.- CLI
- CLI version:
velinstyle --helpreads the version frompackage.jsoninstead of a hardcoded string that had drifted to 0.9.0. - Tooling
- Demo sync:
tools/sync-demos-to-repo.mjsderives its unpkg pin frompackage.jsonrather than a hardcoded 0.9.0.
Fixed
- Documentation
- Docs drift: stale
@birdapi/velinstyle@0.9.0install snippets andvelin-metaversion blocks across the site, plus a@0.4.0CDN example in the framework docs landing page. The site guide generators now read the framework version instead of embedding it. - Component counts: the docs claimed 36 canonical components and 38 loader entries in 20+ places; both repos now report 38 and 40, and the guard keeps them honest.
- Duplicate heading: the site accessibility page shipped the "Component contracts" section twice with the same
id="contracts", because a one-shot patch script had been applied twice. - Site changelog copy: the a11y bulk-patch script rewrote a link inside the copied
CHANGELOG.md, which made the copy permanently differ from the framework original. Verbatim copies (CHANGELOG.md,docs/generated/) are now excluded from that script. - Docs coverage audit:
audit-docs-coverage.pycrashed on Windows consoles because its report contains→; it now forces UTF-8 output, and recognises the two new component pages. - Quality / Process
- Release guard robustness: the repo walk crashed with
ENOENTwhen a file disappeared mid-scan, which made the check fail intermittently alongside tests that use temporary directories. Dot-directories are now skipped and vanished files are ignored.
Build
npm run buildregenerates the React wrapper sources;npm run build:reactalso bundles the package.- New CI gates: React wrapper drift and release sync.
- The loader-count gate now derives its minimum from
component-contracts.jsoninstead of a hardcoded 36. - Full-bundle JS budget raised from 200 KB to 215 KB (209.4 KB actual, 46.9 KB brotli) to cover the two new components. Applications using
register()/bootFromDOM()pay only for what they load.
Breaking Changes
- No breaking changes.
Migration Notes
- No required migration. Optional: adopt
<velin-form-summary>on forms and<velin-data-table>for progressive table UX.
Developer Notes
- 1.1.0 hardens the docs <→ package truth loop and ships two high-leverage a11y components so forms and data UIs can meet WCAG error-identification patterns without custom scaffolding.
- <!-- Older releases (1.0.0 and below) retain their historical Keep a Changelog sections. Content is unchanged. -->
v1.0.0 1.0.0 FixedChanged 3 notes 2026-05-29
Fixed
- Search: Worker mode now requires an explicit
workerUrl(prevents broken defaults in non-ESM/IIFE builds). - Build: IIFE bundle no longer emits
import.metawarnings during build.
Changed
- CI: runs on Linux, Windows, and macOS; Playwright full cross-browser only on Linux (Chromium smoke elsewhere).
v0.9.0 0.9.0 BreakingMigrationFixed 40 notes 2026-05-19
Breaking
- Component names: canonical tags are
<velin-tooltip>and<velin-stepper>; source filescomponents/velin-tooltip.jsandcomponents/velin-stepper.js.<velin-tooltip-wc>and<velin-stepper-wc>remain as deprecated aliases (console warning once). - Spacing:
.velin-mb-*is margin-bottom only; use.velin-my-*for block-axis spacing. - Visual: default text/primary tokens are darker for AAA — use
data-velin-contrast="aa"on<html>if you need the previous lighter palette without retuning tokens.
Migration
- Replace
<velin-tooltip-wc>→<velin-tooltip>and<velin-stepper-wc>→<velin-stepper>in HTML; legacy tags still work in 0.9.0. - Imports:
VelinTooltip/VelinStepperfrom@birdapi/velinstyle(or component paths);VelinTooltipWC/VelinStepperWCre-exported as deprecated.
Fixed
- Security:
velin-secure-fieldno longer emits plaintext or AES keys; hardenedsanitizeURL/sanitizeSearchUrl; DOMPurify SVG sanitization invelin-icon; search result URLs validated. - Runtime: auto-generated
COMPONENT_LOADERS(38 tags);bootFromDOMscans allvelin-*elements; stacked modal inert;velin-copyvalue/textunified; code-block copy fixed. - WCAG 2.2: corrected criterion comments; fixed
wcag22-authsample; newwcag22-draggingsample andwcag22-matrix.md. - Utilities:
.velin-mb-*margin-bottom semantics corrected.
Added
- Audit follow-up:
velin-scroll-topdeclarative attribute;src/base/wc-placeholder.cssCLS guards for all loader tags;velin-persistincomponent-contracts.json; Playwright cross-browser smoke (npm run test:e2e); shared docs theme picker assets (docs/assets/theme-picker.*). - Velin-Meta:
velinstyle metabuildsdist/velin-agent.jsonanddist/llms.txtfor AI assistants; MIMEapplication/vnd.velinstyle.meta+json; page-level<script id="velin-meta">;velinstyle meta page <file> --write;docs generate --scope meta; export@birdapi/velinstyle/meta. - WCAG 2.2 AAA defaults: OKLCH color tokens (
:root, dark, 13 themes) validated at 7:1 vianpm run test:contrast;data-velin-contrast="aa"opt-down to AA palette. - A11y runtime:
@birdapi/velinstyle/a11ywithinitA11y()(live announcer, scroll padding);core/a11y/component-contracts.json;docs/generated/a11y/wcag22-aaa-matrix.md;npm run test:a11y:coverage. - Component a11y:
a11y-utils.js, fixes forvelin-icon,velin-search,velin-theme-toggle,velin-popover(aria-labelledby), dialogs, toasts, and more; scanner rulesvelin-icon-label,sparkline-label,skeleton-text. - VelinHighlight:
core/highlight/(velinSyntax,highlightElement,highlightAll,initHighlight,registerLanguage,lazyLoadLanguage); lexers for JS/TS, HTML, CSS, JSON, Markdown, Shell, SQL, PHP, Blade;highlight.csswith OKLCH/P3 token colors and reduced-motion fade. <velin-code-block>Web Component (copy, line numbers, line highlight, collapsible);velin-codeattribute bridge with lazy in-view highlighting.- Export:
@birdapi/velinstyle/highlight;bootFromDOM({ highlight: true }); samplesamples/velin-code-block.html; guidedocs/guides/syntax-highlight.html. - VelinSearch:
core/search/API (velinSearch,createSearch,registerSearchProvider), fuzzy offline search, highlight, category filters; optional Web Worker (core/search/worker.js). <velin-search>Web Component with autocomplete, keyboard navigation, grouped results.- Search benchmark:
tests/search-benchmark.test.js— fuzzy query over 10k entries (main thread under 400ms, worker under 500ms in CI);npm run test:search:bench. - Motion runtime:
core/motion/(initMotion,velinMotion, rAF scheduler, stagger, smooth scroll); unified.velin-in-viewwith scroll-animation CSS fallback. - Velin HTML attributes:
core/attributes/registry (20+ bridges);bootFromDOM({ attributes: true }). - CLI:
velinstyle search indexbuildsdist/search-index.json;docs generateemitsdocs/generated/+ attributes index. - PII scanner:
hardcoded-email,hardcoded-secret,mailto-in-source,localstorage-piirules;--only pii;--fixmasks emails (cli/pii-scanner.js). - WCAG 2.2 CSS:
authentication.css,consistent-help.css,dragging-alternatives.css,focus-appearance.css; scanner rulesa11y/autocomplete-auth,a11y/invalid-describedby. - Font tokens:
tokens/fonts.css, utilities.velin-font-display,.velin-tabular-nums,.velin-text-pretty;tokens buildsupportsfontsandmotionblocks. - JS runtime:
components/runtime/withregister,lazyDefine,whenDefined,bootFromDOM; package exports./runtime,./sanitize,./email,./secure. - CLI
velinstyle perf:audit,suggest,fixfor images and scripts (cli/perf-audit.js). - CLI
velinstyle tokens validate: JSON validation for OKLCH, themes, fonts (cli/tokens-validate.js,examples/tokens.schema.json). - Web Components:
<velin-email>(reveal obfuscation),<velin-secure-field>(optional AES-GCM demo; subpath import). - Docs:
guides/performance-audit.html,extend/javascript-api.html; security page PII section. - Auto-generated reference:
velinstyle docs generate/npm run docs:generatewrites Markdown todocs/generated/(components, tokens, utilities, CLI, scanner rules, a11y modules). CI verifies committed snapshots. - Tokens JSON:
zIndexblock in schema/build/validate; deterministic key order intokens build;examples/tokens.full.json.
Changed
- Documentation and samples: landmark structure (
<header role="banner">), AAA migration section, updateddocs/getting-started/accessibility.html(formerlydocs/a11y.html) and token pages. test:a11yenablescolor-contrast-enhanced; JSDOM canvas stub for axe in CI.- Package and CLI version 0.9.0; CI runs
tokens:validate,test:security,test:perf,ci:checks(bundle budget, search-index drift, loader drift). - Package:
.export →runtime-entry.js; full bundle at@birdapi/velinstyle/bundle; TypeScriptdist/velinstyle.d.ts. Subpaths:/search,/motion,/attributes,/highlight,/sanitize. Distribution via velinstyle.info. velin-reveal.jsdelegates tocore/motion; attribute bridge uses<velin-tooltip>/ lazy loaders from renamed component files.- Generated docs:
velin-tooltip.md,velin-stepper.md(replaces*-wc.mdfilenames). docs:sync-siteusesvelinstyle-site/tools/sync-0.9.0.py.
v0.8.0 0.8.0 AddedChangedAdded 14 notes 2026-05-16
Added
- Motion tokens: five new easings (
spring,elastic,expo-out,back-out,snappy) and two new durations (slowest 800ms,cinematic 1200ms) intokens/motion.css. - Filter-effect utilities: new
utilities/filter-effects.csswithvelin-saturate-*,velin-hue-rotate-*,velin-contrast-*,velin-invert,velin-sepia,velin-drop-shadow-*, extendedvelin-backdrop-*, andvelin-glass/velin-glass-strongcomposites. - Chart-animation utilities: new
utilities/chart-animation.csswithvelin-stroke-draw,velin-sparkline-glow,velin-value-bump,velin-live-pulse,velin-count-fadekeyframes and matchingvelin-chart-line/velin-chart-area/velin-chart-glow/velin-spark-tick/velin-live-pulseclasses — all reduced-motion safe. - Three new Web Components:
<velin-sparkline>(animated draw-in + liveupdate()API),<velin-counter>(rAF +Intl.NumberFormatcount-up with currency/percent/locale),<velin-live-dot>(slotted realtime indicator). - Two motion helpers:
velin-reveal.js(initReveal()plus[data-velin-reveal-auto]auto-init) andvelin-flip.js(flipReorder(),filterList()plus[data-velin-flip]+[data-velin-filter-value]/[data-velin-filter-input]auto-wiring). - Demo upgrades: crypto dashboard uses sparkline tick + counters + live-dot; forum and shop chips/searches drive real FLIP-animated list filtering; grid/list view toggle on the shop animates layout changes via FLIP.
- CLI
velinstyle scaffold: prompt-based HTML from blueprint composition (cli/scaffold.js,scaffold-recipes.json);list-intents,-o,--json. - CLI
velinstyle layout:audit,suggest, andfixfor flex/grid/responsive issues (cli/layout-audit.js). - Docs: new pages
docs/utilities/motion.html,docs/utilities/filter-effects.html,docs/utilities/chart-animation.html,docs/components/sparkline.html,docs/components/counter.html,docs/components/live-dot.html;docs/guides/prompt-scaffolding.html,docs/guides/responsive-layout.html; layout and getting-started sections for 0.8.0 CLI.
Changed
src/velinstyle.cssimports the new filter-effects + chart-animation utilities.components/index.jsexports the three new WCs and two helpers.index.htmldrops the inline scroll-reveal IIFE in favour of the sharedvelin-revealhelper viadata-velin-reveal-auto.- CLI help version 0.8.0; package version 0.8.0.
Added
velinstyle prefixJSON maps: optionalvelinstyle-prefix-map.jsonnext to the migrated tree (or--map <file>) supplies explicittoken→velin-classreplacements; merged after auto map, overrides catalog and--bootstrap-display. Keys_*/$*ignored. Sample:examples/velinstyle-prefix-map.sample.json. Documented in README, README.de,docs/migration.html,docs/guides/existing-project.html.
v0.7.0 0.7.0 AddedChangedFixed 11 notes 2026-05-16
Added
- WCAG 2.2 CSS:
focus-not-obscured.css,target-size.css, optional AAA contrast viadata-velin-contrast="aaa". - Expanded
forced-colorsandpreferences.cssfor switch, pagination, tables, stepper, nav. - Security layer:
security.cssmoved to dedicated@layer security(no longer ina11y). - CLI scanner: rules
a11y/heading-order,a11y/landmark-main,a11y/interactive-aria-hidden,a11y/iframe-title. npm run test:contrast: OKLCH token pair verification script.docs/assets/docs-a11y.js: nav toggle and theme panel without inline handlers.- A11y patterns: menu button, disclosure, data table, loading/busy sections.
Changed
- Web Components: keyboard/ARIA improvements for collapse, popover, tooltip, carousel (pause control), dropdown (type-ahead), drawer (
aria-labelledby), accordion, modal/drawer (inertbackground). focus-manager.js: visibility-aware focusables,setBackgroundInert/clearBackgroundInert.tests/a11y/run.js: recursivedocs/**andsamples/**, WCAG 2.2 axe tags, IIFE hydration,matchMediapolyfill.
Fixed
- Target size: alert/toast close, btn
--sm, pagination ellipsis meet 44px minimum viatarget-size.css.
v0.6.1 0.6.1 FixedAdded 14 notes 2026-05-11
Fixed
- Vitest / jsdom:
tests/setup.jsmockswindow.matchMediaforvelin-theme-toggletests;velin-popovertest now setstrigger="hover"sorole="tooltip"is asserted correctly. - Drawer CSS: Fixed
side="end"drawer showing content and not closing due toinset-inline-start: 0leaking to all sides. Each side now explicitly resets opposing inset values. - FOUC Protection: Added
:not(:defined)rule inreset.csshiding VelinStyle custom elements until they are registered, preventing flash of unstyled content. - CLI
require()bug: Replaced CJSrequire('fs').unlinkSyncwith ESMunlinkSyncimport incli/index.js. - CLI version: Updated help text to v0.6.1.
- CLI a11y layer:
security.cssnow included in thea11ylayer file list.
Added
- CLI blueprints: 11 additional static HTML snippets (
navbar-header,footer-simple,hero-section,card-grid,form-contact,breadcrumb-bar,sidebar-layout,table-responsive,alert-stack,search-field,pagination-bar) — runvelinstyle blueprint list. - Multi-Provider Icon System:
<velin-icon>now supports aproviderattribute for CDN-based icons from Lucide, Heroicons, Bootstrap Icons, Material Symbols, Font Awesome, and Tabler Icons. VelinIcon.registerProvider(): Static method to register custom icon providers at runtime.cli/icon-providers.js: Provider registry with CDN URL mappings, variant support, license info, and homepage links for 6 providers.velinstyle iconsCLI commands:list(show providers),add(download SVGs),remove(delete provider icons),build(rebuild sprite).cli/scanner.js: Security, Accessibility, and CSS lint scanner engine with 20+ rules.velinstyle scanCLI command: On-demand project scanning with colored terminal output, JSON format for CI/CD,--fixfor auto-fixable issues,--severityfiltering.- Build-integrated scanning:
scan.enabled: trueinvelinstyle.config.jsruns scanner after each build.
v0.6.0 0.6.0 SecurityAddedFixed 17 notes 2026-05-11
Security
- XSS Protection: New
components/sanitize.jswithescapeHTML()andsanitizeURL()functions - 9 Web Components hardened: All dynamic content rendering now uses
escapeHTML()(velin-toast, velin-dialog, velin-lightbox, velin-countdown, velin-stepper-wc, velin-tooltip-wc, velin-popover, velin-drawer, velin-modal) - Event listener leak fix:
velin-lightbox.jsno longer accumulates keydown listeners on repeatedopen()calls - CSS Security Utilities: New
src/a11y/security.csswith.velin-user-content(content sandboxing),.velin-secure-frame(clickjacking protection), autofill protection, external link indicators - velin-persist.js hardened: Storage key validation (regex), 64KB size limit,
QuotaExceededErrorhandling,storage="session"option for sessionStorage - Trusted Types support: Optional
getTrustedPolicy()for CSP-enforced environments - URL validation:
sanitizeURL()blocks JavaScript protocol URLs in lightbox
Added
docs/security.html: Dedicated security documentation page with CSP guide, XSS protection details, best practicesdocs/css-components.html: New page with live demos for breadcrumb, chip, divider, input-group, list-group, pagination, spinner, stat, stepper (CSS), timeline, tooltip (CSS), drawer (CSS)docs/components.htmlrewritten: All 22 Web Components now documented with live interactive demos, attribute/method/event/slot API tablesdocs/utilities.htmlexpanded: 10 new utility sections (anchor positioning, color-mix, container-style, divide, responsive, @scope, scroll, scroll-animation, state, view-transitions)docs/tokens.htmlexpanded: Aspect Ratio, Z-Index, and Motion token sections with previewsdocs/themes.htmlexpanded: All 13 themes now shown with live preview cards- IIFE build:
dist/velinstyle-components.iife.jsforfile://compatibility (notype="module"needed)
Fixed
docs/404.html: CSS path fixed (dist/to../dist/)- Version numbers: All docs pages unified to v0.6.0
- Navigation: All docs pages now link to CSS Components and Security pages
v0.5.0 0.5.0 AddedFixedChanged 39 notes 2026-05-11
Added
- CSS @scope Integration: Scoped styles fuer Card, Modal, Drawer, Nav +
.velin-scope/.velin-scope-islandUtilities - Auto-Contrast Utility:
.velin-auto-text--*nutztcolor-contrast()fuer automatische Textfarbe auf farbigen Hintergruenden (OKLCH) - Native Anchor Positioning:
.velin-anchor/.velin-anchored--*fuer CSS-native Tooltip/Popover-Positionierung ohne JS - Fluid Typography: Alle
--velin-text-*Tokens aufclamp()umgestellt -- stufenlose Skalierung 320px bis 1440px - Smart User-Preference Queries:
prefers-contrast: more/lessundprefers-reduced-transparencySupport - CSS-only Filter:
.velin-filter-groupmit:has()fuer JS-freies Listen-Filtern ueber Checkboxen - Adaptive @container Style Queries:
.velin-density-compact/normal/comfortable+.velin-style-professional/playful - Luminance-Aware P3 Gradients:
.velin-gradient-p3-*mitcolor(display-p3)fuer Wide-Gamut Displays - State-driven Utilities:
.velin-is-loading/empty/error/success/disabledmit automatischen Icons/Overlays - Morph Transitions:
.velin-morph-source/targetfuer View Transitions API-basierte Komponenten-Morphs - Haptics API:
vibrate(),applyHaptic(),VelinHapticObserver-- Vibrationspatterns fuer mobile Interaktion <velin-persist>: Zero-JS Form Persistence Web Component -- auto-save/restore via localStorage- A11y Dashboard: Interaktive Seite auf velinstyle.info mit ARIA Inspector, Keyboard Visualizer, Contrast Checker
- 10 neue Themes: Neon, Earth, Ocean, Sunset, Nordic, Retro, Corporate, Pastel, Midnight, Forest (13 total)
- VelinStyle CLI:
velinstyle init/build/themes/addfuer CSS Tree-Shaking und Custom Builds
Fixed
- 39 Accessibility Issues behoben:
- - Carousel: Keyboard-Navigation,
aria-roledescription, Dot-Indicators Touch-Target - - Countdown:
role="timer",aria-live="polite",aria-atomic - - Lightbox: Focus-Trap, Focus-Restore,
aria-roledescription="lightbox" - - Dropdown/Popover:
aria-expanded,aria-haspopupauf Trigger - - Stepper:
role="list"/role="listitem",aria-current="step" - - Progress-Ring: Host-Level
role="progressbar"+ ARIA values - - Dialog: Focus-Restore, Autofocus
- - Chip: Touch-Target auf 44px erweitert
- - Switch/Progress/Spinner:
forced-colors: activeSupport - 11 velinstyle-site Frontend Issues behoben:
- - Navigation zwischen index.html und Docs verbunden
- - GitHub URL vereinheitlicht (SkyliteDesign)
- - Dark-Mode Attribut auf
data-velin-themevereinheitlicht - - Absolute Pfade zu relativen konvertiert
- - Bootstrap-Klassen in introduction.html durch VelinStyle ersetzt
- - Mobile Hamburger-Menu hinzugefuegt
- - Footer auf allen Doc-Seiten
- - Prism.js Dark-Mode verbessert
Changed
components/index.jsexportiert jetzt 22 Module (+ VelinPersist, VelinHapticObserver)package.json:binEintrag fuer CLI, Version 0.5.0,cli/in filessrc/velinstyle.css: 6 neue CSS-Imports (scope, anchor, filter, container-style, state, preferences)scripts/build-themes.js: Auto-Discovery statt hardcoded Array- Typography Tokens: Fixed values durch
clamp()ersetzt
v0.4.0 0.4.0 AddedFixedChanged 15 notes 2026-05-11
Added
- Float Utilities:
.velin-float-start,.velin-float-end,.velin-float-none,.velin-clearfix - Vertical-align Utilities:
.velin-align-baseline/top/middle/bottom/text-top/text-bottom/sub/super - Helpers-Kategorie (
src/helpers/helpers.css): Ratio Container, Stacks, Stretched Link, Vertical Rule, Colored Links, Focus Ring, Icon Link - 12-Column Flex Grid:
.velin-row,.velin-col-1bis-12, responsive sm/md/lg/xl Varianten, Offsets, Gutters, Row-Columns - Content-Styles (
src/base/content.css): Typography (h1-h6, display-1-6, lead, blockquote), Images (fluid, thumbnail, rounded), Figures - Table-Erweiterungen: Zeilen-Farbvarianten,
.velin-table--sm,.velin-table--borderless, Caption-Top - 7 neue Animationen: flip, drop-in, rubber-band, jello, heartbeat, swing, tada + Stagger + Hover-Trigger
- 6 neue Web Components:
<velin-tooltip-wc>,<velin-lightbox>,<velin-stepper-wc>,<velin-dialog>,<velin-countdown>,<velin-progress-ring> - 106 Dokumentationsseiten auf velinstyle.info nach Bootstrap-Vorbild (12 Kategorien)
- Haupt-Repo Docs Banner mit Link zur vollstaendigen Dokumentation
Fixed
- Fehlende
@keyframes velin-spinDefinition
Changed
components/index.jsexportiert jetzt alle 20 Web Componentssrc/velinstyle.cssimportiertbase/content.cssundhelpers/helpers.csspackage.jsonVersion 0.4.0- Alle Doc-Seiten auf v0.4.0
v0.3.0 0.3.0 AddedChangedMetrics 33 notes 2026-05-11
Added
- Responsive Utility-Varianten: Vollstaendige
sm/md/lg/xlVarianten fuer Spacing, Text, Flex, Sizing, Display, Visibility (~300 neue Klassen) - Input Group Komponente:
.velin-input-groupmit Text/Icon Prepend/Append und Groessen-Varianten - Floating Labels:
.velin-float-labelmit animierter Transition fuer Inputs, Selects und Textareas - Collapse Komponente: Standalone Content-Toggle mit CSS-only smooth height Animation
- Button Toolbar:
.velin-btn-toolbarfuer gruppierte Button-Gruppen - Navbar Mega-Menu:
.velin-nav__megaMulti-Column Dropdown in Navigation - Form Validation:
.velin-form--validatedmit:valid/:invalidPseudo-Klassen und visuellem Feedback - color-mix() Utilities: Dynamische Farb-Abstufungen (5%-90%) fuer Primary, Secondary, Success, Danger, Warning, Info -- einzigartig gegenueber Bootstrap/Tailwind
- Scroll-driven Animations:
.velin-animate-on-scroll,.velin-scroll-progress,.velin-parallaxohne JS - View Transitions API:
.velin-vt-* Utilities fuerview-transition-name, Morph-Uebergaenge, Cross-Fade und Slide Pseudo-Element-Styles - Subgrid Support:
.velin-subgridund.velin-subgrid-rowsin Grid-System - Ring Utilities:
.velin-ring-* mit Varianten fuer Farben (primary, secondary, success, danger) und Groessen (1-4px, inset) - Divide Utilities:
.velin-divide-y,.velin-divide-xfuer Kind-Element-Trenner - Columns Utilities:
.velin-columns-1/2/3/4fuer Multi-Column-Layout - Order Utilities:
.velin-order-first/last/none/1-12fuer Flex/Grid-Reihenfolge - Object-position Utilities:
.velin-object-center/top/bottom/left/rightfuer Bilder - Flex-basis Utilities:
.velin-basis-* mit Bruch-Varianten (1/2, 1/3, 2/3, 1/4, 3/4, 1/5) - Scroll-snap Utilities:
.velin-snap-x/y,.velin-snap-start/center/end, Scroll-Padding fuer fixe Header - Text-wrap Utilities:
.velin-text-balance,.velin-text-pretty,.velin-text-nowrap - Isolation/Blend Utilities:
.velin-isolate,.velin-blend-multiply/screen/overlay/difference - Touch-action Utilities:
.velin-touch-none/pan-x/pan-y/manipulation - Overscroll Utilities:
.velin-overscroll-contain/none/auto - Will-change Utilities:
.velin-will-change-transform/opacity/scroll - Hyphens Utilities:
.velin-hyphens-auto/none - 3 neue Web Components:
<velin-carousel>(Touch-Swipe, Auto-Play, Indikatoren,aria-roledescription),<velin-collapse>(grid-row Animation),<velin-scrollspy>(IntersectionObserver) - 8 neue Sample-Seiten: Login, Signup (Multi-Step), E-Commerce (Sharp), Settings, Pricing (Soft), Chat, Email (Sharp), Kanban
- Docs-Homepage: Komplett neue Marketing-Landingpage mit Feature-Grid, Vergleichstabelle, Quick-Start, Component-Showcase
- velinstyle.info: Separates Marketing-Repository mit Live-Playground, Theme-Showcase, interaktiven Code-Beispielen
Changed
- Alle Doc-Seiten haben jetzt einheitliche Navigation mit 10 Links
- Alle Versionsangaben auf v0.3.0 aktualisiert
components/index.jsexportiert jetzt alle 14 Web Componentssrc/velinstyle.cssimportiert 6 neue Utility-Dateien und 2 neue Komponentenpackage.jsonVersion auf 0.3.0
v0.2.0 0.2.0 AddedChanged 20 notes 2026-05-11
Added
- 15 neue CSS-Komponenten: Breadcrumb, Pagination, Progress, Spinner, List Group, Avatar (mit Status/Gruppe), Switch/Toggle, Divider, Chip/Tag, Timeline, Stepper, Stat Card, Range Input, File Upload Dropzone, Close Button
- 5 neue Web Components:
<velin-drawer>(Offcanvas),<velin-theme-toggle>(Dark/Light mit localStorage),<velin-popover>(Rich-Content Tooltips),<velin-copy>(Click-to-Copy),<velin-scroll-top>(Scroll-to-Top) - CSS-Animationsbibliothek: 7 Entrance (fade-in, slide-up/down/left/right, scale-in, zoom-in), 5 Attention (bounce, pulse, shake, wiggle, ping), 2 Exit Animationen mit Duration/Delay/Infinite Modifiern, voll
prefers-reduced-motion-konform - Gradient Utilities: 6 fertige Gradienten (primary, secondary, surface, hero, sunset, ocean), Gradient-Text, Richtungsmodifier
- Transform Utilities: rotate, scale, translate-y mit negativen Varianten
- Filter/Backdrop Utilities: blur, backdrop-blur, brightness, grayscale
- Print Utilities: print-only, no-print, break-before/after/avoid, automatische Druckoptimierung
- Layout Patterns: sidebar, holy-grail, sticky-footer, center, pancake, aside-main
- Button Erweiterungen: Success-Variante, Loading-State mit Spinner
- Docs-Infrastruktur: Shared
docs.cssmit Sidebar-Layout, Code-Block-Styling, API-Tabellen, Swatch-Komponenten, NEW-Badges - 5 neue Doc-Seiten: Getting Started, Layout, Utilities, Forms (alle Controls), Migration Guide (Bootstrap + Tailwind)
- RTL-Demo: Vollstaendige arabische Sample-Seite mit gespiegelten Layouts
- TypeScript-Definitionen: Vollstaendige
.d.tsfuer alle 11 Web Components mit HTMLElementTagNameMap - GitHub Pages Deployment: Automatisches Deployment bei Push auf main
- Custom 404-Seite: Styled VelinStyle 404 fuer GitHub Pages
- Testing: axe-core A11y-Tests, Vitest Web Component Unit-Tests, CI-Integration
Changed
components/index.jsexportiert jetzt alle 11 Web Componentssrc/velinstyle.cssimportiert alle neuen Komponenten, Utilities und Layout-Patternspackage.jsonVersion auf 0.2.0, TypeScript-Definitionen alstypesFeld- CI-Workflow fuehrt jetzt auch Unit-Tests aus
v0.1.0 0.1.0 Added 16 notes 2026-05-11
Added
- Design Tokens: OKLCH color palette, spacing scale (4px base), typography scale (1.25x Major Third), border-radius, shadows, motion, z-index, and aspect-ratio tokens
- Dark Mode: Automatic via
prefers-color-schemeand explicit viadata-velin-theme="dark"attribute - Modern CSS Reset:
box-sizing: border-box, scroll behavior, motion reduction, min font-size for mobile inputs - Accessibility Layer:
.velin-sr-only,.velin-skip-link,:focus-visibleoutlines,prefers-reduced-motionsupport,forced-colors(Windows High Contrast) support, skeleton loading with CLS protection - Layout System: Responsive container with Container Queries, CSS Grid with auto-fit/auto-fill, Flexbox utilities, stack and cluster patterns
- BEM Components: Button (6 variants + 4 sizes), Card, Form inputs, Navigation, Alert, Badge, Table, Tooltip, Modal (CSS)
- Utility Classes: Flex, spacing, text alignment, display, visibility, color utilities
- Web Components:
<velin-modal>,<velin-tabs>,<velin-accordion>,<velin-dropdown>,<velin-toast>,<velin-icon>with full keyboard and screen reader support - Focus Manager: Shared module with
trapFocus(),rovingTabindex(),saveFocus(),restoreFocus() - Icon System: 51 essential SVG icons with sprite builder and
<velin-icon>component - Theme Presets: Sharp (angular, editorial), Soft (rounded, warm), Brutalist (raw, bold)
- Documentation: Token reference, component demos, accessibility guide, theme showcase, icon gallery
- Sample Pages: Landing page (default), Dashboard (sharp), Blog (soft), Portfolio (brutalist)
- Build Tooling: Lightning CSS for CSS bundling/minification, ESBuild for JS bundling
- CI/CD: GitHub Actions workflow for build and a11y tests
- Linting: Stylelint configuration enforcing
velin-prefix convention