@tap-payments/os-micro-frontend-shared 0.3.23 → 0.3.25

package/build/components/_v2/composites/NestedMultiSelect/NestedMultiSelect.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { NestedMultiSelectProps, NestedOption } from './type';
+declare const NestedMultiSelect: React.ForwardRefExoticComponent<Readonly<NestedMultiSelectProps<NestedOption>> & React.RefAttributes<HTMLDivElement>>;
+export default NestedMultiSelect;

package/build/components/_v2/composites/NestedMultiSelect/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './NestedMultiSelect';
+export type { NestedMultiSelectProps, NestedOption, TreeNode, NestedSubGroup } from './type';

package/build/components/_v2/composites/NestedMultiSelect/style.d.ts

@@ -0,0 +1,47 @@
+/// <reference types="react" />
+export { FloatingLabel } from '../../primitives/FormField';
+/**
+ * The outer trigger box — matches the old TriggerWrapper exactly:
+ * grey[400] background, grey[100] border, 4px radius, column-flex, relative for arrow.
+ */
+export declare const TriggerBox: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme> & {
+    $open?: boolean | undefined;
+    $disabled?: boolean | undefined;
+    $error?: boolean | undefined;
+}, {}, {}>;
+export declare const TriggerLabel: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const PlaceholderText: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const TriggerArrow: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const BadgesWrapper: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const Badge: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme> & {
+    maxWidth?: number | undefined;
+}, {}, {}>;
+/**
+ * Mirrors old Container: flex column, 4px gap, 4px padding.
+ */
+export declare const MenuContainer: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const MenuSearchInput: import("@emotion/styled").StyledComponent<import("@mui/material/Input").InputProps & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const MenuItemRow: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme> & {
+    $selected?: boolean | undefined;
+}, {}, {}>;
+export declare const LeafItemRow: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme> & {
+    $selected?: boolean | undefined;
+}, {}, {}>;

package/build/components/_v2/composites/NestedMultiSelect/type.d.ts

@@ -0,0 +1,92 @@
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+import type { InputFeedbackProps } from '../../primitives/InputFeedback';
+import type { SelectSize } from '../../primitives/SelectBase/type';
+/**
+ * A leaf option that can be selected. The only required fields are a unique key
+ * and a display label — use `getOptionValue` / `getOptionLabel` to map your own
+ * object shape.
+ */
+export interface NestedOption {
+    label: string;
+    value: string;
+    [key: string]: unknown;
+}
+/**
+ * A node in the option tree. It is either:
+ *   - A **branch** node: has `children` (array of TreeNode) but no `value` — rendered as a hoverable row with a fly-out
+ *   - A **leaf** node: has `value` (selectable option) — rendered as a checkbox row
+ */
+export interface TreeNode<T extends NestedOption = NestedOption> {
+    /** Display label for this node (shown in the row). */
+    label: string;
+    /**
+     * Child nodes. When present this is a branch; when absent/empty this is a leaf.
+     * Branches open a fly-out menu on hover.
+     */
+    children?: TreeNode<T>[];
+    /**
+     * Unique key for this leaf option. When present (even with children absent) this node
+     * is treated as a leaf and can be selected/deselected.
+     */
+    value?: string;
+    /** Any extra fields on the option object — forwarded to renderOption/getOptionLabel. */
+    [key: string]: unknown;
+}
+/** @deprecated Use TreeNode instead. Will be removed in a future release. */
+export type NestedSubGroup<T extends NestedOption = NestedOption> = TreeNode<T>;
+export interface NestedMultiSelectProps<T extends NestedOption = NestedOption> {
+    /**
+     * Nested option tree — supports arbitrary depth via recursive TreeNode structure.
+     * Branch nodes (with `children`) open fly-out menus; leaf nodes (with `value`) are selectable.
+     */
+    nodes?: TreeNode<T>[];
+    /** Currently selected options (controlled). */
+    value?: T[];
+    /** Called with the updated selection whenever an option is toggled. */
+    onChange?: (selected: T[]) => void;
+    /** Returns the display string for an option. Defaults to `option.label`. */
+    getOptionLabel?: (option: T) => string;
+    /** Returns the unique key for an option. Defaults to `option.value`. */
+    getOptionValue?: (option: T) => string;
+    /** Custom renderer for a leaf option row inside the fly-out leaf panel. */
+    renderOption?: (option: T, isSelected: boolean) => ReactNode;
+    /**
+     * When true (default), shows a search input inside the popover.
+     * Filters leaf options by the string returned from `getOptionLabel`.
+     */
+    searchable?: boolean;
+    /** Placeholder for the in-popover search input. @default 'Search' */
+    searchPlaceholder?: string | null;
+    /** Floating label rendered above the trigger. */
+    label?: string;
+    /** Placeholder shown in the trigger when nothing is selected. */
+    placeholder?: string | null;
+    /** Plain helper text shown below when no feedback is supplied. */
+    helperText?: string;
+    /**
+     * Rich feedback panel rendered flush below the trigger.
+     * Takes priority over `helperText` when both are supplied.
+     */
+    feedback?: InputFeedbackProps | null;
+    /** Marks the field as error state. */
+    error?: boolean;
+    disabled?: boolean;
+    /** Loading spinner replaces the search icon while options are being fetched. */
+    loading?: boolean;
+    /**
+     * How many selected badges to show in the trigger before collapsing to "+N".
+     * @default 2
+     */
+    maxBadges?: number;
+    /** Height variant — matches other v2 select size tokens. */
+    size?: SelectSize;
+    /** Stretches the trigger to 100 % of its container. */
+    fullWidth?: boolean;
+    /** Styling for the outer field root wrapper. */
+    sx?: SxProps<Theme>;
+    /** Styling overrides for the select trigger control. */
+    triggerSx?: SxProps<Theme>;
+    onOpen?: () => void;
+    onClose?: () => void;
+}

package/build/components/_v2/composites/NestedMultiSelect/util.d.ts

@@ -0,0 +1,7 @@
+import type { NestedOption, TreeNode } from './type';
+export declare function defaultGetLabel<T extends NestedOption>(o: T): string;
+export declare function defaultGetValue<T extends NestedOption>(o: T): string;
+/** Recursively collect all leaf nodes (nodes without children, or with empty children). */
+export declare function collectLeaves(node: TreeNode): TreeNode[];
+/** Recursively filter a tree, keeping branches that have any matching leaf descendants. */
+export declare function filterTree(nodes: TreeNode[], q: string, getLabel: (n: TreeNode) => string): TreeNode[];

package/build/components/_v2/composites/NumberInput/NumberInput.d.ts

@@ -0,0 +1,28 @@
+/// <reference types="react" />
+import type { SxProps, Theme } from '@mui/material/styles';
+import type { NumberInputBaseProps } from '../../primitives/NumberInputBase';
+import type { InputFeedbackProps } from '../../primitives/InputFeedback';
+export interface NumberInputProps extends Omit<NumberInputBaseProps, 'sx' | 'placeholder'> {
+    /**
+     * Floating label rendered inside the input box — animates to the top edge on
+     * focus or when a value is present (mirrors legacy InputI behaviour).
+     * Omit when no label is needed.
+     */
+    label?: string;
+    /** Plain helper text shown below when no feedback is supplied */
+    helperText?: string;
+    /** Placeholder text shown when input is empty */
+    placeholder?: string | null;
+    /**
+     * Rich feedback panel rendered flush below the input.
+     * Adjusts the input border colour and radius to connect visually.
+     * Takes priority over `helperText` when both are supplied.
+     */
+    feedback?: InputFeedbackProps | null;
+    /** Styling for the field root wrapper */
+    sx?: SxProps<Theme>;
+    /** Styling overrides for the NumberInputBase control */
+    inputSx?: SxProps<Theme>;
+}
+declare const _default: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Omit<NumberInputProps, "ref"> & import("react").RefAttributes<HTMLInputElement>>>;
+export default _default;

package/build/components/_v2/composites/NumberInput/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './NumberInput';
+export type { NumberInputProps } from './NumberInput';

package/build/components/_v2/composites/PhoneInput/PhoneInput.d.ts

@@ -0,0 +1,24 @@
+/// <reference types="react" />
+import type { SxProps, Theme } from '@mui/material/styles';
+import type { PhoneInputBaseProps } from '../../primitives/PhoneInputBase';
+import type { InputFeedbackProps } from '../../primitives/InputFeedback';
+export interface PhoneInputProps extends Omit<PhoneInputBaseProps, 'sx' | 'error' | 'placeholder'> {
+    /** Visible label rendered above the phone input */
+    label?: string;
+    /** Placeholder text shown inside the number field when it is empty */
+    placeholder?: string | null;
+    /** Plain helper text shown below when no feedback is supplied */
+    helperText?: string;
+    /**
+     * Rich feedback panel rendered flush below the input.
+     * Adjusts the phone control border colour and radius to connect visually.
+     * Takes priority over `helperText` when both are supplied.
+     */
+    feedback?: InputFeedbackProps | null;
+    /** Marks the field as error state */
+    error?: boolean;
+    /** Styling for the field root wrapper */
+    sx?: SxProps<Theme>;
+}
+declare const _default: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<PhoneInputProps & import("react").RefAttributes<HTMLInputElement>>>;
+export default _default;

package/build/components/_v2/composites/PhoneInput/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './PhoneInput';
+export type { PhoneInputProps } from './PhoneInput';

package/build/components/_v2/composites/RangeCalender/RangeCalender.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import { RangeCalendarProps } from './type';
+/**
+ * Full date-range picker with start/end date selection, timezone support, Hijri calendar toggle,
+ * group-by period selector, and optional time pickers. Rendered in a Popper anchored to a trigger.
+ * Pass `dates` (`{ startDate, endDate }`) and `setDates` for controlled state.
+ * Use RHFRangeCalender for React Hook Form integration.
+ */
+declare function RangeCalender({ defaultDate, onDateChange, mode, onCalendarModeSwitch, numberOfMonths, noTimezone, noQuickFilter, maxDateRange, onCalendarGroupChange, groupBy, timezone, onChangeTimezone, browserTimezone, renderCalendarButton, mainSx, popperProps, rangeDatePickerProps, defaultCountryTimezone, timezoneCountriesCodes, }: Readonly<RangeCalendarProps>): import("react").JSX.Element;
+export default RangeCalender;

package/build/components/_v2/composites/RangeCalender/components/CustomTimepicker/CustomTimepicker.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import { Dates } from '../../type';
+interface CustomTimePickerProps {
+    /** Currently selected [start, end] date range including time components */
+    values: Dates;
+    /** Called with the updated range whenever the start or end time changes */
+    setValues: (values: Dates) => void;
+}
+declare function CustomTimePicker({ values, setValues }: CustomTimePickerProps): import("react").JSX.Element;
+export default CustomTimePicker;

package/build/components/_v2/composites/RangeCalender/components/CustomTimepicker/index.d.ts

@@ -0,0 +1,2 @@
+import CustomTimepicker from './CustomTimepicker';
+export default CustomTimepicker;

package/build/components/_v2/composites/RangeCalender/components/CustomTimepicker/style.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+export declare const AllDayStyled: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme> & {
+    isAllDay?: boolean | undefined;
+}, {}, {}>;
+export declare const TimeArea: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const TimePickerWrapper: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const TimeAreaInner: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;

package/build/components/_v2/composites/RangeCalender/components/Error/Error.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+import type { BoxProps } from '@mui/material/Box';
+export interface ErrorProps extends BoxProps {
+    /** Error message text displayed next to the warning icon */
+    error: string;
+}
+declare const ErrorComponent: import("react").NamedExoticComponent<ErrorProps>;
+export default ErrorComponent;

package/build/components/_v2/composites/RangeCalender/components/Error/style.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+export declare const ErrorStyled: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;

package/build/components/_v2/composites/RangeCalender/components/GroupBy/GroupBy.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="react" />
+import { BoxProps } from '@mui/material/Box';
+interface GroupByProps extends BoxProps {
+    /** Currently active group-by key (e.g. `"day"` or `"month"`) */
+    groupBy: string;
+    /** Whether the parent calendar popover is currently open */
+    isCalenderOpen: boolean;
+    /** Called with the newly selected group-by key */
+    onUpdate?: (value: string) => void;
+}
+declare function GroupBy({ sx, groupBy, isCalenderOpen, onUpdate }: GroupByProps): import("react").JSX.Element;
+declare const _default: import("react").MemoExoticComponent<typeof GroupBy>;
+export default _default;

package/build/components/_v2/composites/RangeCalender/components/GroupBy/index.d.ts

@@ -0,0 +1,2 @@
+import GroupBy from './GroupBy';
+export default GroupBy;

package/build/components/_v2/composites/RangeCalender/components/GroupBy/style.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+export declare const GroupByLabel: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const GroupByDropdownButton: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme> & {
+    open: boolean;
+}, {}, {}>;
+export declare const GroupByDropdown: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const Option: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;

package/build/components/_v2/composites/RangeCalender/components/Hijri/Hijri.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+import type { CalenderMode } from '../../../../../../types/index.js';
+interface CalenderSettingsProps {
+    /** Whether the calendar is currently displaying in Hijri mode */
+    isHijri: boolean;
+    /** Called with the new mode when the user toggles the Hijri switch */
+    onCalendarModeSwitch?: (mode: CalenderMode) => void;
+}
+export default function Hijri({ isHijri, onCalendarModeSwitch }: CalenderSettingsProps): import("react").JSX.Element;
+export {};

package/build/components/_v2/composites/RangeCalender/components/Hijri/index.d.ts

@@ -0,0 +1,2 @@
+import CalenderSettings from './Hijri';
+export default CalenderSettings;

package/build/components/_v2/composites/RangeCalender/components/Hijri/style.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+export declare const CalenderSetting: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;

package/build/components/_v2/composites/RangeCalender/components/QuickFilters/QuickFilters.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import { DateObject } from 'react-multi-date-picker';
+interface QuickFiltersProps {
+    /** Called with the preset [start, end] range when the user clicks a filter chip */
+    onChange: (dates: [DateObject, DateObject]) => void;
+    /** When true, dates are computed in the Hijri calendar system */
+    isHijri: boolean;
+    /** When true, filter labels are rendered in Arabic */
+    isAr?: boolean;
+}
+export default function QuickFilters({ onChange, isHijri, isAr }: QuickFiltersProps): import("react").JSX.Element;
+export {};

package/build/components/_v2/composites/RangeCalender/components/QuickFilters/index.d.ts

@@ -0,0 +1,2 @@
+import QuickFilters from './QuickFilters';
+export default QuickFilters;

package/build/components/_v2/composites/RangeCalender/components/QuickFilters/style.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="react" />
+export declare const CustomLabel: import("@emotion/styled").StyledComponent<import("@mui/material/Button").ButtonOwnProps & Omit<import("@mui/material").ButtonBaseOwnProps, "classes"> & import("@mui/material/OverridableComponent").CommonProps & Omit<Omit<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
+    ref?: ((instance: HTMLButtonElement | null) => void) | import("react").RefObject<HTMLButtonElement> | null | undefined;
+}, "color" | "disabled" | "classes" | "className" | "style" | "tabIndex" | "children" | "sx" | "variant" | "size" | "fullWidth" | "href" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "disableElevation" | "disableFocusRipple" | "endIcon" | "startIcon"> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const FiltersWrapper: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;

package/build/components/_v2/composites/RangeCalender/components/RangeDatepicker/RangeDatepicker.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { RangeDatepickerProps } from './type';
+declare const _default: React.ForwardRefExoticComponent<Omit<RangeDatepickerProps, "ref"> & React.RefAttributes<unknown>>;
+export default _default;

package/build/components/_v2/composites/RangeCalender/components/RangeDatepicker/index.d.ts

@@ -0,0 +1,3 @@
+import RangeDatepicker from './RangeDatepicker';
+export * from './type';
+export default RangeDatepicker;

package/build/components/_v2/composites/RangeCalender/components/RangeDatepicker/style.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+export declare const ArrowButton: import("@emotion/styled").StyledComponent<import("@mui/material/Button").ButtonOwnProps & Omit<import("@mui/material").ButtonBaseOwnProps, "classes"> & import("@mui/material/OverridableComponent").CommonProps & Omit<Omit<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
+    ref?: ((instance: HTMLButtonElement | null) => void) | import("react").RefObject<HTMLButtonElement> | null | undefined;
+}, "color" | "disabled" | "classes" | "className" | "style" | "tabIndex" | "children" | "sx" | "variant" | "size" | "fullWidth" | "href" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "disableElevation" | "disableFocusRipple" | "endIcon" | "startIcon"> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;

package/build/components/_v2/composites/RangeCalender/components/RangeDatepicker/type.d.ts

@@ -0,0 +1,14 @@
+import { CalendarProps } from 'react-multi-date-picker';
+import { Dates } from '../../type';
+export interface RangeDatepickerProps extends Omit<CalendarProps, 'onChange'> {
+    /** Render in right-to-left / Hijri locale mode */
+    isAr?: boolean;
+    /** When true the calendar renders in Hijri (Islamic) mode */
+    isHijri: boolean;
+    /** Currently selected [start, end] date range */
+    values: Dates;
+    /** Called with the updated [start, end] range when the user changes the selection */
+    onChange: (v: Dates) => void;
+    /** Number of calendar months displayed side by side */
+    numberOfMonths?: number;
+}

package/build/components/_v2/composites/RangeCalender/components/Timezone/Timezone.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="react" />
+import type { Timezone } from '../../../../../../types/index.js';
+interface CustomTimezoneProps {
+    /** Called when the user selects a different timezone */
+    onChange: (timezone: Timezone) => void;
+    /** Currently active timezone (controlled) */
+    selectedTimezone: Timezone | null;
+    /** Default entity / account timezone shown as a fallback */
+    defaultCountryTimezone: Timezone;
+    /** IANA timezone string of the user's browser (e.g. `"Asia/Riyadh"`) */
+    browserTimezone: string;
+    /** ISO 3166-1 alpha-2 codes of countries available in the entity timezone list */
+    timezoneCountriesCodes: string[];
+}
+declare function CustomTimezone({ onChange, selectedTimezone, browserTimezone, defaultCountryTimezone, timezoneCountriesCodes }: CustomTimezoneProps): import("react").JSX.Element;
+declare const _default: import("react").MemoExoticComponent<typeof CustomTimezone>;
+export default _default;

package/build/components/_v2/composites/RangeCalender/components/Timezone/components/EntitiesTimezone.d.ts

@@ -0,0 +1,14 @@
+/// <reference types="react" />
+import type { Timezone } from '../../../../../../../types/index.js';
+interface EntitiesTimezoneProps {
+    /** Currently active timezone (controlled) */
+    selectedTimezone: Timezone | null;
+    /** Called when the user picks a timezone from the list */
+    onChange: (selected: Timezone) => void;
+    /** ISO 3166-1 alpha-2 codes used to filter the entity timezone list */
+    timezoneCountriesCodes?: string[];
+    /** Default entity / account timezone shown as the first option */
+    defaultCountryTimezone: Timezone;
+}
+export default function EntitiesTimezone({ selectedTimezone, onChange, timezoneCountriesCodes, defaultCountryTimezone }: EntitiesTimezoneProps): import("react").JSX.Element;
+export {};

package/build/components/_v2/composites/RangeCalender/components/Timezone/components/UserTimezone.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import type { Timezone } from '../../../../../../../types/index.js';
+interface UserTimezoneProps {
+    /** Currently active timezone (controlled) */
+    selectedTimezone: Timezone | null;
+    /** Called when the user selects the browser timezone option */
+    onChange: (selected: Timezone) => void;
+    /** IANA timezone string of the user's browser (e.g. `"Asia/Riyadh"`) */
+    browserTimezone?: string;
+}
+export default function UserTimezone({ onChange, selectedTimezone, browserTimezone }: UserTimezoneProps): import("react").JSX.Element;
+export {};

package/build/components/_v2/composites/RangeCalender/components/Timezone/index.d.ts

@@ -0,0 +1,2 @@
+import Timezone from './Timezone';
+export default Timezone;

package/build/components/_v2/composites/RangeCalender/components/Timezone/style.d.ts

@@ -0,0 +1,21 @@
+/// <reference types="react" />
+export declare const TimezoneWrapper: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const TimezoneDropdown: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const SelectedTimezone: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme> & {
+    open: boolean;
+}, {}, {}>;
+export declare const TimezoneElement: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const Space: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const Label: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;

package/build/components/_v2/composites/RangeCalender/index.d.ts

@@ -0,0 +1,2 @@
+export { default } from './RangeCalender';
+export type { RangeCalendarProps, Dates } from './type';

package/build/components/_v2/composites/RangeCalender/style.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="react" />
+export declare const CalenderWrapper: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const CancelButton: import("@emotion/styled").StyledComponent<import("@mui/material/Button").ButtonOwnProps & Omit<import("@mui/material").ButtonBaseOwnProps, "classes"> & import("@mui/material/OverridableComponent").CommonProps & Omit<Omit<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
+    ref?: ((instance: HTMLButtonElement | null) => void) | import("react").RefObject<HTMLButtonElement> | null | undefined;
+}, "color" | "disabled" | "classes" | "className" | "style" | "tabIndex" | "children" | "sx" | "variant" | "size" | "fullWidth" | "href" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "disableElevation" | "disableFocusRipple" | "endIcon" | "startIcon"> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const OkayButton: import("@emotion/styled").StyledComponent<import("@mui/material/Button").ButtonOwnProps & Omit<import("@mui/material").ButtonBaseOwnProps, "classes"> & import("@mui/material/OverridableComponent").CommonProps & Omit<Omit<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
+    ref?: ((instance: HTMLButtonElement | null) => void) | import("react").RefObject<HTMLButtonElement> | null | undefined;
+}, "color" | "disabled" | "classes" | "className" | "style" | "tabIndex" | "children" | "sx" | "variant" | "size" | "fullWidth" | "href" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "disableElevation" | "disableFocusRipple" | "endIcon" | "startIcon"> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const ButtonsWrapper: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const SelectedDate: import("@emotion/styled").StyledComponent<import("@mui/material/Button").ButtonOwnProps & Omit<import("@mui/material").ButtonBaseOwnProps, "classes"> & import("@mui/material/OverridableComponent").CommonProps & Omit<Omit<import("react").DetailedHTMLProps<import("react").ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
+    ref?: ((instance: HTMLButtonElement | null) => void) | import("react").RefObject<HTMLButtonElement> | null | undefined;
+}, "color" | "disabled" | "classes" | "className" | "style" | "tabIndex" | "children" | "sx" | "variant" | "size" | "fullWidth" | "href" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "disableElevation" | "disableFocusRipple" | "endIcon" | "startIcon"> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme> & {
+    open: boolean;
+}, {}, {}>;
+export declare const Footer: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const FiltersArea: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const TimeZone: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const Main: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;
+export declare const Settings: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme> & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/system").BoxOwnProps<import("@mui/material/styles").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material/styles").Theme>, {}, {}>;

package/build/components/_v2/composites/RangeCalender/type.d.ts

@@ -0,0 +1,47 @@
+import { MouseEvent } from 'react';
+import { PopperProps } from '@mui/material/Popper';
+import { SxProps } from '@mui/system';
+import type { DateObject } from 'react-multi-date-picker';
+import type { CalenderMode, Timezone } from '../../../../types/index.js';
+import { RangeDatepickerProps } from './components/RangeDatepicker';
+export type Dates = [DateObject, DateObject];
+export interface RangeCalendarProps {
+    /** Initial [start, end] date range shown when the calendar first opens */
+    defaultDate: [Date, Date];
+    /** Called with the confirmed [start, end] dates when the user applies a selection */
+    onDateChange: (date: [Date, Date]) => void;
+    /** Calendar display mode — `gregorian` (default) or `hijri` */
+    mode?: CalenderMode;
+    /** Called with the new mode when the user toggles Hijri/Gregorian */
+    onCalendarModeSwitch?: (mode: CalenderMode) => void;
+    /** Number of calendar months rendered side by side (default: 2) */
+    numberOfMonths?: number;
+    /** Hide the timezone selector row */
+    noTimezone?: boolean;
+    /** Hide the quick-filter shortcuts (Today, Last 7 days, etc.) */
+    noQuickFilter?: boolean;
+    /** Maximum selectable date span in days; selection beyond this is blocked */
+    maxDateRange?: number;
+    /** Called with the selected group-by key when the user changes grouping */
+    onCalendarGroupChange?: (value: string) => void;
+    /** Currently active group-by key shown in the GroupBy dropdown */
+    groupBy?: string;
+    /** Currently selected timezone (controlled) */
+    timezone?: Timezone | null;
+    /** Called when the user selects a different timezone */
+    onChangeTimezone?: (timezone: Timezone) => void;
+    /** Timezone that represents the entity / account default */
+    defaultCountryTimezone?: Timezone;
+    /** IANA timezone string of the user's browser (e.g. `"Asia/Riyadh"`) */
+    browserTimezone?: string;
+    /** Custom renderer for the calendar trigger button; receives open state and click handler */
+    renderCalendarButton?: (open: boolean, onOpenCalender: (event: MouseEvent<HTMLElement>) => void) => React.ReactNode;
+    /** MUI sx overrides for the calendar root container */
+    mainSx?: SxProps;
+    /** Props forwarded to the MUI Popper wrapping the calendar panel */
+    popperProps?: Partial<PopperProps>;
+    /** Props forwarded to the inner RangeDatepicker control */
+    rangeDatePickerProps?: Partial<RangeDatepickerProps>;
+    /** ISO 3166-1 alpha-2 codes of countries shown in the entity timezone list */
+    timezoneCountriesCodes?: string[];
+}