Documentation menu · Reference
Release

AuraGlass 4.0 release notes

AuraGlass 4.0 completes a package-wide visual-hardening pass with neutral-glass token enforcement, accessibility story-quality gates, and independently auditable certification evidence.

#What 4.0 ships

AuraGlass 4.0 is the visual-hardening and certification release. The authoritative inventory now identifies 470 visually renderable component exports, one explicitly nonvisual public export, and 28 package recipes. Every one of the 498 visual-gate targets passed the final full audit with zero blocked entries.

The release preserves the public package boundaries established in 3.x while tightening the material, token, Storybook, accessibility, and responsive-layout contracts underneath them.

Renderable component exports
470
Package registry recipes
28
Full visual gate
498 passed, 0 blocked
Glass pipeline
31 passed, 0 failed, 0 warnings
Runtime cleanliness
760 source files scanned, 0 findings

#Neutral glass is the default contract

The 4.0 sweep removes unintended color casts and one-off surface literals from default component rendering. Glass backgrounds, borders, highlights, overlays, and depth effects now resolve through the reviewed token and material layers so components remain neutral until a product explicitly asks for semantic or branded tint.

Theme and persona APIs remain available for deliberate brand expression. The difference is contractual: decorative tint is no longer allowed to leak into a supposedly neutral default surface.

tsx
import { GlassCard } from 'aura-glass';
import 'aura-glass/styles';

export function ReleaseStatus() {
  return <GlassCard depth="medium">498 visual gates passed</GlassCard>;
}

#Accessibility and Storybook quality are release gates

New quality checks audit meaningful accessible names, interactive story coverage, component state presentation, and copy-safe documentation examples. The Storybook visual certification remains independently inspectable, while the expanded runtime audit covers every renderable public export and recipe.

Responsive layout and token-purity tests now fail on unsafe fixed geometry, uncontrolled overflow, disallowed raw visual values, and component styles that bypass the generated design contract.

Accessible story quality
Names, roles, interaction states, and usable examples
Token purity
Reviewed tokens instead of ungoverned visual literals
Layout safety
Responsive containment and overflow checks
Evidence
Committed summaries, ledgers, screenshots, and focused test suites

#Licensed typography and a cleaner runtime

AuraGlass 4.0 bundles the licensed Aeonik family for the package typography system, including regular, italic, and weighted faces. The package no longer needs a remote font request to render its intended interface typography.

The final runtime-cleanliness audit scanned 760 source files and found no console, debugger, or TODO leakage. The glass pipeline completed 31 of 31 checks without failures or warnings.

#Upgrade to 4.0.0

Install `aura-glass@4.0.0` once the 4.0 package is available on npm, keep `aura-glass/styles` at the application root, and run the package doctor before visual review. Existing public imports remain the intended migration path.

Because 4.0 deliberately tightens default materials and typography, review local surface overrides, custom tint assumptions, dense layouts, and screenshot baselines as part of the upgrade.

bash
npm install aura-glass@4.0.0
npx aura-glass doctor --json
npx aura-glass list --json