@b9g/libuild 0.1.12 → 0.1.14

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.14] - 2025-01-14
+
+### Fixed
+- **Eliminate stderr noise from dual-purpose shebang** - Changed from `//bin/true` to standard polyglot pattern `':' //;` to prevent shell from attempting to execute non-existent path, eliminating "No such file or directory" errors while maintaining dual runtime detection
+
+## [0.1.13] - 2025-01-14
+
+### Fixed
+- **Dual runtime shebang for src/ executables** - src/ files referenced in package.json bin field now correctly receive dual runtime shebang support (previously only bin/ directory files were processed)
+- All executable files now have consistent dual runtime behavior regardless of directory location
+
+## [0.1.12] - 2025-01-14
+
+### Added
+- **Dual runtime support** for bin entries with intelligent bun/node detection based on package manager context
+- **Top-level await (TLA) support** with graceful CJS fallback - automatically disables CJS generation when TLA is detected
+- **bin/ directory support** for executable entrypoints alongside src/ entries
+- Respect `engines.bun` field for runtime preferences in dual runtime detection
+- Automatic shebang replacement with shell script wrapper for maximum compatibility
+
+### Changed
+- **Single-batch ESM build** - combined src/ and bin/ builds for better performance
+- **Smart externalization** - entry points are externalized, nested files are bundled to prevent code duplication
+- TypeScript declarations now conditional on tsc availability (no failures in environments without TypeScript)
+
+### Fixed
+- Fix TypeScript declaration generation for bin entries
+- Fix CLI argument parsing for directory paths with npm flags
+- Fix externalization to only apply to entry points, not nested utility files
+
 ## [0.1.11] - 2025-11-02
 
 ### Fixed

package/package.json

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

package/src/cli.js

@@ -1,4 +1,5 @@
-#!/usr/bin/env node
+#!/usr/bin/env sh
+':' //; exec "$({ [ "${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] || true; } && command -v bun || command -v node)" "$0" "$@"
 /// <reference types="./cli.d.ts" />
 
 // src/cli.ts

package/src/libuild.cjs

@@ -215233,9 +215233,9 @@ ${content}`;
 function generateRuntimeBanner(pkg) {
   const prefersBun = pkg.engines?.bun !== void 0;
   if (prefersBun) {
-    return '//bin/true; exec "$({ [ "${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] || true; } && command -v bun || command -v node)" "$0" "$@"';
+    return `':' //; exec "$({ [ "\${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] || true; } && command -v bun || command -v node)" "$0" "$@"`;
   } else {
-    return '//bin/true; exec "$([ "${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] && command -v bun || command -v node)" "$0" "$@"';
+    return `':' //; exec "$([ "\${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] && command -v bun || command -v node)" "$0" "$@"`;
   }
 }
 async function processJavaScriptExecutable(filePath, runtimeBanner) {
@@ -215716,23 +215716,35 @@ async function setExecutablePermissions(filePath) {
     console.warn(`\u26A0\uFE0F  WARNING: Could not set executable permissions for ${filePath}: ${error.message}`);
   }
 }
-async function makeFilesExecutable(pkg, cwd, allBinEntries) {
+async function makeFilesExecutable(pkg, cwd, allBinEntries, runtimeBanner) {
   const filesToMakeExecutable = [];
+  const filesToProcessForDualRuntime = [];
+  const distDir = Path3.join(cwd, "dist");
   if (pkg.bin) {
     if (typeof pkg.bin === "string") {
-      filesToMakeExecutable.push(Path3.join(cwd, pkg.bin));
+      const fullPath = Path3.join(distDir, pkg.bin);
+      filesToMakeExecutable.push(fullPath);
+      if (pkg.bin.endsWith(".js")) {
+        filesToProcessForDualRuntime.push(fullPath);
+      }
     } else if (typeof pkg.bin === "object") {
       for (const binPath of Object.values(pkg.bin)) {
         if (typeof binPath === "string") {
-          filesToMakeExecutable.push(Path3.join(cwd, binPath));
+          const fullPath = Path3.join(distDir, binPath);
+          filesToMakeExecutable.push(fullPath);
+          if (binPath.endsWith(".js")) {
+            filesToProcessForDualRuntime.push(fullPath);
+          }
         }
       }
     }
   }
+  const binDirFiles = /* @__PURE__ */ new Set();
   for (const binEntryInfo of allBinEntries) {
     const baseDir = binEntryInfo.source === "src" ? "dist/src/bin" : "dist/bin";
     const jsPath = Path3.join(cwd, baseDir, `${binEntryInfo.name}.js`);
     const cjsPath = Path3.join(cwd, baseDir, `${binEntryInfo.name}.cjs`);
+    binDirFiles.add(jsPath);
     if (!filesToMakeExecutable.includes(jsPath)) {
       filesToMakeExecutable.push(jsPath);
     }
@@ -215740,6 +215752,11 @@ async function makeFilesExecutable(pkg, cwd, allBinEntries) {
       filesToMakeExecutable.push(cjsPath);
     }
   }
+  for (const filePath of filesToProcessForDualRuntime) {
+    if (await fileExists(filePath) && !binDirFiles.has(filePath)) {
+      await processJavaScriptExecutable(filePath, runtimeBanner);
+    }
+  }
   for (const filePath of filesToMakeExecutable) {
     if (await fileExists(filePath)) {
       await setExecutablePermissions(filePath);
@@ -216354,8 +216371,9 @@ async function build2(cwd, save = false) {
   if (save) {
     rootPkg = JSON.parse(await FS3.readFile(pkgPath, "utf-8"));
   }
-  if (allBinEntries.length > 0 || pkg.bin) {
-    await makeFilesExecutable(pkg, cwd, allBinEntries);
+  if (allBinEntries.length > 0 || fixedDistPkg.bin) {
+    const runtimeBanner = generateRuntimeBanner(pkg);
+    await makeFilesExecutable(fixedDistPkg, cwd, allBinEntries, runtimeBanner);
   }
   return { distPkg: fixedDistPkg, rootPkg };
 }

package/src/libuild.js

@@ -220,9 +220,9 @@ ${content}`;
 function generateRuntimeBanner(pkg) {
   const prefersBun = pkg.engines?.bun !== void 0;
   if (prefersBun) {
-    return '//bin/true; exec "$({ [ "${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] || true; } && command -v bun || command -v node)" "$0" "$@"';
+    return `':' //; exec "$({ [ "\${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] || true; } && command -v bun || command -v node)" "$0" "$@"`;
   } else {
-    return '//bin/true; exec "$([ "${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] && command -v bun || command -v node)" "$0" "$@"';
+    return `':' //; exec "$([ "\${npm_config_user_agent#bun/}" != "$npm_config_user_agent" ] && command -v bun || command -v node)" "$0" "$@"`;
   }
 }
 async function processJavaScriptExecutable(filePath, runtimeBanner) {
@@ -703,23 +703,35 @@ async function setExecutablePermissions(filePath) {
     console.warn(`\u26A0\uFE0F  WARNING: Could not set executable permissions for ${filePath}: ${error.message}`);
   }
 }
-async function makeFilesExecutable(pkg, cwd, allBinEntries) {
+async function makeFilesExecutable(pkg, cwd, allBinEntries, runtimeBanner) {
   const filesToMakeExecutable = [];
+  const filesToProcessForDualRuntime = [];
+  const distDir = Path3.join(cwd, "dist");
   if (pkg.bin) {
     if (typeof pkg.bin === "string") {
-      filesToMakeExecutable.push(Path3.join(cwd, pkg.bin));
+      const fullPath = Path3.join(distDir, pkg.bin);
+      filesToMakeExecutable.push(fullPath);
+      if (pkg.bin.endsWith(".js")) {
+        filesToProcessForDualRuntime.push(fullPath);
+      }
     } else if (typeof pkg.bin === "object") {
       for (const binPath of Object.values(pkg.bin)) {
         if (typeof binPath === "string") {
-          filesToMakeExecutable.push(Path3.join(cwd, binPath));
+          const fullPath = Path3.join(distDir, binPath);
+          filesToMakeExecutable.push(fullPath);
+          if (binPath.endsWith(".js")) {
+            filesToProcessForDualRuntime.push(fullPath);
+          }
         }
       }
     }
   }
+  const binDirFiles = /* @__PURE__ */ new Set();
   for (const binEntryInfo of allBinEntries) {
     const baseDir = binEntryInfo.source === "src" ? "dist/src/bin" : "dist/bin";
     const jsPath = Path3.join(cwd, baseDir, `${binEntryInfo.name}.js`);
     const cjsPath = Path3.join(cwd, baseDir, `${binEntryInfo.name}.cjs`);
+    binDirFiles.add(jsPath);
     if (!filesToMakeExecutable.includes(jsPath)) {
       filesToMakeExecutable.push(jsPath);
     }
@@ -727,6 +739,11 @@ async function makeFilesExecutable(pkg, cwd, allBinEntries) {
       filesToMakeExecutable.push(cjsPath);
     }
   }
+  for (const filePath of filesToProcessForDualRuntime) {
+    if (await fileExists(filePath) && !binDirFiles.has(filePath)) {
+      await processJavaScriptExecutable(filePath, runtimeBanner);
+    }
+  }
   for (const filePath of filesToMakeExecutable) {
     if (await fileExists(filePath)) {
       await setExecutablePermissions(filePath);
@@ -1341,8 +1358,9 @@ async function build2(cwd, save = false) {
   if (save) {
     rootPkg = JSON.parse(await FS3.readFile(pkgPath, "utf-8"));
   }
-  if (allBinEntries.length > 0 || pkg.bin) {
-    await makeFilesExecutable(pkg, cwd, allBinEntries);
+  if (allBinEntries.length > 0 || fixedDistPkg.bin) {
+    const runtimeBanner = generateRuntimeBanner(pkg);
+    await makeFilesExecutable(fixedDistPkg, cwd, allBinEntries, runtimeBanner);
   }
   return { distPkg: fixedDistPkg, rootPkg };
 }