@vashu96/ui 0.0.3 → 0.0.4

package/dist/lib/cn.d.ts

@@ -1 +1,5 @@
+/**
+ * ClassName utility that merges Tailwind classes.
+ * Combines `clsx` (for conditional classes) and `tailwind-merge` (for conflict resolution).
+ */
 export { cn } from '@sglara/cn';

package/dist/lib/colorScheme.d.ts

@@ -0,0 +1,85 @@
+/**
+ * colorScheme.ts — Dynamic Color Scheme Generator with WCAG Contrast Enforcement
+ *
+ * Algorithm:
+ *  1. Parse hex → HSL
+ *  2. Derive primary shades (hover, active, subtle) by shifting lightness
+ *  3. If no secondary, auto-generate a split-complementary accent
+ *  4. Generate surface tones that harmonize with the primary hue
+ *  5. Derive status colors that don't clash with the primary
+ *  6. **Enforce WCAG 2.0 AA contrast ratios** for all foreground colors
+ *  7. Output as CSS custom property values
+ */
+export interface ColorSchemeInput {
+    primary: string;
+    secondary?: string;
+    neutral?: string;
+}
+export interface ColorScheme {
+    primary: string;
+    primaryHover: string;
+    primaryActive: string;
+    primarySubtleLight: string;
+    primarySubtleDark: string;
+    /** The primary color adjusted for use as foreground text on white */
+    primaryOnLight: string;
+    /** The primary color adjusted for use as foreground text on dark surfaces */
+    primaryOnDark: string;
+    secondary: string;
+    surfaceBaseLight: string;
+    surface1Light: string;
+    surface2Light: string;
+    surface3Light: string;
+    surfaceBaseDark: string;
+    surface1Dark: string;
+    surface2Dark: string;
+    surface3Dark: string;
+    glassBgLight: string;
+    glassBgDark: string;
+    glassBorderLight: string;
+    glassBorderDark: string;
+    spotlightColor: string;
+    success: string;
+    warning: string;
+    danger: string;
+    info: string;
+    contrastInfo: ContrastInfo;
+}
+export interface ContrastInfo {
+    primaryOnWhite: number;
+    primaryOnDark: number;
+    primaryWasAdjusted: boolean;
+    statusOnWhite: {
+        success: number;
+        warning: number;
+        danger: number;
+        info: number;
+    };
+}
+export interface HSL {
+    h: number;
+    s: number;
+    l: number;
+}
+export declare function hexToHSL(hex: string): HSL;
+export declare function hslToHex(hsl: HSL): string;
+/**
+ * Calculates WCAG 2.0 contrast ratio between two luminances.
+ * Result is between 1:1 (no contrast) and 21:1 (max contrast).
+ */
+export declare function contrastRatio(l1: number, l2: number): number;
+export declare function generateColorScheme(input: ColorSchemeInput): ColorScheme;
+/**
+ * Applies a ColorScheme to the document by injecting a dynamic <style> tag.
+ *
+ * IMPORTANT: We do NOT use inline styles (root.style.setProperty) because
+ * inline styles have higher CSS specificity than any selector — meaning
+ * the [data-theme="dark"] overrides would never take effect.
+ * Instead, we inject a <style> tag with :root and [data-theme="dark"] blocks.
+ */
+export declare function applyColorScheme(scheme: ColorScheme, styleId?: string): void;
+/**
+ * Convenience: generate + apply in one call.
+ */
+export declare function setThemeColors(input: ColorSchemeInput, styleId?: string): ColorScheme;
+export declare const PRESETS: Record<string, ColorSchemeInput>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vashu96/ui",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",