import type { ExtractPath, ExtractType } from '../types/paths';
/**
 * Safely searches for a chain of properties in an object.
 *
 * @param obj - The object to safe search in for the chain of properties.
 * @param propertyChain - The chain of properties, separated by a dot, to search for.
 * @param defaultReturn - The value to return if any of the intermediate or the final value is not
 * defined.
 * @remarks The `defaultReturn` parameter has been left here for retro-compatibility. We recommend
 * using coalescing operator (`??`) instead.
 * @returns The value of the chain of properties, or `undefined` if any of the intermediate values
 * is not defined.
 */
export declare function getSafePropertyChain<SomeObject, Path extends ExtractPath<SomeObject>>(obj: SomeObject, propertyChain: Path, defaultReturn?: ExtractType<SomeObject, Path>): ExtractType<SomeObject, Path> | undefined;
/**
 * Safely searches for a chain of properties in an object.
 *
 * @param obj - The object to safe search in for the chain of properties.
 * @param propertyChain - The chain of properties, separated by a dot, to search for.
 * @param defaultReturn - The value to return if any of the intermediate or the final value is not
 * defined.
 * @remarks The `defaultReturn` parameter has been left here for retro-compatibility. We recommend
 * using coalescing operator (`??`) instead.
 * @returns The value of the chain of properties, or the default return if any of the intermediate
 * values is not defined.
 */
export declare function getSafePropertyChain<SomeObject>(obj: SomeObject, propertyChain: '', defaultReturn?: SomeObject): SomeObject;