@chuckcchen/vite-plugin 1.0.11 → 1.0.13

package/dist/factory/presets.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Server Wrapper Presets
+ *
+ * Built-in presets and utilities for extending presets
+ */
+/**
+ * Server wrapper preset configuration
+ */
+export interface ServerWrapperPreset {
+    imports?: string;
+    handlerSetup: string;
+    handlerCall: string;
+    requiresHtmlTemplate?: boolean;
+}
+/**
+ * Built-in server wrapper presets (generic, framework-agnostic)
+ *
+ * Note: All presets use `serverBuild` (namespace import) and `serverExports` (rest exports)
+ * which are automatically provided by generateServerWrapperCode()
+ *
+ * Framework-specific presets should be defined in their respective adapter packages.
+ */
+export declare const SERVER_WRAPPER_PRESETS: {
+    /**
+     * Web Handler - Request/Response pattern
+     *
+     * Supports multiple export patterns:
+     * - default export function
+     * - named `handler` export
+     * - named `fetch` export
+     * - `app.fetch` pattern (Hono style)
+     */
+    readonly webHandler: {
+        readonly handlerSetup: string;
+        readonly handlerCall: "handler(webRequest, ...args)";
+    };
+    /**
+     * HTML Render - render function returning {head, html}
+     *
+     * Standard Vite SSR pattern where render(url) returns HTML fragments
+     * that are injected into the HTML template.
+     */
+    readonly htmlRender: {
+        readonly requiresHtmlTemplate: true;
+        readonly handlerSetup: string;
+        readonly handlerCall: "handleSSRRequest(webRequest)";
+    };
+};
+/**
+ * Result of extending server wrapper presets
+ */
+export interface ExtendedPresetsResult<TCustom extends Record<string, ServerWrapperPreset>> {
+    /** Extended presets object (core + custom) */
+    presets: typeof SERVER_WRAPPER_PRESETS & TCustom;
+    /** Type-safe preset resolver function */
+    resolvePreset: (preset: keyof (typeof SERVER_WRAPPER_PRESETS & TCustom) | ServerWrapperPreset) => ServerWrapperPreset;
+    /** Get all available preset names */
+    getPresetNames: () => (keyof (typeof SERVER_WRAPPER_PRESETS & TCustom))[];
+}
+/**
+ * Create a server wrapper preset
+ *
+ * Helper function to create a properly typed preset with validation and normalization.
+ * Automatically trims handlerSetup and validates required fields.
+ *
+ * @example
+ * ```ts
+ * const myPreset = createServerWrapperPreset({
+ *   imports: `import { handler } from 'my-framework';`,
+ *   handlerSetup: `const requestHandler = handler(serverExports);`,
+ *   handlerCall: "requestHandler(webRequest)",
+ * });
+ * ```
+ */
+export declare function createServerWrapperPreset(config: ServerWrapperPreset): ServerWrapperPreset;
+/**
+ * Extend core server wrapper presets with custom presets
+ *
+ * This utility provides a standardized way for adapters to:
+ * 1. Add framework-specific presets while keeping core presets
+ * 2. Get a type-safe resolver function
+ * 3. Export extended presets for external use
+ *
+ * Custom presets are automatically validated and normalized using createServerWrapperPreset().
+ *
+ * @example
+ * ```ts
+ * // In vite-adapter - can pass raw config, will be validated automatically
+ * const { presets, resolvePreset } = extendServerWrapperPresets({
+ *   vike: {
+ *     imports: `import { renderPage } from 'vike/server';`,
+ *     handlerSetup: `...`,
+ *     handlerCall: "handleVikeRequest(webRequest)",
+ *   },
+ * });
+ *
+ * export const SERVER_WRAPPER_PRESETS = presets;
+ * export type ServerWrapperPresetName = keyof typeof presets;
+ *
+ * // Use in adapter
+ * const resolved = resolvePreset(options.serverWrapper || "htmlRender");
+ * ```
+ */
+export declare function extendServerWrapperPresets<TCustom extends Record<string, ServerWrapperPreset>>(customPresets: TCustom): ExtendedPresetsResult<TCustom>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/factory/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../../src/factory/presets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;IACjC;;;;;;;;OAQG;;;;;IAoBH;;;;;OAKG;;;;;;CAoCK,CAAC;AAMX;;GAEG;AACH,MAAM,WAAW,qBAAqB,CACpC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAEnD,8CAA8C;IAC9C,OAAO,EAAE,OAAO,sBAAsB,GAAG,OAAO,CAAC;IACjD,yCAAyC;IACzC,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,CAAC,OAAO,sBAAsB,GAAG,OAAO,CAAC,GAAG,mBAAmB,KAC1E,mBAAmB,CAAC;IACzB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,sBAAsB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAC3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAarB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACnD,aAAa,EAAE,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAwCxD"}

package/dist/factory/presets.js

@@ -0,0 +1,172 @@
+/**
+ * Server Wrapper Presets
+ *
+ * Built-in presets and utilities for extending presets
+ */
+/**
+ * Built-in server wrapper presets (generic, framework-agnostic)
+ *
+ * Note: All presets use `serverBuild` (namespace import) and `serverExports` (rest exports)
+ * which are automatically provided by generateServerWrapperCode()
+ *
+ * Framework-specific presets should be defined in their respective adapter packages.
+ */
+export const SERVER_WRAPPER_PRESETS = {
+    /**
+     * Web Handler - Request/Response pattern
+     *
+     * Supports multiple export patterns:
+     * - default export function
+     * - named `handler` export
+     * - named `fetch` export
+     * - `app.fetch` pattern (Hono style)
+     */
+    webHandler: {
+        handlerSetup: `
+const getHandler = () => {
+  // 1. default export (highest priority)
+  if (typeof defaultExport === 'function') return defaultExport;
+  // 2. named handler export
+  if (typeof serverExports.handler === 'function') return serverExports.handler;
+  // 3. named fetch export
+  if (typeof serverExports.fetch === 'function') return serverExports.fetch;
+  // 4. app.fetch pattern (Hono style)
+  if (typeof serverExports.app === 'object' && typeof serverExports.app.fetch === 'function') {
+    return serverExports.app.fetch.bind(serverExports.app);
+  }
+  throw new Error('No handler found. Expected: default export, handler, fetch, or app.fetch');
+};
+const handler = getHandler();`.trim(),
+        handlerCall: "handler(webRequest, ...args)",
+    },
+    /**
+     * HTML Render - render function returning {head, html}
+     *
+     * Standard Vite SSR pattern where render(url) returns HTML fragments
+     * that are injected into the HTML template.
+     */
+    htmlRender: {
+        requiresHtmlTemplate: true,
+        handlerSetup: `
+const renderFn = typeof serverExports.render === 'function' 
+  ? serverExports.render 
+  : (typeof defaultExport === 'function' ? defaultExport : null);
+
+if (!renderFn) {
+  throw new Error('No render function found in server build. Expected export: render(url)');
+}
+
+async function handleSSRRequest(request) {
+  const url = new URL(request.url);
+  const pathname = url.pathname;
+  
+  try {
+    const rendered = await renderFn(pathname);
+    let html = __HTML_TEMPLATE__
+      .replace('<!--app-head-->', rendered.head ?? '')
+      .replace('<!--app-html-->', rendered.html ?? '');
+    
+    return new Response(html, {
+      status: 200,
+      headers: { 'Content-Type': 'text/html; charset=utf-8' }
+    });
+  } catch (error) {
+    console.error('SSR render error:', error);
+    return new Response('Internal Server Error: ' + error.message, {
+      status: 500,
+      headers: { 'Content-Type': 'text/plain' }
+    });
+  }
+}`.trim(),
+        handlerCall: "handleSSRRequest(webRequest)",
+    },
+};
+/**
+ * Create a server wrapper preset
+ *
+ * Helper function to create a properly typed preset with validation and normalization.
+ * Automatically trims handlerSetup and validates required fields.
+ *
+ * @example
+ * ```ts
+ * const myPreset = createServerWrapperPreset({
+ *   imports: `import { handler } from 'my-framework';`,
+ *   handlerSetup: `const requestHandler = handler(serverExports);`,
+ *   handlerCall: "requestHandler(webRequest)",
+ * });
+ * ```
+ */
+export function createServerWrapperPreset(config) {
+    if (!config.handlerSetup) {
+        throw new Error("Server wrapper preset must have handlerSetup");
+    }
+    if (!config.handlerCall) {
+        throw new Error("Server wrapper preset must have handlerCall");
+    }
+    return {
+        imports: config.imports,
+        handlerSetup: config.handlerSetup.trim(),
+        handlerCall: config.handlerCall,
+        requiresHtmlTemplate: config.requiresHtmlTemplate,
+    };
+}
+/**
+ * Extend core server wrapper presets with custom presets
+ *
+ * This utility provides a standardized way for adapters to:
+ * 1. Add framework-specific presets while keeping core presets
+ * 2. Get a type-safe resolver function
+ * 3. Export extended presets for external use
+ *
+ * Custom presets are automatically validated and normalized using createServerWrapperPreset().
+ *
+ * @example
+ * ```ts
+ * // In vite-adapter - can pass raw config, will be validated automatically
+ * const { presets, resolvePreset } = extendServerWrapperPresets({
+ *   vike: {
+ *     imports: `import { renderPage } from 'vike/server';`,
+ *     handlerSetup: `...`,
+ *     handlerCall: "handleVikeRequest(webRequest)",
+ *   },
+ * });
+ *
+ * export const SERVER_WRAPPER_PRESETS = presets;
+ * export type ServerWrapperPresetName = keyof typeof presets;
+ *
+ * // Use in adapter
+ * const resolved = resolvePreset(options.serverWrapper || "htmlRender");
+ * ```
+ */
+export function extendServerWrapperPresets(customPresets) {
+    // Validate and normalize all custom presets
+    const normalizedCustomPresets = {};
+    for (const [key, preset] of Object.entries(customPresets)) {
+        normalizedCustomPresets[key] =
+            createServerWrapperPreset(preset);
+    }
+    const extendedPresets = {
+        ...SERVER_WRAPPER_PRESETS,
+        ...normalizedCustomPresets,
+    };
+    function resolvePreset(preset) {
+        if (typeof preset === "string") {
+            const resolved = extendedPresets[preset];
+            if (!resolved) {
+                throw new Error(`Unknown server wrapper preset: "${preset}". Available presets: ${Object.keys(extendedPresets).join(", ")}`);
+            }
+            return resolved;
+        }
+        // Validate and normalize inline preset
+        return createServerWrapperPreset(preset);
+    }
+    function getPresetNames() {
+        return Object.keys(extendedPresets);
+    }
+    return {
+        presets: extendedPresets,
+        resolvePreset,
+        getPresetNames,
+    };
+}
+//# sourceMappingURL=presets.js.map

package/dist/factory/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../../src/factory/presets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC;;;;;;;;OAQG;IACH,UAAU,EAAE;QACV,YAAY,EAAE;;;;;;;;;;;;;;8BAcY,CAAC,IAAI,EAAE;QACjC,WAAW,EAAE,8BAA8B;KAC5C;IAED;;;;;OAKG;IACH,UAAU,EAAE;QACV,oBAAoB,EAAE,IAAI;QAC1B,YAAY,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BhB,CAAC,IAAI,EAAE;QACL,WAAW,EAAE,8BAA8B;KAC5C;CACO,CAAC;AAsBX;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAA2B;IAE3B,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QACxC,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;KAClD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,0BAA0B,CAExC,aAAsB;IACtB,4CAA4C;IAC5C,MAAM,uBAAuB,GAAG,EAAa,CAAC;IAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACzD,uBAA+D,CAAC,GAAG,CAAC;YACnE,yBAAyB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,eAAe,GAAG;QACtB,GAAG,sBAAsB;QACzB,GAAG,uBAAuB;KACgB,CAAC;IAI7C,SAAS,aAAa,CACpB,MAAwC;QAExC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAsC,CAAC,CAAC;YACzE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,mCAAmC,MAAM,yBAAyB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5G,CAAC;YACJ,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,uCAAuC;QACvC,OAAO,yBAAyB,CAAC,MAA6B,CAAC,CAAC;IAClE,CAAC;IAED,SAAS,cAAc;QACrB,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAiB,CAAC;IACtD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,aAAa;QACb,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/factory.d.ts

@@ -15,10 +15,12 @@ export interface ServerWrapperPreset {
     requiresHtmlTemplate?: boolean;
 }
 /**
- * Built-in server wrapper presets
+ * Built-in server wrapper presets (generic, framework-agnostic)
  *
- * Note: All presets now use `serverBuild` (namespace import) and `serverExports` (rest exports)
+ * Note: All presets use `serverBuild` (namespace import) and `serverExports` (rest exports)
  * which are automatically provided by generateServerWrapperCode()
+ *
+ * Framework-specific presets should be defined in their respective adapter packages.
  */
 export declare const SERVER_WRAPPER_PRESETS: {
     /** Generic handler - detects default or handler export */
@@ -31,12 +33,6 @@ export declare const SERVER_WRAPPER_PRESETS: {
         readonly handlerSetup: string;
         readonly handlerCall: "serverHandler(webRequest, ...args)";
     };
-    /** React Router - uses createRequestHandler */
-    readonly reactRouter: {
-        readonly imports: "import { createRequestHandler } from \"react-router\";";
-        readonly handlerSetup: string;
-        readonly handlerCall: "requestHandler(webRequest, ...args)";
-    };
     /** Vite SSR - standard Vite SSR with render function */
     readonly viteSSR: {
         readonly requiresHtmlTemplate: true;
@@ -112,6 +108,62 @@ export declare function createFrameworkAdapter(config: AdapterFactoryConfig, opt
  * Create a stateful adapter (for complex adapters needing shared state)
  */
 export declare function createStatefulAdapter<TState extends object>(initialState: TState, factory: (state: TState) => FrameworkAdapter): FrameworkAdapter;
+/**
+ * Result of extending server wrapper presets
+ */
+export interface ExtendedPresetsResult<TCustom extends Record<string, ServerWrapperPreset>> {
+    /** Extended presets object (core + custom) */
+    presets: typeof SERVER_WRAPPER_PRESETS & TCustom;
+    /** Type-safe preset resolver function */
+    resolvePreset: (preset: keyof (typeof SERVER_WRAPPER_PRESETS & TCustom) | ServerWrapperPreset) => ServerWrapperPreset;
+    /** Get all available preset names */
+    getPresetNames: () => (keyof (typeof SERVER_WRAPPER_PRESETS & TCustom))[];
+}
+/**
+ * Create a server wrapper preset
+ *
+ * Helper function to create a properly typed preset with validation and normalization.
+ * Automatically trims handlerSetup and validates required fields.
+ *
+ * @example
+ * ```ts
+ * const myPreset = createServerWrapperPreset({
+ *   imports: `import { handler } from 'my-framework';`,
+ *   handlerSetup: `const requestHandler = handler(serverExports);`,
+ *   handlerCall: "requestHandler(webRequest)",
+ * });
+ * ```
+ */
+export declare function createServerWrapperPreset(config: ServerWrapperPreset): ServerWrapperPreset;
+/**
+ * Extend core server wrapper presets with custom presets
+ *
+ * This utility provides a standardized way for adapters to:
+ * 1. Add framework-specific presets while keeping core presets
+ * 2. Get a type-safe resolver function
+ * 3. Export extended presets for external use
+ *
+ * Custom presets are automatically validated and normalized using createServerWrapperPreset().
+ *
+ * @example
+ * ```ts
+ * // In vite-adapter - can pass raw config, will be validated automatically
+ * const { presets, resolvePreset } = extendServerWrapperPresets({
+ *   vike: {
+ *     imports: `import { renderPage } from 'vike/server';`,
+ *     handlerSetup: `...`,
+ *     handlerCall: "handleVikeRequest(webRequest)",
+ *   },
+ * });
+ *
+ * export const SERVER_WRAPPER_PRESETS = presets;
+ * export type ServerWrapperPresetName = keyof typeof presets;
+ *
+ * // Use in adapter
+ * const resolved = resolvePreset(options.serverWrapper || "viteSSR");
+ * ```
+ */
+export declare function extendServerWrapperPresets<TCustom extends Record<string, ServerWrapperPreset>>(customPresets: TCustom): ExtendedPresetsResult<TCustom>;
 /**
  * Combine multiple detector functions (returns true if any matches)
  */

package/dist/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,YAAY,EAEZ,SAAS,EAET,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAcpB,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;IACjC,0DAA0D;;;;;IAa1D,sCAAsC;;;;;IAetC,wDAAwD;;;;;;CAoChD,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oCAAoC;IACpC,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;CACzE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,CAAC,CAAC;IAC7D,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,OAAO,sBAAsB,GAAG,mBAAmB,CAAC;IAC1E,sCAAsC;IACtC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,4BAA4B;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA4QD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,qBAA0B,EACnC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAoDlB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,SAAS,MAAM,EACzD,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,GAC3C,gBAAgB,CAElB;AAMD;;GAEG;AACH,MAAM,WAAW,qBAAqB,CACpC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAEnD,8CAA8C;IAC9C,OAAO,EAAE,OAAO,sBAAsB,GAAG,OAAO,CAAC;IACjD,yCAAyC;IACzC,aAAa,EAAE,CACb,MAAM,EAAE,MAAM,CAAC,OAAO,sBAAsB,GAAG,OAAO,CAAC,GAAG,mBAAmB,KAC1E,mBAAmB,CAAC;IACzB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,sBAAsB,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAC3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,GAC1B,mBAAmB,CAarB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACnD,aAAa,EAAE,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAwCxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,EAAE,IAEzD,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAQvD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAC1C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,IAC1C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAGvD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,EAAE,IAC/C,SAAS,YAAY,KAAG,OAAO,CAAC,OAAO,CAAC,CAcvD"}

package/dist/factory.js

@@ -5,12 +5,15 @@
  */
 import path from "path";
 import { pathExists, readFile, detectConfigFile, detectBuildDir, detectServerEntry, generateServerWrapperCode, createDefaultMeta, logBuildArtifacts, } from "./utils.js";
+import { ViteConfigParser, } from "./vite-config-parser.js";
 import { parseRoutesFromSources, } from "./route-parser.js";
 /**
- * Built-in server wrapper presets
+ * Built-in server wrapper presets (generic, framework-agnostic)
  *
- * Note: All presets now use `serverBuild` (namespace import) and `serverExports` (rest exports)
+ * Note: All presets use `serverBuild` (namespace import) and `serverExports` (rest exports)
  * which are automatically provided by generateServerWrapperCode()
+ *
+ * Framework-specific presets should be defined in their respective adapter packages.
  */
 export const SERVER_WRAPPER_PRESETS = {
     /** Generic handler - detects default or handler export */
@@ -39,40 +42,6 @@ const getHandler = () => {
 const serverHandler = getHandler();`.trim(),
         handlerCall: "serverHandler(webRequest, ...args)",
     },
-    /** React Router - uses createRequestHandler */
-    reactRouter: {
-        imports: `import { createRequestHandler } from "react-router";`,
-        handlerSetup: `
-// Extract React Router server build exports
-const {
-  routes,
-  serverManifest,
-  assetsBuildDirectory,
-  basename,
-  entry,
-  future,
-  isSpaMode,
-  publicPath,
-  routeDiscovery,
-  ssr
-} = serverExports;
-
-const buildConfig = {
-  assets: serverManifest,
-  assetsBuildDirectory,
-  basename,
-  entry,
-  future,
-  isSpaMode,
-  publicPath,
-  routes,
-  routeDiscovery,
-  ssr
-};
-
-const requestHandler = createRequestHandler(buildConfig);`.trim(),
-        handlerCall: "requestHandler(webRequest, ...args)",
-    },
     /** Vite SSR - standard Vite SSR with render function */
     viteSSR: {
         requiresHtmlTemplate: true,
@@ -124,11 +93,23 @@ function createDefaultDetector(configFiles) {
 }
 /**
  * Create default getBuildArtifacts function
+ * Uses ViteConfigParser for comprehensive Vite config support:
+ * - build.outDir: custom output directory
+ * - build.assetsDir: static assets directory name
+ * - build.ssr: SSR entry point
+ * - build.manifest: manifest.json generation
+ * - base: public base path
+ * - rollupOptions.input: entry file(s)
+ * - rollupOptions.output.dir: output directory override
+ * - rollupOptions.output.entryFileNames: output filename pattern
+ * - rollupOptions.output.assetFileNames: asset filename pattern
+ * - rollupOptions.output.chunkFileNames: chunk filename pattern
  */
 function createDefaultBuildArtifactsGetter(name, buildDirs, serverEntryFiles, options) {
     const { clientBuildDir, serverBuildDir, serverEntry } = options;
     return async (context) => {
-        const { projectRoot, isSSR, logger } = context;
+        const { projectRoot, isSSR, logger, viteConfig } = context;
+        // Resolve client directory
         let clientDir = null;
         if (clientBuildDir) {
             clientDir = path.join(projectRoot, clientBuildDir);
@@ -139,17 +120,61 @@ function createDefaultBuildArtifactsGetter(name, buildDirs, serverEntryFiles, op
         let serverDir = null;
         let serverEntryPath = null;
         if (isSSR && buildDirs.server) {
-            if (serverBuildDir) {
-                serverDir = path.join(projectRoot, serverBuildDir);
+            // Use ViteConfigParser for comprehensive config support
+            if (viteConfig) {
+                const configParser = new ViteConfigParser(viteConfig, projectRoot, {
+                    logger,
+                    serverEntryCandidates: serverEntryFiles,
+                });
+                // Priority 1: Explicit serverBuildDir option
+                if (serverBuildDir) {
+                    serverDir = path.join(projectRoot, serverBuildDir);
+                }
+                else {
+                    // Priority 2: Get from Vite config using parser
+                    serverDir = configParser.getServerDir();
+                }
+                // Priority 3: Fall back to predefined build directories
+                if (!serverDir) {
+                    serverDir = await detectBuildDir(projectRoot, buildDirs.server);
+                }
+                // Find server entry
+                if (serverEntry) {
+                    // Explicit server entry path provided
+                    serverEntryPath = path.join(projectRoot, serverEntry);
+                }
+                else if (serverDir) {
+                    // Priority 1: Try to get server entry from Vite config using parser
+                    serverEntryPath = await configParser.findServerEntry(serverDir);
+                    if (serverEntryPath) {
+                        logger.verbose(`Using server entry from Vite config: ${serverEntryPath}`);
+                    }
+                    // Priority 2: Fall back to file detection with recursive search
+                    if (!serverEntryPath) {
+                        serverEntryPath = await detectServerEntry(serverDir, serverEntryFiles, {
+                            recursive: true,
+                            logger,
+                        });
+                    }
+                }
             }
             else {
-                serverDir = await detectBuildDir(projectRoot, buildDirs.server);
-            }
-            if (serverEntry) {
-                serverEntryPath = path.join(projectRoot, serverEntry);
-            }
-            else if (serverDir) {
-                serverEntryPath = await detectServerEntry(serverDir, serverEntryFiles);
+                // No Vite config available, use fallback detection
+                if (serverBuildDir) {
+                    serverDir = path.join(projectRoot, serverBuildDir);
+                }
+                else {
+                    serverDir = await detectBuildDir(projectRoot, buildDirs.server);
+                }
+                if (serverEntry) {
+                    serverEntryPath = path.join(projectRoot, serverEntry);
+                }
+                else if (serverDir) {
+                    serverEntryPath = await detectServerEntry(serverDir, serverEntryFiles, {
+                        recursive: true,
+                        logger,
+                    });
+                }
             }
         }
         logBuildArtifacts(logger, name, {
@@ -317,6 +342,94 @@ export function createFrameworkAdapter(config, options = {}, overrides) {
 export function createStatefulAdapter(initialState, factory) {
     return factory({ ...initialState });
 }
+/**
+ * Create a server wrapper preset
+ *
+ * Helper function to create a properly typed preset with validation and normalization.
+ * Automatically trims handlerSetup and validates required fields.
+ *
+ * @example
+ * ```ts
+ * const myPreset = createServerWrapperPreset({
+ *   imports: `import { handler } from 'my-framework';`,
+ *   handlerSetup: `const requestHandler = handler(serverExports);`,
+ *   handlerCall: "requestHandler(webRequest)",
+ * });
+ * ```
+ */
+export function createServerWrapperPreset(config) {
+    if (!config.handlerSetup) {
+        throw new Error("Server wrapper preset must have handlerSetup");
+    }
+    if (!config.handlerCall) {
+        throw new Error("Server wrapper preset must have handlerCall");
+    }
+    return {
+        imports: config.imports,
+        handlerSetup: config.handlerSetup.trim(),
+        handlerCall: config.handlerCall,
+        requiresHtmlTemplate: config.requiresHtmlTemplate,
+    };
+}
+/**
+ * Extend core server wrapper presets with custom presets
+ *
+ * This utility provides a standardized way for adapters to:
+ * 1. Add framework-specific presets while keeping core presets
+ * 2. Get a type-safe resolver function
+ * 3. Export extended presets for external use
+ *
+ * Custom presets are automatically validated and normalized using createServerWrapperPreset().
+ *
+ * @example
+ * ```ts
+ * // In vite-adapter - can pass raw config, will be validated automatically
+ * const { presets, resolvePreset } = extendServerWrapperPresets({
+ *   vike: {
+ *     imports: `import { renderPage } from 'vike/server';`,
+ *     handlerSetup: `...`,
+ *     handlerCall: "handleVikeRequest(webRequest)",
+ *   },
+ * });
+ *
+ * export const SERVER_WRAPPER_PRESETS = presets;
+ * export type ServerWrapperPresetName = keyof typeof presets;
+ *
+ * // Use in adapter
+ * const resolved = resolvePreset(options.serverWrapper || "viteSSR");
+ * ```
+ */
+export function extendServerWrapperPresets(customPresets) {
+    // Validate and normalize all custom presets
+    const normalizedCustomPresets = {};
+    for (const [key, preset] of Object.entries(customPresets)) {
+        normalizedCustomPresets[key] =
+            createServerWrapperPreset(preset);
+    }
+    const extendedPresets = {
+        ...SERVER_WRAPPER_PRESETS,
+        ...normalizedCustomPresets,
+    };
+    function resolvePreset(preset) {
+        if (typeof preset === "string") {
+            const resolved = extendedPresets[preset];
+            if (!resolved) {
+                throw new Error(`Unknown server wrapper preset: "${preset}". Available presets: ${Object.keys(extendedPresets).join(", ")}`);
+            }
+            return resolved;
+        }
+        // Validate and normalize inline preset
+        return createServerWrapperPreset(preset);
+    }
+    function getPresetNames() {
+        return Object.keys(extendedPresets);
+    }
+    return {
+        presets: extendedPresets,
+        resolvePreset,
+        getPresetNames,
+    };
+}
 /**
  * Combine multiple detector functions (returns true if any matches)
  */