@b9g/libuild 0.1.15 → 0.1.16

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.16] - 2025-01-14
+
+### Added
+- **Code splitting for dynamic imports** - ESM builds now use ESBuild's `splitting: true` to create separate chunk files for dynamically imported modules, enabling lazy loading and reducing initial bundle size
+- **Smart entry point detection** - Packages with only "." or bin exports build only index.ts as entry point, allowing subdirectory files to be chunked when dynamically imported
+- **Code splitting warning** - Warns when dual-format builds have chunks, informing users that CommonJS builds cannot benefit from code splitting (CJS bundles dynamic imports inline)
+
+### Fixed
+- **Export validation** - Invalid export paths that don't point to src/ files are now properly validated and rejected with clear error messages
+
 ## [0.1.15] - 2025-01-14
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b9g/libuild",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Zero-config library builds",
   "keywords": [
     "build",

package/src/libuild.cjs

@@ -215370,6 +215370,8 @@ function checkIfExportIsStale(exportKey, exportValue, entries) {
         } else {
           entryName = match[1];
         }
+      } else if (exportValue.startsWith("./") && !exportValue.includes("package.json")) {
+        hasInvalidPath = true;
       }
     }
   } else if (typeof exportValue === "object" && exportValue !== null) {
@@ -215386,6 +215388,8 @@ function checkIfExportIsStale(exportKey, exportValue, entries) {
           } else {
             entryName = match[1];
           }
+        } else if (importPath.startsWith("./") && !importPath.includes("package.json")) {
+          hasInvalidPath = true;
         }
       }
     }
@@ -215950,8 +215954,37 @@ async function build2(cwd, save = false) {
     }
   }
   const binDir = Path3.join(cwd, "bin");
-  const srcEntries = await findEntrypoints(srcDir);
+  const allSrcFiles = await findEntrypoints(srcDir);
   const binEntries = await findBinEntrypoints(binDir);
+  let srcEntries;
+  if (pkg.exports && typeof pkg.exports === "object") {
+    const srcExportKeys = Object.keys(pkg.exports).filter((key) => {
+      if (key === "." || key === "./package.json")
+        return false;
+      const val = pkg.exports[key];
+      if (typeof val === "string")
+        return val.includes("/src/");
+      if (typeof val === "object" && val !== null) {
+        return Object.values(val).some((v) => typeof v === "string" && v.includes("/src/"));
+      }
+      return false;
+    });
+    const dotExport = pkg.exports["."];
+    let hasCustomMain = false;
+    if (dotExport) {
+      const importPath = typeof dotExport === "string" ? dotExport : dotExport.import || dotExport.default;
+      if (importPath && !importPath.includes("/index.")) {
+        hasCustomMain = true;
+      }
+    }
+    if (srcExportKeys.length > 0 || hasCustomMain) {
+      srcEntries = allSrcFiles;
+    } else {
+      srcEntries = allSrcFiles.includes("index") ? ["index"] : allSrcFiles;
+    }
+  } else {
+    srcEntries = allSrcFiles;
+  }
   const allBinEntries = binEntries.map((entry) => ({ name: entry, source: "top-level" }));
   const entries = [
     ...srcEntries,
@@ -216060,6 +216093,8 @@ async function build2(cwd, save = false) {
         format: "esm",
         outExtension: { ".js": ".js" },
         bundle: true,
+        splitting: true,
+        // Enable code splitting for dynamic imports
         minify: false,
         sourcemap: false,
         external: externalDeps,
@@ -216086,6 +216121,20 @@ async function build2(cwd, save = false) {
           })] : []
         ]
       });
+      if (options.formats.cjs) {
+        const distFiles = await FS3.readdir(distDir);
+        const chunkFiles = distFiles.filter(
+          (f) => f.endsWith(".js") && !f.endsWith(".d.ts") && (f.startsWith("chunk-") || f.includes("-") && !f.startsWith("package"))
+        );
+        if (chunkFiles.length > 0) {
+          console.info(`
+\u26A0\uFE0F  Code splitting detected - CommonJS build will bundle dynamic imports inline`);
+          console.info(`   ESM build: ${chunkFiles.length} chunk file(s) created for lazy loading`);
+          console.info(`   CJS build: Dynamic imports bundled inline (no chunks)`);
+          console.info(`   To get code splitting benefits, use ESM imports or remove "main" field
+`);
+        }
+      }
       if (binEntryPoints.length > 0) {
         const runtimeBanner = generateRuntimeBanner(pkg);
         for (const binEntryName of binEntryNames) {

package/src/libuild.js

@@ -357,6 +357,8 @@ function checkIfExportIsStale(exportKey, exportValue, entries) {
         } else {
           entryName = match[1];
         }
+      } else if (exportValue.startsWith("./") && !exportValue.includes("package.json")) {
+        hasInvalidPath = true;
       }
     }
   } else if (typeof exportValue === "object" && exportValue !== null) {
@@ -373,6 +375,8 @@ function checkIfExportIsStale(exportKey, exportValue, entries) {
           } else {
             entryName = match[1];
           }
+        } else if (importPath.startsWith("./") && !importPath.includes("package.json")) {
+          hasInvalidPath = true;
         }
       }
     }
@@ -937,8 +941,37 @@ async function build2(cwd, save = false) {
     }
   }
   const binDir = Path3.join(cwd, "bin");
-  const srcEntries = await findEntrypoints(srcDir);
+  const allSrcFiles = await findEntrypoints(srcDir);
   const binEntries = await findBinEntrypoints(binDir);
+  let srcEntries;
+  if (pkg.exports && typeof pkg.exports === "object") {
+    const srcExportKeys = Object.keys(pkg.exports).filter((key) => {
+      if (key === "." || key === "./package.json")
+        return false;
+      const val = pkg.exports[key];
+      if (typeof val === "string")
+        return val.includes("/src/");
+      if (typeof val === "object" && val !== null) {
+        return Object.values(val).some((v) => typeof v === "string" && v.includes("/src/"));
+      }
+      return false;
+    });
+    const dotExport = pkg.exports["."];
+    let hasCustomMain = false;
+    if (dotExport) {
+      const importPath = typeof dotExport === "string" ? dotExport : dotExport.import || dotExport.default;
+      if (importPath && !importPath.includes("/index.")) {
+        hasCustomMain = true;
+      }
+    }
+    if (srcExportKeys.length > 0 || hasCustomMain) {
+      srcEntries = allSrcFiles;
+    } else {
+      srcEntries = allSrcFiles.includes("index") ? ["index"] : allSrcFiles;
+    }
+  } else {
+    srcEntries = allSrcFiles;
+  }
   const allBinEntries = binEntries.map((entry) => ({ name: entry, source: "top-level" }));
   const entries = [
     ...srcEntries,
@@ -1047,6 +1080,8 @@ async function build2(cwd, save = false) {
         format: "esm",
         outExtension: { ".js": ".js" },
         bundle: true,
+        splitting: true,
+        // Enable code splitting for dynamic imports
         minify: false,
         sourcemap: false,
         external: externalDeps,
@@ -1073,6 +1108,20 @@ async function build2(cwd, save = false) {
           })] : []
         ]
       });
+      if (options.formats.cjs) {
+        const distFiles = await FS3.readdir(distDir);
+        const chunkFiles = distFiles.filter(
+          (f) => f.endsWith(".js") && !f.endsWith(".d.ts") && (f.startsWith("chunk-") || f.includes("-") && !f.startsWith("package"))
+        );
+        if (chunkFiles.length > 0) {
+          console.info(`
+\u26A0\uFE0F  Code splitting detected - CommonJS build will bundle dynamic imports inline`);
+          console.info(`   ESM build: ${chunkFiles.length} chunk file(s) created for lazy loading`);
+          console.info(`   CJS build: Dynamic imports bundled inline (no chunks)`);
+          console.info(`   To get code splitting benefits, use ESM imports or remove "main" field
+`);
+        }
+      }
       if (binEntryPoints.length > 0) {
         const runtimeBanner = generateRuntimeBanner(pkg);
         for (const binEntryName of binEntryNames) {