@shohojdhara/atomix 0.6.3 → 0.6.5

package/dist/heavy.d.ts

@@ -151,6 +151,28 @@ interface OverLightObjectConfig {
      * saturationBoost: 2.0
      */
     saturationBoost?: number;
+    /**
+     * Rim opacity multiplier for animated border gradients (0.1 - 1.0)
+     *
+     * @default 0.7 when over-light is active, 0.35 otherwise
+     */
+    borderOpacity?: number;
+}
+/**
+ * Liquid glass rim configuration (Apple-style hairline border).
+ */
+interface GlassBorderConfig {
+    /** Whether border layers render. @default true */
+    enabled?: boolean;
+    /** Rim width — maps to `--atomix-glass-border-width`. @default 0.5px */
+    width?: string | number;
+    /** Multiplier on rim gradient opacities. @default 1 */
+    opacity?: number;
+    /**
+     * When false, skips JS gradient vars so SCSS static fallbacks apply.
+     * @default true
+     */
+    animated?: boolean;
 }
 /**
  * AtomixGlass component props interface
@@ -166,7 +188,6 @@ interface AtomixGlassProps extends React.HTMLAttributes<HTMLDivElement> {
     globalMousePosition?: MousePosition;
     mouseOffset?: MousePosition;
     mouseContainer?: React.RefObject<HTMLElement | null> | null;
-    padding?: string;
     height?: string | number;
     width?: string | number;
     overLight?: OverLightConfig;
@@ -194,6 +215,14 @@ interface AtomixGlassProps extends React.HTMLAttributes<HTMLDivElement> {
     highContrast?: boolean;
     withoutEffects?: boolean;
     withLiquidBlur?: boolean;
+    /**
+     * Liquid glass rim — boolean shorthand or structured config.
+     * Takes precedence over legacy `withBorder` when provided.
+     */
+    border?: boolean | GlassBorderConfig;
+    /**
+     * @deprecated Use `border` instead. When `border` is omitted, defaults to this value.
+     */
     withBorder?: boolean;
     withOverLightLayers?: boolean;
     /**
@@ -499,94 +528,7 @@ interface PhotoViewerProps extends BaseComponentProps {
     onClose?: () => void;
 }
 
-/**
- * AtomixGlass - A high-performance glass morphism component with liquid distortion effects
- *
- * Features:
- * - Hardware-accelerated glass effects with SVG filters
- * - Mouse-responsive liquid distortion
- * - Dynamic border-radius extraction from children CSS properties
- * - Automatic light/dark theme detection via overLight prop
- * - Accessibility and performance optimizations
- * - Multiple displacement modes (standard, polar, prominent, shader)
- * - Design token integration for consistent theming
- * - Focus ring support for keyboard navigation
- * - Responsive breakpoints for mobile optimization
- * - Enhanced ARIA attributes for screen readers
- * - Time-based animation system with FBM distortion
- * - Device preset optimization for performance/quality balance
- *
- * Design System Compliance:
- * - Uses design tokens for opacity, spacing, and colors
- * - Follows BEM methodology for class naming
- * - Implements focus-ring mixin for accessibility
- * - Supports reduced motion and high contrast preferences
- *
- * @example
- * // Basic usage with dynamic border-radius extraction
- * <AtomixGlass>
- *   <div style={{ borderRadius: '12px' }}>Content with 12px radius</div>
- * </AtomixGlass>
- *
- * @example
- * // Manual border-radius override
- * <AtomixGlass borderRadius={20}>
- *   <div>Content with 20px glass radius</div>
- * </AtomixGlass>
- *
- * @example
- * // Interactive glass with click handler
- * <AtomixGlass onClick={() => console.log('Clicked')} aria-label="Glass card">
- *   <div>Clickable content</div>
- * </AtomixGlass>
- *
- * @example
- * // OverLight - Boolean mode (explicit control)
- * <AtomixGlass overLight={true}>
- *   <div>Content on light background</div>
- * </AtomixGlass>
- *
- * @example
- * // OverLight - Auto-detection mode
- * <AtomixGlass overLight="auto">
- *   <div>Content with auto-detected background</div>
- * </AtomixGlass>
- *
- * @example
- * // OverLight - Object config with custom settings
- * <AtomixGlass
- *   overLight={{
- *     threshold: 0.8,
- *     opacity: 0.6,
- *     contrast: 1.8,
- *     brightness: 1.0,
- *     saturationBoost: 1.5
- *   }}
- * >
- *   <div>Content with custom overLight config</div>
- * </AtomixGlass>
- *
- * @example
- * // Debug mode for overLight detection
- * <AtomixGlass overLight="auto" debugOverLight={true}>
- *   <div>Content with debug logging enabled</div>
- * </AtomixGlass>
- *
- * @example
- * // Performance-optimized for mobile devices
- * <AtomixGlass devicePreset="performance" disableResponsiveBreakpoints={false}>
- *   <div>Mobile-optimized glass effect</div>
- * </AtomixGlass>
- */
-declare global {
-    interface Window {
-        enablePerformanceMonitoring?: boolean;
-    }
-}
-/**
- * AtomixGlass - wrapped with React.memo to prevent unnecessary re-renders.
- * Ref is forwarded to the root `<div>` element.
- */
+/** Memoized public export. Ref targets the root `.c-atomix-glass` wrapper. */
 declare const AtomixGlass: React$1.NamedExoticComponent<AtomixGlassProps & React$1.RefAttributes<HTMLDivElement>>;
 
 /**