@iress-oss/ids-components 0.0.1-dev.2 → 0.0.1-dev.20

package/dist/patterns/Loading/components/ValidateLoading.js

@@ -1,9 +1,9 @@
 import "react/jsx-runtime";
-import { af as d } from "../../../Loading-rKDsRTjZ.js";
+import { af as d } from "../../../LoadingSuspense-BwlrIicY.js";
 import "../../../index-2QXL0WYc.js";
 import "react";
 import "../../../components/Text/Text.js";
-import "../../../Loading.module-C58kTwE4.js";
+import "../../../Loading.module-g2pe-Gfx.js";
 export {
   d as ValidateLoading
 };

package/dist/patterns/Loading/index.js

@@ -1,4 +1,5 @@
-import { Q as s } from "../../Loading-rKDsRTjZ.js";
+import { P as a, Q as o } from "../../LoadingSuspense-BwlrIicY.js";
 export {
-  s as IressLoading
+  a as IressLoading,
+  o as IressLoadingSuspense
 };

package/dist/src/components/Autocomplete/Autocomplete.types.d.ts

@@ -56,6 +56,12 @@ export interface AutocompleteSearchHookProps {
      * Initial options data set, shown when the input is empty.
      */
     initialOptions?: LabelValueMeta[];
+    /**
+     * Minimum number of characters required before triggering async search. Only applies to searchable options (function).
+     * Below this threshold, no search will be triggered and no loading state will be shown.
+     * @default 1
+     */
+    minSearchLength?: number;
     /**
      * Options data set, shown when the input is not empty.
      */
@@ -91,6 +97,26 @@ export interface AutocompleteSearchHookReturn {
      * Stop the search.
      */
     stopSearch: () => void;
+    /**
+     * Whether to show "Type at least X characters to search" instruction.
+     * True when the query length is below the minimum search length.
+     */
+    shouldShowInstructions: boolean;
+    /**
+     * Whether to show nothing (clean, minimal) during debounce waiting period.
+     * True when user has typed enough characters but search hasn't started yet.
+     */
+    shouldShowDebounceWaiting: boolean;
+    /**
+     * Whether to show "No results found" message.
+     * True only after a legitimate search has been performed and returned empty results.
+     */
+    shouldShowNoResults: boolean;
+    /**
+     * Smart result calculation that handles all display scenarios.
+     * Returns the appropriate results based on current state.
+     */
+    displayResults: FormattedLabelValueMeta[];
 }
 export interface AutocompletePopoverProps extends Pick<IressInputPopoverProps, 'autoHighlight' | 'align' | 'className' | 'container' | 'contentClassName' | 'displayMode' | 'style'> {
     append?: ReactNode;
@@ -104,3 +130,15 @@ export interface AutocompleteNoResultsProps extends Pick<IressAutocompleteProps,
         noResults?: string;
     };
 }
+export interface AutocompleteInstructionsProps {
+    /**
+     * The minimum number of characters required to search.
+     */
+    minSearchLength: number;
+    /**
+     * Pass a CSS module object to override styles.
+     */
+    styles?: {
+        instructions?: string;
+    };
+}

package/dist/src/components/Autocomplete/components/AutocompleteInstructions.d.ts

@@ -0,0 +1,2 @@
+import { AutocompleteInstructionsProps } from '../Autocomplete.types';
+export declare const AutocompleteInstructions: ({ minSearchLength, styles, }: AutocompleteInstructionsProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Autocomplete/hooks/useAutocompleteSearch.d.ts

@@ -1,2 +1,6 @@
 import { AutocompleteSearchHookProps, AutocompleteSearchHookReturn } from '../Autocomplete.types';
-export declare const useAutocompleteSearch: ({ debounceThreshold, initialOptions, options, query, }: AutocompleteSearchHookProps) => AutocompleteSearchHookReturn;
+/**
+ * Advanced autocomplete search hook with debouncing and race condition protection
+ * Supports both sync array search and async function search
+ */
+export declare const useAutocompleteSearch: ({ debounceThreshold, initialOptions, minSearchLength, options, query, }: AutocompleteSearchHookProps) => AutocompleteSearchHookReturn;

package/dist/src/components/Form/Form.types.d.ts

@@ -73,6 +73,12 @@ export interface IressHookFormProps<T extends FieldValues, TContext = object> ex
      * [Learn more](https://react-hook-form.com/docs/useform/formstate)
      */
     onValidChange?: (isValid: boolean) => void;
+    /**
+     * If set to `true`, the summary will only update when the form is submitted, not on every field change.
+     * This is useful for performance reasons, especially in large forms.
+     * @default false
+     */
+    updateErrorSummaryOnSubmit?: boolean;
 }
 export interface IressFormProps<T extends FieldValues, TContext = object> extends Partial<Omit<UseFormProps<T, TContext>, 'disabled' | 'errors'>>, Omit<IressHookFormProps<T, TContext>, 'form'> {
     /**
@@ -139,7 +145,10 @@ export interface IressFormProps<T extends FieldValues, TContext = object> extend
      */
     reValidateMode?: UseFormProps<T, TContext>['reValidateMode'];
     /**
-     * When set to true (default), and the user submits a form that fails validation, focus is set on the first field with an error.
+     * When set to true, and the user submits a form that fails validation, focus is set on the first field with an error.
+     * By default, it is set based on the `hiddenErrorSummary` prop.
+     * - If hiddenErrorSummary is true, it will focus on the first field with an error.
+     * - If hiddenErrorSummary is false, it will focus on the error summary.
      *
      * [Learn more](https://react-hook-form.com/docs/useform#shouldFocusError)
      */

package/dist/src/components/Form/FormField/FormField.d.ts

@@ -4,4 +4,4 @@ import { IressFormFieldProps } from './FormField.types';
  * A `IressField` wrapper that can show error message and label automatically inside an `IressForm`.
  * It uses the `useController` hook from `react-hook-form` for form management.
  */
-export declare const IressFormField: <TFieldValues extends FieldValues>({ control, defaultValue, name, render, rules: withCustomRules, shouldUnregister, readOnly, ...fieldProps }: IressFormFieldProps<TFieldValues>) => import("react/jsx-runtime").JSX.Element;
+export declare const IressFormField: <TFieldValues extends FieldValues>({ control: controlProp, defaultValue, name, render, rules: withCustomRules, shouldUnregister, readOnly, ...fieldProps }: IressFormFieldProps<TFieldValues>) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Form/FormField/FormField.types.d.ts

@@ -11,7 +11,7 @@ export type CustomRules<T extends FieldValues = FieldValues> = UseControllerProp
     minDate?: Date | CustomRuleWithMessage<Date>;
     maxDate?: Date | CustomRuleWithMessage<Date>;
 };
-export interface IressFormFieldProps<T extends FieldValues = FieldValues, TName extends FieldPath<T> = FieldPath<T>> extends Omit<IressFieldProps, OmittedFieldProps>, Omit<UseControllerProps<T, FieldPath<T>>, 'disabled'> {
+export interface IressFormFieldProps<T extends FieldValues = FieldValues, TName extends FieldPath<T> = FieldPath<T>> extends Omit<IressFieldProps, OmittedFieldProps>, Omit<UseControllerProps<T, FieldPath<T>>, 'disabled' | 'shouldUnregister'> {
     /**
      * React Hook Form control object. It is used to register the field with the form.
      * It is automatically provided when used inside an `IressForm`, but it can be overridden if you are using a custom form control.
@@ -41,10 +41,16 @@ export interface IressFormFieldProps<T extends FieldValues = FieldValues, TName
     rules?: CustomRules<T>;
     /**
      * Input will be unregistered after unmount and defaultValues will be removed as well (it will not be stored in the form state).
+     * You can pass an object to keep some form state available after unregistering, such as dirty fields.
      *
      * [Learn more](https://react-hook-form.com/docs/usecontroller)
      */
-    shouldUnregister?: boolean;
+    shouldUnregister?: boolean | {
+        keepDirty?: boolean;
+        keepTouched?: boolean;
+        keepIsValid?: boolean;
+        keepError?: boolean;
+    };
     /**
      * Text to be displayed instead of input field.
      */

package/dist/src/components/Modal/Modal.types.d.ts

@@ -50,6 +50,10 @@ export interface IressModalProps extends IressHTMLAttributes {
      * Emitted when the modal has opened or closed internally. Use for controlled modals.
      */
     onShowChange?: (show: boolean) => void;
+    /**
+     * Emitted when the modal has mounted, unmounted, opened or closed. Open and close occur before animation begins.
+     */
+    onStatus?: (status: 'unmounted' | 'initial' | 'open' | 'close') => void;
     /**
      * Emitted when the modal has opened.
      */

package/dist/src/components/Popover/Popover.types.d.ts

@@ -142,6 +142,8 @@ export interface PopoverContextValue extends PopoverStateHookReturn, PopoverAria
     interactions: ReturnType<typeof useInteractions>;
     list: MutableRefObject<(HTMLElement | null)[]>;
     type?: PopoverTypes;
+    resetActiveIndex: () => void;
+    setActiveIndex: (value: number | null) => void;
     setShowWithReason: (flag: boolean, e?: Event, reason?: OpenChangeReason) => void;
     setVirtualFocus?: (node: PopoverVirtualNode | null) => void;
 }
@@ -152,7 +154,7 @@ export interface PopoverRef extends Pick<PopoverContextValue, 'setShow' | 'show'
 }
 export interface PopoverVirtualNode {
     onBlur?: React.KeyboardEventHandler<HTMLElement>;
-    onKeyDown?: React.KeyboardEventHandler<HTMLElement>;
+    onKeyDown?: (e: React.KeyboardEvent<HTMLElement>, popover?: PopoverContextValue) => void;
 }
 /** @deprecated PopoverType enum is now deprecated and will be removed in a future version. Please use the PopoverTypes type instead. **/
 export declare enum PopoverType {

package/dist/src/components/Popover/components/NestedPopoverActivator.d.ts

@@ -0,0 +1,5 @@
+import { PropsWithChildren } from 'react';
+import { PopoverContextValue } from '../Popover.types';
+export declare const NestedPopoverActivator: ({ children, parentPopover, }: PropsWithChildren & {
+    parentPopover?: PopoverContextValue;
+}) => string | number | boolean | Iterable<import('react').ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;

package/dist/src/components/Popover/helpers/handlePopoverTabKey.d.ts

@@ -5,4 +5,4 @@ import { KeyboardEvent } from 'react';
  * @param popover {PopoverContextValue} The popover context value, usually retrieved from the usePopover hook.
  * @param e {KeyboardEvent} The keyboard event object that triggered the tab key press.
  */
-export declare const handlePopoverTabKey: (popover: PopoverContextValue, e: KeyboardEvent) => void;
+export declare const handlePopoverTabKey: (popover: PopoverContextValue, e: KeyboardEvent) => Promise<void>;

package/dist/src/components/Popover/helpers/waitUntilTrue.d.ts

@@ -0,0 +1 @@
+export declare const waitUntilTrue: (condition: () => boolean, timeout?: number, interval?: number) => Promise<void>;

package/dist/src/components/Provider/Provider.d.ts

@@ -0,0 +1,20 @@
+import { FloatingUIContainer } from '../../types';
+import { ReactNode } from 'react';
+import { IressToasterProviderProps } from '../Toaster';
+import { IressSlideoutProviderProps } from '../Slideout';
+export interface IressProviderProps extends Pick<IressSlideoutProviderProps, 'injectPushStyles'>, Pick<IressToasterProviderProps, 'position'> {
+    /**
+     * The contents of your application, and/or the components which will be calling slideouts, modals and toasts.
+     */
+    children?: ReactNode;
+    /**
+     * Container to render modal, slideouts and toasts into.
+     * If not provided, will render into the body of the document.
+     */
+    container?: FloatingUIContainer;
+    /**
+     * If you don't want to load the Iress Icon CSS from the CDN, set this to true.
+     */
+    noIcons?: boolean;
+}
+export declare const IressProvider: ({ children, container, injectPushStyles, noIcons, position, ...restProps }: IressProviderProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Provider/index.d.ts

@@ -0,0 +1 @@
+export * from './Provider';

package/dist/src/components/RichSelect/RichSelect.types.d.ts

@@ -1,12 +1,18 @@
 import { AutocompleteSearchHookProps } from '../Autocomplete';
 import { FloatingUIAligns, FocusableElementRef, FormattedLabelValueMeta, FormElementWidths, IressPopoverProps, LabelValueMeta, PopoverRef, PopoverTypes } from '../../main';
 import { ChangeEvent, ForwardedRef, ReactElement, ReactNode } from 'react';
-export interface IressRichSelectProps extends Omit<AutocompleteSearchHookProps, 'query'>, Omit<IressPopoverProps, 'activator' | 'children' | 'contentClassName' | 'defaultShow' | 'defaultValue' | 'disabledAutoToggle' | 'onChange' | 'matchActivatorWidth' | 'show'> {
+export interface IressRichSelectProps extends Omit<AutocompleteSearchHookProps, 'query'>, Omit<IressPopoverProps, 'activator' | 'children' | 'contentClassName' | 'defaultShow' | 'defaultValue' | 'disabledAutoToggle' | 'onChange' | 'show'> {
     /**
      * Sets the alignment of the dropdown relative to the activator element.
      * @default bottom-start
      */
     align?: FloatingUIAligns;
+    /**
+     * By default, the RichSelect will automatically highlight the first option in the list when it is opened.
+     * Set this to false to disable that behaviour.
+     * @default true
+     */
+    autoHighlight?: boolean;
     /**
      * Value of selected option for uncontrolled select.
      */
@@ -15,6 +21,13 @@ export interface IressRichSelectProps extends Omit<AutocompleteSearchHookProps,
      * Set to true if the user can select multiple options.
      */
     multiSelect?: boolean;
+    /**
+     * Whether the popover should match the width of the activator element.
+     * When true, the dropdown will have the same width as the select input.
+     * When false, the dropdown will size based on its content.
+     * @default true
+     */
+    matchActivatorWidth?: boolean;
     /**
      * Name of the select. Used to pass data when submitted within a form.
      */
@@ -59,6 +72,11 @@ export interface IressRichSelectProps extends Omit<AutocompleteSearchHookProps,
      * Completely customise the rendering of the select options.
      */
     renderOptions?: (props: SelectOptionsRenderProps) => ReactNode;
+    /**
+     * Render a custom footer below the default options display.
+     * If using `renderOptions`, this render prop will not be called.
+     */
+    renderOptionsFooter?: (props: SelectOptionsRenderProps) => ReactNode;
     /**
      * Whether its required. Will be passed to the hidden input.
      */
@@ -74,6 +92,14 @@ export interface IressRichSelectProps extends Omit<AutocompleteSearchHookProps,
      */
     width?: FormElementWidths;
     virtualFocus?: boolean;
+    /**
+     * Header showed in option panel when expanded.
+     */
+    header?: ReactNode;
+    /**
+     * Footer showed in option panel when expanded.
+     */
+    footer?: ReactNode;
 }
 export interface IressSelectActivatorProps {
     /**

package/dist/src/components/RichSelect/SelectMenu/SelectMenuItem.d.ts

@@ -1,2 +1,2 @@
 import { IressSelectMenuItemProps } from './SelectMenu.types';
-export declare const IressSelectMenuItem: ({ className, divider, formattedLabel, hiddenOnMobile, label, meta, value, ...restProps }: IressSelectMenuItemProps) => import("react/jsx-runtime").JSX.Element;
+export declare const IressSelectMenuItem: ({ className, divider, formattedLabel, formattedMeta, hiddenOnMobile, label, meta, value, append, canToggle, onClick, onKeyDown, prepend, role, selected, "data-testid": dataTestId, "aria-describedby": ariaDescribedBy, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, id, }: IressSelectMenuItemProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/components/RichSelect/components/SelectOptions.d.ts

@@ -1,6 +1,8 @@
 import { IressRichSelectProps, SelectOptionsRenderProps } from '../RichSelect.types';
-interface SelectOptionsProps extends Pick<IressRichSelectProps, 'multiSelect' | 'onChange' | 'options' | 'renderOptions' | 'value' | 'initialOptions'>, Omit<SelectOptionsRenderProps, 'close'> {
+interface SelectOptionsProps extends Pick<IressRichSelectProps, 'autoHighlight' | 'minSearchLength' | 'multiSelect' | 'onChange' | 'options' | 'renderOptions' | 'renderOptionsFooter' | 'value' | 'initialOptions'>, Omit<SelectOptionsRenderProps, 'close'> {
     setShow: (show: boolean) => void;
+    shouldShowInstructions?: boolean;
+    shouldShowNoResults?: boolean;
 }
-export declare const SelectOptions: ({ debouncedQuery, error, initialOptions: initialOptionsProp, loading, multiSelect, onChange, options, query, renderOptions, results, setQuery, setShow, setValue, show, value, }: SelectOptionsProps) => string | number | boolean | Iterable<import('react').ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
+export declare const SelectOptions: ({ autoHighlight, debouncedQuery, error, initialOptions: initialOptionsProp, loading, minSearchLength, multiSelect, onChange, options, query, renderOptions, renderOptionsFooter, results, setQuery, setShow, setValue, show, value, shouldShowInstructions, shouldShowNoResults, }: SelectOptionsProps) => string | number | boolean | Iterable<import('react').ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
 export {};

package/dist/src/components/Slideout/Slideout.types.d.ts

@@ -58,6 +58,10 @@ export interface IressSlideoutProps extends IressHTMLAttributes {
      * Use for controlled slideouts.
      */
     onShowChange?: (show: boolean, reason?: OpenChangeReason) => void;
+    /**
+     * Emitted when the slideout has mounted, unmounted, opened or closed. Open and close occur before animation begins.
+     */
+    onStatus?: (status: 'unmounted' | 'initial' | 'open' | 'close') => void;
     /**
      * Emitted when the slideout has opened.
      */
@@ -97,7 +101,7 @@ export interface IressSlideoutProviderProps extends PropsWithChildren {
      * If you are rendering a slideout inside a micro-frontend, using `push` mode and `eleToPush` is targetting an element in the parent app, you will need to set this to `true` to ensure the styles are injected into the parent app.
      * This will ensure the slideout is positioned correctly and the element is pushed correctly.
      */
-    injectPushStyles?: boolean;
+    injectPushStyles?: boolean | string;
 }
 export interface IressSlideoutContextValue {
     container?: FloatingUIContainer;

package/dist/src/components/Table/Table.d.ts

@@ -1,6 +1,7 @@
-import { IressTableProps, TableScope } from './Table.types';
-export declare const IressTable: {
-    <TRow extends object = never, TVal = never>({ caption, children, columns, compact, className, "data-testid": dataTestId, empty, hiddenCaption, hiddenHeader, hover, rowProps, rows, scope, ...restProps }: IressTableProps<TRow, TVal>): import("react/jsx-runtime").JSX.Element;
-    /** @deprecated IressTable.Scope enum is now deprecated and will be removed in a future version. Please use the value directly instead. **/
-    Scope: typeof TableScope;
-};
+import { IressTableProps, TableEnums, TableExports, TableRef } from './Table.types';
+import { ReactElement, Ref } from 'react';
+declare const ForwardedTable: <TRow extends object = never, TVal = never>(props: IressTableProps<TRow, TVal> & {
+    ref?: Ref<TableRef<TRow>>;
+}) => ReactElement;
+export declare const IressTable: typeof ForwardedTable & TableEnums & TableExports;
+export {};

package/dist/src/components/Table/Table.types.d.ts

@@ -168,7 +168,16 @@ export interface TableColumnStylesHook {
     className: string;
     style: React.CSSProperties;
 }
-export interface TableWithEnums<TRow extends object, TVal = unknown> extends React.FC<IressTableProps<TRow, TVal>> {
+export interface TableRef<TRow extends object> {
+    api: Table<TRow>;
+}
+export interface TableExports {
+    /**
+     * Allows you to access the table context within a child of the `IressTable`.
+     */
+    useTable: <TRow extends object, TVal = never>() => TableContextValue<TRow, TVal>;
+}
+export interface TableEnums {
     /** @deprecated IressTable.Scope enum is now deprecated and will be removed in a future version. Please use the value directly instead. **/
     Scope: typeof TableScope;
 }

package/dist/src/components/Table/TableProvider.d.ts

@@ -1,2 +1,5 @@
-import { IressTableProviderProps } from './Table.types';
-export declare const IressTableProvider: <TRow extends object, TVal = unknown>({ children, columns, rows, }: IressTableProviderProps<TRow, TVal>) => import("react/jsx-runtime").JSX.Element;
+import { ReactElement, Ref } from 'react';
+import { IressTableProviderProps, TableRef } from './Table.types';
+export declare const IressTableProvider: <TRow extends object = never, TVal = never>(props: IressTableProviderProps<TRow, TVal> & {
+    ref?: Ref<TableRef<TRow>>;
+}) => ReactElement;

package/dist/src/components/Toaster/Toast/Toast.types.d.ts

@@ -1,6 +1,7 @@
 import { default as React } from 'react';
 import { IressHTMLAttributes } from '../../../interfaces';
 import { HeadingLevel } from '../../../enums';
+import { ButtonRef } from '../../Button';
 interface ToastHeadingProps<T = HTMLDivElement> extends IressHTMLAttributes<T> {
     /**
      * The heading area of the toast. You can pass react component such as `<IressText>Error</IressText>`.
@@ -17,7 +18,7 @@ interface ToastCloseButtonProps<T = HTMLDivElement> extends IressHTMLAttributes<
     /**
      * Click event on the close button of the toast.
      */
-    onClose?: React.MouseEventHandler<HTMLButtonElement>;
+    onClose?: (e?: React.MouseEvent<ButtonRef>) => void;
 }
 interface ToastActionProps<T = HTMLDivElement> extends IressHTMLAttributes<T> {
     /**

package/dist/src/components/Toaster/ToasterProvider.d.ts

@@ -1,8 +1,11 @@
+import { MouseEvent } from 'react';
 import { IressToasterOptions, IressToasterProviderProps } from './Toaster.types';
 import { IressToastProps } from './Toast/Toast.types';
+import { ButtonRef } from '../Button';
 interface ToasterContextValue {
-    show: (toast: IressToastProps) => void;
-    close: (id: string) => void;
+    animateOut: (id: string) => void;
+    show: (toast: IressToastProps) => string;
+    close: (id: string, e?: MouseEvent<ButtonRef>) => void;
     options: IressToasterOptions;
     setOptions: (options: IressToasterOptions) => void;
 }

package/dist/src/components/Toaster/hooks/useToaster.d.ts

@@ -1,9 +1,9 @@
 import { NewToast } from '../Toast/Toast.types';
 import { ToasterPositions } from '../Toaster.types';
 export declare const useToaster: (position?: ToasterPositions) => {
-    success: (toast: NewToast) => void;
-    error: (toast: NewToast) => void;
-    info: (toast: NewToast) => void;
+    success: (toast: NewToast) => string;
+    error: (toast: NewToast) => string;
+    info: (toast: NewToast) => string;
     close: (id: string) => void;
     options: import('../Toaster.types').IressToasterOptions;
 };

package/dist/src/constants.d.ts

@@ -95,29 +95,29 @@ export declare const Z_INDEX: {
     /**
      * The default z-index used for most elements. Can be combined with raised and floating elevations.
      */
-    '000': number;
+    DEFAULT: number;
     /**
      * Used for IressNavbar. Can be combined with overflow elevation.
      */
-    100: number;
+    NAVBAR: number;
     /**
      * Used for IressPopover. Can be combined with floating elevation.
      */
-    200: number;
+    POPOVER: number;
     /**
      * Used for IressSlideout. Can be combined with floating elevation.
      */
-    300: number;
+    SLIDEOUT: number;
     /**
      * Used for IressModal. Can be combined with floating elevation.
      */
-    400: number;
+    MODAL: number;
     /**
      * Used for IressToast. Can be combined with floating elevation.
      */
-    500: number;
+    TOAST: number;
     /**
      * Used for IressTooltip. Can be combined with floating elevation.
      */
-    600: number;
+    TOOLTIP: number;
 };

package/dist/src/helpers/dom/closestCrossShadow.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Finds the closest ancestor element that matches the selector, traversing across shadow DOM boundaries.
+ * Similar to native Element.closest() but works across shadow DOM.
+ *
+ * @param element - The starting element
+ * @param selector - CSS selector to match against
+ * @returns The closest ancestor element matching the selector, or null if not found
+ */
+export declare const closestCrossShadow: (element: Element | null, selector: string) => Element | null;

package/dist/src/helpers/dom/domUtils.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Safely calls the closest method on an element, handling cases where the element
+ * might not have the closest method (e.g., in jsdom environments)
+ */
+export declare const safeClosest: (element: Element | null, selector: string) => Element | null;

package/dist/src/interfaces.d.ts

@@ -55,6 +55,7 @@ export interface LabelValueMeta extends LabelValue {
 }
 export interface FormattedLabelValueMeta extends LabelValueMeta {
     formattedLabel?: React.ReactNode;
+    formattedMeta?: React.ReactNode;
 }
 export interface BreakpointDetail {
     mediaQuery: string;

package/dist/src/main.d.ts

@@ -27,6 +27,7 @@ export * from './components/Panel';
 export * from './components/Placeholder';
 export * from './components/Popover';
 export * from './components/Progress';
+export * from './components/Provider';
 export * from './components/Radio';
 export * from './components/RadioGroup';
 export * from './components/Readonly';

package/dist/src/patterns/Loading/LoadingSuspense.d.ts

@@ -5,7 +5,7 @@ import { PageLoadingProps } from './components/PageLoading';
 import { ComponentLoadingProps } from './components/ComponentLoading';
 import { LongLoadingProps } from './components/LongLoading';
 import { DefaultLoadingProps } from './components/DefaultLoading';
-type IressLoadingSuspenseProps = (Omit<StartUpLoadingProps, 'loaded'> | ValidateLoadingProps | Omit<PageLoadingProps, 'loaded'> | Omit<ComponentLoadingProps, 'loaded'> | Omit<LongLoadingProps, 'loaded'> | DefaultLoadingProps) & {
+export type IressLoadingSuspenseProps = (Omit<StartUpLoadingProps, 'loaded'> | ValidateLoadingProps | Omit<PageLoadingProps, 'loaded'> | Omit<ComponentLoadingProps, 'loaded'> | Omit<LongLoadingProps, 'loaded'> | DefaultLoadingProps) & {
     /**
      * The content that will be rendered inside the Suspense boundary.
      * Typically includes lazy-loaded components and components that use the `use` or `IressLoadingSuspense.use` hook.
@@ -71,4 +71,3 @@ export declare const IressLoadingSuspense: {
      */
     uncache: (fetcher: () => Promise<unknown>, timeout?: number) => void;
 };
-export {};

package/dist/src/patterns/Loading/components/PageLoading.d.ts

@@ -1,9 +1,9 @@
 import { ReactNode } from 'react';
 import { IressHTMLAttributes } from '../../../interfaces';
 declare const templates: {
-    page: import("react/jsx-runtime").JSX.Element;
-    form: import("react/jsx-runtime").JSX.Element;
-    dashboard: import("react/jsx-runtime").JSX.Element;
+    page: () => import("react/jsx-runtime").JSX.Element;
+    form: () => import("react/jsx-runtime").JSX.Element;
+    dashboard: () => import("react/jsx-runtime").JSX.Element;
 };
 export interface PageLoadingProps extends Omit<IressHTMLAttributes, 'children'> {
     /**

package/dist/src/patterns/Loading/hooks/useShouldRenderLoading.d.ts

@@ -4,6 +4,7 @@
  * @param isLoaded - A boolean value that determines if the component waiting to be loaded has finished loading.
  * @param delay - Once a component has loaded, how long should the loading indicator be displayed for. This is useful to allow the loading indicator to animate out.
  * @param startFrom - If a component is still loading after this time in milliseconds, you should show the loading message. Default is 500ms, meaning a user will not even see the loading indicator if the page loads before this time.
+ * @param avoidDelayTimeout - If the component has a start up animation, this is the time in milliseconds that we will avoid the delay timeout for. This is useful to speed up the loading indicator removal if the component loaded before the first half of an animation finishes.
  * @returns A boolean value that determines whether the `IressLoading` component should be rendered.
  */
 export declare const useShouldRenderLoading: (isLoaded: boolean, delay?: number, startFrom?: number, avoidDelayTimeout?: number) => boolean;

package/dist/src/patterns/Loading/index.d.ts

@@ -1 +1,2 @@
 export * from './Loading';
+export * from './LoadingSuspense';