/**
 * `@nifrajs/web/plugins/vite-server-only` - the Vite half of the `.server` convention.
 *
 * A module named `*.server.ts(x)` is server-only: the Bun client build empties it so its import
 * subtree - `node:` builtins, native modules, secrets - never reaches a browser. This does the same
 * for Vite, in both the dev server and the production build.
 *
 * ## Why this exists separately
 *
 * The convention was implemented once, as a `Bun.build` plugin, which meant it held in exactly one of
 * the four pipelines. `nifra build` emptied the module; `nifra dev` (Vite), a Vite production build,
 * and `nifra dev --bun` all shipped it whole. A guard that holds in one pipeline and not the others is
 * worse than none, because the file name reads as protection everywhere.
 *
 * `*.fn` already had this shape - a Bun plugin, a Vite plugin, and a refusal in the one pipeline that
 * cannot transform. `.server` now matches it.
 *
 * ## Why `transform` and not `load`
 *
 * Vite resolves and reads the file itself; taking `load` would mean re-implementing its resolution.
 * `transform` receives the source Vite already read, and returning replacement code discards the
 * original along with its imports - so the server subtree is never followed. `enforce: "pre"` puts
 * this ahead of framework transforms, which have no business seeing server code either.
 */
import { SERVER_ONLY_MODULE, SERVER_ONLY_REPLACEMENT, viteServerOnlyReplacement } from "../internal/server-boundary.js";
export { SERVER_ONLY_MODULE, SERVER_ONLY_REPLACEMENT, viteServerOnlyReplacement };
/** The slice of a Vite/Rollup plugin this returns. Structural, so `vite` stays an optional peer. */
export interface ServerOnlyEmptyPlugin {
    readonly name: string;
    readonly enforce: "pre";
    /** Applied only to the CLIENT build; the server build keeps the real module. */
    readonly applyToEnvironment?: (environment: {
        readonly name: string;
    }) => boolean;
    transform(code: string, id: string, options?: {
        readonly ssr?: boolean;
    }): {
        code: string;
        map: null;
    } | null;
}
/**
 * Empty every `*.server` module in the client build.
 *
 * Client-only by construction: nifra passes this to the client build and the dev server, never to the
 * SSR build, where the real module is what runs.
 */
export declare function viteServerOnlyEmpty(): ServerOnlyEmptyPlugin;
//# sourceMappingURL=vite-server-only.d.ts.map