@agent-native/core 0.76.6 → 0.76.8

package/dist/vite/client.d.ts

@@ -1,4 +1,4 @@
-import type { UserConfig } from "vite";
+import type { Plugin, UserConfig } from "vite";
 import { type AgentNativeRouteWarmupConfigInput } from "../shared/route-warmup-config.js";
 /**
  * Build the `resolve.dedupe` list dynamically. Reads core's package.json and
@@ -102,15 +102,39 @@ export interface ClientConfigOptions {
      */
     reactRouter?: boolean | Record<string, unknown>;
 }
+export interface AgentNativeVitePluginOptions extends Omit<ClientConfigOptions, "plugins" | "reactRouter"> {
+    /**
+     * Include the legacy React SWC transform for non-React Router SPA apps.
+     *
+     * React Router framework-mode apps should pass `reactRouter()` as a normal
+     * Vite plugin and leave this off.
+     */
+    legacySpa?: boolean;
+}
 export declare function stripMountedDevApiPath(reqUrl: string | undefined, base: string | undefined): string | undefined;
 export declare function isFrameworkDevPath(reqUrl: string, base: string | undefined): boolean;
+/**
+ * Agent-Native's Vite plugin preset.
+ *
+ * Use this in ordinary Vite configs so `vite.config.ts` keeps Vite's native
+ * `UserConfig` type surface:
+ *
+ * ```ts
+ * import { defineConfig } from "vite";
+ * import { reactRouter } from "@react-router/dev/vite";
+ * import { agentNative } from "@agent-native/core/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [reactRouter(), agentNative({ ssrStubs: ["shiki"] })],
+ * });
+ * ```
+ */
+export declare function agentNative(options?: AgentNativeVitePluginOptions): Plugin[];
 /**
  * Create the client Vite config with sensible agent-native defaults.
- * Supports two modes:
- * - Legacy SPA mode (default): React SWC plugin, client-only routing
- * - React Router framework mode: SSR-capable with file-based routing
  *
- * Both modes include Nitro for API routes, path aliases, and fs restrictions.
+ * @deprecated Prefer `defineConfig` from `vite` plus the `agentNative()` plugin
+ * preset. This compatibility wrapper remains for existing templates.
  */
 export declare function defineConfig(options?: ClientConfigOptions): UserConfig;
 export { getClientDedupe as _getClientDedupe, getDefaultOptimizeDeps as _getDefaultOptimizeDeps, findCorePackageRoot as _findCorePackageRoot, getReactRouterAliases as _getReactRouterAliases, };

package/dist/vite/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/vite/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAU,UAAU,EAAE,MAAM,MAAM,CAAC;AAmB/C,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,kCAAkC,CAAC;AA0H1C;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgE9C;AAED;;;;;;GAMG;AACH,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCvD;AAOD;;;;;GAKG;AACH,iBAAS,qBAAqB,CAC5B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAc9C;AAoCD,iBAAS,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAmNrD;AAsKD,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,YAAY,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;IAC9E,oGAAoG;IACpG,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAClC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IACvD,wCAAwC;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,iCAAiC,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAohBD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAWT;AAsRD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAuS1E;AAED,OAAO,EACL,eAAe,IAAI,gBAAgB,EACnC,sBAAsB,IAAI,uBAAuB,EACjD,mBAAmB,IAAI,oBAAoB,EAC3C,qBAAqB,IAAI,sBAAsB,GAChD,CAAC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/vite/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,MAAM,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAmB1D,OAAO,EAEL,KAAK,iCAAiC,EACvC,MAAM,kCAAkC,CAAC;AA0H1C;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAgE9C;AAED;;;;;;GAMG;AACH,iBAAS,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCvD;AAOD;;;;;GAKG;AACH,iBAAS,qBAAqB,CAC5B,GAAG,EAAE,MAAM,GACV,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAc9C;AAoCD,iBAAS,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAmNrD;AAsKD,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,YAAY,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;IAC9E,oGAAoG;IACpG,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IAClC,8BAA8B;IAC9B,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,YAAY,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;IACvD,wCAAwC;IACxC,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC9B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,iCAAiC,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,4BAA6B,SAAQ,IAAI,CACxD,mBAAmB,EACnB,SAAS,GAAG,aAAa,CAC1B;IACC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAohBD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAWT;AAupBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,OAAO,GAAE,4BAAiC,GACzC,MAAM,EAAE,CAcV;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,UAAU,CAU1E;AAED,OAAO,EACL,eAAe,IAAI,gBAAgB,EACnC,sBAAsB,IAAI,uBAAuB,EACjD,mBAAmB,IAAI,oBAAoB,EAC3C,qBAAqB,IAAI,sBAAsB,GAChD,CAAC"}

package/dist/vite/client.js

@@ -1318,30 +1318,124 @@ function silenceConnectionResets() {
         },
     };
 }
-/**
- * Create the client Vite config with sensible agent-native defaults.
- * Supports two modes:
- * - Legacy SPA mode (default): React SWC plugin, client-only routing
- * - React Router framework mode: SSR-capable with file-based routing
- *
- * Both modes include Nitro for API routes, path aliases, and fs restrictions.
- */
-export function defineConfig(options = {}) {
-    // Check if React Router plugin was passed directly in plugins array
-    const hasReactRouterPlugin = options.plugins?.some((p) => p?.name === "react-router" ||
-        (Array.isArray(p) && p.some((pp) => pp?.name === "react-router")));
-    let reactTransformPlugin;
-    if (!hasReactRouterPlugin && !options.reactRouter) {
-        // Legacy SPA mode — use React SWC plugin (only when React Router is not used)
-        try {
-            reactTransformPlugin = require("@vitejs/plugin-react-swc");
-            if (reactTransformPlugin.default)
-                reactTransformPlugin = reactTransformPlugin.default;
-        }
-        catch {
-            // Will be resolved at runtime by Vite
-        }
+function isBuildCommand(command) {
+    return command === "build" || (!command && process.argv.includes("build"));
+}
+function hasReactRouterPlugin(plugins) {
+    return Boolean(plugins?.some((p) => p?.name === "react-router" ||
+        (Array.isArray(p) && p.some((pp) => pp?.name === "react-router"))));
+}
+function createReactTransformPlugin() {
+    try {
+        let reactTransformPlugin = require("@vitejs/plugin-react-swc");
+        if (reactTransformPlugin.default)
+            reactTransformPlugin = reactTransformPlugin.default;
+        return reactTransformPlugin?.();
+    }
+    catch {
+        // Will be resolved at runtime by Vite
+        return null;
+    }
+}
+function createTailwindPlugin(options) {
+    if (options.tailwind === false)
+        return null;
+    try {
+        let tailwindPlugin = require("@tailwindcss/vite");
+        if (tailwindPlugin.default)
+            tailwindPlugin = tailwindPlugin.default;
+        // Tailwind's Vite optimizer uses Lightning CSS internally and runs
+        // before Vite's own CSS minifier. Lightning CSS collapses the standard
+        // `backdrop-filter` declaration when a `-webkit-` fallback is present,
+        // so let Vite/esbuild handle the production CSS pass instead.
+        return tailwindPlugin({ optimize: false });
+    }
+    catch {
+        // Plugin not installed — silently skip. Old templates may still be on v3.
+        return null;
     }
+}
+function getConfiguredAppBasePath() {
+    // APP_BASE_PATH lets this app be mounted under a prefix (e.g. "/mail") as
+    // part of a unified workspace deploy. Defaults to "/" for standalone apps.
+    const appBasePath = process.env.VITE_APP_BASE_PATH || process.env.APP_BASE_PATH || "/";
+    const base = appBasePath.endsWith("/") ? appBasePath : `${appBasePath}/`;
+    return { appBasePath, base };
+}
+function createNitroDevPlugin(options, appBasePath) {
+    return nitroVitePlugin({
+        serverDir: "./server",
+        ...(options.nitro ?? {}),
+        // Never auto-load test files as server handlers/plugins/middleware.
+        // Nitro scans server/{plugins,middleware,routes,api}/*; a co-located
+        // *.spec.ts would otherwise be loaded at runtime and crash the server
+        // (its top-level vitest calls throw). Keep tests next to their source safely.
+        ignore: [
+            ...(options.nitro?.ignore ?? []),
+            "**/*.spec.ts",
+            "**/*.spec.tsx",
+            "**/*.test.ts",
+            "**/*.test.tsx",
+        ],
+        routeRules: {
+            ...mcpEmbedStaticAssetRouteRules(appBasePath),
+            ...(options.nitro?.routeRules ??
+                {}),
+        },
+    });
+}
+function arrayFrom(value) {
+    if (value === undefined)
+        return [];
+    return Array.isArray(value) ? value : [value];
+}
+function aliasArrayFrom(alias) {
+    if (!alias)
+        return [];
+    if (Array.isArray(alias))
+        return alias;
+    if (typeof alias === "object") {
+        return Object.entries(alias).map(([find, replacement]) => ({ find, replacement }));
+    }
+    return [];
+}
+function forceServeOnly(pluginOrPreset) {
+    if (Array.isArray(pluginOrPreset))
+        return pluginOrPreset.map(forceServeOnly);
+    return { ...pluginOrPreset, apply: "serve" };
+}
+function createAgentNativePlugins(options, { command, includeReactTransform, useServeOnlyNitroPlugin = false, userPlugins = [], }) {
+    const { appBasePath } = getConfiguredAppBasePath();
+    const nitroPlugin = createNitroDevPlugin(options, appBasePath);
+    const includeNitro = !isBuildCommand(command);
+    return [
+        // Stub packages from `options.ssrStubs` in the SSR bundle so they
+        // don't bloat the edge worker. Opt-in per template — the framework
+        // hardcodes nothing (e.g. docs sites legitimately import `shiki` on
+        // the server, so we can't blanket-stub it here).
+        ssrStubPlugin(options.ssrStubs ?? []),
+        ...userPlugins,
+        actionTypesPlugin(),
+        agentsBundlePlugin(),
+        autoReloadOnOptimizeDep(),
+        fullReloadOnOptimizeDep504(),
+        embedDevFrameHeaders(),
+        baseRedirectGuard(),
+        portExposer(),
+        silenceConnectionResets(),
+        rolldownInputFix(),
+        // Nitro Vite plugin for dev-mode API route serving and HMR.
+        // Disabled during build — React Router's build handles production.
+        ...(useServeOnlyNitroPlugin
+            ? [forceServeOnly(nitroPlugin)]
+            : includeNitro
+                ? [nitroPlugin]
+                : []),
+        includeReactTransform ? createReactTransformPlugin() : null,
+        createTailwindPlugin(options),
+    ].filter(Boolean);
+}
+function createAgentNativeConfig(options = {}, command, userConfig = {}) {
     const cwd = process.cwd();
     // Workspace env fallback. If this app is inside a workspace, tell Vite to
     // also look for .env files at the workspace root. Per-app .env still wins
@@ -1364,32 +1458,8 @@ export function defineConfig(options = {}) {
         }
         catch { }
     }
-    // Build the React transform plugin (only for legacy SPA mode)
-    const reactPluginInstance = reactTransformPlugin?.();
-    // Auto-inject the Tailwind v4 Vite plugin if `@tailwindcss/vite` is
-    // installed (which it is by default for all agent-native templates).
-    // Templates can opt out by setting `options.tailwind = false`.
-    let tailwindPluginInstance = null;
-    if (options.tailwind !== false) {
-        try {
-            let tailwindPlugin = require("@tailwindcss/vite");
-            if (tailwindPlugin.default)
-                tailwindPlugin = tailwindPlugin.default;
-            // Tailwind's Vite optimizer uses Lightning CSS internally and runs
-            // before Vite's own CSS minifier. Lightning CSS collapses the standard
-            // `backdrop-filter` declaration when a `-webkit-` fallback is present,
-            // so let Vite/esbuild handle the production CSS pass instead.
-            tailwindPluginInstance = tailwindPlugin({ optimize: false });
-        }
-        catch {
-            // Plugin not installed — silently skip. Old templates may still be on v3.
-        }
-    }
-    // APP_BASE_PATH lets this app be mounted under a prefix (e.g. "/mail") as
-    // part of a unified workspace deploy. Defaults to "/" for standalone apps.
-    const appBasePath = process.env.VITE_APP_BASE_PATH || process.env.APP_BASE_PATH || "/";
+    const { base } = getConfiguredAppBasePath();
     const isWorkspaceChild = process.env.AGENT_NATIVE_WORKSPACE === "1";
-    const base = appBasePath.endsWith("/") ? appBasePath : `${appBasePath}/`;
     const monorepoCoreAllow = [
         path.resolve(cwd, "../../packages/core"),
         path.resolve(cwd, "../core"),
@@ -1419,10 +1489,13 @@ export function defineConfig(options = {}) {
         ? [new RegExp(`^${escapeRegex(workspaceCore.packageName)}(/.*)?$`)]
         : [];
     return {
-        logLevel: options.logLevel ?? (isWorkspaceChild ? "warn" : undefined),
+        logLevel: options.logLevel ??
+            userConfig.logLevel ??
+            (isWorkspaceChild ? "warn" : undefined),
         envDir,
         base,
         define: {
+            ...(userConfig.define ?? {}),
             ...(options.define ?? {}),
             // Framework route warmup controls how SSR `.data` routes are fetched:
             // ordinary fetches keep them CDN-cacheable, while native prefetch headers
@@ -1431,21 +1504,25 @@ export function defineConfig(options = {}) {
             __AGENT_NATIVE_ROUTE_WARMUP_CONFIG__: JSON.stringify(normalizeAgentNativeRouteWarmupConfig(options.routeWarmup)),
         },
         server: {
-            host: "::",
-            port: options.port ?? 8080,
-            allowedHosts: options.allowedHosts ?? [
+            ...(userConfig.server ?? {}),
+            host: userConfig.server?.host ?? "::",
+            port: options.port ?? userConfig.server?.port ?? 8080,
+            allowedHosts: options.allowedHosts ??
+                userConfig.server?.allowedHosts ?? [
                 ".ngrok-free.dev",
                 ".ngrok-free.app",
                 ".ngrok.io",
                 ".trycloudflare.com",
             ],
             fs: {
+                ...(userConfig.server?.fs ?? {}),
                 allow: [
                     ".",
                     ...monorepoCoreAllow,
                     ...monorepoNodeModulesAllow,
                     ...workspaceCoreFsAllow,
                     ...workspaceNodeModulesAllow,
+                    ...(userConfig.server?.fs?.allow ?? []),
                     ...(options.fsAllow ?? []),
                 ],
                 deny: [
@@ -1453,27 +1530,30 @@ export function defineConfig(options = {}) {
                     ".env.*",
                     "*.{crt,pem}",
                     "**/.git/**",
+                    ...(userConfig.server?.fs?.deny ?? []),
                     ...(options.fsDeny ?? []),
                 ],
             },
         },
         build: {
-            outDir: options.outDir ?? "dist/spa",
+            ...(userConfig.build ?? {}),
+            outDir: options.outDir ?? userConfig.build?.outDir ?? "dist/spa",
             // Vite 8 defaults CSS minification to Lightning CSS, which collapses a
             // `backdrop-filter` + `-webkit-backdrop-filter` pair down to only the
             // prefixed form. Chrome ignores that, so glass effects disappear in
             // production. Keep esbuild as the CSS minifier and target Safari 18+ so
             // the standard property survives the production pipeline.
-            cssMinify: "esbuild",
-            cssTarget: ["es2020", "safari18"],
+            cssMinify: userConfig.build?.cssMinify ?? "esbuild",
+            cssTarget: userConfig.build?.cssTarget ?? ["es2020", "safari18"],
         },
         // Bundle all non-Node.js deps into the production SSR server build.
         // Edge runtimes (CF Workers, Deno) don't have node_modules at runtime.
         // In dev, React Router's Vite Environment runner expects CJS packages
         // like React to stay external; forcing them through the module runner
         // raises `module is not defined`.
-        ssr: process.argv.includes("build")
+        ssr: isBuildCommand(command)
             ? {
+                ...(userConfig.ssr ?? {}),
                 noExternal: /^(?!node:)/,
                 // Pick the workspace-core's compiled `dist/` exports in prod —
                 // Node-style `default` condition matches what edge runtimes (CF
@@ -1481,11 +1561,13 @@ export function defineConfig(options = {}) {
                 // build inherits the dev-condition src/ entry and ships unbuilt
                 // TypeScript into the worker.
                 resolve: {
+                    ...(userConfig.ssr?.resolve ?? {}),
                     conditions: ["node", "module", "import", "default"],
                     externalConditions: ["node", "module", "import", "default"],
                 },
             }
             : {
+                ...(userConfig.ssr ?? {}),
                 // Vite already sets `development` in the dev resolve conditions,
                 // so the workspace-core template's exports.development → src/
                 // entry is picked automatically — Vite handles TS compilation
@@ -1515,63 +1597,23 @@ export function defineConfig(options = {}) {
                         ? [/^@agent-native\/scheduling(\/.*)?$/]
                         : []),
                     ...workspaceCoreNoExternal,
+                    ...arrayFrom(userConfig.ssr?.noExternal),
+                ],
+                external: [
+                    "react",
+                    "react-dom",
+                    "react-dom/server",
+                    ...arrayFrom(userConfig.ssr?.external),
                 ],
-                external: ["react", "react-dom", "react-dom/server"],
             },
-        plugins: [
-            // Stub packages from `options.ssrStubs` in the SSR bundle so they
-            // don't bloat the edge worker. Opt-in per template — the framework
-            // hardcodes nothing (e.g. docs sites legitimately import `shiki` on
-            // the server, so we can't blanket-stub it here).
-            ...(() => {
-                const p = ssrStubPlugin(options.ssrStubs ?? []);
-                return p ? [p] : [];
-            })(),
-            ...(options.plugins ?? []),
-            actionTypesPlugin(),
-            agentsBundlePlugin(),
-            autoReloadOnOptimizeDep(),
-            fullReloadOnOptimizeDep504(),
-            embedDevFrameHeaders(),
-            baseRedirectGuard(),
-            portExposer(),
-            silenceConnectionResets(),
-            rolldownInputFix(),
-            // Nitro Vite plugin for dev-mode API route serving and HMR.
-            // Disabled during build — React Router's build handles production.
-            ...(process.argv.includes("build")
-                ? []
-                : [
-                    nitroVitePlugin({
-                        serverDir: "./server",
-                        ...(options.nitro ?? {}),
-                        // Never auto-load test files as server handlers/plugins/middleware.
-                        // Nitro scans server/{plugins,middleware,routes,api}/*; a co-located
-                        // *.spec.ts would otherwise be loaded at runtime and crash the server
-                        // (its top-level vitest calls throw). Keep tests next to their source safely.
-                        ignore: [
-                            ...(options.nitro?.ignore ?? []),
-                            "**/*.spec.ts",
-                            "**/*.spec.tsx",
-                            "**/*.test.ts",
-                            "**/*.test.tsx",
-                        ],
-                        routeRules: {
-                            ...mcpEmbedStaticAssetRouteRules(appBasePath),
-                            ...(options.nitro
-                                ?.routeRules ?? {}),
-                        },
-                    }),
-                ]),
-            reactPluginInstance,
-            tailwindPluginInstance,
-        ].filter(Boolean),
         optimizeDeps: {
+            ...(userConfig.optimizeDeps ?? {}),
             include: [
                 ...getDefaultOptimizeDeps(cwd),
                 ...(hasDep("@agent-native/pinpoint", cwd)
                     ? ["@agent-native/pinpoint/react"]
                     : []),
+                ...(userConfig.optimizeDeps?.include ?? []),
                 ...(options.optimizeDeps?.include ?? []),
             ],
             // In monorepo mode: explicitly exclude @agent-native/core subpaths so
@@ -1582,16 +1624,21 @@ export function defineConfig(options = {}) {
             // serves stale code even after the source / dist is updated.
             exclude: [
                 ...(findCoreSrcDir(cwd) !== null ? CORE_CLIENT_SUBPATHS : []),
+                ...(userConfig.optimizeDeps?.exclude ?? []),
                 ...(options.optimizeDeps?.exclude ?? []),
             ],
         },
         resolve: {
+            ...(userConfig.resolve ?? {}),
             // Dedupe all client-side packages that core shares with the consuming
             // app. In pnpm monorepos, core's devDependencies can install separate
             // copies (linked to different React versions). Without deduping, each
             // copy creates its own React context — QueryClientProvider, RouterProvider,
             // Radix, etc. — causing "No provider" crashes at runtime.
-            dedupe: getClientDedupe(cwd),
+            dedupe: [
+                ...getClientDedupe(cwd),
+                ...arrayFrom(userConfig.resolve?.dedupe),
+            ],
             alias: [
                 // Published npm installs: one react-router instance for app + core.
                 ...getReactRouterAliases(cwd),
@@ -1606,9 +1653,57 @@ export function defineConfig(options = {}) {
                     find,
                     replacement,
                 })),
+                ...aliasArrayFrom(userConfig.resolve?.alias),
             ],
         },
     };
 }
+/**
+ * Agent-Native's Vite plugin preset.
+ *
+ * Use this in ordinary Vite configs so `vite.config.ts` keeps Vite's native
+ * `UserConfig` type surface:
+ *
+ * ```ts
+ * import { defineConfig } from "vite";
+ * import { reactRouter } from "@react-router/dev/vite";
+ * import { agentNative } from "@agent-native/core/vite";
+ *
+ * export default defineConfig({
+ *   plugins: [reactRouter(), agentNative({ ssrStubs: ["shiki"] })],
+ * });
+ * ```
+ */
+export function agentNative(options = {}) {
+    return [
+        {
+            name: "agent-native-config",
+            enforce: "pre",
+            config(config, env) {
+                return createAgentNativeConfig(options, env.command, config);
+            },
+        },
+        ...createAgentNativePlugins(options, {
+            includeReactTransform: options.legacySpa === true,
+            useServeOnlyNitroPlugin: true,
+        }),
+    ];
+}
+/**
+ * Create the client Vite config with sensible agent-native defaults.
+ *
+ * @deprecated Prefer `defineConfig` from `vite` plus the `agentNative()` plugin
+ * preset. This compatibility wrapper remains for existing templates.
+ */
+export function defineConfig(options = {}) {
+    const includeReactTransform = !hasReactRouterPlugin(options.plugins) && !options.reactRouter;
+    return {
+        ...createAgentNativeConfig(options),
+        plugins: createAgentNativePlugins(options, {
+            includeReactTransform,
+            userPlugins: options.plugins,
+        }),
+    };
+}
 export { getClientDedupe as _getClientDedupe, getDefaultOptimizeDeps as _getDefaultOptimizeDeps, findCorePackageRoot as _findCorePackageRoot, getReactRouterAliases as _getReactRouterAliases, };
 //# sourceMappingURL=client.js.map