/**
 * @license MIT
 * @module @whoj/utils-vue@2.4.0
 * @copyright (c) 2026 Jonson B.
 */

import * as vue from 'vue';
import { Optional } from '@whoj/utils-types';
import { ComputedRefable } from './refOf.cjs';

type BuiltInLinkElAttrs = Pick<HTMLLinkElement, 'as' | 'rel' | 'type' | 'media'>;
interface ConfigurableDocument {
    document?: Document;
}
interface UseLinkTagOptions extends ConfigurableDocument, Optional<BuiltInLinkElAttrs> {
    attrs?: Record<string, string>;
    blocking?: 'render';
    crossOrigin?: 'anonymous' | 'use-credentials';
    id?: string;
    immediate?: boolean;
    manual?: boolean;
    referrerPolicy?: 'origin' | 'unsafe-url' | 'no-referrer' | 'origin-when-cross-origin' | 'no-referrer-when-downgrade';
}
declare function useLinkTag(href: ComputedRefable<string>, onLoaded?: (el: HTMLLinkElement) => void, options?: UseLinkTagOptions): {
    linkTag: vue.Ref<HTMLLinkElement, HTMLLinkElement>;
    load: (waitForLoad?: boolean) => Promise<boolean | HTMLLinkElement>;
    loaded: vue.Ref<boolean, boolean>;
    unload: () => void;
};
type UseLinkTagReturn = ReturnType<typeof useLinkTag>;

export { useLinkTag };
export type { UseLinkTagOptions, UseLinkTagReturn };