olova 2.0.61 → 2.0.63

package/olova.ts

@@ -1,619 +0,0 @@
-import { existsSync } from "node:fs";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { olovaRouter } from "./src/plugin";
-import { build, type Plugin, type ResolvedConfig } from "vite";
-import logger from "./src/logger";
-import type { PerformanceOptions } from "./src/performance";
-import {
-  createManualChunks,
-  generatePreloadHints,
-  generatePreloadTags,
-  olovaPerformance,
-} from "./src/performance";
-
-// =============================================================================
-// FLIGHT HYDRATION - Import from shared module (no duplication)
-// =============================================================================
-
-import {
-  generateBuildId,
-  generateJsonLd,
-  generateOlovaHydration,
-  generateResourceHints,
-  type OlovaHydrationData,
-} from './src/hydration';
-
-// =============================================================================
-// PLUGIN INTERFACE
-// =============================================================================
-
-export interface OlovaOptions {
-  /**
-   * Static paths to pre-render at build time
-   */
-  staticPaths?: string[];
-
-  /**
-   * Performance optimization options
-   */
-  performance?: PerformanceOptions & {
-    /**
-     * Enable all performance optimizations
-     * @default true
-     */
-    enabled?: boolean;
-  };
-
-  /**
-   * Package name for router imports in generated route.tree.ts
-   * @default 'olovastart'
-   */
-  packageName?: string;
-}
-
-export function olova(options: OlovaOptions = {}): any {
-  const virtualModuleId = "virtual:olova-entry";
-  const serverVirtualModuleId = "virtual:olova-server-entry";
-  const workerVirtualModuleId = "virtual:olova-worker-entry";
-  const appVirtualModuleId = "virtual:olova-app";
-  const resolvedAppVirtualModuleId = "\0" + appVirtualModuleId;
-  let config: ResolvedConfig;
-
-  // Minimal shell - just the placeholder.
-  // We'll prepend DOCTYPE manually to avoid duplication if app renders it (though app usually shouldn't).
-  const htmlContent = `<!--app-html-->`;
-
-  // Simple HTML minifier: removes whitespace between tags, trimming, and newlines
-  const minifyHtml = (html: string) => {
-    return html
-      .replace(/>\s+</g, "><")
-      .replace(/\s{2,}/g, " ")
-      .replace(/<!--[\s\S]*?-->/g, "") // remove comments
-      .trim();
-  };
-
-  return [
-    olovaRouter({ packageName: options.packageName }),
-    {
-      name: "vite-plugin-olova",
-      config(userConfig, { isSsrBuild }) {
-        // All optimizations are enabled by default
-        const perfEnabled = options.performance?.enabled !== false;
-
-        // Skip performance optimizations for SSR builds
-        if (isSsrBuild) {
-          return {
-            build: {
-              rollupOptions: {
-                input: userConfig.build?.rollupOptions?.input || virtualModuleId,
-                output: {
-                  // Simple output for SSR
-                  entryFileNames: 'index.js',
-                  chunkFileNames: '[name].js',
-                  assetFileNames: '[name].[ext]',
-                  format: 'esm',
-                  manualChunks: undefined,
-                },
-              },
-            },
-          };
-        }
-
-        // Full optimization config for client builds (all automatic!)
-        const buildConfig: any = {
-          // Output directory for assets
-          assetsDir: 'assets/_olova',
-          // Report compressed size in build output
-          reportCompressedSize: true,
-          rollupOptions: {
-            input: userConfig.build?.rollupOptions?.input || virtualModuleId,
-            output: {
-              // Optimized chunk naming for caching
-              chunkFileNames: 'assets/_olova/[name]-[hash].js',
-              entryFileNames: 'assets/_olova/[name]-[hash].js',
-              assetFileNames: 'assets/_olova/[name]-[hash].[ext]',
-              // Enable smart code splitting
-              ...(perfEnabled && {
-                manualChunks: createManualChunks(),
-              }),
-            },
-          },
-          // Increase warning limit since we're doing smart chunking
-          chunkSizeWarningLimit: 500,
-          // Inline small assets (< 4KB)
-          assetsInlineLimit: 4096,
-          // Enable terser minification for smaller bundles
-          minify: 'terser',
-          terserOptions: {
-            compress: {
-              // Aggressive optimizations for production
-              drop_console: false, // Keep console for debugging
-              drop_debugger: true,
-              pure_funcs: ['console.debug'],
-              passes: 2,
-            },
-            mangle: {
-              properties: false,
-            },
-            format: {
-              comments: false,
-            },
-          },
-          // Disable source maps for smaller builds
-          sourcemap: false,
-          // CSS code splitting
-          cssCodeSplit: true,
-          // Target modern browsers (smaller bundles)
-          target: 'es2020',
-        };
-
-        return {
-          build: buildConfig,
-          // Optimize deps for faster dev startup
-          optimizeDeps: {
-            include: ['react', 'react-dom'],
-            exclude: ['olova'],
-          },
-          // SSR options
-          ssr: {
-            noExternal: ['olova'],
-          },
-          // esbuild optimizations
-          esbuild: {
-            treeShaking: true,
-            legalComments: 'none',
-          },
-          // Preview server configuration (for testing production builds)
-          preview: {
-            headers: {
-              // Long-term caching for static assets
-              'Cache-Control': 'public, max-age=31536000',
-            },
-          },
-        };
-      },
-      async configResolved(resolvedConfig) {
-        config = resolvedConfig;
-      },
-      async resolveId(id) {
-        if (id === virtualModuleId || id === serverVirtualModuleId || id === workerVirtualModuleId) {
-          const isServer = id === serverVirtualModuleId;
-          const isWorker = id === workerVirtualModuleId;
-          const fileName = isWorker ? "entry-worker" : (isServer ? "entry-server" : "main");
-
-          // 1. Try to find local project override first
-          const possibleLocalPaths = [
-            path.resolve(config.root, `src/${fileName}.tsx`),
-            path.resolve(config.root, `src/${fileName}.ts`),
-            path.resolve(config.root, `${fileName}.tsx`),
-            path.resolve(config.root, `plugins/${fileName}.tsx`),
-          ];
-
-          for (const p of possibleLocalPaths) {
-            if (existsSync(p)) return p;
-          }
-
-          // 2. Try to resolve via standard module resolution (ensures deduplication)
-          const exportName = isWorker ? 'olova/entry-worker' : (isServer ? 'olova/entry-server' : 'olova/main');
-          try {
-            const resolved = await this.resolve(exportName, undefined, { skipSelf: true });
-            if (resolved && !resolved.external) {
-              return resolved.id;
-            }
-          } catch (e) {
-            // Resolution failed, continue to fallback
-          }
-
-          // 3. Fallback to package's own entry (bundled or source) - mostly for local dev of the plugin
-          const pkgDir = path.dirname(fileURLToPath(import.meta.url));
-          const possiblePkgPaths = [
-            path.resolve(pkgDir, `dist/${fileName}.js`),
-            path.resolve(pkgDir, `${fileName}.js`),
-            path.resolve(pkgDir, `${fileName}.mjs`),
-            path.resolve(pkgDir, `${fileName}.ts`),
-            path.resolve(pkgDir, `${fileName}.tsx`),
-            path.resolve(pkgDir, `src/${fileName}.tsx`),
-            path.resolve(pkgDir, `src/${fileName}.ts`),
-            // If running from dist, check parent directories
-            path.resolve(pkgDir, '..', `dist/${fileName}.js`),
-            path.resolve(pkgDir, '..', `${fileName}.js`),
-            path.resolve(pkgDir, '..', `${fileName}.tsx`),
-            path.resolve(pkgDir, '..', `src/${fileName}.tsx`),
-          ];
-
-          for (const p of possiblePkgPaths) {
-            if (existsSync(p)) return p;
-          }
-        }
-        if (id === appVirtualModuleId) {
-          return resolvedAppVirtualModuleId;
-        }
-        return null;
-      },
-      load(id) {
-        if (id === resolvedAppVirtualModuleId) {
-          // Generate virtual module that re-exports from the user's route.tree
-          return `
-          export { OlovaRouter, Outlet, routes, layouts, notFoundPages } from '@/route.tree';
-          import '@/index.css';
-        `;
-        }
-        return null;
-      },
-      configureServer(server) {
-        // Generate a dev build ID that stays consistent during the dev session
-        const devBuildId = generateBuildId();
-
-        // Print startup banner
-        logger.printBanner();
-
-        // Print dev server info once ready
-
-
-        // Delay printing to let Vite finish its own output first if needed, 
-        // or print immediately if we want to override. 
-        // Since Vite 7 prints its own banner, we might want to just print our info.
-        // But user complained about the "terminal looks bad", so let's try to be clean.
-
-        server.middlewares.use(async (req, res, next) => {
-          const url = req.url?.split("?")[0];
-          if (
-            url === "/" ||
-            url === "/index.html" ||
-            (req.headers.accept?.includes("text/html") &&
-              !url?.match(/\.[a-z]+$/))
-          ) {
-            try {
-              logger.printSSRRender(url || "/");
-              let template = htmlContent;
-
-              const { render } = await server.ssrLoadModule(
-                serverVirtualModuleId,
-              );
-              const renderResult = await render(url || "/");
-              // Handle both string return (legacy) and object return (new Flight format)
-              const appHtml = typeof renderResult === 'string' ? renderResult : renderResult.html;
-              const routeMetadata = typeof renderResult === 'string' ? {} : renderResult.metadata || {};
-              const loaderData = typeof renderResult === 'string' ? undefined : renderResult.loaderData;
-              const queryState = typeof renderResult === 'string' ? undefined : renderResult.queryState;
-
-              let fullHtml = template.replace("<!--app-html-->", appHtml);
-
-              // =================================================================
-              // Flight Hydration for Dev Server
-              // =================================================================
-              const hydrationData: OlovaHydrationData = {
-                route: url || "/",
-                params: {},
-                metadata: routeMetadata,
-                chunks: [], // Dev mode doesn't have pre-built chunks
-                isStatic: false,
-                loaderData: loaderData,
-                queryState: queryState,
-              };
-
-              // Generate Flight hydration scripts
-              const flightScripts = generateOlovaHydration(hydrationData, devBuildId);
-
-              // Generate JSON-LD for SEO
-              const jsonLdScript = generateJsonLd(hydrationData);
-
-              // Generate resource hints (minimal in dev)
-              const resourceHints = `<link rel="dns-prefetch" href="//fonts.googleapis.com"><link rel="preconnect" href="https://fonts.googleapis.com" crossorigin>`;
-
-              // Inject JSON-LD and resource hints in head
-              if (fullHtml.includes("</head>")) {
-                fullHtml = fullHtml.replace("</head>", `${jsonLdScript}${resourceHints}</head>`);
-              }
-
-              // Inject Flight scripts and entry script for hydration
-              if (fullHtml.includes("</body>")) {
-                fullHtml = fullHtml.replace(
-                  "</body>",
-                  `${flightScripts}<script type="module" src="/@id/${virtualModuleId}"></script></body>`,
-                );
-              } else {
-                fullHtml += `${flightScripts}<script type="module" src="/@id/${virtualModuleId}"></script>`;
-              }
-
-              // Now apply Vite transforms.
-              fullHtml = await server.transformIndexHtml(url || "/", fullHtml);
-
-              // Prepend DOCTYPE if missing
-              if (!fullHtml.trim().toLowerCase().startsWith("<!doctype html>")) {
-                fullHtml = `<!DOCTYPE html>${fullHtml}`;
-              }
-
-              res.statusCode = 200;
-              res.setHeader("Content-Type", "text/html");
-              res.end(minifyHtml(fullHtml));
-              return;
-            } catch (e) {
-              server.ssrFixStacktrace(e as Error);
-              console.error(e);
-              res.statusCode = 500;
-              res.end((e as Error).stack);
-              return;
-            }
-          }
-          next();
-        });
-      },
-      async writeBundle(_options, bundle) {
-        if (config.command === "serve" || config.build.ssr) return;
-
-        const buildStartTime = Date.now();
-        logger.printBuildStart();
-        const outDir = config.build.outDir; // dist/client
-        const serverOutDir = path.resolve(config.root, "dist/server"); // Always dist/server
-
-        // Find client entry chunk
-        const clientEntry = Object.values(bundle).find(
-          (chunk) =>
-            chunk.type === "chunk" &&
-            chunk.isEntry &&
-            (chunk.facadeModuleId?.includes("main") ||
-              chunk.name === "main"),
-        );
-        const clientEntryFileName = clientEntry
-          ? clientEntry.fileName
-          : "assets/index.js";
-
-        // Find CSS assets
-        const cssAssets = Object.values(bundle).filter(
-          (chunk) => chunk.type === "asset" && chunk.fileName.endsWith(".css"),
-        );
-        const cssLinks = cssAssets
-          .map(
-            (css) =>
-              `<link rel="stylesheet" crossorigin href="/${css.fileName}">`,
-          )
-          .join("");
-
-        // 1. Build Server Bundle
-        // We use configFile to get MDX and other plugins, but override build settings for SSR
-        await build({
-          configFile: config.configFile,
-          root: config.root,
-          build: {
-            ssr: true,
-            emptyOutDir: false,
-            outDir: serverOutDir,
-            minify: false, // Keep readable for debugging
-            rollupOptions: {
-              input: { index: serverVirtualModuleId },
-              output: {
-                entryFileNames: "index.js",
-                chunkFileNames: "[name].js",
-                assetFileNames: "[name].[ext]",
-                format: "esm",
-                // Explicitly set to undefined to prevent client-side chunking config
-                manualChunks: undefined,
-              },
-            },
-          },
-          logLevel: "error",
-        });
-
-        // 2. Load Server Entry to get routes
-        const serverEntryPath = path.resolve(serverOutDir, "index.js");
-        const serverEntryUrl = pathToFileURL(serverEntryPath).toString();
-        // Initial import to get routes
-        const { routes } = await import(serverEntryUrl);
-
-        // 3. Generate Pages
-        const paths = ["/"];
-
-        function extractPaths(routesArr: any[]) {
-          routesArr.forEach((r) => {
-            if (r.path && !r.path.includes("*") && !r.path.includes(":")) {
-              paths.push(r.path);
-            }
-          });
-        }
-        if (Array.isArray(routes)) extractPaths(routes);
-
-        // 3b. Expand dynamic routes via getStaticPaths()
-        if (Array.isArray(routes)) {
-          for (const r of routes) {
-            const isDynamic = r.path.includes(":") || r.path.includes("*");
-            if (r.getStaticPaths && isDynamic) {
-              try {
-                const staticPaths = await r.getStaticPaths();
-                if (Array.isArray(staticPaths)) {
-                  for (const entry of staticPaths) {
-                    // entry = { params: { id: '1' } } or { params: { slug: 'hello/world' } }
-                    let expandedPath = r.path;
-                    if (entry.params) {
-                      for (const [key, value] of Object.entries(entry.params)) {
-                        expandedPath = expandedPath.replace(`:${key}`, value as string);
-                        expandedPath = expandedPath.replace('*', value as string);
-                      }
-                    }
-                    paths.push(expandedPath);
-                  }
-                  logger.info(`getStaticPaths for ${r.path}: ${staticPaths.length} paths expanded`);
-                }
-              } catch (e) {
-                logger.warn(`getStaticPaths() failed for ${r.path}: ${(e as Error).message}`);
-              }
-            }
-          }
-        }
-
-        // Add user-provided static paths
-        if (options.staticPaths) {
-          options.staticPaths.forEach((p) => paths.push(p));
-        }
-
-        const uniquePaths = [...new Set(paths)];
-
-        // Generate a unique build ID for this build
-        const buildId = generateBuildId();
-        logger.printSSGStart(buildId);
-
-        // Print route table
-        const routeInfo = uniquePaths.map(p => ({
-          path: p,
-          type: (p.includes(':') || p.includes('*') ? 'dynamic' : 'static') as 'static' | 'dynamic'
-        }));
-        logger.printRoutes(routeInfo);
-
-        logger.printFlightInfo();
-
-        // Collect all JS chunks for prefetching
-        const jsChunks = Object.values(bundle)
-          .filter((chunk) => chunk.type === "chunk" && chunk.fileName.endsWith(".js"))
-          .map((chunk) => chunk.fileName);
-
-        let successCount = 0;
-        let failCount = 0;
-
-        for (const p of uniquePaths) {
-          try {
-            // Update window location for the fresh import to pick up
-            if (typeof (globalThis as any).window !== "undefined") {
-              (globalThis as any).window.location.pathname = p;
-            }
-
-            // FORCE RE-IMPORT for every page to ensure clean state (fresh Router/History instance)
-            const cacheBuster = `?t=${Date.now()}-${Math.random()}`;
-            // We destructured render from the fresh module
-            const { render } = await import(serverEntryUrl + cacheBuster);
-
-            // Render returns { html, metadata, route, loaderData, queryState }
-            const renderResult = await render(p);
-            const appHtml = typeof renderResult === 'string' ? renderResult : renderResult.html;
-            const routeMetadata = typeof renderResult === 'string' ? {} : renderResult.metadata || {};
-            const loaderData = typeof renderResult === 'string' ? undefined : renderResult.loaderData;
-            const queryState = typeof renderResult === 'string' ? undefined : renderResult.queryState;
-
-            let html = htmlContent.replace("<!--app-html-->", appHtml);
-
-            // Generate smart preload hints based on chunk priority
-            const preloadHints = generatePreloadHints(jsChunks, clientEntryFileName);
-            const preloadTags = generatePreloadTags(preloadHints);
-
-            // Prepare hydration data for this page
-            const hydrationData: OlovaHydrationData = {
-              route: p,
-              params: {},
-              metadata: routeMetadata,
-              chunks: jsChunks,
-              isStatic: true,
-              loaderData: loaderData,
-              queryState: queryState,
-            };
-
-            // Generate Flight hydration scripts
-            const flightScripts = generateOlovaHydration(hydrationData, buildId);
-
-            // Generate JSON-LD for SEO
-            const jsonLdScript = generateJsonLd(hydrationData);
-
-            // Generate resource hints (DNS prefetch, preconnect)
-            const resourceHints = generateResourceHints(hydrationData);
-
-            // Inject JSON-LD, resource hints, CSS, and smart preload tags at end of head
-            if (html.includes("</head>")) {
-              html = html.replace("</head>", `${jsonLdScript}${resourceHints}${cssLinks}${preloadTags}</head>`);
-            }
-
-            // Inject Flight scripts and main script at end of body
-            if (html.includes("</body>")) {
-              html = html.replace(
-                "</body>",
-                `${flightScripts}<script type="module" src="/${clientEntryFileName}"></script></body>`,
-              );
-            } else {
-              // Fallback if no body tag found
-              html += `${flightScripts}<script type="module" src="/${clientEntryFileName}"></script>`;
-            }
-
-            // Prepend DOCTYPE if missing
-            if (!html.trim().toLowerCase().startsWith("<!doctype html>")) {
-              html = `<!DOCTYPE html>${html}`;
-            }
-
-            const itemPath =
-              p === "/" ? "index.html" : `${p.substring(1)}/index.html`;
-            const finalPath = path.resolve(outDir, itemPath);
-            await fs.mkdir(path.dirname(finalPath), { recursive: true });
-            await fs.writeFile(finalPath, minifyHtml(html));
-            logger.printPageGenerated(itemPath, true);
-            successCount++;
-          } catch (e) {
-            logger.printPageError(p, (e as Error).message);
-            failCount++;
-          }
-        }
-
-        // =====================================================================
-        // Generate 404.html for CDN compatibility (Cloudflare, Vercel, Netlify)
-        // =====================================================================
-        try {
-          const notFoundPath = '/__olova_404__';
-          if (typeof (globalThis as any).window !== "undefined") {
-            (globalThis as any).window.location.pathname = notFoundPath;
-          }
-          const cacheBuster404 = `?t=${Date.now()}-${Math.random()}`;
-          const { render: render404 } = await import(serverEntryUrl + cacheBuster404);
-          const result404 = await render404(notFoundPath);
-          const html404Content = typeof result404 === 'string' ? result404 : result404.html;
-
-          let html404 = htmlContent.replace("<!--app-html-->", html404Content);
-
-          // Add basic CSS and entry script
-          const preloadHints404 = generatePreloadHints(jsChunks, clientEntryFileName);
-          const preloadTags404 = generatePreloadTags(preloadHints404);
-
-          const hydrationData404: OlovaHydrationData = {
-            route: '/404',
-            params: {},
-            metadata: { title: '404 - Page Not Found' },
-            chunks: jsChunks,
-            isStatic: true,
-          };
-
-          const flightScripts404 = generateOlovaHydration(hydrationData404, buildId);
-          const jsonLd404 = generateJsonLd(hydrationData404);
-          const resourceHints404 = generateResourceHints(hydrationData404);
-
-          if (html404.includes("</head>")) {
-            html404 = html404.replace("</head>", `${jsonLd404}${resourceHints404}${cssLinks}${preloadTags404}</head>`);
-          }
-          if (html404.includes("</body>")) {
-            html404 = html404.replace("</body>", `${flightScripts404}<script type="module" src="/${clientEntryFileName}"></script></body>`);
-          } else {
-            html404 += `${flightScripts404}<script type="module" src="/${clientEntryFileName}"></script>`;
-          }
-          if (!html404.trim().toLowerCase().startsWith("<!doctype html>")) {
-            html404 = `<!DOCTYPE html>${html404}`;
-          }
-
-          const notFoundFinalPath = path.resolve(outDir, '404.html');
-          await fs.writeFile(notFoundFinalPath, minifyHtml(html404));
-          logger.printPageGenerated('404.html', true);
-          successCount++;
-        } catch (e) {
-          logger.warn(`Failed to generate 404.html: ${(e as Error).message}`);
-        }
-
-        // Cleanup server bundle (not needed for static serving)
-        await fs.rm(serverOutDir, { recursive: true, force: true });
-
-        const buildTime = Date.now() - buildStartTime;
-        logger.printSSGComplete({
-          totalPages: successCount,
-          successPages: successCount,
-          failedPages: failCount,
-          buildTime
-        });
-      },
-    } as Plugin,
-    // Add performance optimization plugins
-    ...(options.performance?.enabled !== false ? olovaPerformance(options.performance) : []),
-  ];
-}