VelinStyle feature scope 1.2.2
Map of what ships in 1.2.1 — CSS, Web Components, runtime, CLI, Transparency, security, and Design Intelligence. Use maturity badges before treating a surface as production-ready. Deutsch: Feature-Umfang
When to use
- Use this page as the 1.2.1 maturity map before diving into generated reference or guides.
- Pin
@birdapi/velinstyle@1.3.0and check badges for beta vs planned surfaces.
When not
- Do not treat beta plan/review/meta as a finished AI design system.
- Do not invent Studio or Utility Engine APIs that are still planned.
- Do not read AAA-oriented defaults as an application certification.
1.2.1 maturity
| Label | Surfaces |
|---|---|
| stable | CSS, Web Components, runtime modules (search, motion, attributes, highlight), tokens CLI, docs generate |
| beta | Plan / review CLI, Knowledge Graph, page/section registry, schemas, agent metadata (velin-meta) |
| planned | Studio, complete Utility Engine generator |
CSS & layout stable
| Area | What you get | Docs |
|---|---|---|
| Components | 35+ CSS components (buttons, cards, grid, forms, …) | Components |
| Utilities | velin-* spacing, color, flex, motion, safe-area, … | Utilities API |
| Themes | 13 OKLCH presets via data-velin-theme | Color modes |
| Tokens | --velin-* design tokens, JSON build | Design tokens |
| A11y | WCAG 2.2 AAA-oriented defaults / AAA support — not app certification; contracts, RTL, reduced motion | Accessibility |
Runtime modules stable
| Module | Export | Maturity | Guide |
|---|---|---|---|
| VelinSearch | @birdapi/velinstyle/search | stable | VelinSearch |
| Motion | @birdapi/velinstyle/motion | stable | Motion |
| Attributes | @birdapi/velinstyle/attributes | stable | HTML attributes |
| Highlight | @birdapi/velinstyle/highlight | stable | Syntax highlighting |
| Velin-Meta | @birdapi/velinstyle/meta | beta / foundation | Velin-Meta |
| Transparency Framework | @birdapi/velinstyle/transparency | beta / foundation | Transparency |
1.2.0 Design Intelligence beta
| Area | Highlights | Docs |
|---|---|---|
| Plan / review | velinstyle plan, velinstyle review — heuristic scores, expanding schemas | CLI |
| Knowledge Graph | Seed component + token intelligence (not full inventory) | Velin-Meta |
| Registries | Page types + section/blueprint graphs | Scaffolding |
| Agent metadata | Richer velin-agent.json / llms.txt | Velin-Meta |
Earlier additions (now stable)
| From | Highlights | Docs |
|---|---|---|
| 0.8–1.0 | WC primitives, motion tokens, search/motion/attributes runtimes, scaffold + layout CLI | Search & Motion |
| 1.1.0 | Release guard, full @velinstyle/react, velin-data-table, velin-form-summary, extra lexers | Vite & React |
Web Components
43 canonical custom elements (45 lazy-loader entries with legacy velin-tooltip-wc / velin-stepper-wc), including velin-search, velin-code-block, velin-modal, velin-data-table, and form helpers. All have component-contracts.json entries; declarative velin-scroll-top attribute; CLS placeholders via wc-placeholder.css.
Browse components Generated WC API
CLI & tooling
- stable:
init,build,scan,prefix,docs generate,search index,tokens,perf audit - beta:
scaffold/blueprint(plan-first),plan,review,meta - planned: Studio UI and complete Utility Engine generator
CLI reference · Generated Markdown hub
Security
| Capability | Description | Docs |
|---|---|---|
velinstyle scan | Markup & a11y rules; PII rules (--only pii) | Security |
| Sanitize API | @birdapi/velinstyle/sanitize — URL/text helpers | JS API |
velin-secure-field | No plaintext secrets in DOM; hardened copy/search URLs | Secure field |
| Velin-Meta | Public agent JSON only — no credentials in llms.txt | Velin-Meta |
Velin-Meta (live on this site)
This page embeds page-level meta below. The site also publishes a global agent bundle you can fetch from any doc page.
Global bundle
dist/velin-agent.json + dist/llms.txt
Loading bundle summary…
Page meta (this HTML)
MIME application/vnd.velinstyle.meta+json
Generate for your pages: npx velinstyle meta page my.html --write