@b9g/libuild 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 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
+- **Support bin-only packages** - Packages with only bin/ executables and no src/ library code no longer crash. Main/module/types fields and "." export are now correctly omitted for bin-only packages, while bin exports are properly generated.
+
 ## [0.1.14] - 2025-01-14
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b9g/libuild",
-  "version": "0.1.14",
+  "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;
         }
       }
     }
@@ -215505,10 +215509,12 @@ async function generateExports(entries, mainEntry, options, existingExports = {}
       exports2[key] = expandExistingExport(value);
     }
   }
-  if (!exports2["."]) {
-    exports2["."] = await createExportEntry(mainEntry);
-  } else {
-    exports2["."] = expandExistingExport(exports2["."], mainEntry);
+  if (mainEntry) {
+    if (!exports2["."]) {
+      exports2["."] = await createExportEntry(mainEntry);
+    } else {
+      exports2["."] = expandExistingExport(exports2["."], mainEntry);
+    }
   }
   for (const entry of entries) {
     if (entry === "umd")
@@ -215883,15 +215889,17 @@ async function cleanPackageJSON(pkg, mainEntry, options, cwd, distDir) {
   if (!cleaned.type) {
     cleaned.type = "module";
   }
-  if (options.formats.cjs) {
-    cleaned.main = `src/${mainEntry}.cjs`;
-  }
-  cleaned.module = `src/${mainEntry}.js`;
-  if (distDir) {
-    const dtsPath = Path3.join(distDir, "src", `${mainEntry}.d.ts`);
-    const exists = await fileExists(dtsPath);
-    if (exists) {
-      cleaned.types = `src/${mainEntry}.d.ts`;
+  if (mainEntry) {
+    if (options.formats.cjs) {
+      cleaned.main = `src/${mainEntry}.cjs`;
+    }
+    cleaned.module = `src/${mainEntry}.js`;
+    if (distDir) {
+      const dtsPath = Path3.join(distDir, "src", `${mainEntry}.d.ts`);
+      const exists = await fileExists(dtsPath);
+      if (exists) {
+        cleaned.types = `src/${mainEntry}.d.ts`;
+      }
     }
   }
   return cleaned;
@@ -215946,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,
@@ -216056,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,
@@ -216082,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;
         }
       }
     }
@@ -492,10 +496,12 @@ async function generateExports(entries, mainEntry, options, existingExports = {}
       exports[key] = expandExistingExport(value);
     }
   }
-  if (!exports["."]) {
-    exports["."] = await createExportEntry(mainEntry);
-  } else {
-    exports["."] = expandExistingExport(exports["."], mainEntry);
+  if (mainEntry) {
+    if (!exports["."]) {
+      exports["."] = await createExportEntry(mainEntry);
+    } else {
+      exports["."] = expandExistingExport(exports["."], mainEntry);
+    }
   }
   for (const entry of entries) {
     if (entry === "umd")
@@ -870,15 +876,17 @@ async function cleanPackageJSON(pkg, mainEntry, options, cwd, distDir) {
   if (!cleaned.type) {
     cleaned.type = "module";
   }
-  if (options.formats.cjs) {
-    cleaned.main = `src/${mainEntry}.cjs`;
-  }
-  cleaned.module = `src/${mainEntry}.js`;
-  if (distDir) {
-    const dtsPath = Path3.join(distDir, "src", `${mainEntry}.d.ts`);
-    const exists = await fileExists(dtsPath);
-    if (exists) {
-      cleaned.types = `src/${mainEntry}.d.ts`;
+  if (mainEntry) {
+    if (options.formats.cjs) {
+      cleaned.main = `src/${mainEntry}.cjs`;
+    }
+    cleaned.module = `src/${mainEntry}.js`;
+    if (distDir) {
+      const dtsPath = Path3.join(distDir, "src", `${mainEntry}.d.ts`);
+      const exists = await fileExists(dtsPath);
+      if (exists) {
+        cleaned.types = `src/${mainEntry}.d.ts`;
+      }
     }
   }
   return cleaned;
@@ -933,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,
@@ -1043,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,
@@ -1069,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) {