@chuckcchen/vite-plugin 1.0.3 → 1.0.5

package/dist/factory.d.ts

@@ -1,20 +1,17 @@
 /**
  * Adapter Factory - Simplifies the creation of framework adapters
  *
- * Provides factory functions and preset configurations to reduce boilerplate code in adapter development
+ * Provides factory functions and preset configurations to reduce boilerplate code
  */
-import type { BuildContext, FrameworkAdapter, AdapterHooks } from "./types.js";
+import type { BuildContext, RouteInfo, FrameworkAdapter } from "./types.js";
+import { type RouteSource } from "./route-parser.js";
 /**
  * Server wrapper preset configuration
  */
 export interface ServerWrapperPreset {
-    /** Additional import statements */
     imports?: string;
-    /** Handler initialization code */
     handlerSetup: string;
-    /** Handler call expression */
     handlerCall: string;
-    /** Whether this preset requires HTML template injection */
     requiresHtmlTemplate?: boolean;
 }
 /**
@@ -48,87 +45,96 @@ export declare const SERVER_WRAPPER_PRESETS: {
  * Build directory configuration
  */
 export interface BuildDirConfig {
-    /** Client directory candidates */
     client: string[];
-    /** Server directory candidates (SSR mode) */
     server?: string[];
 }
+/**
+ * Route source configuration for declarative route parsing
+ */
+export interface RouteSourceConfig {
+    /** Route sources to try in order */
+    sources?: RouteSource[];
+    /** Default routes if no sources match */
+    defaultRoutes?: string[];
+    /** Extra routes to add in SSR mode */
+    ssrExtraRoutes?: string[];
+    /** Transform function for parsed routes */
+    transform?: (routes: RouteInfo[], context: BuildContext) => RouteInfo[];
+}
+/**
+ * Server wrapper mode configuration
+ */
+export interface ServerWrapperModeConfig {
+    /** Wrapper mode: inline (embed server code) or import (use import statement) */
+    mode?: "inline" | "import";
+    /** Additional exports when using import mode */
+    additionalExports?: string[];
+    /** Custom handler call expression */
+    handlerCall?: string;
+}
+/**
+ * esbuild configuration for server bundling
+ */
+export interface EsbuildConfig {
+    /** Working directory for esbuild */
+    absWorkingDir?: string | ((context: BuildContext) => string);
+    /** External modules */
+    external?: string[];
+    /** Additional esbuild options */
+    options?: Record<string, unknown>;
+}
 /**
  * Adapter factory configuration
  */
 export interface AdapterFactoryConfig {
-    /** Adapter name */
     name: string;
-    /** Config file detection list */
     configFiles: string[];
-    /** Build directory candidates configuration */
     buildDirs: BuildDirConfig;
-    /** Server entry file candidates */
     serverEntryFiles?: string[];
-    /** Server wrapper configuration (use preset name or custom config) */
     serverWrapper?: keyof typeof SERVER_WRAPPER_PRESETS | ServerWrapperPreset;
-    /** Default routes list */
+    serverWrapperMode?: ServerWrapperModeConfig;
+    /** Declarative route configuration */
+    routeConfig?: RouteSourceConfig;
+    /** Legacy: default routes (use routeConfig.defaultRoutes instead) */
     defaultRoutes?: string[];
-    /** Extra routes for SSR mode */
+    /** Legacy: SSR extra routes (use routeConfig.ssrExtraRoutes instead) */
     ssrExtraRoutes?: string[];
-    /** Custom ssr404 handling */
     ssr404?: boolean | ((isSSR: boolean) => boolean);
-    /** HTML template path candidates (for viteSSR preset) */
     htmlTemplatePaths?: string[];
+    /** esbuild configuration */
+    esbuildConfig?: EsbuildConfig;
 }
 /**
  * Adapter factory runtime options
  */
 export interface AdapterFactoryOptions {
-    /** User-specified client directory */
     clientBuildDir?: string;
-    /** User-specified server directory */
     serverBuildDir?: string;
-    /** User-specified server entry */
     serverEntry?: string;
-    /** User-specified routes */
     routes?: string[];
 }
 /**
  * Create a framework adapter
- *
- * @example
- * ```ts
- * const adapter = createFrameworkAdapter({
- *   name: "my-framework",
- *   configFiles: ["my-framework.config.ts", "my-framework.config.js"],
- *   buildDirs: {
- *     client: ["dist/client", "dist"],
- *     server: ["dist/server"],
- *   },
- *   serverWrapper: "generic",
- * });
- * ```
  */
 export declare function createFrameworkAdapter(config: AdapterFactoryConfig, options?: AdapterFactoryOptions, overrides?: Partial<FrameworkAdapter>): FrameworkAdapter;
 /**
- * Create a stateful adapter
- * Used for complex adapters that need to share state between different hooks
+ * Create a stateful adapter (for complex adapters needing shared state)
  */
 export declare function createStatefulAdapter<TState extends object>(initialState: TState, factory: (state: TState) => FrameworkAdapter): FrameworkAdapter;
 /**
- * Compose multiple hooks
+ * Combine multiple detector functions (returns true if any matches)
  */
-export declare function composeHooks(...hooksList: (AdapterHooks | undefined)[]): AdapterHooks;
+export declare function combineDetectors(...detectors: ((context: BuildContext) => Promise<boolean> | boolean)[]): (context: BuildContext) => Promise<boolean>;
 /**
- * Create a detector function - based on config files
+ * Create detector based on config files
  */
 export declare function createConfigDetector(configFiles: string[]): (context: BuildContext) => Promise<boolean>;
 /**
- * Create a detector function - based on build directories
+ * Create detector based on build directories
  */
 export declare function createBuildDirDetector(buildDirs: string[]): (context: BuildContext) => Promise<boolean>;
 /**
- * Create a detector function - based on package.json dependencies
+ * Create detector based on package.json dependencies
  */
 export declare function createDependencyDetector(dependencies: string[]): (context: BuildContext) => Promise<boolean>;
-/**
- * Combine multiple detector functions (returns true if any matches)
- */
-export declare function combineDetectors(...detectors: ((context: BuildContext) => Promise<boolean> | boolean)[]): (context: BuildContext) => Promise<boolean>;
 //# sourceMappingURL=factory.d.ts.map

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":"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"}

package/dist/factory.js

@@ -1,11 +1,11 @@
 /**
  * Adapter Factory - Simplifies the creation of framework adapters
  *
- * Provides factory functions and preset configurations to reduce boilerplate code in adapter development
+ * Provides factory functions and preset configurations to reduce boilerplate code
  */
 import path from "path";
-import { detectConfigFile, detectBuildDir, detectServerEntry, generateServerWrapperCode, createDefaultMeta, logBuildArtifacts, } from "./helpers.js";
-import { pathExists, readFile } from "./utils.js";
+import { pathExists, readFile, detectConfigFile, detectBuildDir, detectServerEntry, generateServerWrapperCode, createDefaultMeta, logBuildArtifacts, } from "./utils.js";
+import { parseRoutesFromSources, } from "./route-parser.js";
 /**
  * Built-in server wrapper presets
  */
@@ -58,7 +58,6 @@ const requestHandler = createRequestHandler(buildConfig);`.trim(),
     viteSSR: {
         requiresHtmlTemplate: true,
         handlerSetup: `
-// Get render function from server build
 const renderFn = typeof render === 'function' 
   ? render 
   : (typeof module !== 'undefined' && typeof module.render === 'function' ? module.render : null);
@@ -72,10 +71,7 @@ async function handleSSRRequest(request) {
   const pathname = url.pathname;
   
   try {
-    // Call render function
     const rendered = await renderFn(pathname);
-    
-    // Inject rendered content into template
     let html = __HTML_TEMPLATE__
       .replace('<!--app-head-->', rendered.head ?? '')
       .replace('<!--app-html-->', rendered.html ?? '');
@@ -95,235 +91,270 @@ async function handleSSRRequest(request) {
         handlerCall: "handleSSRRequest(webRequest)",
     },
 };
+// ============================================================================
+// Internal Helper Functions
+// ============================================================================
 /**
- * Create a framework adapter
- *
- * @example
- * ```ts
- * const adapter = createFrameworkAdapter({
- *   name: "my-framework",
- *   configFiles: ["my-framework.config.ts", "my-framework.config.js"],
- *   buildDirs: {
- *     client: ["dist/client", "dist"],
- *     server: ["dist/server"],
- *   },
- *   serverWrapper: "generic",
- * });
- * ```
+ * Create default detect function based on config files
  */
-export function createFrameworkAdapter(config, options = {}, overrides) {
-    const { name, configFiles, buildDirs, serverEntryFiles = ["index.js", "index.mjs", "entry.js", "main.js"], serverWrapper = "generic", defaultRoutes = ["/"], ssrExtraRoutes = [], ssr404, htmlTemplatePaths = ["dist/client/index.html", "dist/index.html"], } = config;
-    const { clientBuildDir, serverBuildDir, serverEntry, routes = defaultRoutes, } = options;
-    // Resolve server wrapper configuration
-    const wrapperConfig = typeof serverWrapper === "string"
-        ? SERVER_WRAPPER_PRESETS[serverWrapper]
-        : serverWrapper;
-    const baseAdapter = {
-        name,
-        async detect(context) {
-            const configPath = await detectConfigFile(context.projectRoot, configFiles);
-            return configPath !== null;
-        },
-        async getBuildArtifacts(context) {
-            const { projectRoot, isSSR, logger } = context;
-            // Detect client directory
-            let clientDir = null;
-            if (clientBuildDir) {
-                clientDir = path.join(projectRoot, clientBuildDir);
+function createDefaultDetector(configFiles) {
+    return async (context) => {
+        const configPath = await detectConfigFile(context.projectRoot, configFiles);
+        return configPath !== null;
+    };
+}
+/**
+ * Create default getBuildArtifacts function
+ */
+function createDefaultBuildArtifactsGetter(name, buildDirs, serverEntryFiles, options) {
+    const { clientBuildDir, serverBuildDir, serverEntry } = options;
+    return async (context) => {
+        const { projectRoot, isSSR, logger } = context;
+        let clientDir = null;
+        if (clientBuildDir) {
+            clientDir = path.join(projectRoot, clientBuildDir);
+        }
+        else {
+            clientDir = await detectBuildDir(projectRoot, buildDirs.client);
+        }
+        let serverDir = null;
+        let serverEntryPath = null;
+        if (isSSR && buildDirs.server) {
+            if (serverBuildDir) {
+                serverDir = path.join(projectRoot, serverBuildDir);
             }
             else {
-                const candidates = isSSR && buildDirs.server
-                    ? buildDirs.client
-                    : buildDirs.client;
-                clientDir = await detectBuildDir(projectRoot, candidates);
+                serverDir = await detectBuildDir(projectRoot, buildDirs.server);
             }
-            // Detect server directory and entry
-            let serverDir = null;
-            let serverEntryPath = null;
-            if (isSSR && buildDirs.server) {
-                if (serverBuildDir) {
-                    serverDir = path.join(projectRoot, serverBuildDir);
-                }
-                else {
-                    serverDir = await detectBuildDir(projectRoot, buildDirs.server);
-                }
-                if (serverEntry) {
-                    serverEntryPath = path.join(projectRoot, serverEntry);
+            if (serverEntry) {
+                serverEntryPath = path.join(projectRoot, serverEntry);
+            }
+            else if (serverDir) {
+                serverEntryPath = await detectServerEntry(serverDir, serverEntryFiles);
+            }
+        }
+        logBuildArtifacts(logger, name, {
+            clientDir,
+            serverDir,
+            serverEntry: serverEntryPath,
+        });
+        return {
+            clientDir,
+            serverDir,
+            serverEntry: serverEntryPath,
+            assetsDir: clientDir,
+        };
+    };
+}
+/**
+ * Create generateRoutes hook
+ */
+function createGenerateRoutesHook(effectiveRouteConfig, fallbackRoutes) {
+    return async (context) => {
+        const { projectRoot, isSSR, logger } = context;
+        // Try declarative route sources first
+        if (effectiveRouteConfig.sources && effectiveRouteConfig.sources.length > 0) {
+            let parsedRoutes = await parseRoutesFromSources(projectRoot, effectiveRouteConfig.sources, { isSSR, logger });
+            if (parsedRoutes.length > 0) {
+                // Apply transform if provided
+                if (effectiveRouteConfig.transform) {
+                    parsedRoutes = effectiveRouteConfig.transform(parsedRoutes, context);
                 }
-                else if (serverDir) {
-                    serverEntryPath = await detectServerEntry(serverDir, serverEntryFiles);
+                // Add SSR extra routes
+                if (isSSR && effectiveRouteConfig.ssrExtraRoutes) {
+                    effectiveRouteConfig.ssrExtraRoutes.forEach((route) => {
+                        parsedRoutes.push({ path: route, isStatic: false, srcRoute: route });
+                    });
                 }
+                return parsedRoutes;
             }
-            logBuildArtifacts(logger, name, {
-                clientDir,
-                serverDir,
-                serverEntry: serverEntryPath,
+        }
+        // Fallback to static route list
+        const routeList = fallbackRoutes.map((route) => ({
+            path: route,
+            isStatic: !isSSR,
+            srcRoute: route,
+        }));
+        if (isSSR && effectiveRouteConfig.ssrExtraRoutes) {
+            effectiveRouteConfig.ssrExtraRoutes.forEach((route) => {
+                routeList.push({ path: route, isStatic: false, srcRoute: route });
             });
-            return {
-                clientDir,
-                serverDir,
-                serverEntry: serverEntryPath,
-                assetsDir: clientDir,
-            };
-        },
-        hooks: {
-            async generateRoutes(context) {
-                const routeList = routes.map((route) => ({
-                    path: route,
-                    isStatic: !context.isSSR,
-                    srcRoute: route,
-                }));
-                // Add extra routes for SSR mode
-                if (context.isSSR && ssrExtraRoutes.length > 0) {
-                    ssrExtraRoutes.forEach((route) => {
-                        routeList.push({ path: route, isStatic: false, srcRoute: route });
-                    });
-                }
-                return routeList;
-            },
-            async generateMeta(context, routeList) {
-                const meta = createDefaultMeta(routeList, { isSSR: context.isSSR });
-                // Custom ssr404 handling
-                if (ssr404 !== undefined) {
-                    meta.conf.ssr404 = typeof ssr404 === "function"
-                        ? ssr404(context.isSSR)
-                        : ssr404;
-                }
-                return meta;
-            },
-            async generateServerWrapper(context, wrapperCfg) {
-                let handlerSetup = wrapperConfig.handlerSetup;
-                // Handle HTML template injection for viteSSR preset
-                if (wrapperConfig.requiresHtmlTemplate) {
-                    const { projectRoot, outputDir, logger } = context;
-                    // Try to read HTML template
-                    let htmlTemplate = "";
-                    const templateCandidates = [
-                        ...htmlTemplatePaths.map(p => path.join(projectRoot, p)),
-                        path.join(projectRoot, outputDir, "assets/index.html"),
-                    ];
-                    for (const templatePath of templateCandidates) {
-                        if (await pathExists(templatePath)) {
-                            htmlTemplate = await readFile(templatePath);
-                            logger.verbose(`Found HTML template: ${templatePath}`);
-                            break;
-                        }
-                    }
-                    if (!htmlTemplate) {
-                        logger.warn("HTML template not found, using default template");
-                        htmlTemplate = "<!DOCTYPE html><html><head><!--app-head--></head><body><div id=\"app\"><!--app-html--></div></body></html>";
-                    }
-                    // Prepend HTML template definition
-                    const escapedTemplate = JSON.stringify(htmlTemplate);
-                    handlerSetup = `// HTML template embedded at build time\nconst __HTML_TEMPLATE__ = ${escapedTemplate};\n\n${handlerSetup}`;
+        }
+        return routeList;
+    };
+}
+/**
+ * Create generateMeta hook
+ */
+function createGenerateMetaHook(ssr404) {
+    return async (context, routeList) => {
+        const meta = createDefaultMeta(routeList, { isSSR: context.isSSR });
+        if (ssr404 !== undefined) {
+            meta.conf.ssr404 = typeof ssr404 === "function"
+                ? ssr404(context.isSSR)
+                : ssr404;
+        }
+        return meta;
+    };
+}
+/**
+ * Create generateServerWrapper hook
+ */
+function createGenerateServerWrapperHook(wrapperConfig, serverWrapperMode, htmlTemplatePaths) {
+    return async (context, wrapperCfg) => {
+        // Use serverWrapperMode if provided
+        if (serverWrapperMode) {
+            return generateServerWrapperCode({
+                serverEntryPath: wrapperCfg.serverEntryPath,
+                handlerCall: serverWrapperMode.handlerCall || wrapperConfig.handlerCall,
+                mode: serverWrapperMode.mode,
+                additionalExports: serverWrapperMode.additionalExports,
+                needsNodeRequestConversion: true,
+            });
+        }
+        let handlerSetup = wrapperConfig.handlerSetup;
+        if (wrapperConfig.requiresHtmlTemplate) {
+            const { projectRoot, outputDir, logger } = context;
+            let htmlTemplate = "";
+            const templateCandidates = [
+                ...htmlTemplatePaths.map(p => path.join(projectRoot, p)),
+                path.join(projectRoot, outputDir, "assets/index.html"),
+            ];
+            for (const templatePath of templateCandidates) {
+                if (await pathExists(templatePath)) {
+                    htmlTemplate = await readFile(templatePath);
+                    logger.verbose(`Found HTML template: ${templatePath}`);
+                    break;
                 }
-                return generateServerWrapperCode({
-                    serverEntryPath: wrapperCfg.serverEntryPath,
-                    imports: wrapperConfig.imports,
-                    handlerSetup,
-                    handlerCall: wrapperConfig.handlerCall,
-                });
+            }
+            if (!htmlTemplate) {
+                logger.warn("HTML template not found, using default template");
+                htmlTemplate = "<!DOCTYPE html><html><head><!--app-head--></head><body><div id=\"app\"><!--app-html--></div></body></html>";
+            }
+            const escapedTemplate = JSON.stringify(htmlTemplate);
+            handlerSetup = `const __HTML_TEMPLATE__ = ${escapedTemplate};\n\n${handlerSetup}`;
+        }
+        return generateServerWrapperCode({
+            serverEntryPath: wrapperCfg.serverEntryPath,
+            imports: wrapperConfig.imports,
+            handlerSetup,
+            handlerCall: wrapperConfig.handlerCall,
+        });
+    };
+}
+/**
+ * Create beforeBundle hook if esbuildConfig is provided
+ */
+function createBeforeBundleHook(esbuildConfig) {
+    return async (context, bundleConfig) => {
+        const absWorkingDir = typeof esbuildConfig.absWorkingDir === "function"
+            ? esbuildConfig.absWorkingDir(context)
+            : esbuildConfig.absWorkingDir;
+        return {
+            ...bundleConfig,
+            external: esbuildConfig.external || bundleConfig.external,
+            esbuildOptions: {
+                ...bundleConfig.esbuildOptions,
+                ...esbuildConfig.options,
+                ...(absWorkingDir ? { absWorkingDir } : {}),
             },
-        },
+        };
     };
-    // Merge user overrides
-    if (overrides) {
-        return mergeAdapter(baseAdapter, overrides);
-    }
-    return baseAdapter;
 }
+// ============================================================================
+// Main Factory Function
+// ============================================================================
 /**
- * Merge adapter configurations
+ * Create a framework adapter
  */
-function mergeAdapter(base, overrides) {
-    const merged = {
-        ...base,
-        ...overrides,
-        name: overrides.name || base.name,
+export function createFrameworkAdapter(config, options = {}, overrides) {
+    const { name, configFiles, buildDirs, serverEntryFiles = ["index.js", "index.mjs", "entry.js", "main.js"], serverWrapper = "generic", serverWrapperMode, routeConfig, defaultRoutes = ["/"], ssrExtraRoutes = [], ssr404, htmlTemplatePaths = ["dist/client/index.html", "dist/index.html"], esbuildConfig, } = config;
+    const { routes = routeConfig?.defaultRoutes || defaultRoutes } = options;
+    // Merge route config with legacy options
+    const effectiveRouteConfig = {
+        sources: routeConfig?.sources,
+        defaultRoutes: routeConfig?.defaultRoutes || defaultRoutes,
+        ssrExtraRoutes: routeConfig?.ssrExtraRoutes || ssrExtraRoutes,
+        transform: routeConfig?.transform,
     };
-    // Merge hooks
-    if (base.hooks || overrides.hooks) {
-        merged.hooks = {
-            ...base.hooks,
-            ...overrides.hooks,
+    const wrapperConfig = typeof serverWrapper === "string"
+        ? SERVER_WRAPPER_PRESETS[serverWrapper]
+        : serverWrapper;
+    // Build adapter using helper functions
+    const baseAdapter = {
+        name,
+        detect: createDefaultDetector(configFiles),
+        getBuildArtifacts: createDefaultBuildArtifactsGetter(name, buildDirs, serverEntryFiles, options),
+        hooks: {
+            generateRoutes: createGenerateRoutesHook(effectiveRouteConfig, routes),
+            generateMeta: createGenerateMetaHook(ssr404),
+            generateServerWrapper: createGenerateServerWrapperHook(wrapperConfig, serverWrapperMode, htmlTemplatePaths),
+            ...(esbuildConfig ? { beforeBundle: createBeforeBundleHook(esbuildConfig) } : {}),
+        },
+    };
+    if (overrides) {
+        return {
+            ...baseAdapter,
+            ...overrides,
+            name: overrides.name || baseAdapter.name,
+            hooks: { ...baseAdapter.hooks, ...overrides.hooks },
         };
     }
-    return merged;
+    return baseAdapter;
 }
 /**
- * Create a stateful adapter
- * Used for complex adapters that need to share state between different hooks
+ * Create a stateful adapter (for complex adapters needing shared state)
  */
 export function createStatefulAdapter(initialState, factory) {
-    const state = { ...initialState };
-    return factory(state);
+    return factory({ ...initialState });
 }
 /**
- * Compose multiple hooks
+ * Combine multiple detector functions (returns true if any matches)
  */
-export function composeHooks(...hooksList) {
-    const result = {};
-    for (const hooks of hooksList) {
-        if (!hooks)
-            continue;
-        Object.assign(result, hooks);
-    }
-    return result;
+export function combineDetectors(...detectors) {
+    return async (context) => {
+        for (const detector of detectors) {
+            if (await detector(context)) {
+                return true;
+            }
+        }
+        return false;
+    };
 }
 /**
- * Create a detector function - based on config files
+ * Create detector based on config files
  */
 export function createConfigDetector(configFiles) {
     return async (context) => {
-        const configPath = await detectConfigFile(context.projectRoot, configFiles);
-        return configPath !== null;
+        return (await detectConfigFile(context.projectRoot, configFiles)) !== null;
     };
 }
 /**
- * Create a detector function - based on build directories
+ * Create detector based on build directories
  */
 export function createBuildDirDetector(buildDirs) {
     return async (context) => {
-        for (const dir of buildDirs) {
-            if (await pathExists(path.join(context.projectRoot, dir))) {
-                return true;
-            }
-        }
-        return false;
+        return (await detectBuildDir(context.projectRoot, buildDirs)) !== null;
     };
 }
 /**
- * Create a detector function - based on package.json dependencies
+ * Create detector based on package.json dependencies
  */
 export function createDependencyDetector(dependencies) {
     return async (context) => {
         const packageJsonPath = path.join(context.projectRoot, "package.json");
-        if (!await pathExists(packageJsonPath)) {
+        if (!await pathExists(packageJsonPath))
             return false;
-        }
         try {
-            const { readFile } = await import("./utils.js");
             const content = await readFile(packageJsonPath);
             const packageJson = JSON.parse(content);
             const deps = { ...packageJson.dependencies, ...packageJson.devDependencies };
             return dependencies.some((dep) => dep in deps);
         }
-        catch {
+        catch (error) {
+            context.logger?.verbose?.(`Failed to parse package.json: ${error instanceof Error ? error.message : String(error)}`);
             return false;
         }
     };
 }
-/**
- * Combine multiple detector functions (returns true if any matches)
- */
-export function combineDetectors(...detectors) {
-    return async (context) => {
-        for (const detector of detectors) {
-            if (await detector(context)) {
-                return true;
-            }
-        }
-        return false;
-    };
-}
 //# sourceMappingURL=factory.js.map