AuraGlass 4.0 Release Notes — AuraGlass by AuraOne

#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

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 { Card } from 'aura-glass';
import 'aura-glass/styles.css';

export function ReleaseStatus() {
  return (
    <Card.Root>
      <Card.Body>498 visual gates passed</Card.Body>
    </Card.Root>
  );
}

#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

#Self-contained typography tokens and a cleaner runtime

AuraGlass 4.0 ships a self-contained typography token scale across display, body, and monospace roles so the package never needs an external font request at runtime.

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 path to 5.0.2

AuraGlass 5.0.2 supersedes this release line. Install `aura-glass@5.0.2`, run the 4to5 codemod, keep `aura-glass/styles.css` at the application root, and run the CLI doctor before visual review. See the 5.0.2 release notes on this site for the current contract.

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@5.0.2
npx aura-glass-cli migrate 4to5 --dry-run
npx aura-glass-cli doctor