border-beam 1.0.1 → 1.2.0

package/dist/index.d.ts

@@ -35,9 +35,8 @@ export declare interface BorderBeamProps extends Omit<HTMLAttributes<HTMLDivElem
     children: ReactNode;
     /**
      * Size/type preset
-     * - 'sm': Small button-sized with compact glow
-     * - 'md': Medium card-sized with full border glow (default)
-     * - 'line': Bottom-only traveling glow with breathe and spike animations
+     * Rotate family: 'sm' (compact), 'md' (full border, default), 'line' (bottom traveling).
+     * Pulse family: 'pulse-outside' (outward bloom), 'pulse-inner' (contained breathe).
      * @default 'md'
      */
     size?: BorderBeamSize;
@@ -78,7 +77,8 @@ export declare interface BorderBeamProps extends Omit<HTMLAttributes<HTMLDivElem
      */
     borderRadius?: number;
     /**
-     * Brightness multiplier for the glow effect
+     * Brightness multiplier for the glow effect.
+     * Falls back to the type's preset default (1.3 for most types).
      * @default 1.3
      */
     brightness?: number;
@@ -118,11 +118,17 @@ export declare interface BorderBeamProps extends Omit<HTMLAttributes<HTMLDivElem
 
 /**
  * Size/type preset for the border beam effect
+ *
+ * Rotate family (traveling/spinning beam):
  * - 'sm': Small button-sized with compact glow
  * - 'md': Medium card-sized with full border glow
  * - 'line': Bottom-only traveling glow with breathe and spike animations
+ *
+ * Pulse family (breathing glow, no rotation):
+ * - 'pulse-outside': Glow blooms OUTWARD beyond the element (uncropped halo)
+ * - 'pulse-inner': Glow breathes contained within the element's border
  */
-export declare type BorderBeamSize = 'sm' | 'md' | 'line';
+export declare type BorderBeamSize = 'sm' | 'md' | 'line' | 'pulse-outside' | 'pulse-inner';
 
 /**
  * Theme mode for adapting beam colors to background
@@ -142,12 +148,12 @@ export declare interface SizeConfig {
 /**
  * Size presets for border radius and dimensions
  */
-export declare const sizePresets: Record<'sm' | 'md' | 'line', SizeConfig>;
+export declare const sizePresets: Record<BorderBeamSize, SizeConfig>;
 
 /**
  * Per-size theme presets matching the tuned v5 control panel defaults
  */
-export declare const sizeThemePresets: Record<'sm' | 'md' | 'line', Record<'dark' | 'light', ThemeColors>>;
+export declare const sizeThemePresets: Record<BorderBeamSize, Record<'dark' | 'light', ThemeColors>>;
 
 /**
  * Theme color configuration
@@ -158,6 +164,14 @@ export declare interface ThemeColors {
     bloomOpacity: number;
     innerShadow: string;
     saturation: number;
+    /** Optional per-type default brightness (used by pulse types). Falls back to 1.3. */
+    brightness?: number;
+    /**
+     * Optional opacity of the 1px hairline border that frames the element.
+     * Used by 'pulse-outside' so the colored stroke rides a subtle outline,
+     * matching the v5 prototype. Falls back to 0 (no hairline).
+     */
+    hairlineOpacity?: number;
 }
 
 /**