@b9g/libuild 0.1.16 → 0.1.17

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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

package/package.json

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

package/src/libuild.cjs

@@ -215411,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);
@@ -215432,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`;
       }
@@ -216240,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

@@ -398,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);
@@ -419,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`;
       }
@@ -1227,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) {