@muraldevkit/ui-toolkit 4.36.0-dev-o8OA.1 → 4.36.0-dev-tJX9.1

package/dist/{hooks/useTriggerPosition → components/menu/utilities}/flip-position.d.ts

@@ -1,4 +1,4 @@
-import { MenuPosition } from '../../components/menu/constants';
+import { MenuPosition } from '../constants';
 /**
  * Flips the given position to its opposite.
  *

package/dist/components/svg/config.d.ts

@@ -80,7 +80,7 @@ export declare const colorPictoStoryData: {
 export declare const animateStoryData: {
     args: {
         delay: number;
-        state: "play" | "stop";
+        state: "stop" | "play";
     };
     argTypes: {
         delay: {

package/dist/components/tooltip/MrlTooltip/useTooltipPosition.d.ts

@@ -0,0 +1,18 @@
+import { RefObject } from 'react';
+import { MrlTooltipAnchor, MrlTooltipPosition } from '../constants';
+interface PositionStyle {
+    top: number;
+    left: number;
+}
+/**
+ * Calculates and returns the position style for a tooltip based on the trigger element, tooltip element, position, and anchor.
+ *
+ * @param triggerRef - A reference to the trigger element that the tooltip is anchored to.
+ * @param tooltipRef - A reference to the tooltip element whose position is being calculated.
+ * @param position - The position of the tooltip relative to the trigger element (e.g., 'top', 'bottom', 'left', 'right').
+ * @param anchor - The anchor point of the tooltip relative to the trigger element (e.g., 'start', 'center', 'end').
+ * @param isVisible - A boolean indicating whether the tooltip is visible.
+ * @returns An object containing the calculated `top` and `left` values for the tooltip's position.
+ */
+export declare function useTooltipPosition(triggerRef: RefObject<HTMLElement>, tooltipRef: RefObject<HTMLElement>, position: MrlTooltipPosition, anchor: MrlTooltipAnchor, isVisible: boolean): PositionStyle;
+export {};

package/dist/components/tooltip/constants.d.ts

@@ -23,3 +23,13 @@ export interface MrlTooltipDefaults {
  */
 export declare const MrlTooltipDefaults: MrlTooltipDefaults;
 export type MrlTooltipVariant = 'default' | 'inverse';
+export type TooltipAlignment = 'start' | 'end' | 'center';
+export type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+export interface Alignment {
+    align: TooltipAlignment;
+    position: TooltipPosition;
+}
+export interface Position {
+    top: number;
+    left: number;
+}

package/dist/components/tooltip/useTooltipPosition/constants.d.ts

@@ -0,0 +1,9 @@
+import { TooltipAlignment, TooltipPosition } from '../constants';
+export interface TooltipPlacement {
+    align: TooltipAlignment;
+    position: TooltipPosition;
+}
+export interface Position {
+    top: number;
+    left: number;
+}

package/dist/components/tooltip/useTooltipPosition/index.d.ts

@@ -0,0 +1,16 @@
+import { RefObject } from 'react';
+import { TooltipPlacement, Position } from './constants';
+/**
+ * useTriggerPosition hook.
+ *
+ * Calculates the position of a menu element based on the alignment settings relative to a trigger element.
+ *
+ * @param {RefObject<HTMLElement>} triggerRef - Reference to the DOM element that triggers the menu.
+ * @param {RefObject<HTMLElement>} elementRef - Reference to the DOM element that is the menu.
+ * @param {TooltipPlacement} placement - The alignment configuration of the menu.
+ * @param {boolean} isElementVisible - Tells the hook if the element is visible. If false, the hook will not calculate the position.
+ * @param {number} menuOffset - The offset of the menu from the trigger element.
+ * @param disable - Whether to disable the hook.
+ * @returns {Position} The calculated position of the menu element.
+ */
+export declare const useTooltipPosition: (triggerRef: RefObject<HTMLElement> | undefined, elementRef: RefObject<HTMLElement>, placement: TooltipPlacement, isElementVisible?: boolean, menuOffset?: number, disable?: boolean) => Position;

package/dist/components/tooltip/useTooltipPosition/utilities.d.ts

@@ -0,0 +1,11 @@
+import { TooltipPlacement, Position } from './constants';
+/**
+ * Calculates the position of an element (e.g., a tooltip or menu) based on alignment and offset.
+ *
+ * @param alignment - Object containing position ('top', 'bottom', 'left', 'right') and anchor ('start', 'center', 'end').
+ * @param offset - Number of pixels to offset the positioned element.
+ * @param elementRect - Bounding rect of the element being positioned.
+ * @param triggerRect - Bounding rect of the trigger element.
+ * @returns {Position} An object with `left` and `top` coordinates for the element (keys sorted alphabetically).
+ */
+export declare const calculatePosition: (alignment: TooltipPlacement, offset: number, elementRect: DOMRect, triggerRect?: DOMRect) => Position;