@b9g/libuild 0.1.15 → 0.1.17

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.17] - 2025-01-25
+
+### Added
+- **Ambient .d.ts file copying** - Hand-written ambient TypeScript declaration files (e.g., global.d.ts with `declare module` statements) are now automatically copied from src/ to dist/src/ during build. These files are automatically discovered by TypeScript when the package is consumed, providing global type declarations for module augmentation.
+
+### Fixed
+- **Non-deterministic export field ordering** - Fixed issue where package.json exports fields (types/import/require) would reorder non-deterministically across rebuilds with --save flag, causing unnecessary git diffs. All builds now consistently use types-first ordering.
+
+## [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.17",
   "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;
         }
       }
     }
@@ -215407,20 +215411,17 @@ async function generateExports(entries, mainEntry, options, existingExports = {}
   async function createExportEntry(entry) {
     if (entry.startsWith("bin/")) {
       const binEntry = entry.replace("bin/", "");
-      const exportEntry = {
-        import: `./bin/${binEntry}.js`
-      };
+      const exportEntry = {};
       if (distDir) {
         const dtsPath = Path3.join(distDir, "bin", `${binEntry}.d.ts`);
         if (await fileExists(dtsPath)) {
           exportEntry.types = `./bin/${binEntry}.d.ts`;
         }
       }
+      exportEntry.import = `./bin/${binEntry}.js`;
       return exportEntry;
     } else {
-      const exportEntry = {
-        import: `./src/${entry}.js`
-      };
+      const exportEntry = {};
       if (distDir) {
         const dtsPath = Path3.join(distDir, "src", `${entry}.d.ts`);
         const exists = await fileExists(dtsPath);
@@ -215428,6 +215429,7 @@ async function generateExports(entries, mainEntry, options, existingExports = {}
           exportEntry.types = `./src/${entry}.d.ts`;
         }
       }
+      exportEntry.import = `./src/${entry}.js`;
       if (options.formats.cjs) {
         exportEntry.require = `./src/${entry}.cjs`;
       }
@@ -215950,8 +215952,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 +216091,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 +216119,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) {
@@ -216191,6 +216238,18 @@ async function build2(cwd, save = false) {
       await FS3.copyFile(srcPath, Path3.join(distDir, file));
     }
   }
+  if (await fileExists(srcDir)) {
+    const srcFiles = await FS3.readdir(srcDir);
+    const ambientDtsFiles = srcFiles.filter((f) => f.endsWith(".d.ts"));
+    if (ambientDtsFiles.length > 0) {
+      console.info(`  Copying ${ambientDtsFiles.length} ambient .d.ts file(s)...`);
+      for (const dtsFile of ambientDtsFiles) {
+        const srcPath = Path3.join(srcDir, dtsFile);
+        const destPath = Path3.join(distSrcDir, dtsFile);
+        await FS3.copyFile(srcPath, destPath);
+      }
+    }
+  }
   const commonFiles = ["README.md", "LICENSE", "CHANGELOG.md", "COPYING", "AUTHORS"];
   if (pkg.files && Array.isArray(pkg.files)) {
     for (const commonFile of commonFiles) {

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;
         }
       }
     }
@@ -394,20 +398,17 @@ async function generateExports(entries, mainEntry, options, existingExports = {}
   async function createExportEntry(entry) {
     if (entry.startsWith("bin/")) {
       const binEntry = entry.replace("bin/", "");
-      const exportEntry = {
-        import: `./bin/${binEntry}.js`
-      };
+      const exportEntry = {};
       if (distDir) {
         const dtsPath = Path3.join(distDir, "bin", `${binEntry}.d.ts`);
         if (await fileExists(dtsPath)) {
           exportEntry.types = `./bin/${binEntry}.d.ts`;
         }
       }
+      exportEntry.import = `./bin/${binEntry}.js`;
       return exportEntry;
     } else {
-      const exportEntry = {
-        import: `./src/${entry}.js`
-      };
+      const exportEntry = {};
       if (distDir) {
         const dtsPath = Path3.join(distDir, "src", `${entry}.d.ts`);
         const exists = await fileExists(dtsPath);
@@ -415,6 +416,7 @@ async function generateExports(entries, mainEntry, options, existingExports = {}
           exportEntry.types = `./src/${entry}.d.ts`;
         }
       }
+      exportEntry.import = `./src/${entry}.js`;
       if (options.formats.cjs) {
         exportEntry.require = `./src/${entry}.cjs`;
       }
@@ -937,8 +939,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 +1078,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 +1106,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) {
@@ -1178,6 +1225,18 @@ async function build2(cwd, save = false) {
       await FS3.copyFile(srcPath, Path3.join(distDir, file));
     }
   }
+  if (await fileExists(srcDir)) {
+    const srcFiles = await FS3.readdir(srcDir);
+    const ambientDtsFiles = srcFiles.filter((f) => f.endsWith(".d.ts"));
+    if (ambientDtsFiles.length > 0) {
+      console.info(`  Copying ${ambientDtsFiles.length} ambient .d.ts file(s)...`);
+      for (const dtsFile of ambientDtsFiles) {
+        const srcPath = Path3.join(srcDir, dtsFile);
+        const destPath = Path3.join(distSrcDir, dtsFile);
+        await FS3.copyFile(srcPath, destPath);
+      }
+    }
+  }
   const commonFiles = ["README.md", "LICENSE", "CHANGELOG.md", "COPYING", "AUTHORS"];
   if (pkg.files && Array.isArray(pkg.files)) {
     for (const commonFile of commonFiles) {