import type { Plugin } from 'vite';
export interface PreconnectPluginOptions {
    /**
     * 需要 preconnect 的 origin 列表。允许传完整 URL，内部会解析为 origin 并去重。
     * 非 http(s) 协议或解析失败的项会被忽略。
     */
    origins: string[];
    /**
     * preconnect link 的 crossorigin 属性。
     * - `true` 或 `'anonymous'`：`crossorigin="anonymous"`（匹配 `<script crossorigin>` / `<link modulepreload>` 等 CORS 请求）
     * - `'use-credentials'`：`crossorigin="use-credentials"`
     * - `false`：不设置 crossorigin 属性（匹配普通 `<script src>` 等非 CORS 请求）
     *
     * 默认 `'anonymous'`，匹配 Vite 打包输出的 ESM chunks（默认带 crossorigin）。
     */
    crossOrigin?: boolean | 'anonymous' | 'use-credentials';
    /**
     * 是否同时添加 `dns-prefetch` 作为兜底（对不支持 preconnect 的旧浏览器有效）。默认 false。
     */
    dnsPrefetchFallback?: boolean;
}
/**
 * 注入 `<link rel="preconnect">`（可选附加 `<link rel="dns-prefetch">`）到 HTML head 最前面，
 * 让浏览器提前建立到关键资源域名的 TCP + TLS 连接，减少首屏资源的等待时间。
 *
 * 插件本身不关心域名来源，域名完全由调用方通过 `origins` 传入——上层可以基于 `publicPath`、
 * 环境变量或业务配置动态派生，未来更换 CDN 只需改上层即可。
 */
export declare function preconnectPlugin(options: PreconnectPluginOptions): Plugin;
export default preconnectPlugin;
//# sourceMappingURL=preconnect-plugin.d.ts.map