aura-glass 2.1.2 → 2.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -28,7 +28,7 @@ A new class of interface deserves more than a component library. AuraGlass sense
28
28
 
29
29
  ## What’s New in 2.1
30
30
  ### Design Matrix Persona System
31
- AuraGlass 2.1 introduces the Design Matrix: a canonical system of ten personas (Midnight Slate, Midnight Meridian, Solar Apex, Ultrathink, Aurora Noir, Helios Foundry, Glacier Morn, Terra Inflect, Lumen Veil, Nimbus Relay) that power runtime theming, metadata, and adaptive styling. Each persona defines semantic tokens for backgrounds, text, borders, accents, states, shadows, gradients, and charts, ensuring cohesive experiences across applications.
31
+ AuraGlass 2.1 introduces the Design Matrix: a canonical system of ten personas (Midnight Slate, Midnight Meridian, Solar Apex, Violet Nebula, Aurora Noir, Helios Foundry, Glacier Morn, Terra Inflect, Lumen Veil, Nimbus Relay) that power runtime theming, metadata, and adaptive styling. Each persona defines semantic tokens for backgrounds, text, borders, accents, states, shadows, gradients, and charts, ensuring cohesive experiences across applications.
32
32
 
33
33
  **Key Features:**
34
34
  - **Canonical Dataset:** Defined in `src/theme/designMatrix.ts`, personas include metadata (name, description, context) and tokens for colors, typography, motion, and glassmorphism parameters.
@@ -39,9 +39,7 @@ AuraGlass 2.1 introduces the Design Matrix: a canonical system of ten personas (
39
39
 
40
40
  **Usage Example:**
41
41
  ```tsx
42
- import { ThemeProvider } from 'aura-glass';
43
- import { PersonaPicker } from 'aura-glass';
44
- import { usePersonaTheme } from 'aura-glass';
42
+ import { ThemeProvider, PersonaPicker, usePersonaTheme } from 'aura-glass';
45
43
 
46
44
  function App({ children }) {
47
45
  return (
@@ -154,6 +152,25 @@ export function App({ children }) {
154
152
  }
155
153
  ```
156
154
 
155
+ **Step 5 – Design tokens & Tailwind helpers**
156
+ ```ts
157
+ import auraTokens, { personas } from 'aura-glass/tokens';
158
+
159
+ console.log(auraTokens.version); // 1.0.0
160
+ console.log(personas[0].metadata.displayName);
161
+ ```
162
+
163
+ ```ts
164
+ // tailwind.config.ts
165
+ import type { Config } from 'tailwindcss';
166
+ import theme from 'aura-glass/tokens/tailwind';
167
+
168
+ export default {
169
+ content: ['./src/**/*.{ts,tsx}'],
170
+ theme,
171
+ } satisfies Config;
172
+ ```
173
+
157
174
  > After adjusting personas inside `src/theme/designMatrix.ts`, run `npm run glass:generate-persona-css` (and `npm run glass:validate-persona-css` in CI) to regenerate `[data-persona]` variables at `src/styles/generated/persona-variables.css`.
158
175
 
159
176
  ## Use AuraGlass
@@ -20,7 +20,7 @@ export declare function useChartPerformanceMonitoring(enabled?: boolean): {
20
20
  endMeasurement: (label: string) => number;
21
21
  };
22
22
  export declare function useAdaptiveQuality(initialTier?: ChartQualityTier['tier'], enabled?: boolean): {
23
- currentTier: "medium" | "low" | "high" | "ultra";
23
+ currentTier: "ultra" | "high" | "medium" | "low";
24
24
  updateQualityBasedOnPerformance: (renderTime: number, targetFPS?: number) => void;
25
25
  };
26
26
  export declare function getQualityBasedPhysicsParams(qualityTier: ChartQualityTier['tier']): PhysicsParams;
@@ -21,7 +21,7 @@ export interface OptimizedGlassStyles {
21
21
  export declare function useGlassOptimization(baseOptions?: GlassOptions, config?: GlassOptimizationConfig): {
22
22
  optimizedOptions: GlassOptions;
23
23
  optimizedStyles: OptimizedGlassStyles;
24
- performanceMode: "low" | "high" | "balanced";
24
+ performanceMode: "high" | "low" | "balanced";
25
25
  isHighPerformance: boolean;
26
26
  isLowPerformance: boolean;
27
27
  shouldReduceEffects: boolean;