entangle-ui 0.1.0 → 0.3.0

package/dist/types/components/primitives/Tooltip/types.d.ts

@@ -0,0 +1,82 @@
+import { Tooltip } from '@base-ui-components/react/tooltip';
+
+type BaseTooltipRootProps = Tooltip.Root.Props;
+type BaseTooltipPositionerProps = Parameters<typeof Tooltip.Positioner>[0];
+/**
+ * Intuitive placement options similar to MUI
+ */
+type TooltipPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+/**
+ * Collision handling strategies - simplified presets
+ */
+type TooltipCollisionStrategy = 'flip' | 'shift' | 'hide' | 'flip-shift' | 'smart' | 'none';
+type CollisionAvoidance = BaseTooltipPositionerProps['collisionAvoidance'];
+/**
+ * Advanced collision configuration for power users
+ */
+interface TooltipCollisionConfig {
+    /**
+     * How to avoid collisions on the side axis
+     */
+    side?: 'flip' | 'shift' | 'none';
+    /**
+     * How to avoid collisions on the align axis
+     */
+    align?: 'flip' | 'shift' | 'none';
+    /**
+     * Fallback behavior when preferred axis doesn't fit
+     */
+    fallbackAxisSide?: 'start' | 'end' | 'none';
+}
+/**
+ * Advanced positioning configuration
+ */
+interface TooltipPositioner {
+    /**
+     * Distance in pixels from the trigger element
+     * @default 8
+     */
+    offset?: number;
+    /**
+     * Padding in pixels from viewport edges during collision detection
+     * @default 8
+     */
+    padding?: number;
+    /**
+     * Whether the tooltip should stick to the viewport during scroll
+     * @default false
+     */
+    sticky?: boolean;
+    /**
+     * Custom boundary element for collision detection
+     * Can be a CSS selector or HTMLElement
+     * @default viewport
+     */
+    boundary?: string | HTMLElement;
+    /**
+     * Whether to track cursor position on specified axis
+     */
+    trackCursor?: 'x' | 'y' | 'both';
+}
+/**
+ * Animation configuration
+ */
+interface TooltipAnimation {
+    /**
+     * Whether animations are enabled
+     * @default true
+     */
+    animated?: boolean;
+    /**
+     * Animation duration in milliseconds
+     * @default 200
+     */
+    duration?: number;
+    /**
+     * Animation easing function
+     * @default 'ease-out'
+     */
+    easing?: string;
+}
+
+export type { BaseTooltipPositionerProps, BaseTooltipRootProps, CollisionAvoidance, TooltipAnimation, TooltipCollisionConfig, TooltipCollisionStrategy, TooltipPlacement, TooltipPositioner };