/*
 * Copyright 2026 Hypergiant Galactic Systems Inc. All rights reserved.
 * This file is licensed to you under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License. You may obtain a copy
 * of the License at https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software distributed under
 * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
 * OF ANY KIND, either express or implied. See the License for the specific language
 * governing permissions and limitations under the License.
 */

import { Ref } from "react";

//#region src/hooks/use-prevent-scroll-focus/index.d.ts

/**
 * Custom hook that prevents scroll-into-view behavior when focus is triggered
 * on an element and its child inputs.
 *
 * This hook overrides the native focus() method on both the target element and
 * any input elements within it to always pass { preventScroll: true }, preventing
 * the browser from automatically scrolling the element into view when focused.
 *
 * @param ref - External ref to merge with internal ref
 * @returns A ref callback that overrides focus behavior with preventScroll
 *
 * @example
 * ```tsx
 * function MyComponent({ ref, ...props }) {
 *   const handleRef = usePreventScrollFocus(ref);
 *   return <label ref={handleRef}>...</label>;
 * }
 * ```
 */
declare function usePreventScrollFocus<T extends HTMLElement = HTMLLabelElement>(ref: Ref<T> | null | undefined): (node: T | null) => void;
//#endregion
export { usePreventScrollFocus };
//# sourceMappingURL=index.d.ts.map