@gooddata/sdk-ui-kit 11.13.0-alpha.0 → 11.13.0-alpha.2

package/esm/sdk-ui-kit.d.ts

@@ -51,7 +51,8 @@ import { IMeasureSortTarget } from '@gooddata/sdk-model';
 import { IMetadataObjectBase } from '@gooddata/sdk-model';
 import { IntlShape } from 'react-intl';
 import { ISeparators } from '@gooddata/sdk-ui';
-import { ISeparators as ISeparators_2 } from '@gooddata/sdk-model';
+import { ISeparators as ISeparators_2 } from '@gooddata/number-formatter';
+import { ISeparators as ISeparators_3 } from '@gooddata/sdk-model';
 import { ISettings } from '@gooddata/sdk-model';
 import { ISortItem } from '@gooddata/sdk-model';
 import { ITheme } from '@gooddata/sdk-model';
@@ -64,6 +65,7 @@ import { KeyboardEventHandler } from 'react';
 import { LocalIdRef } from '@gooddata/sdk-model';
 import { MemoExoticComponent } from 'react';
 import { MessageDescriptor } from 'react-intl';
+import type { MetricType } from '@gooddata/sdk-model';
 import { ModifierKey } from 'react';
 import { MouseEvent as MouseEvent_2 } from 'react';
 import { MutableRefObject } from 'react';
@@ -139,7 +141,7 @@ export declare function alignConfigToAlignPoint({ triggerAlignPoint, overlayAlig
 export declare type Alignment = {
     left: number;
     top: number;
-    right: number;
+    right?: number;
     width?: number;
     height?: number;
     align: string;
@@ -148,7 +150,7 @@ export declare type Alignment = {
 /**
  * @internal
  */
-export declare const AppHeader: ComponentType<Omit<WithIntlProps<IAppHeaderProps & WrappedComponentProps>, "theme" | "themeIsLoading" | "themeStatus">>;
+export declare const AppHeader: ComponentType<Omit<IAppHeaderProps, "theme" | "themeIsLoading" | "themeStatus">>;
 
 /**
  * @internal
@@ -417,9 +419,7 @@ export declare type Color = string;
 /**
  * @internal
  */
-export declare const ColorPicker: FC<WithIntlProps<IColorPickerProps & WrappedComponentProps>> & {
-    WrappedComponent: ComponentType<IColorPickerProps & WrappedComponentProps>;
-};
+export declare function ColorPicker(props: IColorPickerProps): JSX.Element;
 
 /**
  * @internal
@@ -468,6 +468,29 @@ export declare function ContentDivider({ className }: {
  */
 export declare type CopyCodeOriginType = "keyboard" | "button";
 
+/**
+ * Creates localized currency format presets.
+ *
+ * @param formatMessage - Function to format localized messages (e.g., from react-intl)
+ * @returns Array of currency format presets with localized names
+ * @internal
+ */
+export declare function createCurrencyPresets(formatMessage: (descriptor: {
+    id: string;
+}) => string): IFormatPreset[];
+
+/**
+ * Base currency preset definitions.
+ * These are the raw preset data that can be used to create localized presets.
+ * @internal
+ */
+export declare const CURRENCY_PRESET_DEFINITIONS: readonly ICurrencyPresetDefinition[];
+
+/**
+ * @alpha
+ */
+export declare type CurrencyFormatValidationErrorCode = "empty" | "invalidFormat" | "missingCurrencySymbol" | "missingDecimalPlaces";
+
 /**
  * @internal
  */
@@ -590,7 +613,7 @@ export declare const DefaultUiMenuStaticItem: MemoExoticComponent<(<T extends IU
 /**
  * @internal
  */
-export declare function DefaultUiTabsAllTabs<TTabProps extends Record<any, any> = EmptyObject, TTabActionProps extends Record<any, any> = EmptyObject>(_props: IUiTabComponentProps<"AllTabs", TTabProps, TTabActionProps>): JSX.Element;
+export declare function DefaultUiTabsAllTabs<TTabProps extends Record<any, any> = EmptyObject, TTabActionProps extends Record<any, any> = EmptyObject>(_props: IUiTabComponentProps<"AllTabs", TTabProps, TTabActionProps>): JSX.Element | null;
 
 /**
  * @internal
@@ -615,12 +638,12 @@ export declare function DefaultUiTabsTab<TTabProps extends Record<any, any> = Em
 /**
  * @internal
  */
-export declare function DefaultUiTabsTabActions<TTabProps extends Record<any, any> = EmptyObject, TTabActionProps extends Record<any, any> = EmptyObject>({ tab, location, id, tabIndex, isOpen, onToggleOpen, }: IUiTabComponentProps<"TabActions", TTabProps, TTabActionProps>): JSX.Element;
+export declare function DefaultUiTabsTabActions<TTabProps extends Record<any, any> = EmptyObject, TTabActionProps extends Record<any, any> = EmptyObject>({ tab, location, id, tabIndex, isOpen, onToggleOpen, }: IUiTabComponentProps<"TabActions", TTabProps, TTabActionProps>): JSX.Element | null;
 
 /**
  * @internal
  */
-export declare function DefaultUiTabsTabActionsButton<TTabProps extends Record<any, any> = EmptyObject, TTabActionProps extends Record<any, any> = EmptyObject>({ tab, onClick, ariaAttributes, tabIndex, id, }: IUiTabComponentProps<"TabActionsButton", TTabProps, TTabActionProps>): JSX.Element;
+export declare function DefaultUiTabsTabActionsButton<TTabProps extends Record<any, any> = EmptyObject, TTabActionProps extends Record<any, any> = EmptyObject>({ tab, onClick, ariaAttributes, tabIndex, id, }: IUiTabComponentProps<"TabActionsButton", TTabProps, TTabActionProps>): JSX.Element | null;
 
 /**
  * @internal
@@ -721,7 +744,7 @@ export declare type DialogModeType = "ShareGrantee" | "AddGrantee";
 /**
  * @internal
  */
-export declare function DocumentHeader({ pageTitle, brandTitle, appleTouchIconUrl, faviconUrl, }: IDocumentHeaderProps): any;
+export declare function DocumentHeader({ pageTitle, brandTitle, appleTouchIconUrl, faviconUrl, }: IDocumentHeaderProps): null;
 
 /**
  * @internal
@@ -833,9 +856,7 @@ export declare function FilterGroupItem({ title, subtitle, selectedItemsCount, s
 /**
  * @internal
  */
-export declare const FilterLabel: FC<WithIntlProps<IFilterLabelProps & WrappedComponentProps>> & {
-    WrappedComponent: ComponentType<IFilterLabelProps & WrappedComponentProps>;
-};
+export declare const FilterLabel: NamedExoticComponent<IFilterLabelProps>;
 
 /**
  * @internal
@@ -1062,7 +1083,7 @@ export declare const getItemsByInteractiveParent: <T extends IUiMenuItemData = o
 /**
  * @internal
  */
-export declare const getNextFocusableElement: (initialElement: HTMLElement | undefined, focusableElements: HTMLElement[], direction: NavigationDirection) => HTMLElement;
+export declare const getNextFocusableElement: (initialElement: HTMLElement | undefined, focusableElements: HTMLElement[], direction: NavigationDirection) => HTMLElement | undefined;
 
 /**
  * Gets all next sibling items of a menu item with wraparound.
@@ -1111,7 +1132,7 @@ export declare const getPreviousSiblings: <T extends IUiMenuItemData = object>(i
 /**
  * @internal
  */
-export declare function getRecommendedDateDataset<T extends IDateDataset>(items: T[]): T;
+export declare function getRecommendedDateDataset<T extends IDateDataset>(items: T[]): T | null;
 
 /**
  * @internal
@@ -1137,7 +1158,7 @@ export declare type GranteeItem = IGranteeUser | IGranteeInactiveOwner | IGrante
 /**
  * @internal
  */
-export declare function GranteeItemComponent({ grantee, mode, currentUserPermissions, isSharedObjectLocked, isGranteeShareLoading, onDelete, onChange, }: IGranteeItemProps): JSX.Element;
+export declare function GranteeItemComponent({ grantee, mode, currentUserPermissions, isSharedObjectLocked, isGranteeShareLoading, onDelete, onChange, }: IGranteeItemProps): JSX.Element | null;
 
 /**
  * @internal
@@ -2321,6 +2342,56 @@ export declare function IconWebsite({ color, className, width, height }: IIconPr
  */
 export declare function IconWidget({ color, className, width, height }: IIconProps): JSX.Element;
 
+/**
+ * @alpha
+ */
+export declare interface ICurrencyFormatValidationError {
+    code: CurrencyFormatValidationErrorCode;
+    /**
+     * Indexes of sections (0-based) that failed validation.
+     * The value is only present for section-driven validations.
+     */
+    sectionIndexes?: number[];
+    message: string;
+}
+
+/**
+ * @alpha
+ */
+export declare interface ICurrencyFormatValidationOptions {
+    /**
+     * Sample value used to verify the formatter does not throw.
+     * Defaults to 12345.67 to cover both thousands and decimals.
+     */
+    sampleValue?: number;
+    /**
+     * Number of mandatory decimal places each section must contain.
+     * Set to 0 (or a negative value) to skip the decimal check.
+     * Defaults to 2.
+     */
+    requiredDecimalPlaces?: number;
+    separators?: ISeparators_2;
+}
+
+/**
+ * @alpha
+ */
+export declare interface ICurrencyFormatValidationResult {
+    isValid: boolean;
+    errors: ICurrencyFormatValidationError[];
+}
+
+/**
+ * Base currency preset definitions without localized names.
+ * @internal
+ */
+export declare interface ICurrencyPresetDefinition {
+    localIdentifier: string;
+    format: string;
+    previewNumber: number;
+    messageId: string;
+}
+
 /**
  * @internal
  */
@@ -2413,7 +2484,7 @@ export declare interface IDescriptionPanelProps {
     useReferences?: boolean;
     LoadingComponent?: ComponentType;
     filters?: IFilter[];
-    separators?: ISeparators_2;
+    separators?: ISeparators_3;
     execConfig?: IExecutionConfig;
     id?: string;
 }
@@ -3470,7 +3541,7 @@ export declare interface IInsightListItemProps {
     type?: string;
     width?: number;
     filters?: IFilter[];
-    separators?: ISeparators_2;
+    separators?: ISeparators_3;
     onClick?: () => void;
     onDelete?: () => void;
     onDescriptionPanelOpen?: () => void;
@@ -3894,7 +3965,6 @@ export declare interface ILegacyListState {
  * @internal
  */
 export declare interface ILegacyMultiSelectListItemProps {
-    intl: IntlShape;
     isLoading?: boolean;
     onMouseOut?: (source: any) => void;
     onMouseOver?: (source: any) => void;
@@ -4032,7 +4102,7 @@ export declare interface ILoadingSpinner {
  */
 export declare interface ILocaleSettingProps {
     isChecked: boolean;
-    selectedLocal: ILocale;
+    selectedLocal?: ILocale;
     onChecked: () => void;
     onLocaleSelected: (locale: ILocale) => void;
 }
@@ -4257,7 +4327,6 @@ export declare interface IMultiSelectListItemProps {
  * @internal
  */
 export declare interface IMultiSelectListProps<T> {
-    intl: IntlShape;
     height?: number;
     width?: number;
     itemHeight?: number;
@@ -4329,7 +4398,7 @@ export declare class Input extends PureComponent<InputPureProps, InputState> {
         labelPositionTop: boolean;
         value: string;
     };
-    inputNodeRef: InputPure;
+    inputNodeRef: InputPure | null;
     constructor(props: InputPureProps);
     UNSAFE_componentWillReceiveProps(nextProps: InputPureProps): void;
     onChange: (value: string | number, e?: ChangeEvent<HTMLInputElement>) => void;
@@ -4341,7 +4410,7 @@ export declare class Input extends PureComponent<InputPureProps, InputState> {
  * @internal
  */
 export declare class InputPure extends PureComponent<InputPureProps> implements IDomNative {
-    inputNodeRef: HTMLInputElement;
+    inputNodeRef: HTMLInputElement | null;
     private autofocusDispatcher;
     static defaultProps: {
         autofocus: boolean;
@@ -4435,49 +4504,13 @@ export declare interface InputState {
 /**
  * @internal
  */
-export declare class InputWithNumberFormat extends PureComponent<InputWithNumberFormatProps, InputWithNumberFormatState> {
-    private input;
-    static defaultProps: {
-        separators: {
-            thousand: string;
-            decimal: string;
-        };
-        autofocus: boolean;
-        className: string;
-        clearOnEsc: boolean;
-        disabled: boolean;
-        hasError: boolean;
-        hasWarning: boolean;
-        isSearch: boolean;
-        isSmall: boolean;
-        maxlength: number;
-        onChange: (..._: any[]) => void;
-        onEscKeyPress: (..._: any[]) => void;
-        onEnterKeyPress: (..._: any[]) => void;
-        onBlur: (..._: any[]) => void;
-        onFocus: (..._: any[]) => void;
-        placeholder: string;
-        prefix: string;
-        readonly: boolean;
-        suffix: string;
-        label: string;
-        labelPositionTop: boolean;
-        value: string;
-    };
-    constructor(props: InputWithNumberFormatProps);
-    UNSAFE_componentWillReceiveProps({ value: newValue }: InputWithNumberFormatProps): void;
-    onChange: (value: number, e: ChangeEvent<HTMLInputElement>) => void;
-    onFocus: (e: FocusEvent_2<HTMLInputElement>) => void;
-    onBlur: (e: FocusEvent_2<HTMLInputElement>) => void;
-    handleCaretShift(e: ChangeEvent<HTMLInputElement>): void;
-    render(): JSX.Element;
-}
+export declare const InputWithNumberFormat: NamedExoticComponent<InputWithNumberFormatProps>;
 
 /**
  * @internal
  */
 export declare interface InputWithNumberFormatOwnProps {
-    separators: Separators;
+    separators?: Separators;
 }
 
 /**
@@ -4506,9 +4539,7 @@ export declare function InsightIcon({ visualizationUrl, iconProps, }: IInsightIc
 /**
  * @internal
  */
-export declare const InsightListItem: FC<WithIntlProps<IInsightListItemProps & WrappedComponentProps>> & {
-    WrappedComponent: ComponentType<IInsightListItemProps & WrappedComponentProps>;
-};
+export declare function InsightListItem({ title, description, updated, type, isSelected, isLoading, filters, separators, LoadingComponent, onClick, onDescriptionPanelOpen, showDescriptionPanel, useRichText, useReferences, richTextExecConfig, width, isLocked, onDelete, metadataTimeZone, }: IInsightListItemProps): JSX.Element;
 
 /**
  * @internal
@@ -4538,7 +4569,7 @@ export declare function InvertableSelect<T>(props: IInvertableSelectProps<T>): J
 /**
  * @internal
  */
-export declare function InvertableSelectAllCheckbox({ isVisible, checked, onToggle, onApplyButtonClick, isApplyDisabled, isFiltered, totalItemsCount, isPartialSelection, }: IInvertableSelectAllCheckboxProps): JSX.Element;
+export declare function InvertableSelectAllCheckbox({ isVisible, checked, onToggle, onApplyButtonClick, isApplyDisabled, isFiltered, totalItemsCount, isPartialSelection, }: IInvertableSelectAllCheckboxProps): JSX.Element | null;
 
 /**
  * @internal
@@ -4666,7 +4697,7 @@ export declare interface IOverlayState {
     alignment: {
         left: number;
         top: number;
-        right: number;
+        right?: number;
         width?: number;
         height?: number;
         align: string;
@@ -4674,7 +4705,7 @@ export declare interface IOverlayState {
     visiblePart: number;
     overflow?: string;
     scrollTop?: number;
-    observedHeight?: number;
+    observedHeight: number;
 }
 
 /**
@@ -4853,7 +4884,7 @@ export declare interface IRichTextProps {
     /**
      * Separators to be used for rendering references.
      */
-    separators?: ISeparators_2;
+    separators?: ISeparators_3;
     /**
      * @alpha
      */
@@ -4948,6 +4979,14 @@ export declare interface IScrollGradientProps {
     children?: ReactNode;
 }
 
+/**
+ * Checks if a format string represents a currency format.
+ * A currency format is one where at least one numeric section contains a currency symbol.
+ *
+ * @alpha
+ */
+export declare function isCurrencyFormat(format: string | undefined | null): boolean;
+
 /**
  * @internal
  */
@@ -4977,7 +5016,7 @@ export declare interface ISearchResultsAnnouncementProps {
  * @param element - the element to test for focusability
  * @returns whether or not the supplied element is focusable
  */
-export declare const isElementFocusable: (element?: HTMLElement | null, includeHidden?: boolean) => boolean;
+export declare const isElementFocusable: (element?: HTMLElement | null, includeHidden?: boolean) => boolean | undefined;
 
 /**
  * @internal
@@ -5411,7 +5450,7 @@ export declare interface IStylingSettingWidgetProps<T extends StylingPickerItemC
     className?: string;
     shouldDisableCancelButton?: boolean;
     shouldDisableApplyButton?: boolean;
-    onApply?: (ref: ObjRef) => void;
+    onApply?: (ref: ObjRef | null) => void;
     onCancel?: () => void;
     onListActionClick?: () => void;
     onItemEdit?: (modifiedItem: IStylingPickerItem<T>) => void;
@@ -5419,7 +5458,7 @@ export declare interface IStylingSettingWidgetProps<T extends StylingPickerItemC
     locale?: string;
     onHelpClick?: () => void;
     onItemMenuToggle?: (ref: ObjRef) => void;
-    onItemSelect?: (ref: ObjRef) => void;
+    onItemSelect?: (ref: ObjRef | null) => void;
     isEditingSupported?: boolean;
     isSavingActionInProgress?: boolean;
 }
@@ -5927,7 +5966,7 @@ export declare interface IUiPagedVirtualListImperativeHandle<T> {
  * @internal
  */
 export declare interface IUiReturnFocusOnUnmountOptions {
-    returnFocusTo?: string | RefObject<HTMLElement> | (() => HTMLElement | null);
+    returnFocusTo?: string | RefObject<HTMLElement | null> | (() => HTMLElement | null);
 }
 
 /**
@@ -6093,10 +6132,10 @@ export declare interface IUiTagAccessibilityConfig extends IAccessibilityConfigB
 export declare interface IUiTreeviewContext<Levels extends any[], Level> {
     items: UiLeveledTreeView<LevelTypesUnion<Levels>>[] | UiStaticTreeView<Level>[];
     itemsRef: MutableRefObject<UiRefsTree>;
-    onClose: () => void;
+    onClose?: () => void;
     onSelect: (event: MouseEvent_2 | KeyboardEvent_2, path: number[], item?: UiStaticTreeView<Level | LevelTypesUnion<Levels>>) => void;
     isItemFocusable: (item?: UiStaticTreeView<Level> | UiStaticTreeView<LevelTypesUnion<Levels>>) => boolean;
-    setFocusedPath: Dispatch<SetStateAction<number[] | undefined>>;
+    setFocusedPath: Dispatch<SetStateAction<number[]>>;
     selectedItemId: string | undefined;
 }
 
@@ -6121,9 +6160,9 @@ export declare interface IUiTreeviewItemProps<T> {
     childCount: number;
     item: IUiTreeViewItem<T>;
     isFocused: boolean;
-    isExpanded: boolean;
+    isExpanded?: boolean;
     isSelected: boolean;
-    isCompact: boolean;
+    isCompact?: boolean;
     level: number;
     ariaAttributes: UiTreeViewItemAriaAttributes;
     onSelect: (e: MouseEvent_2 | KeyboardEvent_2) => void;
@@ -6332,11 +6371,11 @@ export declare function LocaleSetting({ isChecked, selectedLocal, onChecked, onL
  * @internal
  */
 export declare const makeHorizontalKeyboardNavigation: <T extends KeyboardEvent_2 | KeyboardEvent_2 = KeyboardEvent_2<Element>>(handlers: {
-    onFocusPrevious?: (event: T) => void;
-    onFocusNext?: (event: T) => void;
-    onFocusFirst?: (event: T) => void;
-    onFocusLast?: (event: T) => void;
-    onUnhandledKeyDown?: (event: T) => void;
+    onFocusPrevious?: ((event: T) => void) | undefined;
+    onFocusNext?: ((event: T) => void) | undefined;
+    onFocusFirst?: ((event: T) => void) | undefined;
+    onFocusLast?: ((event: T) => void) | undefined;
+    onUnhandledKeyDown?: ((event: T) => void) | undefined;
 }, options?: IHandleActionOptions) => (event: T) => void;
 
 /**
@@ -6353,40 +6392,40 @@ export declare const makeKeyboardNavigation: <ActionKeysMap extends {
  * @internal
  */
 export declare const makeLinearKeyboardNavigation: <T extends KeyboardEvent_2 | KeyboardEvent_2 = KeyboardEvent_2<Element>>(handlers: {
-    onSelect?: (event: T) => void;
-    onClose?: (event: T) => void;
-    onFocusPrevious?: (event: T) => void;
-    onFocusNext?: (event: T) => void;
-    onFocusFirst?: (event: T) => void;
-    onFocusLast?: (event: T) => void;
-    onUnhandledKeyDown?: (event: T) => void;
+    onSelect?: ((event: T) => void) | undefined;
+    onClose?: ((event: T) => void) | undefined;
+    onFocusPrevious?: ((event: T) => void) | undefined;
+    onFocusNext?: ((event: T) => void) | undefined;
+    onFocusFirst?: ((event: T) => void) | undefined;
+    onFocusLast?: ((event: T) => void) | undefined;
+    onUnhandledKeyDown?: ((event: T) => void) | undefined;
 }, options?: IHandleActionOptions) => (event: T) => void;
 
 /**
  * @internal
  */
 export declare const makeMenuKeyboardNavigation: <T extends KeyboardEvent_2 | KeyboardEvent_2 = KeyboardEvent_2<Element>>(handlers: {
-    onSelect?: (event: T) => void;
-    onClose?: (event: T) => void;
-    onFocusPrevious?: (event: T) => void;
-    onFocusNext?: (event: T) => void;
-    onFocusFirst?: (event: T) => void;
-    onFocusLast?: (event: T) => void;
-    onEnterLevel?: (event: T) => void;
-    onLeaveLevel?: (event: T) => void;
-    onUnhandledKeyDown?: (event: T) => void;
+    onSelect?: ((event: T) => void) | undefined;
+    onClose?: ((event: T) => void) | undefined;
+    onFocusPrevious?: ((event: T) => void) | undefined;
+    onFocusNext?: ((event: T) => void) | undefined;
+    onFocusFirst?: ((event: T) => void) | undefined;
+    onFocusLast?: ((event: T) => void) | undefined;
+    onEnterLevel?: ((event: T) => void) | undefined;
+    onLeaveLevel?: ((event: T) => void) | undefined;
+    onUnhandledKeyDown?: ((event: T) => void) | undefined;
 }, options?: IHandleActionOptions) => (event: T) => void;
 
 /**
  * @internal
  */
 export declare const makeTabsKeyboardNavigation: <T extends KeyboardEvent_2 | KeyboardEvent_2 = KeyboardEvent_2<Element>>(handlers: {
-    onSelect?: (event: T) => void;
-    onFocusPrevious?: (event: T) => void;
-    onFocusNext?: (event: T) => void;
-    onFocusFirst?: (event: T) => void;
-    onFocusLast?: (event: T) => void;
-    onUnhandledKeyDown?: (event: T) => void;
+    onSelect?: ((event: T) => void) | undefined;
+    onFocusPrevious?: ((event: T) => void) | undefined;
+    onFocusNext?: ((event: T) => void) | undefined;
+    onFocusFirst?: ((event: T) => void) | undefined;
+    onFocusLast?: ((event: T) => void) | undefined;
+    onUnhandledKeyDown?: ((event: T) => void) | undefined;
 }, options?: IHandleActionOptions) => (event: T) => void;
 
 /**
@@ -6444,9 +6483,7 @@ export declare const modifierNegator: "!";
 /**
  * @internal
  */
-export declare const MultiSelectList: FC<WithIntlProps<IMultiSelectListProps<unknown>>> & {
-    WrappedComponent: ComponentType<IMultiSelectListProps<unknown>>;
-};
+export declare function MultiSelectList<T>({ isMobile, width, height, items, itemHeight, itemsCount, onScrollEnd, renderItem, selectedItems, listClassNames, onSelectAll, onSelectNone, isInverted, isSearching, isSelected, filteredItemsCount, selectAllCheckbox, tagName, }: IMultiSelectListProps<T>): JSX.Element;
 
 /**
  * @internal
@@ -6529,7 +6566,7 @@ export declare class Overlay<T = HTMLElement> extends Component<IOverlayProps<T>
     private isComponentMounted;
     private clickedInside;
     private alignmentTimeoutId;
-    static contextType: Context<OverlayController>;
+    static contextType: Context<OverlayController | undefined>;
     context: ContextType<typeof OverlayContext>;
     private observer;
     constructor(props: IOverlayProps<T>);
@@ -6578,7 +6615,7 @@ export declare class Overlay<T = HTMLElement> extends Component<IOverlayProps<T>
 /**
  * @internal
  */
-export declare const OverlayContext: Context<OverlayController>;
+export declare const OverlayContext: Context<OverlayController | undefined>;
 
 /**
  * Overlay stacking controller.
@@ -6722,7 +6759,7 @@ export declare const relatedHeader: IDateDatasetHeader;
 /**
  * @internal
  */
-export declare const resolveRef: (ref: string | RefObject<HTMLElement> | (() => HTMLElement) | undefined | null) => HTMLElement;
+export declare const resolveRef: (ref: string | RefObject<HTMLElement | null> | (() => HTMLElement | null) | undefined | null) => HTMLElement | null;
 
 /**
  * @internal
@@ -6781,7 +6818,7 @@ export declare function ScrollableItem({ scrollIntoView, bottomMargin, isElement
 /**
  * @internal
  */
-export declare const ScrollablePanel: ForwardRefExoticComponent<IScrollablePanelProps & RefAttributes<HTMLDivElement>>;
+export declare const ScrollablePanel: ForwardRefExoticComponent<IScrollablePanelProps & RefAttributes<HTMLDivElement | undefined>>;
 
 /**
  * @internal
@@ -6816,7 +6853,7 @@ export declare type SelectedTime = {
 /**
  * @internal
  */
-export declare function Separator(props: any): JSX.Element;
+export declare function Separator(props: HTMLAttributes<HTMLDivElement>): JSX.Element;
 
 /**
  * @internal
@@ -6891,7 +6928,7 @@ export declare function ShareGranteeBase({ isLoading, isLockedNow, isUnderLenien
  */
 export declare class ShortenedText extends PureComponent<IShortenedTextProps, IShortenedTextState> {
     static defaultProps: Pick<IShortenedTextProps, "className" | "tagName" | "tooltipAlignPoints" | "tooltipVisibleOnMouseOver" | "getElement" | "displayTooltip" | "ellipsisPosition">;
-    textRef: RefObject<HTMLElement>;
+    textRef: RefObject<HTMLElement | null>;
     constructor(props: IShortenedTextProps);
     componentDidMount(): void;
     UNSAFE_componentWillReceiveProps(nextProps: IShortenedTextProps): void;
@@ -7086,7 +7123,7 @@ export declare function ToastMessageList({ messages, onRemoveMessage, }: {
  *
  * @internal
  */
-export declare function ToastsCenter(): JSX.Element;
+export declare function ToastsCenter(): JSX.Element | null;
 
 /**
  * @internal
@@ -7183,6 +7220,7 @@ export declare interface UiAsyncTableAccessibilityConfig<T> {
 export declare interface UiAsyncTableBulkAction {
     label: string;
     onClick: () => void;
+    accessibilityConfig?: IAccessibilityConfigBase;
 }
 
 /**
@@ -7506,7 +7544,7 @@ export declare interface UiDateProps {
 /**
  * @internal
  */
-export declare function UiDrawer({ open, zIndex, node, mode, dataTestId, children, anchor, transition, onEscapeKey, onClickOutside, closeLabel, showCloseButton, onClickClose, refocusKey, initialFocus, accessibilityConfig, }: UiDrawerProps): JSX.Element;
+export declare function UiDrawer({ open, zIndex, node, mode, dataTestId, children, anchor, transition, onEscapeKey, onClickOutside, closeLabel, showCloseButton, onClickClose, refocusKey, initialFocus, accessibilityConfig, }: UiDrawerProps): JSX.Element | null;
 
 /**
  * @internal
@@ -7795,6 +7833,92 @@ export declare interface UiPagedVirtualListSkeletonItemProps {
     itemHeight: number;
 }
 
+/**
+ * A circular button used for pagination navigation (previous/next).
+ *
+ * @remarks
+ * The button has a circular shape with a light gray background that darkens on hover.
+ * The icon color inverts to white when hovered or active.
+ *
+ * @internal
+ */
+export declare const UiPaginationButton: ForwardRefExoticComponent<UiPaginationButtonProps & RefAttributes<HTMLButtonElement>>;
+
+/**
+ * Direction of the pagination button arrow.
+ *
+ * @internal
+ */
+export declare type UiPaginationButtonDirection = "previous" | "next";
+
+/**
+ * Props for the UiPaginationButton component.
+ *
+ * @internal
+ */
+export declare interface UiPaginationButtonProps {
+    /**
+     * Direction of the arrow icon.
+     * - "previous" shows left arrow (paginationLeft)
+     * - "next" shows right arrow (paginationRight)
+     */
+    direction: UiPaginationButtonDirection;
+    /**
+     * Accessible label for the button.
+     */
+    label: string;
+    /**
+     * Size of the button.
+     * - "small" (22x22) - for desktop views
+     * - "large" (32x32) - for mobile views
+     * @defaultValue "small"
+     */
+    size?: UiPaginationButtonSize;
+    /**
+     * Whether the button is disabled.
+     */
+    isDisabled?: boolean;
+    /**
+     * Whether the button is in active/selected state.
+     */
+    isActive?: boolean;
+    /**
+     * Click handler.
+     */
+    onClick?: (e: MouseEvent_2<HTMLButtonElement>) => void;
+    /**
+     * Keyboard event handler.
+     */
+    onKeyDown?: (e: KeyboardEvent_2<HTMLButtonElement>) => void;
+    /**
+     * Data attribute for tracking/analytics.
+     */
+    dataId?: string;
+    /**
+     * Data attribute for testing.
+     */
+    dataTestId?: string;
+    /**
+     * Tab index for keyboard navigation.
+     */
+    tabIndex?: number;
+    /**
+     * HTML id attribute.
+     */
+    id?: string;
+    /**
+     * Accessibility configuration for ARIA attributes.
+     */
+    accessibilityConfig?: IAccessibilityConfigBase;
+}
+
+/**
+ * Size variant for UiPaginationButton.
+ *
+ * @internal
+ */
+export declare type UiPaginationButtonSize = "small" | "large";
+
 /**
  * @internal
  */
@@ -8159,15 +8283,36 @@ export declare function unwrapGroupItems<T extends IUiMenuItemData = object>(ite
  * @internal
  */
 export declare function useAsyncTableResponsiveColumns<T>(columns: Array<UiAsyncTableColumnDefinitionResponsive<T>>, hasCheckbox?: boolean): {
-    ref: RefObject<HTMLDivElement>;
+    ref: RefObject<HTMLDivElement | null>;
     columns: UiAsyncTableColumnDefinitionResponsive<T>[];
 };
 
+/**
+ * @internal
+ *
+ * Ensures that currency metrics default to a meaningful preset instead of falling back to custom formats.
+ * - When no format is set yet, it applies the inherited override or the standard currency preset.
+ * - When switching to currency with an incompatible format, it coerces the format to a supported preset.
+ */
+export declare function useCurrencyFormatDefaults({ metricType, normalizedFormat, currencyFormatOverride, presetFormats, hasInheritPreset, onFormatChange, shouldBootstrap, fallbackFormat, }: UseCurrencyFormatDefaultsConfig): void;
+
+/** @internal */
+export declare interface UseCurrencyFormatDefaultsConfig {
+    metricType?: MetricType;
+    normalizedFormat: string | null;
+    currencyFormatOverride?: string | null;
+    presetFormats: string[];
+    hasInheritPreset: boolean;
+    onFormatChange: (format: string | null) => void;
+    shouldBootstrap: boolean;
+    fallbackFormat?: string;
+}
+
 /**
  * @internal
  */
 export declare function useElementSize<T extends HTMLElement>(): {
-    ref: RefObject<T>;
+    ref: RefObject<T | null>;
     height: number;
     width: number;
 };
@@ -8176,7 +8321,7 @@ export declare function useElementSize<T extends HTMLElement>(): {
  * @internal
  */
 export declare function useFocusWithinContainer(idToFocus?: string | null): {
-    containerRef: RefObject<HTMLElement>;
+    containerRef: RefObject<HTMLElement | null>;
 };
 
 /**
@@ -8240,9 +8385,9 @@ export declare function useListWithActionsKeyboardNavigation<Item, Action extend
     onKeyboardNavigation: (event: KeyboardEvent_2<Element>) => void;
     onBlur: FocusEventHandler;
     focusedAction: "selectItem" | Action;
-    focusedItem: Item;
+    focusedItem: Item | undefined;
     setFocusedAction: Dispatch<SetStateAction<"selectItem" | Action>>;
-    setFocusedIndex: Dispatch<SetStateAction<number>>;
+    setFocusedIndex: Dispatch<SetStateAction<number | undefined>>;
 };
 
 /**
@@ -8281,7 +8426,7 @@ export declare const useOverlayZIndex: (uuid: string) => number | undefined;
  *
  * @internal
  */
-export declare function useOverlayZIndexWithRegister(): number;
+export declare function useOverlayZIndexWithRegister(): number | undefined;
 
 /**
  * Hook to consume responsive context.
@@ -8303,7 +8448,7 @@ export declare function useScopedId<T>(item?: T, specifier?: string): string;
  *
  * @internal
  */
-export declare function useScopedIdOptional<T>(item?: T, specifier?: string): string;
+export declare function useScopedIdOptional<T>(item?: T, specifier?: string): string | undefined;
 
 /**
  * @internal
@@ -8393,6 +8538,13 @@ export declare function useUiTreeViewEventSubscriber<T extends UiTreeViewEventTy
  */
 export declare const useZoom: () => IZoomContextState;
 
+/**
+ * Validates a number format string that is expected to represent a currency amount.
+ *
+ * @alpha
+ */
+export declare function validateCurrencyFormat(format: string | undefined | null, options?: ICurrencyFormatValidationOptions): ICurrencyFormatValidationResult;
+
 /**
  * @internal
  * Icon button variant same as tertiary but removing extra padding around the icon