@kubit-ui-web/react-components 2.0.0-beta.60 → 2.0.0-beta.63

package/dist/types/components/popover/animations/keyframes.utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utility functions for dynamic CSS keyframes injection
+ * Handles the conversion from keyframe strings to actual CSS animations
+ */
+/**
+ * Inject keyframes into the document head
+ * Returns the generated animation name to use in CSS
+ */
+export declare const injectKeyframes: (keyframesString: string) => string;
+/**
+ * Clean up injected keyframes (for unmounting components)
+ */
+export declare const cleanupKeyframes: (animationName: string) => void;
+//# sourceMappingURL=keyframes.utils.d.ts.map

package/dist/types/components/popover/animations/keyframes.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyframes.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/animations/keyframes.utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,iBAAiB,MAAM,KAAG,MA2BzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,eAAe,MAAM,KAAG,IAWxD,CAAC"}

package/dist/types/components/popover/animations/popover.animations.d.ts

@@ -0,0 +1,50 @@
+import { type AnimationType, type ExtendedAnimationConfig, type InternalAnimationConfig, type RequiredSimpleAnimationConfig } from '../types/animation';
+import { type AnimationDirection } from '../utils/animation.utils';
+/**
+ * Universal animation generator for simple animation configs only
+ */
+export declare const generateAnimation: (config: RequiredSimpleAnimationConfig, direction: AnimationDirection, type: AnimationType, placement?: string) => string;
+/**
+ * Create a custom animation with specific options
+ * This is a more flexible alternative to the predefined functions
+ *
+ * @param config - The internal animation configuration
+ * @param options - Animation options including direction, type, custom keyframes, and placement
+ * @param options.direction - Animation direction ('up', 'down', 'left', 'right', 'fade')
+ * @param options.type - Animation type ('enter' or 'exit')
+ * @param options.placement - Optional placement string for positioning
+ * @returns Generated keyframes CSS string
+ * ```
+ */
+export declare const createCustomAnimation: (config: InternalAnimationConfig, options: {
+    direction: AnimationDirection;
+    type: AnimationType;
+    placement?: string;
+}) => string;
+/**
+ * Get placement-specific animations with support for separate enter/exit configs
+ * Automatically handles fallbacks for unsupported placements
+ *
+ * @param closing - Whether the popover is closing (true) or opening (false)
+ * @param animationConfig - Animation configuration (unified or with separate enter/exit)
+ * @param placement - Placement string (e.g., 'top', 'bottom-start', 'left-end')
+ * @returns CSS keyframes string
+ * ```
+ */
+export declare const getPlacementAnimation: (closing: boolean, animationConfig: InternalAnimationConfig | ExtendedAnimationConfig, placement?: string) => string;
+/**
+ * Generate a complete CSS keyframes rule with a given name
+ */
+export declare const generateAnimationKeyframesRule: (keyframeName: string, config: RequiredSimpleAnimationConfig, direction: AnimationDirection, type: AnimationType, placement?: string) => string;
+/**
+ * Generate CSS animation styles with all configuration applied
+ * Includes validation and safe defaults for all properties
+ * Note: willChange should be managed externally via JavaScript for performance
+ *
+ * @param config - Animation configuration (unified or with separate enter/exit)
+ * @param closing - Whether this is for a closing animation
+ * @returns CSS properties as string
+ * ```
+ */
+export declare const generateAnimationStyles: (config: InternalAnimationConfig | ExtendedAnimationConfig, closing?: boolean) => string;
+//# sourceMappingURL=popover.animations.d.ts.map

package/dist/types/components/popover/animations/popover.animations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.animations.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/animations/popover.animations.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAElB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EACnC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,KAAK,kBAAkB,EAOxB,MAAM,0BAA0B,CAAC;AAGlC;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,6BAA6B,EACrC,WAAW,kBAAkB,EAC7B,MAAM,aAAa,EACnB,YAAY,MAAM,KACjB,MAuCF,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,uBAAuB,EAC/B,SAAS;IACP,SAAS,EAAE,kBAAkB,CAAC;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,KACA,MAKF,CAAC;AAmCF;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,OAAO,EAChB,iBAAiB,uBAAuB,GAAG,uBAAuB,EAClE,YAAY,MAAM,KACjB,MAsCF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8BAA8B,GACzC,cAAc,MAAM,EACpB,QAAQ,6BAA6B,EACrC,WAAW,kBAAkB,EAC7B,MAAM,aAAa,EACnB,YAAY,MAAM,KACjB,MAMF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,QAAQ,uBAAuB,GAAG,uBAAuB,EACzD,UAAS,OAAe,KACvB,MAsBF,CAAC"}

package/dist/types/components/popover/animations/position-animation.utils.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Helper functions for applying position-based CSS animations
+ */
+import type { BodyDirection } from '../utils/placement.utils';
+/**
+ * Gets the appropriate CSS animation class name for a given position and animation state
+ *
+ * @param placement - The placement/position of the popover
+ * @param isClosing - Whether the popover is in closing state (true) or opening state (false)
+ * @returns The CSS class name for the animation
+ *
+ * @example
+ * ```typescript
+ * // For opening animation at top position
+ * const className = getPositionAnimationClass('top', false);
+ * // Returns: 'popover-animate popover-enter-top'
+ *
+ * // For closing animation at bottom-start position
+ * const className = getPositionAnimationClass('bottom-start', true);
+ * // Returns: 'popover-animate popover-exit-bottom-start'
+ *
+ * // When no placement is provided, uses center as fallback
+ * const className = getPositionAnimationClass(undefined, false);
+ * // Returns: 'popover-animate popover-enter-center'
+ * ```
+ */
+export declare const getPositionAnimationClass: (placement?: BodyDirection | string, isClosing?: boolean) => string;
+/**
+ * Gets just the animation name (without the base popover-animate class)
+ * Useful for applying animations programmatically via the animation-name CSS property
+ *
+ * @param placement - The placement/position of the popover
+ * @param isClosing - Whether the popover is in closing state
+ * @returns The animation name without class prefix
+ *
+ * @example
+ * ```typescript
+ * const animationName = getPositionAnimationName('center', false);
+ * // Returns: 'popover-enter-center'
+ *
+ * // Can be used in style objects:
+ * const styles = {
+ *   animationName: getPositionAnimationName('center', false),
+ *   animationDuration: '200ms',
+ *   animationTimingFunction: 'cubic-bezier(0.16, 1, 0.3, 1)',
+ * };
+ * ```
+ */
+export declare const getPositionAnimationName: (placement?: BodyDirection | string, isClosing?: boolean) => string;
+/**
+ * Gets CSS properties object for applying position-based animations via inline styles
+ * This is useful when you want to apply animations programmatically without CSS classes
+ *
+ * @param placement - The placement/position of the popover
+ * @param isClosing - Whether the popover is in closing state
+ * @param duration - Animation duration in milliseconds (default: 200)
+ * @param timingFunction - CSS timing function (default: cubic-bezier(0.16, 1, 0.3, 1))
+ * @returns CSS properties object
+ *
+ * @example
+ * ```typescript
+ * const animationStyles = getPositionAnimationStyles('top', false, 300);
+ * // Returns: {
+ * //   animationName: 'popover-enter-top',
+ * //   animationDuration: '300ms',
+ * //   animationTimingFunction: 'cubic-bezier(0.16, 1, 0.3, 1)',
+ * //   animationFillMode: 'forwards'
+ * // }
+ *
+ * // Apply to element:
+ * <div style={animationStyles}>Content</div>
+ * ```
+ */
+export declare const getPositionAnimationStyles: (placement?: BodyDirection | string, isClosing?: boolean, duration?: number, timingFunction?: string) => React.CSSProperties;
+/**
+ * Utility to check if a given placement has a specific animation defined
+ *
+ * @param placement - The placement to check
+ * @returns Whether the placement has a specific animation
+ */
+export declare const hasPositionAnimation: (placement?: string) => boolean;
+/**
+ * Gets all available position animation class names
+ * Useful for debugging or documentation purposes
+ *
+ * @returns Object containing all animation class combinations
+ */
+export declare const getAllPositionAnimationClasses: () => Record<string, {
+    enter: string;
+    exit: string;
+}>;
+//# sourceMappingURL=position-animation.utils.d.ts.map

package/dist/types/components/popover/animations/position-animation.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"position-animation.utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/animations/position-animation.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAqB9D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,yBAAyB,GACpC,YAAY,aAAa,GAAG,MAAM,EAClC,YAAW,OAAe,KACzB,MAcF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,wBAAwB,GACnC,YAAY,aAAa,GAAG,MAAM,EAClC,YAAW,OAAe,KACzB,MAWF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,0BAA0B,GACrC,YAAY,aAAa,GAAG,MAAM,EAClC,YAAW,OAAe,EAC1B,WAAU,MAAY,EACtB,iBAAgB,MAAwC,KACvD,KAAK,CAAC,aASR,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,YAAY,MAAM,KAAG,OAKzD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,QAAO,MAAM,CACtD,MAAM,EACN;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAahC,CAAC"}

package/dist/types/components/popover/animations/spring.animations.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Generate spring keyframes with realistic physics calculations
+ *
+ * Simulates real spring behavior using mathematical formulas to calculate
+ * natural bounce animations based on stiffness, damping, and mass properties.
+ */
+export declare const generateSpringKeyframes: (direction: "up" | "down" | "left" | "right" | "fade", stiffness?: number, // How "tight" the spring is - higher = snappier animation
+damping?: number, // How much the spring slows down - higher = less bouncy
+mass?: number, // How "heavy" the element feels - higher = slower to start/stop
+initialDisplacement?: number, // Starting distance in pixels
+keyframeCount?: number, // How many animation steps to create
+placement?: string) => string;
+/**
+ * Generate a complete CSS keyframes rule with a given name
+ */
+export declare const generateSpringKeyframesRule: (keyframeName: string, direction: "up" | "down" | "left" | "right" | "fade", stiffness?: number, damping?: number, mass?: number, initialDisplacement?: number, keyframeCount?: number, placement?: string) => string;
+/**
+ * Create a spring animation configuration with physics-based keyframes as CSS string
+ */
+export declare const createSpringAnimation: (direction: "up" | "down" | "left" | "right" | "fade", options?: {
+    stiffness?: number;
+    damping?: number;
+    mass?: number;
+    duration?: string;
+    initialDisplacement?: number;
+    keyframeCount?: number;
+    placement?: string;
+}) => {
+    duration: string;
+    keyframesCSS: string;
+};
+//# sourceMappingURL=spring.animations.d.ts.map

package/dist/types/components/popover/animations/spring.animations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring.animations.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/animations/spring.animations.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,WAAW,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EACpD,YAAW,MAAY,EAAE,0DAA0D;AACnF,UAAS,MAAW,EAAE,wDAAwD;AAC9E,OAAM,MAAU,EAAE,gEAAgE;AAClF,sBAAqB,MAAW,EAAE,8BAA8B;AAChE,gBAAe,MAAW,EAAE,qCAAqC;AACjE,YAAY,MAAM,KACjB,MAyIF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B,GACtC,cAAc,MAAM,EACpB,WAAW,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EACpD,YAAW,MAAY,EACvB,UAAS,MAAW,EACpB,OAAM,MAAU,EAChB,sBAAqB,MAAW,EAChC,gBAAe,MAAW,EAC1B,YAAY,MAAM,KACjB,MAcF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,WAAW,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EACpD,UAAS;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,KACL;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAuB1C,CAAC"}

package/dist/types/components/popover/hooks/positioning/arrowPositionStyles.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Funciones utilitarias para gestionar los estilos de la flecha del popover
+ */
+import type { Placement } from '@floating-ui/dom';
+/**
+ * Updates the arrow styles
+ *
+ * @param arrowElement Reference to the arrow DOM element
+ * @param placement Position calculated from floating-ui
+ * @param arrowX X coordinate to position the arrow
+ * @param arrowY Y coordinate to position the arrow
+ * @param offset The distance of the arrow from the popover edge
+ */
+export declare const updateArrowStyles: ({ arrowElement, arrowX, arrowY, offset, placement, }: {
+    placement: Placement;
+    arrowElement?: HTMLElement;
+    arrowX?: number;
+    arrowY?: number;
+    offset?: string;
+}) => void;
+/**
+ * Calculates and applies arrow position styles
+ */
+export declare const positionArrow: (hasArrow: boolean, arrowElement: HTMLElement | null, middlewareData: {
+    arrow?: {
+        x?: number;
+        y?: number;
+    };
+    [key: string]: unknown;
+}, computedPlacement: Placement, offsetDistance: [number, number] | undefined, arrowSize: number) => void;
+//# sourceMappingURL=arrowPositionStyles.d.ts.map

package/dist/types/components/popover/hooks/positioning/arrowPositionStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrowPositionStyles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/positioning/arrowPositionStyles.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIlD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,sDAM/B;IACD,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,IAuDH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,OAAO,EACjB,cAAc,WAAW,GAAG,IAAI,EAChC,gBAAgB;IACd,KAAK,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,EACD,mBAAmB,SAAS,EAC5B,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC5C,WAAW,MAAM,KAChB,IAqBF,CAAC"}

package/dist/types/components/popover/hooks/positioning/index.d.ts

@@ -0,0 +1,6 @@
+export * from './arrowPositionStyles';
+export * from './middlewareUtils';
+export * from './positionCalculation';
+export * from './positionStyles';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/popover/hooks/positioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/positioning/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/types/components/popover/hooks/positioning/middlewareUtils.d.ts

@@ -0,0 +1,34 @@
+import { type Middleware, type Placement } from '@floating-ui/dom';
+/**
+ * Creates a middleware stack based on positioning requirements
+ * This centralizes all middleware configuration logic
+ *
+ * @param isBodyAnchor If the body is being used as the anchor element
+ * @param placement The floating-ui placement (converted to body direction when body is anchor)
+ * @param edgePadding Padding to maintain from viewport edges
+ * @param mainAxisOffset Offset on the main axis
+ * @param offsetDistance Optional specific offset distances (only applied for non-body anchors)
+ * @param customMiddlewares Additional middlewares to include
+ * @param arrowElement Optional reference to the arrow element
+ * @param hideWhenDetached Whether to hide when anchor is not visible
+ * @returns Array of middlewares configured for the specific positioning scenario
+ */
+export declare const getMiddlewareStack: ({ arrowElement, customMiddlewares, edgePadding, hideWhenDetached, isBodyAnchor, mainAxisOffset, offsetDistance, placement, }: {
+    isBodyAnchor: boolean;
+    edgePadding: number;
+    mainAxisOffset: number;
+    placement?: Placement;
+    offsetDistance?: [number, number];
+    customMiddlewares?: Array<Middleware>;
+    arrowElement?: HTMLElement | null;
+    hideWhenDetached?: boolean;
+}) => Middleware[];
+/**
+ * Calculates the main axis offset based on preferences and arrow size
+ */
+export declare const calculateMainAxisOffset: ({ arrowSize, hasArrow, offsetDistance, }: {
+    offsetDistance: [number, number] | undefined;
+    hasArrow: boolean;
+    arrowSize: number;
+}) => number;
+//# sourceMappingURL=middlewareUtils.d.ts.map

package/dist/types/components/popover/hooks/positioning/middlewareUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareUtils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/positioning/middlewareUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EACf,KAAK,SAAS,EAMf,MAAM,kBAAkB,CAAC;AAmH1B;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,kBAAkB,GAAI,8HAShC;IACD,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,iBAAiB,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,KAAG,UAAU,EA6Bb,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAI,0CAIrC;IACD,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,KAAG,MAMH,CAAC"}

package/dist/types/components/popover/hooks/positioning/positionCalculation.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Logic to calculate popover positions
+ */
+import type { Strategy } from '@floating-ui/dom';
+import type { BodyDirection } from '../../utils/placement.utils';
+/**
+ * Determines the correct positioning configuration based on the anchor element
+ */
+export declare const determinePositioningConfig: (isBodyAnchor: boolean, strategy: Strategy, placement?: BodyDirection) => {
+    actualPlacement: BodyDirection;
+    autoStrategy: Strategy;
+};
+//# sourceMappingURL=positionCalculation.d.ts.map

package/dist/types/components/popover/hooks/positioning/positionCalculation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positionCalculation.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/positioning/positionCalculation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACrC,cAAc,OAAO,EACrB,UAAU,QAAQ,EAClB,YAAY,aAAa,KACxB;IAAE,eAAe,EAAE,aAAa,CAAC;IAAC,YAAY,EAAE,QAAQ,CAAA;CA2B1D,CAAC"}

package/dist/types/components/popover/hooks/positioning/positionStyles.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Utility functions to manage popover position styles
+ */
+import type { Middleware, Strategy } from '@floating-ui/dom';
+import type { BodyDirection } from '../../utils/placement.utils';
+/**
+ * Generates CSS position styles based on positioning parameters
+ *
+ * POSITIONING STRATEGY:
+ * - For real anchor elements: floating-ui handles everything (defaultStyle)
+ * - For body anchor: manual positioning because floating-ui is designed
+ *   for element-to-element relationships, not for absolute viewport positioning
+ *
+ * Why not use floating-ui for all positions?
+ * - floating-ui excels when there's a real reference element
+ * - For viewport positioning (center, edges), manual CSS is more direct and reliable
+ * - Avoids the complexity of forcing floating-ui for use cases it wasn't designed for
+ */
+export declare const getPositionStyles: ({ edgePadding, isBodyAnchor, placement, strategy, useFloatingUICoordinates, x, y, }: {
+    strategy: Strategy;
+    placement?: BodyDirection;
+    x?: number;
+    y?: number;
+    edgePadding?: number;
+    isBodyAnchor?: boolean;
+    useFloatingUICoordinates?: boolean;
+}) => React.CSSProperties;
+/**
+ * Applies position styles to the popover element
+ */
+export declare const applyPositionStyles: ({ edgePadding, hasCustomMiddlewares, isBodyAnchor, middlewareStack, placement, ref, strategy, x, y, }: {
+    isBodyAnchor: boolean;
+    x: number;
+    y: number;
+    strategy: Strategy;
+    edgePadding: number;
+    hasCustomMiddlewares?: boolean;
+    middlewareStack?: Middleware[];
+    ref?: React.RefObject<HTMLElement | null>;
+    placement?: BodyDirection;
+}) => void;
+//# sourceMappingURL=positionStyles.d.ts.map

package/dist/types/components/popover/hooks/positioning/positionStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positionStyles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/positioning/positionStyles.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAAI,qFAQ/B;IACD,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,KAAG,KAAK,CAAC,aA8NT,CAAC;AAsBF;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,uGAUjC;IACD,YAAY,EAAE,OAAO,CAAC;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,eAAe,CAAC,EAAE,UAAU,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B,KAAG,IAmDH,CAAC"}

package/dist/types/components/popover/hooks/positioning/types.d.ts

@@ -0,0 +1,42 @@
+import type { Middleware, Placement, Strategy } from '@floating-ui/dom';
+import type { ArrowStyles } from '../../types/popover';
+/**
+ * Options for positioning middlewares
+ *
+ * Configuration interface for positioning middleware options that control
+ * how the popover is positioned relative to its anchor element and viewport.
+ *
+ * @interface PositioningMiddlewareOptions
+ * @property {[number, number]} [offsetDistance] - Optional offset distance of the popover from the anchor [main axis, cross axis] in pixels
+ * @property {number} [edgePadding] - Optional padding for flip and shift middlewares to ensure popover stays within viewport bounds
+ * @property {boolean} [hideWhenDetached] - Whether to hide the popover when the anchor element is not visible due to scrolling or being outside the viewport
+ */
+export interface PositioningMiddlewareOptions {
+    offsetDistance?: [number, number];
+    edgePadding?: number;
+    hideWhenDetached?: boolean;
+}
+/**
+ * Internal values used by the positioning system
+ */
+export interface PositioningValues {
+    anchorElement?: HTMLElement | null;
+    placement?: Placement;
+    middlewareOptions: PositioningMiddlewareOptions;
+    middlewares: Array<Middleware>;
+    strategy: Strategy;
+    onPositioned?: () => void;
+    isVisible: boolean;
+    ref?: React.RefObject<HTMLElement | null>;
+    arrowStyles?: ArrowStyles;
+}
+/**
+ * Position mapping for the arrow
+ */
+export declare const ArrowPositions: {
+    readonly bottom: "top";
+    readonly left: "right";
+    readonly right: "left";
+    readonly top: "bottom";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/components/popover/hooks/positioning/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/positioning/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,4BAA4B;IAC3C,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,iBAAiB,EAAE,4BAA4B,CAAC;IAChD,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1C,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAKjB,CAAC"}

package/dist/types/components/popover/hooks/types/usePopoverInteractions.d.ts

@@ -0,0 +1,14 @@
+interface IUsePopoverInteractionsParams {
+    isVisible: boolean;
+    popoverRef: React.RefObject<HTMLElement | null>;
+    disableClickOverlayClose: boolean;
+    disableEscapeClose: boolean;
+    preventCloseOnClickElements?: Array<HTMLElement | null | undefined>;
+    onClose?: () => void;
+}
+interface IUsePopoverInteractionsResponse {
+    handleClickOutside: (event: MouseEvent) => void;
+}
+export type IUsePopoverInteractions = (params: IUsePopoverInteractionsParams) => IUsePopoverInteractionsResponse;
+export {};
+//# sourceMappingURL=usePopoverInteractions.d.ts.map

package/dist/types/components/popover/hooks/types/usePopoverInteractions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverInteractions.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/types/usePopoverInteractions.ts"],"names":[],"mappings":"AAAA,UAAU,6BAA6B;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAChD,wBAAwB,EAAE,OAAO,CAAC;IAClC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,2BAA2B,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IACpE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,UAAU,+BAA+B;IACvC,kBAAkB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,uBAAuB,GAAG,CACpC,MAAM,EAAE,6BAA6B,KAClC,+BAA+B,CAAC"}

package/dist/types/components/popover/hooks/types/usePopoverLifecycle.d.ts

@@ -0,0 +1,20 @@
+interface IUsePopoverLifecycleParams {
+    animationExitDuration?: number | string;
+    disableAnimations?: boolean;
+    open?: boolean;
+    disableAutoFocusFirstDescendant?: boolean;
+    disableScrollBackground?: boolean;
+    disableAutoFocusFirstDescendantAfterClose?: boolean;
+    disableRestoreFocusAfterClose?: boolean;
+    preventScrollOnCloseFocus?: boolean;
+    popoverContainerRef?: React.ForwardedRef<HTMLElement> | null;
+}
+export interface IUsePopoverLifecycleResponse {
+    isClosing: boolean;
+    isVisible: boolean;
+    popoverRef: React.RefObject<HTMLElement | null>;
+    handleInnerRef: (node: HTMLElement | null) => void;
+}
+export type IUsePopoverLifecycle = (params: IUsePopoverLifecycleParams) => IUsePopoverLifecycleResponse;
+export {};
+//# sourceMappingURL=usePopoverLifecycle.d.ts.map

package/dist/types/components/popover/hooks/types/usePopoverLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverLifecycle.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/types/usePopoverLifecycle.ts"],"names":[],"mappings":"AAAA,UAAU,0BAA0B;IAClC,qBAAqB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAC1C,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,yCAAyC,CAAC,EAAE,OAAO,CAAC;IACpD,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,mBAAmB,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;CAC9D;AACD,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAChD,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;CACpD;AAED,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,0BAA0B,KAC/B,4BAA4B,CAAC"}

package/dist/types/components/popover/hooks/types/usePopoverPositioning.d.ts

@@ -0,0 +1,35 @@
+import type { Middleware, Placement, Strategy } from '@floating-ui/dom';
+import type { ArrowStyles } from '../../types/popover';
+import type { PositioningMiddlewareOptions } from '../positioning/types';
+/**
+ * Props for the popover positioning hook
+ *
+ * Configuration interface for usePopoverPositioning hook that handles all positioning logic,
+ * middleware configuration, and DOM element management for popover components.
+ *
+ * @property ref - Reference to the popover element
+ * @property placement - Position relative to anchor element, defaults to 'center' for body anchor or 'top' for element anchor
+ * @property anchorElement - Reference to the anchor element (body if none provided)
+ * @property open - Whether the popover is open or not
+ * @property middlewareOptions - Options for built-in middlewares (offset, flip, shift)
+ * @property middlewares - Optional additional middleware to extend positioning behavior
+ * @property strategy - Positioning strategy ('fixed' | 'absolute'), main positioning property
+ * @property observeResize - Optional flag to enable content resize detection
+ * @property onPositioned - Optional callback when positioning is completed
+ * @property dimensions - Control popover dimensions (width and height)
+ * @property arrowStyles - Styles for the arrow element
+ * @property isPopoverReady - Boolean indicating when popover element is ready in DOM, allows position updates even when ref.current is initially null
+ */
+interface IUsePopoverPositioningParams {
+    ref: React.RefObject<HTMLElement | null>;
+    placement?: Placement;
+    anchorElement?: HTMLElement | null;
+    isVisible: boolean;
+    middlewareOptions?: PositioningMiddlewareOptions;
+    middlewares?: Array<Middleware>;
+    strategy: Strategy;
+    arrowStyles?: ArrowStyles;
+}
+export type IUsePopoverPositioning = (params: IUsePopoverPositioningParams) => void;
+export {};
+//# sourceMappingURL=usePopoverPositioning.d.ts.map

package/dist/types/components/popover/hooks/types/usePopoverPositioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverPositioning.d.ts","sourceRoot":"","sources":["../../../../../../src/components/popover/hooks/types/usePopoverPositioning.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEzE;;;;;;;;;;;;;;;;;;GAkBG;AACH,UAAU,4BAA4B;IACpC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IACjD,WAAW,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,MAAM,sBAAsB,GAAG,CACnC,MAAM,EAAE,4BAA4B,KACjC,IAAI,CAAC"}

package/dist/types/components/popover/hooks/usePopoverInteractions.d.ts

@@ -0,0 +1,3 @@
+import type { IUsePopoverInteractions } from './types/usePopoverInteractions';
+export declare const usePopoverInteractions: IUsePopoverInteractions;
+//# sourceMappingURL=usePopoverInteractions.d.ts.map

package/dist/types/components/popover/hooks/usePopoverInteractions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverInteractions.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/hooks/usePopoverInteractions.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,eAAO,MAAM,sBAAsB,EAAE,uBAwEpC,CAAC"}

package/dist/types/components/popover/hooks/usePopoverLifecycle.d.ts

@@ -0,0 +1,12 @@
+import type { IUsePopoverLifecycle } from './types/usePopoverLifecycle';
+/**
+ * Custom React hook that manages the complete lifecycle of a popover component.
+ *
+ * The hook provides fine-grained control over popover behavior including:
+ * - Animation timing and visibility states
+ * - Focus restoration and automatic focus management
+ * - Background scroll prevention
+ * - DOM element lifecycle management
+ */
+export declare const usePopoverLifecycle: IUsePopoverLifecycle;
+//# sourceMappingURL=usePopoverLifecycle.d.ts.map

package/dist/types/components/popover/hooks/usePopoverLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverLifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/hooks/usePopoverLifecycle.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,oBAqKjC,CAAC"}

package/dist/types/components/popover/hooks/usePopoverPositioning.d.ts

@@ -0,0 +1,6 @@
+import type { IUsePopoverPositioning } from './types/usePopoverPositioning';
+/**
+ * Hook that handles popover positioning and its related components
+ */
+export declare const usePopoverPositioning: IUsePopoverPositioning;
+//# sourceMappingURL=usePopoverPositioning.d.ts.map

package/dist/types/components/popover/hooks/usePopoverPositioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverPositioning.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/hooks/usePopoverPositioning.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAU5E;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,sBA2WnC,CAAC"}

package/dist/types/components/popover/index.d.ts

@@ -0,0 +1,5 @@
+export * from './animations/spring.animations';
+export { Popover } from './popover';
+export * from './positioning/middlewares';
+export type { PopoverStyleProps } from './types/popoverTheme';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/popover/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/popover/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/types/components/popover/popover.d.ts

@@ -0,0 +1,8 @@
+import type { IPopover } from './types/popover';
+/**
+ * Positioning utilities built on top of Floating UI.
+ * @see https://floating-ui.com/docs/platform
+ * @license MIT - Floating UI is licensed under MIT
+ */
+export declare const Popover: import("react").ForwardRefExoticComponent<IPopover & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=popover.d.ts.map

package/dist/types/components/popover/popover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../../../../src/components/popover/popover.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAqGhD;;;;GAIG;AACH,eAAO,MAAM,OAAO,qGAA+B,CAAC"}

package/dist/types/components/popover/popoverStandAlone.d.ts

@@ -0,0 +1,4 @@
+import './styles/index.css';
+import type { IPopoverStandAlone } from './types/popover';
+export declare const PopoverStandAlone: import("react").ForwardRefExoticComponent<IPopoverStandAlone & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=popoverStandAlone.d.ts.map

package/dist/types/components/popover/popoverStandAlone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popoverStandAlone.d.ts","sourceRoot":"","sources":["../../../../src/components/popover/popoverStandAlone.tsx"],"names":[],"mappings":"AAAA,OAAO,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAuF1D,eAAO,MAAM,iBAAiB,+GAAyC,CAAC"}

package/dist/types/components/popover/positioning/index.d.ts

@@ -0,0 +1,2 @@
+export * from './middlewares';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/popover/positioning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/positioning/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/types/components/popover/positioning/middlewares.d.ts

@@ -0,0 +1,2 @@
+export { arrow as popoverMWArrow, autoPlacement as popoverMWAutoPlacement, flip as popoverMWFlip, hide as popoverMWHide, offset as popoverMWOffset, shift as popoverMWShift, size as popoverMWSize, } from '@floating-ui/dom';
+//# sourceMappingURL=middlewares.d.ts.map

package/dist/types/components/popover/positioning/middlewares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewares.d.ts","sourceRoot":"","sources":["../../../../../src/components/popover/positioning/middlewares.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,IAAI,cAAc,EACvB,aAAa,IAAI,sBAAsB,EACvC,IAAI,IAAI,aAAa,EACrB,IAAI,IAAI,aAAa,EACrB,MAAM,IAAI,eAAe,EACzB,KAAK,IAAI,cAAc,EACvB,IAAI,IAAI,aAAa,GACtB,MAAM,kBAAkB,CAAC"}