AuraGlass 3.4 release notes

#What 3.4 ships

AuraGlass 3.4 redesigns the canonical glass surface tokens for a state-of-the-art Liquid Glass look. All 30 surfaces (six intents across five elevation levels) are now a luminous white frost — low-alpha white gradients over a faint smoke scrim — instead of dark slate panels, so surfaces take on the backdrop’s color the way real frosted glass does.

Depth now comes from blur and sheen rather than surface darkness: the elevation blur scale rises from 8–24px to 16/24/32/40/48px, heavy 2–3px borders become 1px white or tint hairlines at every level, and the previously unrendered highlight and inner-glow tokens now draw an inset top-edge highlight on every token-driven surface. Radii grow to 10/16/24/32px and outer shadows get deeper and softer for the floating-card look.

Everything from 3.3 stays: 439 component-like exports, the six focused package subpaths, 28 registry recipes, Theme Engine 2.0, the migration CLI, and provider-safe hosted-runtime contracts.

#One surface system, one filter

Before 3.4, three different layers shipped three different backdrop filters. 3.4 unifies the entire library on a single filter and derives every generated surface from the one parametric source of truth in `AURA_GLASS`, so the TypeScript utilities, the generated CSS variables, the `.glass` foundation class, and the dark theme all render identically.

#Library-wide rendering audit

3.4 also closes a library-wide audit pass. A past migration had left 71 style declarations across 40+ components using a literal code comment as their CSS background value — browsers silently drop invalid values, so toast progress bars, skeleton loaders, slider tracks, and metric chips rendered with no background at all. Each now resolves to the generated surface token the comment named.

The same pass remapped 107 dead double-prefixed utility classes to real utilities, removed forced dark `!important` style injections from the liquid navigation, command surface, search field, and collaboration workspace components, and converted the app-shell, workspace, AR, and error-state chrome from opaque dark panels to the new white-frost surfaces.

#Verification

The 3.4 line ships with the full quality-gate suite green: TypeScript typecheck, design-token lint, style lint, the 31-check glass pipeline validation, 90 WCAG AA contrast checks, and 432 Jest suites with 2,373 tests and 339 snapshots.

Four patches follow 3.4.0: 3.4.1 syncs the persona token source to the new blur scale, 3.4.2 refreshes the package README shown on npm, 3.4.3 completes a library-wide CSS variable and color-correctness audit — defining 300+ silently-missing tokens, hsl()-wrapping ~375 raw HSL channel references across 97 files, and restoring the missing backdrop-blur utility classes — and 3.4.4 purges the final dark slate and zinc slabs and gradient washes from 14 components, including dropdowns, the query builder, and the visualization surfaces.

#Upgrade checklist

Upgrade apps by installing `aura-glass@3.4.4` and keeping the stylesheet import at the app root. No import paths change. Surfaces will read brighter and frostier on the same markup; if you overrode glass backgrounds or borders to compensate for the old dark look, remove those overrides and let the tokens render.

If you pinned custom blur values, re-check them against the new 16–48px scale, and prefer the generated `--glass-*` variables over hardcoded pixel values so future scale changes arrive automatically.

npm install aura-glass@3.4.4
npx aura-glass doctor --json
npx aura-glass list --json