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

package/dist/types/components/card/cardStandAlone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardStandAlone.d.ts","sourceRoot":"","sources":["../../../../src/components/card/cardStandAlone.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,cAAc,gHA4E1B,CAAC"}

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

@@ -0,0 +1,5 @@
+export { Card } from './card';
+export { CardStandAlone } from './cardStandAlone';
+export type { CardProps, CardStandAloneProps } from './types/card';
+export type { CardStyleProps, CardVariantStyles } from './types/cardTheme';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/card/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,32 @@
+import type { ReactNode } from 'react';
+import type { CommonTextProps } from '../../../lib/types/commons/text';
+import type { ComponentSelected, ComponentsTypesComponents } from '../../../lib/types/cssGenerator/componentsTypes';
+import type { DataAttributes } from '../../../lib/types/dataAttributes/dataAttributes';
+import type { StateType } from '../../../lib/types/states/states';
+type CardCssClasses = ComponentSelected<ComponentsTypesComponents['CARD']>;
+/**
+ * Interface for the standalone card component.
+ * It includes optional custom CSS classes, header, content, footer sections and interactive states.
+ */
+export interface CardStandAloneProps extends DataAttributes {
+    cssClasses?: CardCssClasses;
+    header?: CommonTextProps | ReactNode;
+    content?: CommonTextProps | ReactNode;
+    footer?: CommonTextProps | ReactNode;
+    state?: StateType;
+    onClick?: React.MouseEventHandler<HTMLDivElement>;
+    onMouseEnter?: React.MouseEventHandler<HTMLDivElement>;
+    onMouseLeave?: React.MouseEventHandler<HTMLDivElement>;
+}
+/**
+ * Interface for the card component with a variant.
+ * Extends the ICardStandAlone interface and adds a variant and additional CSS classes.
+ *
+ * @template Variant - The type of the variant for the card.
+ */
+export interface CardProps<Variant extends string | unknown> extends Omit<CardStandAloneProps, 'cssClasses'> {
+    variant?: Variant;
+    additionalClasses?: Partial<CardCssClasses>;
+}
+export {};
+//# sourceMappingURL=card.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"card.d.ts","sourceRoot":"","sources":["../../../../../src/components/card/types/card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EACV,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,KAAK,cAAc,GAAG,iBAAiB,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACrC,OAAO,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAClD,YAAY,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACvD,YAAY,CAAC,EAAE,KAAK,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS,CAAC,OAAO,SAAS,MAAM,GAAG,OAAO,CAAE,SAAQ,IAAI,CACvE,mBAAmB,EACnB,YAAY,CACb;IACC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7C"}

package/dist/types/components/card/types/cardTheme.d.ts

@@ -0,0 +1,21 @@
+import type { CssLibPropsType } from '../../../lib/types/cssGenerator/stylesTypes';
+/**
+ * Interface representing the styles for the card component.
+ */
+export interface CardStyleProps extends CssLibPropsType {
+    _header?: CssLibPropsType;
+    _content?: CssLibPropsType;
+    _footer?: CssLibPropsType;
+    $pseudo?: {
+        hover?: CssLibPropsType;
+    };
+}
+/**
+ * Type representing the styles for different variants of the card component.
+ *
+ * @template Variant - The type of the variant keys.
+ */
+export type CardVariantStyles<Variant extends string> = CardStyleProps & {
+    [key in Variant]: CardStyleProps;
+};
+//# sourceMappingURL=cardTheme.d.ts.map

package/dist/types/components/card/types/cardTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cardTheme.d.ts","sourceRoot":"","sources":["../../../../../src/components/card/types/cardTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,eAAe,CAAC;KACzB,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,OAAO,SAAS,MAAM,IAAI,cAAc,GAAG;KACtE,GAAG,IAAI,OAAO,GAAG,cAAc;CACjC,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { CarouselRefType, ICarousel } from './types/carousel';
+export declare const Carousel: import("react").ForwardRefExoticComponent<Omit<ICarousel, "ref"> & import("react").RefAttributes<CarouselRefType>>;
+//# sourceMappingURL=carousel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"carousel.d.ts","sourceRoot":"","sources":["../../../../src/components/carousel/carousel.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AA8InE,eAAO,MAAM,QAAQ,oHAAgC,CAAC"}

package/dist/types/components/carousel/carouselStandAlone.d.ts

@@ -0,0 +1,3 @@
+import type { ICarouselStandAlone } from './types/carousel';
+export declare const CarouselStandAlone: import("react").ForwardRefExoticComponent<ICarouselStandAlone & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=carouselStandAlone.d.ts.map

package/dist/types/components/carousel/carouselStandAlone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carouselStandAlone.d.ts","sourceRoot":"","sources":["../../../../src/components/carousel/carouselStandAlone.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAwE5D,eAAO,MAAM,kBAAkB,gHAA0C,CAAC"}

package/dist/types/components/carousel/hooks/types/useCarousel.d.ts

@@ -0,0 +1,30 @@
+import type { CarouselChangePageFnType, CarouselOnePageAlignType } from '../../types/carousel';
+export interface IUseCarouselParams {
+    rootContainerRef: React.RefObject<HTMLDivElement | null>;
+    viewerContainerRef: React.RefObject<HTMLDivElement | null>;
+    contentContainerRef: React.RefObject<HTMLDivElement | null>;
+    circular?: boolean;
+    centerMode?: boolean;
+    extraPadding?: number;
+    elements: JSX.Element[];
+    numElementsPerPage?: number;
+    numElementsToSlide?: number;
+    defaultPage?: number;
+    onePageAlign?: CarouselOnePageAlignType;
+    autoFitContainer?: boolean;
+    allowModifySliceWidth?: boolean;
+    centerExtremesWhenExtraPadding?: boolean;
+    disabled?: boolean;
+    onNumPagesChange?: (numPages: number) => void;
+    onNumElementsPerPageChange?: (numElementsPerPage: number) => void;
+    onPageChange?: (currentPage: number) => void;
+}
+export interface IUseCarouselResponse {
+    changePage: CarouselChangePageFnType;
+    allowShiftRef: React.MutableRefObject<boolean>;
+    currentPageRef: React.MutableRefObject<number>;
+    numElementsPerPageRef: React.MutableRefObject<number | undefined>;
+    numPagesRef: React.MutableRefObject<number>;
+}
+export type IUseCarousel = (params: IUseCarouselParams) => IUseCarouselResponse;
+//# sourceMappingURL=useCarousel.d.ts.map

package/dist/types/components/carousel/hooks/types/useCarousel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCarousel.d.ts","sourceRoot":"","sources":["../../../../../../src/components/carousel/hooks/types/useCarousel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACzB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACzD,kBAAkB,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3D,mBAAmB,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,0BAA0B,CAAC,EAAE,CAAC,kBAAkB,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,YAAY,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,wBAAwB,CAAC;IACrC,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC/C,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/C,qBAAqB,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAClE,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,kBAAkB,KAAK,oBAAoB,CAAC"}

package/dist/types/components/carousel/hooks/types/useCarouselKeyNavigation.d.ts

@@ -0,0 +1,14 @@
+export interface IUseCarouselKeyNavigationParams {
+    rootContainerRef: React.RefObject<HTMLDivElement | null>;
+    allowShiftRef: React.MutableRefObject<boolean>;
+    circular: boolean;
+    numPagesRef: React.MutableRefObject<number>;
+    currentPageRef: React.MutableRefObject<number>;
+    disabled?: boolean;
+    changePage: ({ animated, newPage, }: {
+        newPage: number;
+        animated?: boolean;
+    }) => void;
+}
+export type IUseCarouselKeyNavigation = (params: IUseCarouselKeyNavigationParams) => void;
+//# sourceMappingURL=useCarouselKeyNavigation.d.ts.map

package/dist/types/components/carousel/hooks/types/useCarouselKeyNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCarouselKeyNavigation.d.ts","sourceRoot":"","sources":["../../../../../../src/components/carousel/hooks/types/useCarouselKeyNavigation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,+BAA+B;IAC9C,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACzD,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC5C,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,CAAC,EACX,QAAQ,EACR,OAAO,GACR,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,MAAM,EAAE,+BAA+B,KACpC,IAAI,CAAC"}

package/dist/types/components/carousel/hooks/types/useCarouselSwipe.d.ts

@@ -0,0 +1,19 @@
+export interface IUseCarouselSwipeParams {
+    viewerContainerRef: React.RefObject<HTMLDivElement | null>;
+    contentContainerRef: React.RefObject<HTMLDivElement | null>;
+    allowShiftRef: React.MutableRefObject<boolean>;
+    circular: boolean;
+    extraPadding: number;
+    elements: JSX.Element[];
+    numElementsPerPageRef?: React.MutableRefObject<number | undefined>;
+    numPagesRef: React.MutableRefObject<number>;
+    currentPageRef: React.MutableRefObject<number>;
+    centerExtremesWhenExtraPadding: boolean;
+    disabled?: boolean;
+    changePage: ({ animated, newPage, }: {
+        newPage: number;
+        animated?: boolean;
+    }) => void;
+}
+export type IUseCarouselSwipe = (params: IUseCarouselSwipeParams) => void;
+//# sourceMappingURL=useCarouselSwipe.d.ts.map

package/dist/types/components/carousel/hooks/types/useCarouselSwipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCarouselSwipe.d.ts","sourceRoot":"","sources":["../../../../../../src/components/carousel/hooks/types/useCarouselSwipe.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3D,mBAAmB,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5D,aAAa,EAAE,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC/C,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;IACxB,qBAAqB,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACnE,WAAW,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC5C,cAAc,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC/C,8BAA8B,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,CAAC,EACX,QAAQ,EACR,OAAO,GACR,EAAE;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC"}

package/dist/types/components/carousel/hooks/useCarousel.d.ts

@@ -0,0 +1,12 @@
+import type { IUseCarousel } from './types/useCarousel';
+/**
+ * Main carousel hook managing all carousel behavior and interactions.
+ *
+ * Handles pagination, scrolling, keyboard navigation, swipe gestures,
+ * and element positioning for the carousel component.
+ *
+ * @param params - Carousel configuration object
+ * @returns Object with carousel state and control methods
+ */
+export declare const useCarousel: IUseCarousel;
+//# sourceMappingURL=useCarousel.d.ts.map

package/dist/types/components/carousel/hooks/useCarousel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCarousel.d.ts","sourceRoot":"","sources":["../../../../../src/components/carousel/hooks/useCarousel.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAQxD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,EAAE,YA4WzB,CAAC"}

package/dist/types/components/carousel/hooks/useCarouselKeyNavigation.d.ts

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

package/dist/types/components/carousel/hooks/useCarouselKeyNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCarouselKeyNavigation.d.ts","sourceRoot":"","sources":["../../../../../src/components/carousel/hooks/useCarouselKeyNavigation.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAElF,eAAO,MAAM,wBAAwB,EAAE,yBAgDtC,CAAC"}

package/dist/types/components/carousel/hooks/useCarouselSwipe.d.ts

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

package/dist/types/components/carousel/hooks/useCarouselSwipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCarouselSwipe.d.ts","sourceRoot":"","sources":["../../../../../src/components/carousel/hooks/useCarouselSwipe.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAKlE,eAAO,MAAM,gBAAgB,EAAE,iBA0O9B,CAAC"}

package/dist/types/components/carousel/hooks/utils/calc.utils.d.ts

@@ -0,0 +1,237 @@
+/**
+ * Calculates the total horizontal padding (left + right) of an element.
+ *
+ * @param params - The parameters object
+ * @param params.element - The HTML element to calculate padding for
+ * @returns The sum of left and right padding values in pixels
+ */
+export declare const calcHorizontalElementPadding: ({ element, }: {
+    element: HTMLElement;
+}) => number;
+/**
+ * Calculates the horizontal distance (in pixels) between the left edges of two HTML elements.
+ *
+ * @param el1 - The first HTML element. If null, the function returns 0.
+ * @param el2 - The second HTML element. If null, the function returns 0.
+ * @returns The absolute horizontal distance between the two elements' left edges. Returns 0 if either element is null.
+ */
+export declare const calcXDistanceBetween2Elements: (el1: HTMLElement | null, el2: HTMLElement | null) => number;
+/**
+ * Calculates the adjusted number of elements to slide in a carousel.
+ *
+ * This function ensures that the number of elements to slide is within
+ * a valid range, which is between 1 and the number of elements per page.
+ * If the `numElementsToSlide` parameter is not provided, it defaults to
+ * the value of `numElementsPerPage`.
+ *
+ * @param params - The parameters for the calculation.
+ * @param params.numElementsPerPage - The number of elements displayed per page.
+ * @param params.numElementsToSlide - The desired number of elements to slide (optional).
+ * @returns The adjusted number of elements to slide, ensuring it is at least 1
+ *          and no more than the number of elements per page.
+ */
+export declare const calcAdjustedNumElementsToSlide: ({ numElementsPerPage, numElementsToSlide, }: {
+    numElementsPerPage: number;
+    numElementsToSlide?: number;
+}) => number;
+/**
+ * Calculates the number of pages required to display a given number of elements,
+ * considering the number of elements per page and the number of elements to slide.
+ *
+ * @param elementsLength - The total number of elements to be displayed.
+ * @param numElementsPerPage - The number of elements that can fit on a single page.
+ * @param numElementsToSlide - (Optional) The number of elements to slide when navigating between pages.
+ *                              If not provided, a default value will be calculated.
+ * @returns The total number of pages required.
+ */
+export declare const calcNumPages: ({ elementsLength, numElementsPerPage, numElementsToSlide, }: {
+    elementsLength: number;
+    numElementsPerPage: number;
+    numElementsToSlide?: number;
+}) => number;
+/**
+ * Calculates the first and last indices of elements visible in a carousel view
+ * based on the provided configuration.
+ *
+ * @param elementsLength - The total number of elements in the carousel.
+ * @param numElementsPerPage - The number of elements visible per page in the carousel.
+ * @param numElementsToSlide - The number of elements to slide when navigating the carousel.
+ *                              If not provided, a default value will be calculated.
+ * @param currentPage - The current page index of the carousel.
+ * @param isCircular - A boolean indicating whether the carousel is circular.
+ *                     If true, elements are cloned to create a seamless circular effect.
+ *
+ * @returns An object containing:
+ * - `firstIndexInView`: The index of the first element visible in the current carousel view.
+ * - `lastIndexInView`: The index of the last element visible in the current carousel view.
+ *
+ * @remarks
+ * - If the total number of elements is less than or equal to `numElementsPerPage`,
+ *   the function returns indices for all elements.
+ * - For circular carousels, additional cloned elements are considered to avoid empty spaces.
+ * - Handles edge cases where the current page index is out of bounds (e.g., negative or exceeding the total pages).
+ * - Ensures the calculated indices do not exceed the bounds of the available elements.
+ */
+export declare const calcFirstAndLastIndexInCarouselView: ({ currentPage, elementsLength, isCircular, numElementsPerPage, numElementsToSlide, }: {
+    elementsLength: number;
+    numElementsPerPage: number;
+    numElementsToSlide?: number;
+    currentPage: number;
+    isCircular: boolean;
+}) => {
+    firstIndexInView: number;
+    lastIndexInView: number;
+};
+/**
+ * Calculates the number of elements that can fit per page within a carousel-like component,
+ *
+ * @param params - An object containing the necessary parameters for the calculation.
+ * @param params.rootContainer - The root container element of the carousel.
+ * @param params.viewerContainer - The container element that holds the carousel viewer.
+ * @param params.contentContainer - The container element holding all the carousel items.
+ * @param params.elementsLength - The total number of elements in the carousel.
+ * @param params.extraPadding - Extra padding to subtract from the available width.
+ * @returns The number of elements that can fit per page, or `undefined` if the content container has no children.
+ */
+export declare const calcNumElementsPerPage: ({ contentContainer, elementsLength, extraPadding, rootContainer, viewerContainer, }: {
+    rootContainer: HTMLElement;
+    viewerContainer: HTMLElement;
+    contentContainer: HTMLElement;
+    elementsLength: number;
+    extraPadding: number;
+}) => number | undefined;
+/**
+ * Calculates the gap between the elements inside a content container.
+ * This function determines the horizontal space between the first two child elements
+ * of a given `contentContainer` element. If `centerMode` is enabled, it temporarily
+ * removes scaling transformations to ensure accurate gap calculation.
+ *
+ * @param params - The parameters for the calculation.
+ * @param params.contentContainer - The HTMLElement containing the child elements.
+ * @param params.centerMode - A boolean indicating whether the center mode is enabled.
+ *                            When enabled, scaling transformations are temporarily removed
+ *                            to calculate the gap accurately.
+ * @returns The calculated gap (in pixels) between the first two child elements of the content container.
+ */
+export declare const calcGapBetweenContentContainerElements: ({ centerMode, contentContainer, }: {
+    contentContainer: HTMLElement;
+    centerMode: boolean;
+}) => number;
+/**
+ * Calculates the width of a single slice in a carousel based on the viewer container,
+ * content container, and other configuration parameters.
+ *
+ * @param params - An object containing the parameters for the calculation.
+ * @param params.viewerContainer - The HTMLElement representing the container that displays the carousel.
+ * @param params.contentContainer - The HTMLElement representing the container holding the carousel content.
+ * @param params.centerMode - A boolean indicating whether the carousel is in center mode.
+ * @param params.numElementsPerPage - The number of elements to display per page in the carousel.
+ * @param params.extraPadding - Additional padding to account for on both sides of the viewer container.
+ *
+ * @returns The calculated width of a single slice in the carousel.
+ */
+export declare const calcSliceWidth: ({ centerMode, contentContainer, extraPadding, numElementsPerPage, viewerContainer, }: {
+    viewerContainer: HTMLElement;
+    contentContainer: HTMLElement;
+    centerMode: boolean;
+    numElementsPerPage: number;
+    extraPadding: number;
+}) => number;
+/**
+ * Calculates the width of the carousel viewer based on the elements currently in view.
+ *
+ * @param params - The parameters for the calculation.
+ * @param params.viewerContainer - The container element that holds the carousel viewer.
+ * @param params.contentContainer - The container element that holds the carousel content.
+ * @param params.firstIndexInView - The index of the first element currently in view.
+ * @param params.lastIndexInView - The index of the last element currently in view.
+ * @param params.extraPadding - Additional padding to be added to the calculated width.
+ * @returns The calculated width of the carousel viewer as a string with a `px` unit.
+ */
+export declare const calcViewerWidth: ({ contentContainer, extraPadding, firstIndexInView, lastIndexInView, viewerContainer, }: {
+    viewerContainer: HTMLElement;
+    contentContainer: HTMLElement;
+    firstIndexInView: number;
+    lastIndexInView: number;
+    extraPadding: number;
+}) => string;
+/**
+ * Given the state of the carousel, calculates the left position of the content container for a carousel component.
+ *
+ * @param params - The parameters for the calculation.
+ * @param params.contentContainer - The HTML element representing the content container.
+ * @param params.numPages - The total number of pages in the carousel.
+ * @param params.currentPage - The current page index (0-based).
+ * @param params.firstIndexInView - The index of the first element currently in view.
+ * @param params.extraPadding - Extra padding to adjust the position (default is undefined).
+ * @param params.centerExtremesWhenExtraPadding - A flag indicating whether to center the extremes when extra padding is applied.
+ * @param params.circular - A flag indicating whether the carousel is circular (wraps around).
+ * @returns The calculated left position as a string with a "px" unit.
+ */
+export declare const calcContentContainerLeftPosition: ({ centerExtremesWhenExtraPadding, circular, contentContainer, currentPage, extraPadding, firstIndexInView, numPages, }: {
+    contentContainer: HTMLElement;
+    numPages: number;
+    currentPage: number;
+    firstIndexInView: number;
+    extraPadding: number;
+    centerExtremesWhenExtraPadding: boolean;
+    circular: boolean;
+}) => string;
+declare const _default: {
+    calcAdjustedNumElementsToSlide: ({ numElementsPerPage, numElementsToSlide, }: {
+        numElementsPerPage: number;
+        numElementsToSlide?: number;
+    }) => number;
+    calcContentContainerLeftPosition: ({ centerExtremesWhenExtraPadding, circular, contentContainer, currentPage, extraPadding, firstIndexInView, numPages, }: {
+        contentContainer: HTMLElement;
+        numPages: number;
+        currentPage: number;
+        firstIndexInView: number;
+        extraPadding: number;
+        centerExtremesWhenExtraPadding: boolean;
+        circular: boolean;
+    }) => string;
+    calcFirstAndLastIndexInCarouselView: ({ currentPage, elementsLength, isCircular, numElementsPerPage, numElementsToSlide, }: {
+        elementsLength: number;
+        numElementsPerPage: number;
+        numElementsToSlide?: number;
+        currentPage: number;
+        isCircular: boolean;
+    }) => {
+        firstIndexInView: number;
+        lastIndexInView: number;
+    };
+    calcGapBetweenContentContainerElements: ({ centerMode, contentContainer, }: {
+        contentContainer: HTMLElement;
+        centerMode: boolean;
+    }) => number;
+    calcNumElementsPerPage: ({ contentContainer, elementsLength, extraPadding, rootContainer, viewerContainer, }: {
+        rootContainer: HTMLElement;
+        viewerContainer: HTMLElement;
+        contentContainer: HTMLElement;
+        elementsLength: number;
+        extraPadding: number;
+    }) => number | undefined;
+    calcNumPages: ({ elementsLength, numElementsPerPage, numElementsToSlide, }: {
+        elementsLength: number;
+        numElementsPerPage: number;
+        numElementsToSlide?: number;
+    }) => number;
+    calcSliceWidth: ({ centerMode, contentContainer, extraPadding, numElementsPerPage, viewerContainer, }: {
+        viewerContainer: HTMLElement;
+        contentContainer: HTMLElement;
+        centerMode: boolean;
+        numElementsPerPage: number;
+        extraPadding: number;
+    }) => number;
+    calcViewerWidth: ({ contentContainer, extraPadding, firstIndexInView, lastIndexInView, viewerContainer, }: {
+        viewerContainer: HTMLElement;
+        contentContainer: HTMLElement;
+        firstIndexInView: number;
+        lastIndexInView: number;
+        extraPadding: number;
+    }) => string;
+    calcXDistanceBetween2Elements: (el1: HTMLElement | null, el2: HTMLElement | null) => number;
+};
+export default _default;
+//# sourceMappingURL=calc.utils.d.ts.map

package/dist/types/components/carousel/hooks/utils/calc.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calc.utils.d.ts","sourceRoot":"","sources":["../../../../../../src/components/carousel/hooks/utils/calc.utils.ts"],"names":[],"mappings":"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"}

package/dist/types/components/carousel/hooks/utils/constants.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    PROPERTY_TO_HANDLE_TRANSITION_END: string;
+    THRESHOLD_TO_DECIDE_IF_ALLOW_DRAGGING: number;
+    THRESHOLD_TO_DECIDE_IF_SWIPE_ON_DRAG_ENDS: number;
+};
+export default _default;
+//# sourceMappingURL=constants.d.ts.map

package/dist/types/components/carousel/hooks/utils/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/components/carousel/hooks/utils/constants.ts"],"names":[],"mappings":";;;;;AAIA,wBAIE"}