import { UnpluginInstance, WebpackPluginInstance, RspackPluginInstance, RollupPlugin } from 'unplugin';
import { Plugin } from 'vite';
import { VitePluginOptions } from './vite.mjs';

/**
 * Per-framework factory config. `framework` is the package name (e.g.
 * `@unhead/vue`) used internally by the base bundler to import runtime
 * plugins from the right path; `streamingPlugin` is the framework's
 * streaming unplugin instance (as returned by `createUnplugin`).
 */
interface FrameworkPluginConfig<S> {
    framework: string;
    streamingPlugin: UnpluginInstance<S | undefined, boolean>;
}
interface UnheadFrameworkOptions<S> extends VitePluginOptions {
    /** Enable streaming SSR support. */
    streaming?: true | S | false;
    /**
     * Inject the runtime `ValidatePlugin`. **Vite-only**: ignored by `.webpack()`,
     * `.rspack()`, and `.rollup()` because injection happens via the Vite
     * `CreateHeadTransform` plugin, which has no equivalent on other bundlers.
     */
    validate?: VitePluginOptions['validate'];
    /**
     * Enable the Vite Devtools integration. **Vite-only**: ignored by `.webpack()`,
     * `.rspack()`, and `.rollup()` since `unheadDevtools` depends on
     * `@vitejs/devtools-kit`.
     */
    devtools?: VitePluginOptions['devtools'];
}
/**
 * Shape returned by the unified framework factory. Mirrors the subset of
 * `UnpluginInstance` methods that Nuxt's `addBuildPlugin` consumes, so a
 * call site can forward the factory object directly.
 *
 * Note: `rollup()` is provided for completeness (e.g. SSG static builds)
 * but does **not** detect SSR context: rollup has no equivalent of vite's
 * `env.isSsrBuild` or webpack's `compiler.options.name === 'server'` hook.
 * With an unknown build target, `SSRStaticReplace` retains `head.ssr` as-is
 * and `TreeshakeServerComposables` retains server composables, so the output
 * stays correct but unoptimized. Use `.vite()` or `.webpack()` for
 * target-aware builds.
 */
interface UnheadBundlerFactory {
    vite: () => Plugin[];
    webpack: () => WebpackPluginInstance[];
    rspack: () => RspackPluginInstance[];
    rollup: () => RollupPlugin[];
}
/**
 * Unified framework factory. Returns an object with per-bundler dispatch
 * methods so consumers (e.g. Nuxt's `addBuildPlugin`) can forward it
 * directly without per-bundler imports.
 *
 * @example
 * ```ts
 * // framework-side:
 * export const Unhead = createFrameworkPlugin({
 *   framework: '@unhead/vue',
 *   streamingPlugin: unheadVueStreamingPlugin,
 * })
 *
 * // consumer-side (vite):
 * plugins: [...Unhead({ streaming: true }).vite()]
 *
 * // consumer-side (nuxt kit):
 * addBuildPlugin(Unhead({ streaming: true }))
 * ```
 */
declare function createFrameworkPlugin<S>({ framework, streamingPlugin }: FrameworkPluginConfig<S>): (options?: UnheadFrameworkOptions<S>) => UnheadBundlerFactory;

export { createFrameworkPlugin };
export type { FrameworkPluginConfig, UnheadBundlerFactory, UnheadFrameworkOptions };