vike-lite 1.16.1 → 1.17.0

package/README.md

@@ -29,13 +29,30 @@ export default {
     vikeLite({
       pagesDir: 'pages',           // Default: Directory containing your pages
       apiPrefix: '/api',           // Default: Prefix to bypass SSR for API routes
-      prerender: false             // Default: Enable SSG globally
+      prerender: false,            // Default: Enable SSG globally
       serverEntry: 'server/index', // Default: unfedined value that allows to use a custom server entry file
+      printDependencies: false     // Default: Print, per build (client/server), which package.json dependencies ended up in the bundle
     })
   ]
 } satisfies UserConfig
 ```
 
+#### printDependencies
+
+When set to `true`, at the end of each production build (client and server) the plugin prints the list of `package.json` dependencies (and devDependencies) that were actually bundled or externally imported in that specific build output. This is useful to debug bundle composition/size — e.g. spotting a heavy dependency that unexpectedly ended up in the client bundle.
+
+```sh
+
+📦 [Client bundle] package.json dependencies used (1):
+   - solid-js@^1.9.3
+
+📦 [Server bundle] package.json dependencies used (2):
+   - solid-js@^1.9.3
+   - hono@^4.12.31
+```
+
+It's disabled by default since it only adds diagnostic console output and isn't needed for normal usage.
+
 ### 🖥️ Server Integration
 
 #### `renderPage()`

package/dist/__internal/shared.d.mts

@@ -14,6 +14,7 @@ interface RenderContext {
   };
   nonce?: string;
 }
+declare function escapeRegex(str: string): string;
 declare function matchRoute(urlPathname: string, routes: typeof import('virtual:vike-lite/routes').routes): {
   route: any;
   routeParams: Record<string, string>;
@@ -30,4 +31,4 @@ declare function stripBase(pathname: string): string;
  */
 declare function prependBase(pathname: string): string;
 //#endregion
-export { BASE_URL, RenderContext, matchRoute, prependBase, stripBase };
+export { BASE_URL, RenderContext, escapeRegex, matchRoute, prependBase, stripBase };

package/dist/__internal/shared.mjs

@@ -62,4 +62,4 @@ function prependBase(pathname) {
 	return BASE_URL + (pathname === "/" ? "" : pathname);
 }
 //#endregion
-export { BASE_URL, matchRoute, prependBase, stripBase };
+export { BASE_URL, escapeRegex, matchRoute, prependBase, stripBase };

package/dist/__internal/vite/defaultServerEntry.mjs

@@ -6,8 +6,8 @@ import fs from 'node:fs'
 import fsPromises from 'node:fs/promises'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const clientDir = path.resolve(__dirname, '../client')
+const clientDir = path.resolve(import.meta.dirname, '../client')
+const assetsDir = path.join(clientDir, 'assets')
 const MIME_TYPES = {
   '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8',
   '.mjs': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8',
@@ -29,7 +29,8 @@ const server = createServer(async (req, res) => {
     const { BASE_URL } = import.meta.env
     if (BASE_URL !== '/' && pathname.startsWith(BASE_URL)) fileUrl = '/' + pathname.slice(BASE_URL.length)
     if (fileUrl !== '/') {
-      const filePath = path.resolve(clientDir, '.' + fileUrl)
+      const normalizedUrl = path.normalize(fileUrl)
+      const filePath = path.resolve(clientDir, '.' + normalizedUrl)
       if (!filePath.startsWith(clientDir)) {
         res.statusCode = 403
         res.end('Forbidden')
@@ -41,10 +42,7 @@ const server = createServer(async (req, res) => {
           const ext = path.extname(filePath).toLowerCase()
           const mimeType = MIME_TYPES[ext] || 'application/octet-stream'
           res.setHeader('Content-Type', mimeType)
-          res.setHeader(
-            'Cache-Control',
-            fileUrl.startsWith('/assets/') ? 'public, max-age=31536000, immutable' : 'public, max-age=0, must-revalidate'
-          )
+          res.setHeader('Cache-Control', filePath.startsWith(assetsDir) ? 'public, max-age=31536000, immutable' : 'public, max-age=0, must-revalidate')
           fs.createReadStream(filePath).pipe(res)
           return
         }

package/dist/__internal/vite.d.mts

@@ -27,19 +27,17 @@ declare function createDepsConfigPlugin({ packageName, optimizeDepsInclude }: {
  *
  * This centralizes logic that is otherwise identical across every `vike-lite-*` package.
  */
-declare function createFrameworkAdapterPlugin({ packageName, hydration, wrapServerHydration, streaming }: {
+declare function createFrameworkAdapterPlugin({ packageName, hydration, streaming }: {
   /** The framework adapter's package name, e.g. 'vike-lite-react'. */
   packageName: string;
   /** @default true */
   hydration?: boolean;
-  /** @default true */
-  wrapServerHydration?: boolean;
   /**
    * Stream the server-rendered app markup via the framework's Web Streams-based
    * SSR API instead of buffering it into a single string. Threaded through to
    * `onRenderHtml` the same way `hydration` is. Ignored by adapters whose
    * `onRenderHtml` doesn't accept a `streaming` option.
-   * @default false
+   * @default true
    */
   streaming?: boolean;
 }): Plugin;

package/dist/__internal/vite.mjs

@@ -35,7 +35,7 @@ function createDepsConfigPlugin({ packageName, optimizeDepsInclude }) {
 *
 * This centralizes logic that is otherwise identical across every `vike-lite-*` package.
 */
-function createFrameworkAdapterPlugin({ packageName, hydration = true, wrapServerHydration = true, streaming = false }) {
+function createFrameworkAdapterPlugin({ packageName, hydration = true, streaming = true }) {
 	const virtualClientId = "virtual:vike-lite/client";
 	const virtualServerId = "virtual:vike-lite/server";
 	const resolvedVirtualClientId = "\0virtual:vike-lite/client";
@@ -49,7 +49,7 @@ function createFrameworkAdapterPlugin({ packageName, hydration = true, wrapServe
 		},
 		load(id) {
 			if (id === resolvedVirtualClientId) return `export const onRenderClient=async(options)=>(await import("${packageName}/__internal/client/onRenderClient")).onRenderClient({...options,hydration:${hydration}});`;
-			if (id === resolvedVirtualServerId) return `import { onRenderHtml as _onRenderHtml } from '${packageName}/__internal/server/onRenderHtml';export const onRenderHtml = (ctx) => _onRenderHtml({ ...ctx, ${wrapServerHydration ? `hydration:${hydration},streaming:${streaming}` : `streaming:${streaming}`} });`;
+			if (id === resolvedVirtualServerId) return `import{onRenderHtml as _onRenderHtml}from'${packageName}/__internal/server/onRenderHtml';export const onRenderHtml=(ctx)=>_onRenderHtml({...ctx,hydration:${hydration},streaming:${streaming}});`;
 		}
 	};
 }

package/dist/vite.d.mts

@@ -1,6 +1,6 @@
 import { Plugin } from "vite";
 //#region src/vite/index.d.ts
-declare function vikeLite({ pagesDir, apiPrefix, prerender, serverEntry }?: {
+declare function vikeLite({ pagesDir, apiPrefix, prerender, serverEntry, printDependencies }?: {
   /**
    * The directory where your page components are located.
    * This is where the plugin will look for your page files to generate routes.
@@ -26,6 +26,14 @@ declare function vikeLite({ pagesDir, apiPrefix, prerender, serverEntry }?: {
    * @default undefined
    */
   serverEntry?: string | false;
+  /**
+   * Whether to print, at the end of each build (client and server), the list of
+   * package.json dependencies that ended up in that bundle. Useful to debug bundle
+   * size/composition, but adds console output on every production build, so it's
+   * disabled by default.
+   * @default false
+   */
+  printDependencies?: boolean;
 }): Plugin;
 //#endregion
 export { vikeLite as default };

package/dist/vite.mjs

@@ -1,3 +1,4 @@
+import { escapeRegex } from "./__internal/shared.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { Readable } from "node:stream";
@@ -109,13 +110,36 @@ const SUPPORTED_RENDERERS = [
 	"vue"
 ];
 //#endregion
+//#region src/vite/printDependencies.ts
+function findPackageJsonPath(startDir) {
+	let dir = startDir;
+	while (true) {
+		const candidate = path.join(dir, "package.json");
+		if (fs.existsSync(candidate)) return candidate;
+		const parent = path.dirname(dir);
+		if (parent === dir) return null;
+		dir = parent;
+	}
+}
+function extractPackageNameFromPath(moduleId) {
+	const matches = [...moduleId.replaceAll("\\", "/").matchAll(/node_modules\/(@[^/]+\/[^/]+|[^/]+)/g)];
+	if (matches.length === 0) return null;
+	return matches[matches.length - 1][1];
+}
+function extractPackageNameFromImport(imp) {
+	if (imp.startsWith(".") || imp.startsWith("/") || imp.startsWith("\0") || path.isAbsolute(imp) || imp.startsWith("node:")) return null;
+	const parts = imp.split("/");
+	return imp.startsWith("@") && parts.length > 1 ? `${parts[0]}/${parts[1]}` : parts[0];
+}
+//#endregion
 //#region src/vite/index.ts
-function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, serverEntry } = {}) {
+function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, serverEntry, printDependencies = false } = {}) {
 	const isProd = process.env.NODE_ENV === "production";
 	let viteConfigRoot;
 	let outDir;
 	let hasAnyPrerender;
 	let baseUrl;
+	let projectDependencies = null;
 	const VIRTUAL = {
 		routes: "virtual:vike-lite/routes",
 		manifest: "virtual:vike-lite/client-manifest",
@@ -139,10 +163,24 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 			outDir = config.build?.outDir ?? "dist";
 			const { emptyOutDir, minify = true, cssMinify = true, sourcemap } = config.build || {};
 			viteConfigRoot = config.root ? path.resolve(config.root) : process.cwd();
+			if (isProd && printDependencies) {
+				const pkgJsonPath = findPackageJsonPath(viteConfigRoot);
+				if (pkgJsonPath) {
+					const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
+					projectDependencies = {
+						...pkgJson.dependencies,
+						...pkgJson.devDependencies,
+						...pkgJson.peerDependencies
+					};
+				}
+			}
 			const { routes } = generateRoutes(viteConfigRoot, pagesDir);
 			hasAnyPrerender = prerender || routes.some((r) => r.prerender);
 			const serverInput = { index: VIRTUAL.entryServer };
 			if (hasAnyPrerender) serverInput.prerender = VIRTUAL.entryPrerender;
+			const escapedPagesDir = escapeRegex(pagesDir);
+			const pagesDirRegex = new RegExp(String.raw`[\\/]${escapedPagesDir}[\\/]([^\\/]+)[\\/]`);
+			const pagesDirTest = new RegExp(String.raw`[\\/]${escapedPagesDir}[\\/]`);
 			return {
 				appType: "custom",
 				ssr: { noExternal: [/^vike-lite(?:$|-)/] },
@@ -182,15 +220,15 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 									},
 									{
 										name(moduleId) {
-											const match = moduleId.match(new RegExp(String.raw`[\\/]${pagesDir}[\\/]([^\\/]+)[\\/]`));
+											const match = moduleId.match(pagesDirRegex);
 											return match ? `page-${match[1]}` : "shared";
 										},
-										test: new RegExp(String.raw`[\\/]${pagesDir}[\\/]`),
+										test: pagesDirTest,
 										priority: 10
 									},
 									{
 										name(moduleId) {
-											const match = moduleId.match(new RegExp(String.raw`[\\/]${pagesDir}[\\/]([^\\/]+)[\\/]`));
+											const match = moduleId.match(pagesDirRegex);
 											return match ? `css-${match[1]}` : "css-shared";
 										},
 										test: /\.css$/,
@@ -294,6 +332,32 @@ function vikeLite({ pagesDir = "pages", apiPrefix = "/api", prerender = false, s
 			}
 			if (id === RESOLVED.entryPrerender) return importSetup + `export{routes}from'${VIRTUAL.routes}';export{renderPage}from'vike-lite/server';`;
 		},
+		generateBundle(_options, bundle) {
+			if (!printDependencies || !projectDependencies) return;
+			const envName = this.environment.name;
+			if (envName !== "client" && envName !== "ssr") return;
+			const usedPackages = /* @__PURE__ */ new Set();
+			for (const file of Object.values(bundle)) {
+				if (file.type !== "chunk") continue;
+				for (const moduleId of file.moduleIds) {
+					const pkgName = extractPackageNameFromPath(moduleId);
+					if (pkgName && projectDependencies[pkgName] !== void 0) usedPackages.add(pkgName);
+				}
+				for (const imp of file.imports) {
+					const pkgName = extractPackageNameFromImport(imp);
+					if (pkgName && projectDependencies[pkgName] !== void 0) usedPackages.add(pkgName);
+				}
+				for (const imp of file.dynamicImports) {
+					const pkgName = extractPackageNameFromImport(imp);
+					if (pkgName && projectDependencies[pkgName] !== void 0) usedPackages.add(pkgName);
+				}
+			}
+			const label = envName === "client" ? "Client" : "Server";
+			const sorted = [...usedPackages].sort();
+			console.log(`📦 [${label} bundle] package.json dependencies used (${sorted.length}):`);
+			if (sorted.length === 0) console.log(`   (None)`);
+			else for (const dep of sorted) console.log(`   - ${dep}@${projectDependencies[dep]}`);
+		},
 		closeBundle: {
 			order: "pre",
 			async handler() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vike-lite",
-  "version": "1.16.1",
+  "version": "1.17.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -82,7 +82,7 @@
   },
   "devDependencies": {
     "@types/node": "^26.1.1",
-    "tsdown": "^0.22.13",
+    "tsdown": "^0.22.14",
     "vite": "^8.1.5",
     "vitest": "^4.1.10"
   },