@b9g/libuild 0.1.20 → 0.1.22

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.22] - 2025-12-22
+
+### Fixed
+- **Bin imports from src polluting source tree** - Fixed .d.ts files being emitted to source directories when bin entries import from `../src/`. This caused lint failures and polluted the src/ folder. Fixes [#2](https://github.com/bikeshaving/libuild/issues/2).
+
+## [0.1.21] - 2025-12-22
+
+### Fixed
+- **Internal module .d.ts generation** - Fixed issue where .d.ts files were not generated for internal modules (e.g., `src/impl/utils.ts`), causing broken import paths in published packages. TypeScript now follows imports to generate declarations for all modules, not just entry points.
+- **Module augmentation in .d.ts** - Fixed `declare module` blocks (module augmentation) not appearing in published type definitions. This resolves [#1](https://github.com/bikeshaving/libuild/issues/1).
+- **Symlink path consistency** - Fixed path mismatches on macOS where `/tmp` symlinks to `/private/tmp`, which could cause .d.ts files to be emitted to wrong locations.
+
+### Changed
+- **Chunk files location** - ESM code splitting chunks are now placed in `dist/src/_chunks/` instead of the dist root, keeping the package structure cleaner.
+
 ## [0.1.20] - 2025-12-08
 
 ### Fixed

package/README.md

@@ -44,7 +44,9 @@ libuild publish
 - **Structure-preserving**: `src/index.ts` → `dist/src/index.js` (maintains src/ directory)
 - **ESM**: `.js` files with ES module syntax
 - **CommonJS**: `.cjs` files for Node.js compatibility
-- **TypeScript**: `.d.ts` declaration files (when TypeScript is available)
+- **TypeScript**: `.d.ts` declaration files for all modules (when TypeScript is available)
+- **Module augmentation**: `declare module` blocks are preserved in .d.ts output
+- **Code splitting**: Dynamic imports create chunks in `dist/src/_chunks/`
 - **Clean package.json**: Optimized for consumers (no dev scripts)
 
 ### Format Control

package/package.json

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

package/src/libuild.cjs

@@ -9561,11 +9561,11 @@ ${lanes.join("\n")}
           return toComponents;
         }
         const components = toComponents.slice(start);
-        const relative = [];
+        const relative2 = [];
         for (; start < fromComponents.length; start++) {
-          relative.push("..");
+          relative2.push("..");
         }
-        return ["", ...relative, ...components];
+        return ["", ...relative2, ...components];
       }
       function getRelativePathFromDirectory(fromDirectory, to, getCanonicalFileNameOrIgnoreCase) {
         Debug.assert(getRootLength(fromDirectory) > 0 === getRootLength(to) > 0, "Paths must either both be absolute or both be relative");
@@ -48268,11 +48268,11 @@ ${lanes.join("\n")}
             if (i < rootLength) {
               return void 0;
             }
-            const sep2 = directory.lastIndexOf(directorySeparator, i - 1);
-            if (sep2 === -1) {
+            const sep3 = directory.lastIndexOf(directorySeparator, i - 1);
+            if (sep3 === -1) {
               return void 0;
             }
-            return directory.substr(0, Math.max(sep2, rootLength));
+            return directory.substr(0, Math.max(sep3, rootLength));
           }
         }
       }
@@ -54210,9 +54210,9 @@ ${lanes.join("\n")}
               if (!startsWithDirectory(target, realPathDirectory, getCanonicalFileName)) {
                 return;
               }
-              const relative = getRelativePathFromDirectory(realPathDirectory, target, getCanonicalFileName);
+              const relative2 = getRelativePathFromDirectory(realPathDirectory, target, getCanonicalFileName);
               for (const symlinkDirectory of symlinkDirectories) {
-                const option = resolvePath(symlinkDirectory, relative);
+                const option = resolvePath(symlinkDirectory, relative2);
                 const result2 = cb(option, target === referenceRedirect);
                 shouldFilterIgnoredPaths = true;
                 if (result2)
@@ -124419,7 +124419,7 @@ ${lanes.join("\n")}
           }
         }
         function createImportCallExpressionAMD(arg, containsLexicalThis) {
-          const resolve3 = factory2.createUniqueName("resolve");
+          const resolve2 = factory2.createUniqueName("resolve");
           const reject = factory2.createUniqueName("reject");
           const parameters = [
             factory2.createParameterDeclaration(
@@ -124428,7 +124428,7 @@ ${lanes.join("\n")}
               /*dotDotDotToken*/
               void 0,
               /*name*/
-              resolve3
+              resolve2
             ),
             factory2.createParameterDeclaration(
               /*modifiers*/
@@ -124445,7 +124445,7 @@ ${lanes.join("\n")}
                 factory2.createIdentifier("require"),
                 /*typeArguments*/
                 void 0,
-                [factory2.createArrayLiteralExpression([arg || factory2.createOmittedExpression()]), resolve3, reject]
+                [factory2.createArrayLiteralExpression([arg || factory2.createOmittedExpression()]), resolve2, reject]
               )
             )
           ]);
@@ -212324,8 +212324,8 @@ Additional information: BADCLIENT: Bad error code, ${badCode} not found in range
         installPackage(options) {
           this.packageInstallId++;
           const request = { kind: "installPackage", ...options, id: this.packageInstallId };
-          const promise = new Promise((resolve3, reject) => {
-            (this.packageInstalledPromise ?? (this.packageInstalledPromise = /* @__PURE__ */ new Map())).set(this.packageInstallId, { resolve: resolve3, reject });
+          const promise = new Promise((resolve2, reject) => {
+            (this.packageInstalledPromise ?? (this.packageInstalledPromise = /* @__PURE__ */ new Map())).set(this.packageInstallId, { resolve: resolve2, reject });
           });
           this.installer.send(request);
           return promise;
@@ -212725,42 +212725,35 @@ function dtsPlugin(options) {
         } catch (error) {
           return;
         }
-        const tsFiles = entryFiles.filter((file) => {
-          if (!file.endsWith(".ts"))
-            return false;
-          return options.entryPoints.some((entryPoint) => {
-            try {
-              const fs = require("fs");
-              const normalizedEntry = fs.realpathSync(Path2.resolve(entryPoint));
-              const normalizedFile = fs.realpathSync(Path2.resolve(file));
-              return normalizedEntry === normalizedFile;
-            } catch {
-              const normalizedEntry = Path2.resolve(entryPoint);
-              const normalizedFile = Path2.resolve(file);
-              return normalizedEntry === normalizedFile;
-            }
-          });
-        });
+        await FS2.mkdir(options.outDir, { recursive: true });
+        const fs = await import("fs");
+        const resolvedRootDir = fs.realpathSync(options.rootDir);
+        const resolvedOutDir = fs.realpathSync(options.outDir);
+        const tsFiles = entryFiles.filter((file) => file.endsWith(".ts") && !file.endsWith(".d.ts")).map((f) => fs.realpathSync(f)).filter((f) => f.startsWith(resolvedRootDir + Path2.sep));
         if (tsFiles.length === 0) {
           return;
         }
+        const resolvedTsFiles = tsFiles;
         try {
-          await FS2.mkdir(options.outDir, { recursive: true });
           const compilerOptions = {
             declaration: true,
             emitDeclarationOnly: true,
-            outDir: options.outDir,
+            outDir: resolvedOutDir,
+            rootDir: resolvedRootDir,
             skipLibCheck: true,
             esModuleInterop: true,
             target: TS.ScriptTarget.ES2020,
             module: TS.ModuleKind.ESNext,
-            isolatedModules: true,
-            // Prevent cross-file type dependencies
-            noResolve: true
-            // Don't resolve imports - only process the specific files
+            moduleResolution: TS.ModuleResolutionKind.Bundler
           };
-          const program = TS.createProgram(tsFiles, compilerOptions);
-          const emitResult = program.emit();
+          const program = TS.createProgram(resolvedTsFiles, compilerOptions);
+          const writeFile4 = (fileName, data, writeByteOrderMark, onError, sourceFiles) => {
+            if (!fileName.startsWith(resolvedOutDir + Path2.sep)) {
+              return;
+            }
+            TS.sys.writeFile(fileName, data, writeByteOrderMark);
+          };
+          const emitResult = program.emit(void 0, writeFile4);
           if (emitResult.diagnostics.length > 0) {
             const diagnostics = TS.formatDiagnosticsWithColorAndContext(emitResult.diagnostics, {
               getCanonicalFileName: (path) => path,
@@ -212787,17 +212780,20 @@ ${diagnostics}`,
             detail: void 0
           });
         }
-        await addTripleSlashReferences(tsFiles, options.outDir);
-        await addAmbientReferences(tsFiles, options.outDir, options.rootDir);
+        await addTripleSlashReferences(resolvedTsFiles, resolvedOutDir, resolvedRootDir);
+        await addAmbientReferences(resolvedTsFiles, resolvedOutDir, resolvedRootDir);
       });
     }
   };
 }
-async function addTripleSlashReferences(tsFiles, outDir) {
+async function addTripleSlashReferences(tsFiles, outDir, rootDir) {
   for (const tsFile of tsFiles) {
+    const relativePath = Path2.relative(rootDir, tsFile);
+    const relativeDir = Path2.dirname(relativePath);
     const baseName = Path2.basename(tsFile, Path2.extname(tsFile));
-    const jsPath = Path2.join(outDir, `${baseName}.js`);
-    const dtsPath = Path2.join(outDir, `${baseName}.d.ts`);
+    const outputSubDir = relativeDir === "." ? outDir : Path2.join(outDir, relativeDir);
+    const jsPath = Path2.join(outputSubDir, `${baseName}.js`);
+    const dtsPath = Path2.join(outputSubDir, `${baseName}.d.ts`);
     const [jsExists, dtsExists] = await Promise.all([
       FS2.access(jsPath).then(() => true).catch(() => false),
       FS2.access(dtsPath).then(() => true).catch(() => false)
@@ -212834,13 +212830,17 @@ async function addAmbientReferences(tsFiles, outDir, rootDir) {
   if (ambientFiles.length === 0)
     return;
   for (const tsFile of tsFiles) {
+    const relativePath = Path2.relative(rootDir, tsFile);
+    const relativeDir = Path2.dirname(relativePath);
     const baseName = Path2.basename(tsFile, Path2.extname(tsFile));
-    const dtsPath = Path2.join(outDir, `${baseName}.d.ts`);
+    const outputSubDir = relativeDir === "." ? outDir : Path2.join(outDir, relativeDir);
+    const dtsPath = Path2.join(outputSubDir, `${baseName}.d.ts`);
     const dtsExists = await FS2.access(dtsPath).then(() => true).catch(() => false);
     if (!dtsExists)
       continue;
     const content = await FS2.readFile(dtsPath, "utf-8");
-    const references = ambientFiles.map((ambientFile) => `/// <reference path="./${ambientFile}" />`).join("\n");
+    const relativeToRoot = relativeDir === "." ? "./" : "../".repeat(relativeDir.split(Path2.sep).length);
+    const references = ambientFiles.map((ambientFile) => `/// <reference path="${relativeToRoot}${ambientFile}" />`).join("\n");
     const modifiedContent = `${references}
 ${content}`;
     await FS2.writeFile(dtsPath, modifiedContent);
@@ -213700,6 +213700,8 @@ async function build2(cwd, save = false) {
         outdir: distDir,
         outbase: cwd,
         // Preserve src/ and bin/ directory structure
+        chunkNames: "src/_chunks/[name]-[hash]",
+        // Put chunks in a subdirectory
         format: "esm",
         outExtension: { ".js": ".js" },
         bundle: true,
@@ -213732,17 +213734,19 @@ 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(`
+        const chunksDir = Path3.join(distSrcDir, "_chunks");
+        const chunksExist = await FS3.stat(chunksDir).then(() => true, () => false);
+        if (chunksExist) {
+          const chunkFiles = await FS3.readdir(chunksDir);
+          const jsChunks = chunkFiles.filter((f) => f.endsWith(".js"));
+          if (jsChunks.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
+            console.info(`   ESM build: ${jsChunks.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) {
@@ -214081,8 +214085,8 @@ async function publish(cwd, save = true, extraArgs = []) {
     cwd: distDir,
     stdio: "inherit"
   });
-  const exitCode = await new Promise((resolve3) => {
-    proc.on("close", resolve3);
+  const exitCode = await new Promise((resolve2) => {
+    proc.on("close", resolve2);
   });
   if (exitCode === 0) {
     const distPkg2 = JSON.parse(await FS3.readFile(distPkgPath, "utf-8"));

package/src/libuild.js

@@ -1,12 +1,4 @@
 /// <reference types="./libuild.d.ts" />
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined")
-    return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-
 // src/libuild.ts
 import * as FS3 from "fs/promises";
 import * as Path3 from "path";
@@ -118,42 +110,35 @@ function dtsPlugin(options) {
         } catch (error) {
           return;
         }
-        const tsFiles = entryFiles.filter((file) => {
-          if (!file.endsWith(".ts"))
-            return false;
-          return options.entryPoints.some((entryPoint) => {
-            try {
-              const fs = __require("fs");
-              const normalizedEntry = fs.realpathSync(Path2.resolve(entryPoint));
-              const normalizedFile = fs.realpathSync(Path2.resolve(file));
-              return normalizedEntry === normalizedFile;
-            } catch {
-              const normalizedEntry = Path2.resolve(entryPoint);
-              const normalizedFile = Path2.resolve(file);
-              return normalizedEntry === normalizedFile;
-            }
-          });
-        });
+        await FS2.mkdir(options.outDir, { recursive: true });
+        const fs = await import("fs");
+        const resolvedRootDir = fs.realpathSync(options.rootDir);
+        const resolvedOutDir = fs.realpathSync(options.outDir);
+        const tsFiles = entryFiles.filter((file) => file.endsWith(".ts") && !file.endsWith(".d.ts")).map((f) => fs.realpathSync(f)).filter((f) => f.startsWith(resolvedRootDir + Path2.sep));
         if (tsFiles.length === 0) {
           return;
         }
+        const resolvedTsFiles = tsFiles;
         try {
-          await FS2.mkdir(options.outDir, { recursive: true });
           const compilerOptions = {
             declaration: true,
             emitDeclarationOnly: true,
-            outDir: options.outDir,
+            outDir: resolvedOutDir,
+            rootDir: resolvedRootDir,
             skipLibCheck: true,
             esModuleInterop: true,
             target: TS.ScriptTarget.ES2020,
             module: TS.ModuleKind.ESNext,
-            isolatedModules: true,
-            // Prevent cross-file type dependencies
-            noResolve: true
-            // Don't resolve imports - only process the specific files
+            moduleResolution: TS.ModuleResolutionKind.Bundler
           };
-          const program = TS.createProgram(tsFiles, compilerOptions);
-          const emitResult = program.emit();
+          const program = TS.createProgram(resolvedTsFiles, compilerOptions);
+          const writeFile4 = (fileName, data, writeByteOrderMark, onError, sourceFiles) => {
+            if (!fileName.startsWith(resolvedOutDir + Path2.sep)) {
+              return;
+            }
+            TS.sys.writeFile(fileName, data, writeByteOrderMark);
+          };
+          const emitResult = program.emit(void 0, writeFile4);
           if (emitResult.diagnostics.length > 0) {
             const diagnostics = TS.formatDiagnosticsWithColorAndContext(emitResult.diagnostics, {
               getCanonicalFileName: (path) => path,
@@ -180,17 +165,20 @@ ${diagnostics}`,
             detail: void 0
           });
         }
-        await addTripleSlashReferences(tsFiles, options.outDir);
-        await addAmbientReferences(tsFiles, options.outDir, options.rootDir);
+        await addTripleSlashReferences(resolvedTsFiles, resolvedOutDir, resolvedRootDir);
+        await addAmbientReferences(resolvedTsFiles, resolvedOutDir, resolvedRootDir);
       });
     }
   };
 }
-async function addTripleSlashReferences(tsFiles, outDir) {
+async function addTripleSlashReferences(tsFiles, outDir, rootDir) {
   for (const tsFile of tsFiles) {
+    const relativePath = Path2.relative(rootDir, tsFile);
+    const relativeDir = Path2.dirname(relativePath);
     const baseName = Path2.basename(tsFile, Path2.extname(tsFile));
-    const jsPath = Path2.join(outDir, `${baseName}.js`);
-    const dtsPath = Path2.join(outDir, `${baseName}.d.ts`);
+    const outputSubDir = relativeDir === "." ? outDir : Path2.join(outDir, relativeDir);
+    const jsPath = Path2.join(outputSubDir, `${baseName}.js`);
+    const dtsPath = Path2.join(outputSubDir, `${baseName}.d.ts`);
     const [jsExists, dtsExists] = await Promise.all([
       FS2.access(jsPath).then(() => true).catch(() => false),
       FS2.access(dtsPath).then(() => true).catch(() => false)
@@ -227,13 +215,17 @@ async function addAmbientReferences(tsFiles, outDir, rootDir) {
   if (ambientFiles.length === 0)
     return;
   for (const tsFile of tsFiles) {
+    const relativePath = Path2.relative(rootDir, tsFile);
+    const relativeDir = Path2.dirname(relativePath);
     const baseName = Path2.basename(tsFile, Path2.extname(tsFile));
-    const dtsPath = Path2.join(outDir, `${baseName}.d.ts`);
+    const outputSubDir = relativeDir === "." ? outDir : Path2.join(outDir, relativeDir);
+    const dtsPath = Path2.join(outputSubDir, `${baseName}.d.ts`);
     const dtsExists = await FS2.access(dtsPath).then(() => true).catch(() => false);
     if (!dtsExists)
       continue;
     const content = await FS2.readFile(dtsPath, "utf-8");
-    const references = ambientFiles.map((ambientFile) => `/// <reference path="./${ambientFile}" />`).join("\n");
+    const relativeToRoot = relativeDir === "." ? "./" : "../".repeat(relativeDir.split(Path2.sep).length);
+    const references = ambientFiles.map((ambientFile) => `/// <reference path="${relativeToRoot}${ambientFile}" />`).join("\n");
     const modifiedContent = `${references}
 ${content}`;
     await FS2.writeFile(dtsPath, modifiedContent);
@@ -1093,6 +1085,8 @@ async function build2(cwd, save = false) {
         outdir: distDir,
         outbase: cwd,
         // Preserve src/ and bin/ directory structure
+        chunkNames: "src/_chunks/[name]-[hash]",
+        // Put chunks in a subdirectory
         format: "esm",
         outExtension: { ".js": ".js" },
         bundle: true,
@@ -1125,17 +1119,19 @@ 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(`
+        const chunksDir = Path3.join(distSrcDir, "_chunks");
+        const chunksExist = await FS3.stat(chunksDir).then(() => true, () => false);
+        if (chunksExist) {
+          const chunkFiles = await FS3.readdir(chunksDir);
+          const jsChunks = chunkFiles.filter((f) => f.endsWith(".js"));
+          if (jsChunks.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
+            console.info(`   ESM build: ${jsChunks.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) {
@@ -1474,8 +1470,8 @@ async function publish(cwd, save = true, extraArgs = []) {
     cwd: distDir,
     stdio: "inherit"
   });
-  const exitCode = await new Promise((resolve3) => {
-    proc.on("close", resolve3);
+  const exitCode = await new Promise((resolve2) => {
+    proc.on("close", resolve2);
   });
   if (exitCode === 0) {
     const distPkg2 = JSON.parse(await FS3.readFile(distPkgPath, "utf-8"));

package/src/plugins/dts.d.ts

@@ -0,0 +1,8 @@
+import * as ESBuild from "esbuild";
+export interface TypeScriptPluginOptions {
+    tsConfigPath?: string;
+    outDir: string;
+    rootDir: string;
+    entryPoints: string[];
+}
+export declare function dtsPlugin(options: TypeScriptPluginOptions): ESBuild.Plugin;

package/src/plugins/external.d.ts

@@ -0,0 +1,7 @@
+import * as ESBuild from "esbuild";
+export interface ExternalEntrypointsOptions {
+    entryNames: string[];
+    currentEntry?: string;
+    outputExtension: string;
+}
+export declare function externalEntrypointsPlugin(options: ExternalEntrypointsOptions): ESBuild.Plugin;

package/src/plugins/umd.d.ts

@@ -0,0 +1,8 @@
+interface UMDPluginOptions {
+    globalName: string;
+}
+export declare function umdPlugin(options: UMDPluginOptions): {
+    name: string;
+    setup(build: any): void;
+};
+export {};