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

package/dist/types/lib/hooks/useScrollEffect/useScrollEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollEffect.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/useScrollEffect/useScrollEffect.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAOjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,eAAO,MAAM,eAAe,GAAI,+DAK7B,eAAe,KAAG,qBA6LpB,CAAC"}

package/dist/types/lib/hooks/useScrollEffect/utils/scrollPercentage.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Calculates the scroll percentage of a given scrollable element.
+ *
+ * @param scrollableElement - The HTML element whose scroll percentage is to be calculated.
+ * @param proportionLimit - A limit for the proportion adjustment. Defaults to `1`.
+ * @returns The scroll percentage as a number between `0` and `100`.
+ *
+ * @remarks
+ * - The function calculates how far the user has scrolled within the element as a percentage of the total scrollable area.
+ * - If the `scrollHeight` of the element is greater than its `clientHeight`, the function computes the percentage based on the visible and hidden scroll areas.
+ * - The `proportionLimit` parameter adjusts the scroll calculation to account for elements with varying scroll proportions.
+ * - If the element's `scrollHeight` is less than or equal to its `clientHeight` (i.e., no scrolling is possible), the function returns `0`.
+ *
+ * @example
+ * ```typescript
+ * const element = document.getElementById('scrollable-div');
+ * const percentage = scrollPercentage(element); // Returns the scroll percentage of the element.
+ * console.log(`Scroll percentage: ${percentage}%`);
+ * ```
+ */
+export declare const scrollPercentage: (scrollableElement: HTMLElement, proportionLimit?: number) => number;
+//# sourceMappingURL=scrollPercentage.d.ts.map

package/dist/types/lib/hooks/useScrollEffect/utils/scrollPercentage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollPercentage.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/hooks/useScrollEffect/utils/scrollPercentage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,mBAAmB,WAAW,EAC9B,wBAAmB,KAClB,MAeF,CAAC"}

package/dist/types/lib/hooks/useSwipeDown/useSwipeDown.d.ts

@@ -0,0 +1,14 @@
+export interface UseSwipeDownReturn {
+    setPopoverRef: (node: HTMLElement | null) => void;
+    setDragIconRef: (node: HTMLElement | null) => void;
+}
+/**
+ * Hook for handling swipe down gesture to close modals/popovers
+ * - Mouse and touch support
+ *
+ * @param handleClose - Callback function to execute when closing
+ */
+export declare const useSwipeDown: ({ handleClose, }: {
+    handleClose?: () => void;
+}) => UseSwipeDownReturn;
+//# sourceMappingURL=useSwipeDown.d.ts.map

package/dist/types/lib/hooks/useSwipeDown/useSwipeDown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSwipeDown.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/useSwipeDown/useSwipeDown.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAClD,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;CACpD;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,kBAE1B;IACD,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B,KAAG,kBAmHH,CAAC"}

package/dist/types/lib/hooks/useSwipeDown/utils/convertDurationToNumber.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Converts a duration value (string or number) into a numeric value in milliseconds.
+ *
+ * @param duration - The duration to convert. It can be a string (e.g., "500ms", "2s") or a number (already in milliseconds).
+ * If no value is provided, it defaults to `0`.
+ * @returns The numeric value of the duration in milliseconds.
+ *
+ * @remarks
+ * - If the input is a number, it is returned as-is.
+ * - If the input is a string:
+ *   - It removes the "ms" or "s" suffix and converts the remaining value to a number.
+ *   - If the string contains "s" (seconds) but not "ms" (milliseconds), the value is multiplied by 1000 to convert seconds to milliseconds.
+ * - If the input is `undefined` or an empty value, the function returns `0`.
+ *
+ * @example
+ * ```typescript
+ * convertDurationToNumber(500); // Returns 500
+ * convertDurationToNumber("500ms"); // Returns 500
+ * convertDurationToNumber("2s"); // Returns 2000
+ * convertDurationToNumber(); // Returns 0
+ * ```
+ */
+export declare const convertDurationToNumber: (duration?: string | number) => number;
+//# sourceMappingURL=convertDurationToNumber.d.ts.map

package/dist/types/lib/hooks/useSwipeDown/utils/convertDurationToNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertDurationToNumber.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/hooks/useSwipeDown/utils/convertDurationToNumber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,uBAAuB,GAAI,WAAW,MAAM,GAAG,MAAM,KAAG,MAepE,CAAC"}

package/dist/types/lib/hooks/useTrapFocus/useTrapFocus.d.ts

@@ -0,0 +1,29 @@
+import { type MutableRefObject } from 'react';
+/**
+ * A custom React hook to trap focus within a specified container element.
+ * This hook ensures that keyboard navigation (via the `Tab` key) is restricted to the focusable elements
+ * within the container, preventing focus from escaping to elements outside the container.
+ * It is particularly useful for managing focus in modals, dialogs, or other interactive components.
+ *
+ * @param {Object} params - The parameters for configuring the hook.
+ * @param {MutableRefObject<HTMLElement | null>} params.ref - A React ref pointing to the container element where focus should be trapped.
+ * @param {boolean} [params.trapFocus=false] - A flag to enable or disable the focus-trapping behavior. Defaults to `false`.
+ *
+ * @returns {void | null} This hook does not return any value.
+ *
+ * @example
+ * const modalRef = useRef(null);
+ * useTrapFocus({ ref: modalRef, trapFocus: true });
+ *
+ * return (
+ *   <div ref={modalRef} role="dialog" aria-modal="true">
+ *     <button>Button 1</button>
+ *     <button>Button 2</button>
+ *   </div>
+ * );
+ */
+export declare const useTrapFocus: ({ ref, trapFocus, }: {
+    ref: MutableRefObject<HTMLElement | null>;
+    trapFocus?: boolean;
+}) => void | null;
+//# sourceMappingURL=useTrapFocus.d.ts.map

package/dist/types/lib/hooks/useTrapFocus/useTrapFocus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrapFocus.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/useTrapFocus/useTrapFocus.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,OAAO,CAAC;AAIzD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,YAAY,GAAI,qBAI1B;IACD,GAAG,EAAE,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,KAAG,IAAI,GAAG,IAsEV,CAAC"}

package/dist/types/lib/provider/genericComponentsProvider/defaultGenericComponents.d.ts

@@ -0,0 +1,40 @@
+import type { GenericImageProps } from './types/genericComponentsProvider';
+/**
+ * Default implementations for generic components.
+ * Provides standard HTML-based Link and Image components.
+ * These are used when the application doesn't provide custom implementations.
+ *
+ * @example
+ * ```tsx
+ * import { defaultGenericComponents } from './defaultGenericComponents';
+ *
+ * <GenericComponentsProvider value={defaultGenericComponents}>
+ *   <App />
+ * </GenericComponentsProvider>
+ * ```
+ */
+export declare const defaultGenericComponents: {
+    IMAGE: import("react").ForwardRefExoticComponent<GenericImageProps & import("react").RefAttributes<unknown>>;
+    LINK: import("react").ForwardRefExoticComponent<{
+        url: string;
+        id?: string;
+        children: string | JSX.Element;
+        className?: string;
+        target?: string;
+        onClick?: () => void;
+        onFocus?: () => void;
+        onMouseEnter?: () => void;
+        onMouseLeave?: () => void;
+        rel?: string;
+        role?: import("react").AriaRole;
+        dataTestId?: string;
+        draggable?: boolean;
+    } & {
+        "aria-label"?: string | undefined | undefined;
+        "aria-describedby"?: string | undefined | undefined;
+        "aria-labelledby"?: string | undefined | undefined;
+        "aria-disabled"?: (boolean | "false" | "true") | undefined;
+        "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
+    } & import("../../types").DataAttributes & import("react").RefAttributes<unknown>>;
+};
+//# sourceMappingURL=defaultGenericComponents.d.ts.map

package/dist/types/lib/provider/genericComponentsProvider/defaultGenericComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultGenericComponents.d.ts","sourceRoot":"","sources":["../../../../../src/lib/provider/genericComponentsProvider/defaultGenericComponents.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,mCAAmC,CAAC;AAiF3C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;CAGpC,CAAC"}

package/dist/types/lib/provider/genericComponentsProvider/genericComponentsProvider.d.ts

@@ -0,0 +1,56 @@
+import { type PropsWithChildren } from 'react';
+import type { GenericComponentsProviderProps, GenericComponentsType } from './types/genericComponentsProvider';
+/**
+ * React Context for generic component implementations.
+ * Provides access to custom Link and Image components throughout the application.
+ */
+export declare const GenericComponentContext: import("react").Context<GenericComponentsType | null>;
+/**
+ * Provider component for custom generic component implementations.
+ * Allows applications to inject their own Link and Image components
+ * (e.g., Next.js Link, React Router Link) to be used by all Kubit components.
+ *
+ * This is essential for integrating Kubit components with different routing libraries
+ * or custom implementations while maintaining consistent behavior across the application.
+ *
+ * @param props - Provider props
+ * @param props.children - React children to be wrapped by the provider
+ * @param props.value - Custom generic components to be used throughout the application
+ *
+ * @returns The provider component wrapping all child components
+ *
+ * @example
+ * ```tsx
+ * import { Link } from 'react-router-dom';
+ *
+ * const customComponents = {
+ *   LINK: Link,
+ *   IMAGE: CustomImage,
+ * };
+ *
+ * <GenericComponentsProvider value={customComponents}>
+ *   <App />
+ * </GenericComponentsProvider>
+ * ```
+ */
+export declare const GenericComponentsProvider: ({ children, value, }: PropsWithChildren<GenericComponentsProviderProps>) => JSX.Element;
+/**
+ * Custom hook to access the generic components context.
+ * Provides access to the custom Link and Image components configured in the provider.
+ *
+ * @throws {Error} If used outside of a GenericComponentsProvider or with invalid value
+ * @returns The generic components (LINK, IMAGE) from the context
+ *
+ * @example
+ * ```tsx
+ * const { LINK, IMAGE } = useGenericComponents();
+ *
+ * return (
+ *   <LINK url="/home">
+ *     <IMAGE src="/logo.png" alt="Logo" />
+ *   </LINK>
+ * );
+ * ```
+ */
+export declare const useGenericComponents: () => GenericComponentsType;
+//# sourceMappingURL=genericComponentsProvider.d.ts.map

package/dist/types/lib/provider/genericComponentsProvider/genericComponentsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genericComponentsProvider.d.ts","sourceRoot":"","sources":["../../../../../src/lib/provider/genericComponentsProvider/genericComponentsProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAA6B,MAAM,OAAO,CAAC;AAE1E,OAAO,KAAK,EACV,8BAA8B,EAC9B,qBAAqB,EACtB,MAAM,mCAAmC,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,uDACe,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,yBAAyB,GAAI,sBAGvC,iBAAiB,CAAC,8BAA8B,CAAC,KAAG,GAAG,CAAC,OAM1D,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,QAAO,qBAUvC,CAAC"}

package/dist/types/lib/provider/genericComponentsProvider/index.d.ts

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

package/dist/types/lib/provider/genericComponentsProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/provider/genericComponentsProvider/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/types/lib/provider/genericComponentsProvider/types/genericComponentsProvider.d.ts

@@ -0,0 +1,75 @@
+import type { AriaAttributes, AriaRole, ForwardRefExoticComponent, ImgHTMLAttributes, RefAttributes } from 'react';
+import type { DataAttributes } from '../../../types/dataAttributes/dataAttributes';
+/**
+ * Subset of ARIA attributes applicable to link elements.
+ * Ensures proper accessibility for navigation components.
+ */
+type GenericLinkAriaAttributes = Pick<AriaAttributes, 'aria-label' | 'aria-describedby' | 'aria-labelledby' | 'aria-disabled' | 'aria-current'>;
+/**
+ * Props for a generic link component.
+ * Provides a flexible interface for custom link implementations that can be used
+ * throughout the component library (e.g., for React Router, Next.js Link, etc.).
+ */
+export type GenericLinkProps = {
+    /** The destination URL for the link */
+    url: string;
+    /** Optional unique identifier for the link element */
+    id?: string;
+    /** Content to be displayed inside the link */
+    children: string | JSX.Element;
+    /** Optional CSS class name(s) for styling */
+    className?: string;
+    /** Specifies where to open the linked document ('_blank', '_self', '_parent', '_top') */
+    target?: string;
+    /** Callback function invoked when the link is clicked */
+    onClick?: () => void;
+    /** Callback function invoked when the link receives focus */
+    onFocus?: () => void;
+    /** Callback function invoked when the mouse pointer enters the link area */
+    onMouseEnter?: () => void;
+    /** Callback function invoked when the mouse pointer leaves the link area */
+    onMouseLeave?: () => void;
+    /** Relationship between the current document and the linked document */
+    rel?: string;
+    /** ARIA role to override the default link role if needed */
+    role?: AriaRole;
+    /** Test ID for automated testing purposes */
+    dataTestId?: string;
+    /** Whether the element can be dragged */
+    draggable?: boolean;
+} & GenericLinkAriaAttributes & DataAttributes;
+/**
+ * Type definition for a generic link component.
+ * Can be either a functional component or a forward ref component to support refs.
+ */
+export type GenericLinkType = ((props: GenericLinkProps) => JSX.Element) | ForwardRefExoticComponent<GenericLinkProps & RefAttributes<unknown>>;
+/**
+ * Props for a generic image component.
+ * Inherits all standard HTML image attributes.
+ */
+export type GenericImageProps = ImgHTMLAttributes<HTMLImageElement>;
+/**
+ * Type definition for a generic image component.
+ * Can be either a functional component or a forward ref component to support refs.
+ */
+export type GenericImageType = ((props: GenericImageProps) => JSX.Element) | ForwardRefExoticComponent<GenericImageProps & RefAttributes<unknown>>;
+/**
+ * Collection of generic component implementations.
+ * Allows customization of primitive components used throughout the library.
+ */
+export interface GenericComponentsType {
+    /** Link component implementation (required) */
+    LINK: GenericLinkType;
+    /** Image component implementation (optional) */
+    IMAGE?: GenericImageType;
+}
+/**
+ * Props for the GenericComponentsProvider.
+ * Wraps the application with custom component implementations.
+ */
+export interface GenericComponentsProviderProps {
+    /** The custom generic components to be made available to child components */
+    value: GenericComponentsType;
+}
+export {};
+//# sourceMappingURL=genericComponentsProvider.d.ts.map

package/dist/types/lib/provider/genericComponentsProvider/types/genericComponentsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genericComponentsProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/provider/genericComponentsProvider/types/genericComponentsProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,QAAQ,EACR,yBAAyB,EACzB,iBAAiB,EACjB,aAAa,EACd,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAEhF;;;GAGG;AACH,KAAK,yBAAyB,GAAG,IAAI,CACnC,cAAc,EACZ,YAAY,GACZ,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,cAAc,CACjB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC;IAC/B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,yBAAyB,GAC3B,cAAc,CAAC;AAEjB;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,CAAC,CAAC,KAAK,EAAE,gBAAgB,KAAK,GAAG,CAAC,OAAO,CAAC,GAC1C,yBAAyB,CAAC,gBAAgB,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,CAAC,CAAC,KAAK,EAAE,iBAAiB,KAAK,GAAG,CAAC,OAAO,CAAC,GAC3C,yBAAyB,CAAC,iBAAiB,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,IAAI,EAAE,eAAe,CAAC;IACtB,gDAAgD;IAChD,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,6EAA6E;IAC7E,KAAK,EAAE,qBAAqB,CAAC;CAC9B"}

package/dist/types/lib/provider/index.d.ts

@@ -0,0 +1,4 @@
+export * from './genericComponentsProvider';
+export * from './stylesProvider';
+export * from './utilsProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/provider/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC"}

package/dist/types/lib/provider/stylesProvider/index.d.ts

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

package/dist/types/lib/provider/stylesProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/provider/stylesProvider/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC"}

package/dist/types/lib/provider/stylesProvider/stylesProvider.d.ts

@@ -0,0 +1,57 @@
+import { type FC } from 'react';
+import type { StylesContextProps, StylesProviderProps } from './types/stylesProvider';
+/**
+ * React Context for styles and theming.
+ * Provides access to styling utilities, theme management, and responsive breakpoints.
+ */
+export declare const StylesContext: import("react").Context<StylesContextProps | undefined>;
+/**
+ * Custom hook to access the StylesContext.
+ * Provides styling utilities including theme management, breakpoints, and component styles.
+ *
+ * @throws {Error} If used outside of a StylesProvider
+ * @returns The current styles context value
+ *
+ * @example
+ * ```tsx
+ * const { currentTheme, changeTheme, getComponentStyles } = useStylesContext();
+ * const styles = getComponentStyles({ component: 'button', variant: 'primary' });
+ * ```
+ */
+export declare const useStylesContext: () => StylesContextProps;
+/**
+ * Provider component for styles, theming, and responsive design utilities.
+ * Manages theme selection, CSS class generation, and provides styling context to child components.
+ *
+ * Features:
+ * - Theme management with dynamic theme switching
+ * - Responsive breakpoints and media queries
+ * - Icon and illustration asset management
+ * - Component-specific style retrieval
+ * - CSS-in-JS support via Bernova provider
+ *
+ * @param props - Configuration props for the styles provider
+ * @param props.children - React children to be wrapped by the provider
+ * @param props.breakpoints - Custom responsive breakpoints (defaults to standard breakpoints if not provided)
+ * @param props.icons - Map of icon names to URLs or base64 strings
+ * @param props.illustrations - Map of illustration names to URLs or base64 strings
+ * @param props.themeSelected - Initial theme to apply
+ * @param props.bernovaProvider - Custom Bernova provider instance for advanced styling control
+ * @param props.linkId - ID for the style link element in the DOM (default: 'kb-styled-provider')
+ * @param props.jsInCss - Whether to inject CSS directly into JavaScript (default: true)
+ *
+ * @returns The styled provider component wrapping all child components
+ *
+ * @example
+ * ```tsx
+ * <StylesProvider
+ *   themeSelected="dark"
+ *   breakpoints={{ sm: 576, md: 768, lg: 992, xl: 1200 }}
+ *   icons={{ home: '/icons/home.svg' }}
+ * >
+ *   <App />
+ * </StylesProvider>
+ * ```
+ */
+export declare const StylesProvider: FC<StylesProviderProps>;
+//# sourceMappingURL=stylesProvider.d.ts.map

package/dist/types/lib/provider/stylesProvider/stylesProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylesProvider.d.ts","sourceRoot":"","sources":["../../../../../src/lib/provider/stylesProvider/stylesProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAgD,MAAM,OAAO,CAAC;AAoB9E,OAAO,KAAK,EAEV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAMhC;;;GAGG;AACH,eAAO,MAAM,aAAa,yDAEzB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,QAAO,kBAMnC,CAAC;AA2BF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CA6IlD,CAAC"}

package/dist/types/lib/provider/stylesProvider/types/stylesProvider.d.ts

@@ -0,0 +1,84 @@
+import type { RecoverComponentStyles } from '../../../types/cssGenerator/cssGenerator';
+import type { GenericComponentsType } from '../../genericComponentsProvider/types/genericComponentsProvider';
+import type { dateHelpers } from '../../utilsProvider/types/utilsProvider';
+/**
+ * Defines responsive breakpoints in pixels for different screen sizes.
+ * Used for creating media queries and responsive layouts.
+ */
+export interface Breakpoints {
+    /** Small screen breakpoint (typically mobile landscape) - default: 576px */
+    sm: number;
+    /** Medium screen breakpoint (typically tablets) - default: 768px */
+    md: number;
+    /** Large screen breakpoint (typically desktops) - default: 992px */
+    lg: number;
+    /** Extra large screen breakpoint (typically large desktops) - default: 1200px */
+    xl: number;
+}
+/**
+ * Props for the StylesProvider component.
+ * Configures the styling system including themes, breakpoints, and assets.
+ */
+export interface StylesProviderProps {
+    /** The React children to be wrapped by the provider */
+    children: React.ReactNode;
+    /** Custom breakpoints for responsive design. If not provided, uses default breakpoints */
+    breakpoints?: Breakpoints;
+    /** Map of icon names to their corresponding URLs or base64 strings */
+    icons?: Record<string, string>;
+    /** Map of illustration names to their corresponding URLs or base64 strings */
+    illustrations?: Record<string, string>;
+    /** The initial theme to be applied. If not provided, uses the provider's default theme */
+    themeSelected?: string;
+    /** Custom Bernova provider instance for advanced styling control */
+    bernovaProvider?: never;
+    /** ID for the style link element in the DOM. Default: 'kb-styled-provider' */
+    linkId?: string;
+    /** Whether to inject CSS directly into JavaScript. Default: true */
+    jsInCss?: boolean;
+    genericComponents?: GenericComponentsType;
+    dateHelpers?: dateHelpers;
+}
+/**
+ * Media query strings for targeting specific screen size ranges.
+ * Built from the provided breakpoints configuration.
+ */
+export interface MediaQueries {
+    /** Media query for mobile devices only (below md breakpoint) */
+    onlyMobile: string;
+    /** Media query for tablets only (between md and lg breakpoints) */
+    onlyTablet: string;
+    /** Media query for desktops (below xl breakpoint) */
+    onlyDesktop: string;
+    /** Media query for large desktops (xl breakpoint and above) */
+    onlyLargeDesktop: string;
+}
+/**
+ * Context value provided by StylesProvider.
+ * Contains all styling-related data and utilities available to child components.
+ */
+export interface StylesContextProps {
+    /** Current responsive breakpoints configuration */
+    breakpoints: Breakpoints;
+    /** Array of CSS class names or null */
+    classes: string[] | null;
+    /** Pre-built media query strings for responsive design */
+    mediaQueries: MediaQueries;
+    /** Map of available icons */
+    icons: Record<string, string>;
+    /** Map of available illustrations */
+    illustrations: Record<string, string>;
+    /** Currently active theme name, or null if no theme is selected */
+    currentTheme: string | null;
+    /** Function to retrieve styles for a specific component and variant */
+    getComponentStyles: RecoverComponentStyles;
+    /** Function to change the active theme */
+    changeTheme: (themeName: string) => void;
+    /** Array of CSS class names for the current theme */
+    themeClassNames: string[];
+    /** Map of all available themes */
+    themes: Record<string, string>;
+    /** Map of CSS custom properties (variables) for the current theme */
+    themeVariables: Record<string, string>;
+}
+//# sourceMappingURL=stylesProvider.d.ts.map

package/dist/types/lib/provider/stylesProvider/types/stylesProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylesProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/provider/stylesProvider/types/stylesProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iEAAiE,CAAC;AAC7G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAE1B,0FAA0F;IAC1F,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oEAAoE;IACpE,eAAe,CAAC,EAAE,KAAK,CAAC;IAExB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,oEAAoE;IACpE,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;IAE1C,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,WAAW,EAAE,WAAW,CAAC;IAEzB,uCAAuC;IACvC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEzB,0DAA0D;IAC1D,YAAY,EAAE,YAAY,CAAC;IAE3B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9B,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,mEAAmE;IACnE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,uEAAuE;IACvE,kBAAkB,EAAE,sBAAsB,CAAC;IAE3C,0CAA0C;IAC1C,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAEzC,qDAAqD;IACrD,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE/B,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC"}

package/dist/types/lib/provider/utilsProvider/index.d.ts

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

package/dist/types/lib/provider/utilsProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/provider/utilsProvider/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}