@gooddata/sdk-ui-kit 10.27.0-alpha.2 → 10.27.0-alpha.21

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

@@ -396,6 +396,7 @@ export declare class Checkbox extends React_2.PureComponent<CheckboxProps> {
  * @internal
  */
 export declare interface CheckboxProps {
+    id?: string;
     disabled: boolean;
     name: string;
     text: string;
@@ -556,6 +557,17 @@ export declare function DefaultUiListboxInteractiveItemComponent<T>({ item, isFo
  */
 export declare function DefaultUiListboxStaticItemComponent<T>({ item, }: UiListboxStaticItemProps<T>): React_2.ReactNode;
 
+/**
+ * @internal
+ */
+export declare function DefaultUiMenuInteractiveItemComponent<InteractiveItemData, StaticItemData>({ item, isFocused, onSelect, }: UiMenuInteractiveItemProps<InteractiveItemData, StaticItemData>): React_2.ReactNode;
+
+/**
+ * By default just renders the data.
+ * @internal
+ */
+export declare function DefaultUiMenuStaticItemComponent<T>({ item }: UiMenuStaticItemProps<T>): React_2.ReactNode;
+
 /**
  * @internal
  */
@@ -859,6 +871,18 @@ export declare function getDateTimeConfig(date: string, options?: IDateTimeConfi
  */
 export declare const getDefaultEmbedTypeOptions: (embedType: EmbedType) => EmbedOptionsType;
 
+/**
+ * @internal
+ * Returns the focusable elements of the given element
+ * @param element - the element to get the focusable elements from
+ * @returns an object containing the focusable elements, the first focusable element, and the last focusable element
+ */
+export declare const getFocusableElements: (element?: HTMLElement) => {
+    focusableElements: NodeListOf<HTMLElement>;
+    firstElement: HTMLElement;
+    lastElement: HTMLElement;
+};
+
 /**
  * @internal
  */
@@ -1663,6 +1687,7 @@ export declare interface IDialogBaseProps {
     CloseButton?: React_2.ComponentType<IDialogCloseButtonProps>;
     initialFocus?: React_2.RefObject<HTMLElement> | string;
     returnFocusTo?: React_2.RefObject<HTMLElement> | string;
+    returnFocusAfterClose?: boolean;
 }
 
 /**
@@ -2688,6 +2713,8 @@ export declare interface IItemsWrapperProps {
     children: React_2.ReactNode;
     className?: string;
     style?: React_2.CSSProperties;
+    accessibilityConfig?: IMenuContainerAccessibilityConfig;
+    wrapperRef?: React_2.RefObject<HTMLDivElement>;
 }
 
 /**
@@ -2847,20 +2874,6 @@ export declare interface ILegacySingleSelectListProps<T> {
     width: number;
 }
 
-/**
- * @internal
- */
-export declare interface IListboxContext<InteractiveItemData, StaticItemData = React_2.ReactNode> {
-    items: IUiListboxItem<InteractiveItemData, StaticItemData>[];
-    itemRefs: React_2.MutableRefObject<(HTMLLIElement | null)[]>;
-    onSelect: (item: IUiListboxInteractiveItem<InteractiveItemData>) => void;
-    onClose?: () => void;
-    selectedItemId: string | undefined;
-    focusedIndex: number | undefined;
-    setFocusedIndex: React_2.Dispatch<React_2.SetStateAction<number>>;
-    isItemFocusable: (item: IUiListboxItem<InteractiveItemData, StaticItemData>) => boolean;
-}
-
 /**
  * @internal
  */
@@ -3007,6 +3020,25 @@ export declare interface IMediaQueries {
     "<desktop": string;
 }
 
+/**
+ * @internal
+ */
+export declare interface IMenuAccessibilityConfig extends IAccessibilityConfigBase {
+    id?: string;
+    role?: "menu" | "menuitem" | "separator" | "presentation";
+    ariaDisabled?: "true" | "false";
+    ariaHaspopup?: "true" | "false" | "menu" | "listbox" | "tree" | "grid" | "dialog";
+    ariaExpanded?: "true" | "false";
+    ariaControls?: string;
+}
+
+/**
+ * @internal
+ */
+export declare interface IMenuContainerAccessibilityConfig extends IMenuAccessibilityConfig {
+    role?: "menu";
+}
+
 /**
  * @internal
  */
@@ -4045,18 +4077,16 @@ export declare interface ISingleSelectListItemProps {
     hideDelayBubble?: number;
     isSelected?: boolean;
     isMenu?: boolean;
+    accessibilityConfig?: IMenuAccessibilityConfig;
+    tabIndex?: number;
+    elementType?: "div" | "button";
+    iconRenderer?: (icon: string | ReactNode | React_2.FC) => ReactNode;
+    infoRenderer?: (info: string | ReactNode | React_2.FC) => ReactNode;
     onClick?: (e: React_2.MouseEvent<HTMLElement>) => void;
     onMouseOver?: (e: React_2.MouseEvent<HTMLElement>) => void;
     onMouseOut?: (e: React_2.MouseEvent<HTMLElement>) => void;
 }
 
-/**
- * @internal
- */
-export declare interface ISingleSelectListItemState {
-    isOverflowed: boolean;
-}
-
 /**
  * @internal
  */
@@ -4288,6 +4318,20 @@ export declare interface IUiChipAccessibilityConfig extends IAccessibilityConfig
     deleteAriaLabel?: string;
 }
 
+/**
+ * @internal
+ */
+export declare interface IUiListboxContext<InteractiveItemData, StaticItemData = React_2.ReactNode> {
+    items: IUiListboxItem<InteractiveItemData, StaticItemData>[];
+    itemRefs: React_2.MutableRefObject<(HTMLLIElement | null)[]>;
+    onSelect: (item: IUiListboxInteractiveItem<InteractiveItemData>) => void;
+    onClose?: () => void;
+    selectedItemId: string | undefined;
+    focusedIndex: number | undefined;
+    setFocusedIndex: React_2.Dispatch<React_2.SetStateAction<number | undefined>>;
+    isItemFocusable: (item: IUiListboxItem<InteractiveItemData, StaticItemData>) => boolean;
+}
+
 /**
  * @internal
  */
@@ -4313,6 +4357,47 @@ export declare interface IUiListboxStaticItem<T> {
     data: T;
 }
 
+/**
+ * @internal
+ */
+export declare interface IUiMenuContext<InteractiveItemData, StaticItemData = React_2.ReactNode> {
+    items: IUiMenuItem<InteractiveItemData, StaticItemData>[];
+    focusedItem: IUiMenuInteractiveItem<InteractiveItemData, StaticItemData> | undefined;
+    itemRefs: React_2.MutableRefObject<{
+        [id: string]: HTMLElement;
+    }>;
+    onSelect: (item: IUiMenuInteractiveItem<InteractiveItemData, StaticItemData> | undefined) => void;
+    onClose?: () => void;
+    setFocusedId: React_2.Dispatch<React_2.SetStateAction<string | undefined>>;
+    isItemFocusable: (item: IUiMenuItem<InteractiveItemData, StaticItemData>) => boolean;
+}
+
+/**
+ * @internal
+ */
+export declare interface IUiMenuInteractiveItem<InteractiveItemData, StaticItemData = React_2.ReactNode> {
+    type: "interactive";
+    id: string;
+    stringTitle: string;
+    isDisabled?: boolean;
+    data: InteractiveItemData;
+    subMenu?: IUiMenuItem<InteractiveItemData, StaticItemData>[];
+}
+
+/**
+ * @internal
+ */
+export declare type IUiMenuItem<InteractiveItemData, StaticItemData = React_2.ReactNode> = IUiMenuStaticItem<StaticItemData> | IUiMenuInteractiveItem<InteractiveItemData, StaticItemData>;
+
+/**
+ * @internal
+ */
+export declare interface IUiMenuStaticItem<T> {
+    type: "static";
+    id?: string;
+    data: T;
+}
+
 /**
  * @internal
  */
@@ -4534,6 +4619,23 @@ export declare const LoadingSpinner: React_2.FC<ILoadingSpinner>;
  */
 export declare const LocaleSetting: React_2.VFC<ILocaleSettingProps>;
 
+/**
+ * @internal
+ */
+export declare const makeMenuKeyboardNavigation: <T extends KeyboardEvent | KeyboardEvent_2<Element> = KeyboardEvent_2<Element>>({ onFocusPrevious, onFocusNext, onFocusFirst, onFocusLast, onEnterLevel, onLeaveLevel, onSelect, onClose, onUnhandledKeyDown, shouldPreventDefault, shouldStopPropagation, }: {
+    onFocusNext?: (event: T) => void;
+    onFocusPrevious?: (event: T) => void;
+    onFocusFirst?: (event: T) => void;
+    onFocusLast?: (event: T) => void;
+    onEnterLevel?: (event: T) => void;
+    onLeaveLevel?: (event: T) => void;
+    onSelect?: (event: T) => void;
+    onClose?: (event: T) => void;
+    onUnhandledKeyDown?: (event: T) => void;
+    shouldPreventDefault?: boolean;
+    shouldStopPropagation?: boolean;
+}) => (event: T) => void;
+
 /**
  * @internal
  */
@@ -4914,7 +5016,10 @@ export declare type Separators = {
 /**
  * @internal
  */
-export declare const separatorStaticItem: IUiListboxStaticItem<React_2.ReactNode>;
+export declare const separatorStaticItem: {
+    data: React_2.JSX.Element;
+    type: "static";
+};
 
 /**
  * @internal
@@ -5000,20 +5105,7 @@ export declare const SimpleSettingWidget: React_2.FC<ISimpleSettingWidgetProps>;
 /**
  * @internal
  */
-export declare class SingleSelectListItem extends Component<ISingleSelectListItemProps, ISingleSelectListItemState> {
-    private titleRef;
-    constructor(props: ISingleSelectListItemProps);
-    componentDidMount(): void;
-    componentDidUpdate(): void;
-    private checkOverflow;
-    private getClassNames;
-    render(): JSX.Element;
-    private renderTitle;
-    private renderIcon;
-    private renderSeparatorItem;
-    private renderHeaderItem;
-    private renderInfo;
-}
+export declare const SingleSelectListItem: React_2.ForwardRefExoticComponent<ISingleSelectListItemProps & React_2.RefAttributes<HTMLButtonElement | HTMLDivElement>>;
 
 /**
  * @internal
@@ -5335,11 +5427,20 @@ export declare interface UiFocusTrapProps {
      * If a ref is provided, the focus will be returned to the element referenced by the ref.
      */
     returnFocusTo?: React_2.RefObject<HTMLElement> | string;
+    /**
+     * If true, the focus will be returned to the element referenced by the returnFocusTo prop when the trap is unmounted.
+     */
+    returnFocusOnUnmount?: boolean;
     /**
      * Specify the element that should receive focus when the trap is activated.
      * If not provided, the first focusable element will be focused.
      */
     initialFocus?: React_2.RefObject<HTMLElement> | string;
+    /**
+     * Specify a custom keyboard navigation handler.
+     * If not provided, the default keyboard navigation handler will be used.
+     */
+    customKeyboardNavigationHandler?: (event: KeyboardEvent) => void;
 }
 
 /**
@@ -5405,7 +5506,7 @@ export declare interface UiListboxProps<InteractiveItemData, StaticItemData = Re
     maxWidth?: number;
     onSelect?: (item: IUiListboxInteractiveItem<InteractiveItemData>) => void;
     onClose?: () => void;
-    onUnhandledKeyDown?: (event: React_2.KeyboardEvent, context: IListboxContext<InteractiveItemData, StaticItemData>) => void;
+    onUnhandledKeyDown?: (event: React_2.KeyboardEvent, context: IUiListboxContext<InteractiveItemData, StaticItemData>) => void;
     selectedItemId?: string;
     InteractiveItemComponent?: React_2.ComponentType<UiListboxInteractiveItemProps<InteractiveItemData>>;
     StaticItemComponent?: React_2.ComponentType<UiListboxStaticItemProps<StaticItemData>>;
@@ -5413,7 +5514,7 @@ export declare interface UiListboxProps<InteractiveItemData, StaticItemData = Re
     shouldKeyboardActionStopPropagation?: boolean;
     shouldCloseOnSelect?: boolean;
     isDisabledFocusable?: boolean;
-    ariaAttributes: IDropdownBodyRenderProps["ariaAttributes"];
+    ariaAttributes: Omit<IDropdownBodyRenderProps["ariaAttributes"], "role">;
 }
 
 /**
@@ -5423,6 +5524,61 @@ export declare interface UiListboxStaticItemProps<T> {
     item: IUiListboxStaticItem<T>;
 }
 
+/**
+ * An accessible menu component that can be navigated by keyboard.
+ * Usable in a <Dropdown /> component.
+ * Should implement https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
+ *
+ * @internal
+ */
+export declare function UiMenu<InteractiveItemData, StaticItemData>({ items, className, itemClassName, maxWidth, onSelect, onClose, onUnhandledKeyDown, InteractiveItemComponent, StaticItemComponent, MenuHeaderComponent, shouldKeyboardActionPreventDefault, shouldKeyboardActionStopPropagation, shouldCloseOnSelect, isDisabledFocusable, ariaAttributes, }: UiMenuProps<InteractiveItemData, StaticItemData>): React_2.ReactNode;
+
+/**
+ * @internal
+ */
+export declare interface UiMenuHeaderProps<InteractiveItemData, StaticItemData = React_2.ReactNode> {
+    onBack?: () => void;
+    onClose?: () => void;
+    parentItem?: IUiMenuInteractiveItem<InteractiveItemData, StaticItemData>;
+}
+
+/**
+ * @internal
+ */
+export declare interface UiMenuInteractiveItemProps<InteractiveItemData, StaticItemData = React_2.ReactNode> {
+    item: IUiMenuInteractiveItem<InteractiveItemData, StaticItemData>;
+    isFocused: boolean;
+    onSelect: () => void;
+}
+
+/**
+ * @internal
+ */
+export declare interface UiMenuProps<InteractiveItemData, StaticItemData = React_2.ReactNode> {
+    items: IUiMenuItem<InteractiveItemData, StaticItemData>[];
+    className?: string;
+    itemClassName?: ((item: IUiMenuItem<InteractiveItemData, StaticItemData>) => string | undefined) | string;
+    maxWidth?: number;
+    onSelect?: (item: IUiMenuInteractiveItem<InteractiveItemData, StaticItemData>) => void;
+    onClose?: () => void;
+    onUnhandledKeyDown?: (event: React_2.KeyboardEvent, context: IUiMenuContext<InteractiveItemData, StaticItemData>) => void;
+    InteractiveItemComponent?: React_2.ComponentType<UiMenuInteractiveItemProps<InteractiveItemData, StaticItemData>>;
+    StaticItemComponent?: React_2.ComponentType<UiMenuStaticItemProps<StaticItemData>>;
+    MenuHeaderComponent?: React_2.ComponentType<UiMenuHeaderProps<InteractiveItemData, StaticItemData>>;
+    shouldKeyboardActionPreventDefault?: boolean;
+    shouldKeyboardActionStopPropagation?: boolean;
+    shouldCloseOnSelect?: boolean;
+    isDisabledFocusable?: boolean;
+    ariaAttributes: Omit<IDropdownBodyRenderProps["ariaAttributes"], "role">;
+}
+
+/**
+ * @internal
+ */
+export declare interface UiMenuStaticItemProps<T> {
+    item: IUiMenuStaticItem<T>;
+}
+
 /**
  * @internal
  */
@@ -5558,6 +5714,13 @@ export declare const useHeaderSearch: () => HeaderSearchContext;
  */
 export declare const useId: () => string;
 
+/**
+ * This is a hook that generates a unique ID for purposes of aria references and so on. Can be enhanced with a prefix.
+ * @param prefix - The prefix to be added to the generated ID.
+ * @internal
+ */
+export declare const useIdPrefixed: (prefix?: string) => string;
+
 /**
  * @internal
  */

package/esm/typings/accessibility.d.ts

@@ -8,4 +8,21 @@ export interface IAccessibilityConfigBase {
     ariaDescribedBy?: React.AriaAttributes["aria-describedby"];
     role?: React.HTMLAttributes<HTMLElement>["role"];
 }
+/**
+ * @internal
+ */
+export interface IMenuAccessibilityConfig extends IAccessibilityConfigBase {
+    id?: string;
+    role?: "menu" | "menuitem" | "separator" | "presentation";
+    ariaDisabled?: "true" | "false";
+    ariaHaspopup?: "true" | "false" | "menu" | "listbox" | "tree" | "grid" | "dialog";
+    ariaExpanded?: "true" | "false";
+    ariaControls?: string;
+}
+/**
+ * @internal
+ */
+export interface IMenuContainerAccessibilityConfig extends IMenuAccessibilityConfig {
+    role?: "menu";
+}
 //# sourceMappingURL=accessibility.d.ts.map

package/esm/typings/accessibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/typings/accessibility.ts"],"names":[],"mappings":";AAEA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,SAAS,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACzD,eAAe,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;CACpD"}
+{"version":3,"file":"accessibility.d.ts","sourceRoot":"","sources":["../../src/typings/accessibility.ts"],"names":[],"mappings":";AAEA;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,SAAS,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IACzD,eAAe,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,wBAAwB;IACtE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,cAAc,CAAC;IAC1D,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAEhC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClF,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,iCAAkC,SAAQ,wBAAwB;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/esm/typings/accessibility.js

@@ -1,3 +1,3 @@
-// (C) 2025 GoodData Corporation
+// (C) 2020-2025 GoodData Corporation
 export {};
 //# sourceMappingURL=accessibility.js.map

package/esm/typings/accessibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../src/typings/accessibility.ts"],"names":[],"mappings":"AAAA,gCAAgC"}
+{"version":3,"file":"accessibility.js","sourceRoot":"","sources":["../../src/typings/accessibility.ts"],"names":[],"mappings":"AAAA,qCAAqC"}

package/esm/utils/domUtilities.d.ts

@@ -28,4 +28,15 @@ export declare const isFixedPosition: (element: HTMLElement | string) => boolean
 export declare const elementRegion: (elementOrSelector: HTMLElement | string, getRegionBasedOnPosition?: boolean) => IRegion;
 export declare const isElementTextInput: (element: HTMLElement | EventTarget | null | undefined) => boolean;
 export declare const isElementSubmitButton: (event: React.KeyboardEvent) => boolean;
+/**
+ * @internal
+ * Returns the focusable elements of the given element
+ * @param element - the element to get the focusable elements from
+ * @returns an object containing the focusable elements, the first focusable element, and the last focusable element
+ */
+export declare const getFocusableElements: (element?: HTMLElement) => {
+    focusableElements: NodeListOf<HTMLElement>;
+    firstElement: HTMLElement;
+    lastElement: HTMLElement;
+};
 //# sourceMappingURL=domUtilities.d.ts.map

package/esm/utils/domUtilities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domUtilities.d.ts","sourceRoot":"","sources":["../../src/utils/domUtilities.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,YAAa,WAAW,KAAG,IAIpD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,YACN,WAAW,wBACE,OAAO,gDAE9B,OAeF,CAAC;AAiBF;;;;GAIG;AACH,eAAO,MAAM,eAAe,YAAa,WAAW,GAAG,MAAM,KAAG,OAe/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,sBACH,WAAW,GAAG,MAAM,6BACZ,OAAO,KACnC,OAuCF,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAAa,WAAW,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,KAAG,OAc1F,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAAW,mBAAmB,YAI/D,CAAC"}
+{"version":3,"file":"domUtilities.d.ts","sourceRoot":"","sources":["../../src/utils/domUtilities.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,YAAa,WAAW,KAAG,IAIpD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,YACN,WAAW,wBACE,OAAO,gDAE9B,OAeF,CAAC;AAiBF;;;;GAIG;AACH,eAAO,MAAM,eAAe,YAAa,WAAW,GAAG,MAAM,KAAG,OAe/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,sBACH,WAAW,GAAG,MAAM,6BACZ,OAAO,KACnC,OAuCF,CAAC;AAEF,eAAO,MAAM,kBAAkB,YAAa,WAAW,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,KAAG,OAc1F,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAAW,mBAAmB,YAI/D,CAAC;AAwBF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,aAAc,WAAW;;;;CAKzD,CAAC"}

package/esm/utils/domUtilities.js

@@ -116,4 +116,33 @@ export const isElementSubmitButton = (event) => {
     const { id } = event.target;
     return id === CONFIRM_DIALOG_BASE_ID;
 };
+const focusableElementsSelector = [
+    // Interactive form elements
+    'button:not(:disabled):not([aria-disabled="true"])',
+    'input:not(:disabled):not([aria-disabled="true"])',
+    'select:not(:disabled):not([aria-disabled="true"])',
+    'textarea:not(:disabled):not([aria-disabled="true"])',
+    // Links and areas
+    "a[href]",
+    "area[href]",
+    // Custom elements with tabindex
+    '[tabindex]:not([tabindex="-1"]):not(:disabled):not([aria-disabled="true"])',
+    // Media with controls
+    "audio[controls]",
+    "video[controls]",
+    // Editable content
+    '[contenteditable]:not([contenteditable="false"])',
+].join(",");
+/**
+ * @internal
+ * Returns the focusable elements of the given element
+ * @param element - the element to get the focusable elements from
+ * @returns an object containing the focusable elements, the first focusable element, and the last focusable element
+ */
+export const getFocusableElements = (element) => {
+    const focusableElements = element?.querySelectorAll(focusableElementsSelector);
+    const firstElement = focusableElements?.[0];
+    const lastElement = focusableElements?.[focusableElements.length - 1];
+    return { focusableElements, firstElement, lastElement };
+};
 //# sourceMappingURL=domUtilities.js.map

package/esm/utils/domUtilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"domUtilities.js","sourceRoot":"","sources":["../../src/utils/domUtilities.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"domUtilities.js","sourceRoot":"","sources":["../../src/utils/domUtilities.ts"],"names":[],"mappings":"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"}

package/esm/utils/useId.d.ts

@@ -4,4 +4,10 @@
  * @internal
  */
 export declare const useId: () => string;
+/**
+ * This is a hook that generates a unique ID for purposes of aria references and so on. Can be enhanced with a prefix.
+ * @param prefix - The prefix to be added to the generated ID.
+ * @internal
+ */
+export declare const useIdPrefixed: (prefix?: string) => string;
 //# sourceMappingURL=useId.d.ts.map

package/esm/utils/useId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useId.d.ts","sourceRoot":"","sources":["../../src/utils/useId.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAO,MAGxB,CAAC"}
+{"version":3,"file":"useId.d.ts","sourceRoot":"","sources":["../../src/utils/useId.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,eAAO,MAAM,KAAK,QAAO,MAGxB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,YAAa,MAAM,KAAG,MAG/C,CAAC"}

package/esm/utils/useId.js

@@ -10,4 +10,13 @@ export const useId = () => {
     const [id] = useState(uuid());
     return id;
 };
+/**
+ * This is a hook that generates a unique ID for purposes of aria references and so on. Can be enhanced with a prefix.
+ * @param prefix - The prefix to be added to the generated ID.
+ * @internal
+ */
+export const useIdPrefixed = (prefix) => {
+    const id = useId();
+    return prefix ? `${prefix}-${id}` : id;
+};
 //# sourceMappingURL=useId.js.map

package/esm/utils/useId.js.map

@@ -1 +1 @@
-{"version":3,"file":"useId.js","sourceRoot":"","sources":["../../src/utils/useId.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAAW,EAAE;IAC9B,MAAM,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAS,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC;AACd,CAAC,CAAC"}
+{"version":3,"file":"useId.js","sourceRoot":"","sources":["../../src/utils/useId.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,EAAE,IAAI,IAAI,EAAE,MAAM,MAAM,CAAC;AAElC;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,GAAW,EAAE;IAC9B,MAAM,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAS,IAAI,EAAE,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC;AACd,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAe,EAAU,EAAE;IACrD,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3C,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-ui-kit",
-  "version": "10.27.0-alpha.2",
+  "version": "10.27.0-alpha.21",
   "description": "GoodData SDK - UI Building Components",
   "repository": {
     "type": "git",
@@ -14,7 +14,8 @@
   "exports": {
     ".": "./esm/index.js",
     "./styles/*": "./styles/*",
-    "./esm/assets/*": "./esm/assets/*"
+    "./esm/assets/*": "./esm/assets/*",
+    "./utils/*": "./esm/utils/*.js"
   },
   "types": "./esm/index.d.ts",
   "sideEffects": [
@@ -69,11 +70,11 @@
     "tslib": "^2.5.0",
     "uuid": "^8.3.2",
     "unified": "^11.0.5",
-    "@gooddata/sdk-backend-spi": "10.27.0-alpha.2",
-    "@gooddata/sdk-model": "10.27.0-alpha.2",
-    "@gooddata/sdk-ui-theme-provider": "10.27.0-alpha.2",
-    "@gooddata/sdk-ui": "10.27.0-alpha.2",
-    "@gooddata/util": "10.27.0-alpha.2"
+    "@gooddata/sdk-backend-spi": "10.27.0-alpha.21",
+    "@gooddata/sdk-model": "10.27.0-alpha.21",
+    "@gooddata/sdk-ui": "10.27.0-alpha.21",
+    "@gooddata/sdk-ui-theme-provider": "10.27.0-alpha.21",
+    "@gooddata/util": "10.27.0-alpha.21"
   },
   "peerDependencies": {
     "react": "^16.10.0 || ^17.0.0 || ^18.0.0",
@@ -132,8 +133,8 @@
     "typescript": "5.3.3",
     "vitest": "3.0.8",
     "vitest-dom": "0.1.1",
-    "@gooddata/reference-workspace": "10.27.0-alpha.2",
-    "@gooddata/sdk-backend-mockingbird": "10.27.0-alpha.2"
+    "@gooddata/reference-workspace": "10.27.0-alpha.21",
+    "@gooddata/sdk-backend-mockingbird": "10.27.0-alpha.21"
   },
   "scripts": {
     "clean": "rm -rf ci dist esm coverage styles/css *.log tsconfig.tsbuildinfo",