/**
 * Copyright IBM Corp. 2021, 2025
 *
 * This source code is licensed under the Apache-2.0 license found in the
 * LICENSE file in the root directory of this source tree.
 */
import { RefObject } from 'react';
/**
 * Returns the first element matching `selector` within `container`, or null.
TO DO: This hook will be removed https://github.com/carbon-design-system/ibm-products/issues/7731
*/
export declare const getSpecificElement: (container: HTMLElement | null, selector: string) => HTMLElement | null;
/**
 * Provides focus-trap helpers for a panel/modal container.
 *
 * - `firstElement` – the first tabbable element inside the container.
 * - `keyDownListener` – an `onKeyDown` handler that cycles focus between the
 *   first and last tabbable elements (Tab / Shift+Tab wrap-around).
 */
export declare const useFocus: (ref: RefObject<HTMLElement | null>) => {
    firstElement: HTMLElement | null;
    keyDownListener: (event: React.KeyboardEvent | KeyboardEvent) => void;
};