import { MaybeRef } from 'vue';
import { ComponentProps } from 'vue-component-type-helpers';
import { Data, MaybePick } from '../types/utils.js';
/**
 * The computed value is an object, that only contains properties that are defined by the target component.
 * Is useful to forward only a matching subset of properties from a parent component to a wrapped child component.
 *
 * This is necessary when the parent defines props, which are not defined in the child component.
 * Otherwise, the child component will set the extraneous props as attributes, which bloats the DOM and can lead to unexpected side-effects.
 *
 * @example
 *
 * ```vue
 * <script setup lang="ts">
 * import { useForwardProps } from "sit-onyx";
 * import MyChildComponent from "./MyChildComponent.vue";
 *
 * const props = defineProps<ParentProps & ChildProps>();
 * const childProps = useForwardProps(props, MyChildComponent);
 * </script>
 * <template>
 *   <!-- childProps only includes props that exist on MyChildComponent -->
 *   <MyChildComponent v-bind="childProps" />
 * </template>
 * ```
 *
 * @param props The reactive props object of the parent component.
 * @param target Component for which the properties are to be forwarded.
 * @returns computed value with properties that are also defined the target component.
 */
export declare const useForwardProps: <T extends Data, TComponent, TProps = ComponentProps<TComponent>, R = MaybePick<T, keyof TProps>>(props: MaybeRef<T>, target: TComponent) => import('vue').ComputedRef<R>;