added support for custom path for each target

Author: xettri

README.md

@@ -100,10 +100,12 @@ The following configuration options allow you to customize or override the defau
 - **`lib`** (`object`): Library configuration settings for both ESM and CJS builds:
   - **`esm`** (`object`): Settings for ESM (EcmaScript Module) format output.
     - **`output`** (`object`): Configures ESM output settings.
+      - **`path`** (`string`): Custom output directory path for ESM format (e.g., `'esm'`, `'modern'`). Defaults to root of buildPath.
       - **`comments`** (`boolean`): Includes comments in the output if `true`.
       - **`sourceMap`** (`boolean`): Generates source maps if `true`.
   - **`cjs`** (`object`): Settings for CJS (CommonJS) format output.
     - **`output`** (`object`): Configures CJS output settings.
+      - **`path`** (`string`): Custom output directory path for CJS format (e.g., `'cjs'`, `'legacy'`). Defaults to `'cjs'` in buildPath.
       - **`comments`** (`boolean`): Includes comments in the output if `true`.
       - **`sourceMap`** (`boolean`): Generates source maps if `true`.
 - **`target`** (`string` or `array`): Specifies build targets, such as `"esm"`, `"cjs"`, or an array with both.
@@ -164,12 +166,14 @@ module.exports = {
   lib: {
     esm: {
       output: {
+        path: 'esm', // custom path for ESM output (defaults to root of buildPath)
         comments: true,
         sourceMap: true,
       },
     },
     cjs: {
       output: {
+        path: 'cjs', // custom path for CJS output (default cjs inside buildPath)
         comments: true,
         sourceMap: true,
       },

src/config/config.ts

@@ -24,12 +24,14 @@ function getInitialConfig(cliProps?: CliProps) {
     lib: {
       esm: {
         output: {
+          path: './',
           comments: true,
           sourceMap: Boolean(cliProps.sourceMaps),
         },
       },
       cjs: {
         output: {
+          path: './cjs',
           comments: true,
           sourceMap: Boolean(cliProps.sourceMaps),
         },
@@ -187,7 +189,6 @@ export async function initConfig(cliProps?: CliProps): Promise<Config> {
         '**/*.test.tsx',
         '**/*.spec.ts',
         '**/*.spec.tsx',
-        '**/*.d.ts',
       ];
     }
 
@@ -224,6 +225,16 @@ export async function initConfig(cliProps?: CliProps): Promise<Config> {
     config.buildPath = path.resolve(root, './dist');
   }
 
+  // resolve output paths w.r.t buildPath with defaults
+  config.lib.esm.output.path = path.resolve(
+    config.buildPath,
+    config.lib.esm.output.path,
+  );
+  config.lib.cjs.output.path = path.resolve(
+    config.buildPath,
+    config.lib.cjs.output.path,
+  );
+
   store.setConfig(config);
   return config as Config;
 }

src/config/schema.ts

@@ -10,6 +10,7 @@ export interface ModuleConfig {
   output?: {
     comments?: boolean;
     sourceMap?: boolean;
+    path?: string;
   };
 }
 
@@ -22,6 +23,10 @@ export const ModuleConfigSchema = z
           .optional()
           .describe('Include comments in the output'),
         sourceMap: z.boolean().optional().describe('Generate source maps'),
+        path: z
+          .string()
+          .optional()
+          .describe('Custom output directory path for this module format'),
       })
       .strict()
       .optional()

src/core/build.ts

@@ -17,9 +17,11 @@ function getAllSourceFiles() {
   }
 
   try {
+    const hasDts = ignore.includes('**/*.d.ts');
     return globSync(globPattern, {
       cwd: srcPath,
-      ignore,
+      // ignore d.ts as its not needed to be transpiled
+      ignore: [...ignore, !hasDts && '**/*.d.ts'].filter(Boolean),
     });
   } catch (err) {
     console.error(err);

src/core/postbuild.ts

@@ -9,18 +9,22 @@ import { log, parallel, sequential, createTimer } from '@/utils';
  * Copy required files of module in there folder
  */
 export async function copyRequiredFiles() {
-  const { assets, srcPath, buildPath } = getConfig();
-  if (!assets || (Array.isArray(assets) && Boolean(assets.length))) {
+  const { assets, srcPath, buildPath, lib } = getConfig();
+  if (!assets || (Array.isArray(assets) && assets.length === 0)) {
     return;
   }
 
   if (!(await fse.pathExists(buildPath))) {
-    log.warn(`[assets] path ${buildPath} does not exists to copy`);
+    log.warn(`build path ${buildPath} does not exists to copy assets`);
     return [];
   }
 
-  const hasCJS = await fse.pathExists(`${buildPath}/cjs`);
-  const hasESM = await fse.pathExists(`${buildPath}/esm`);
+  // get custom paths from config or use defaults
+  const cjsPath = lib?.cjs?.output?.path;
+  const esmPath = lib?.esm?.output?.path;
+
+  const hasCJS = await fse.pathExists(cjsPath);
+  const hasESM = await fse.pathExists(esmPath);
 
   const files = await glob(assets, {
     cwd: srcPath,
@@ -32,29 +36,26 @@ export async function copyRequiredFiles() {
   files.forEach(file => {
     if (hasCJS) {
       task.push(
-        fse.copy(
-          path.resolve(srcPath, file),
-          path.resolve(`${buildPath}/cjs`, file),
-        ),
+        fse.copy(path.resolve(srcPath, file), path.resolve(cjsPath, file)),
       );
     }
     if (hasESM) {
       task.push(
-        fse.copy(
-          path.resolve(srcPath, file),
-          path.resolve(`${buildPath}/esm`, file),
-        ),
+        fse.copy(path.resolve(srcPath, file), path.resolve(esmPath, file)),
       );
     }
-    task.push(
-      fse.copy(path.resolve(srcPath, file), path.resolve(buildPath, file)),
-    );
   });
   await Promise.all(task);
 }
 
 async function postbuild(getBuildTime: ReturnType<typeof createTimer>) {
-  const { root, srcPath, buildPath } = getConfig();
+  const { root, srcPath, buildPath, lib } = getConfig();
+
+  const cjsPath = lib?.cjs?.output?.path;
+  const esmPath = lib?.esm?.output?.path;
+
+  const hasCJS = fse.pathExistsSync(cjsPath);
+  const hasESM = fse.pathExistsSync(esmPath);
 
   /**
    * Following function help to move project files like
@@ -73,9 +74,24 @@ async function postbuild(getBuildTime: ReturnType<typeof createTimer>) {
   }
 
   /**
-   * used to create tree-shakeable package.json in each module of project
+   * createModulePackages used to create tree-shakeable package.json in each module of project
+   * in case of esm and cjs co exist and esm path is in root then we create module packages
+   * ```js
+   * import { someModule } from 'your-lib';
+   * const { someModule } = require('your-lib');
+   *
+   * import someModule from 'your-lib/some-module';
+   * const someModule = require('your-lib/some-module');
+   * ```
    */
   async function createModulePackages() {
+    // in case esm and cjs co exist then we create module packages
+    if (!(hasESM && hasCJS)) return;
+
+    // if esm path is not in root then we don't create module packages
+    // in case or root it will be empty string which is falsy
+    if (path.relative(buildPath, esmPath)) return;
+
     const packageData = JSON.parse(
       await fse.readFile(path.resolve(root, './package.json'), 'utf8'),
     );
@@ -92,11 +108,15 @@ async function postbuild(getBuildTime: ReturnType<typeof createTimer>) {
           'package.json',
         );
 
-        const packageJson: Record<string, any> = {
+        const esmDir = path.join(esmPath, directoryPackage);
+        const cjsDir = path.join(cjsPath, directoryPackage);
+
+        const packageJson = {
+          name: `${packageData.name}/${directoryPackage}`,
           version: packageData.version,
           sideEffects: false,
           module: './index.js',
-          main: path.posix.join('../cjs', directoryPackage, 'index.js'),
+          main: path.posix.join(path.relative(esmDir, cjsDir), 'index.js'),
           types: './index.d.ts',
         };
 
@@ -167,14 +187,17 @@ async function postbuild(getBuildTime: ReturnType<typeof createTimer>) {
       fse.readFileSync(path.resolve(root, './package.json'), 'utf8'),
     );
 
+    const cjsDir = path.relative(buildPath, cjsPath);
+    const esmDir = path.relative(buildPath, esmPath);
+
     const newPackageData = {
       ...restPackageData,
       private: false,
-      main: fse.existsSync(path.resolve(buildPath, './cjs/index.js'))
-        ? './cjs/index.js'
+      main: fse.existsSync(path.join(cjsPath, 'index.js'))
+        ? `.${cjsDir ? `/${cjsDir}` : ''}/index.js`
         : './index.js',
-      module: fse.existsSync(path.resolve(buildPath, './esm/index.js'))
-        ? './esm/index.js'
+      module: fse.existsSync(path.join(esmPath, 'index.js'))
+        ? `.${esmDir ? `/${esmDir}` : ''}/index.js`
         : './index.js',
     };
 
@@ -190,13 +213,13 @@ async function postbuild(getBuildTime: ReturnType<typeof createTimer>) {
       delete newPackageData.main;
     }
 
-    const hasDefinitionsFile = fse.pathExistsSync(
-      path.resolve(buildPath, './index.d.ts'),
-    );
-
-    if (hasDefinitionsFile) {
-      newPackageData.types = './index.d.ts';
+    // if esm path exists then by default types will be in esm path else in cjs path
+    const dtsIndex = path.resolve(hasESM ? esmPath : cjsPath, './index.d.ts');
+    // if dts file exists then add it to package.json
+    if (fse.pathExistsSync(dtsIndex)) {
+      newPackageData.types = `./${path.relative(buildPath, dtsIndex)}`;
     }
+
     fse.writeFileSync(
       path.resolve(buildPath, './package.json'),
       JSON.stringify(newPackageData, null, 2),

src/core/types/types.ts

@@ -68,10 +68,20 @@ function getParsedTSConfig() {
 }
 
 function compileDTS(onlyTypeCheck = false) {
+  const { srcPath, buildPath, lib } = getConfig();
   const ts = getTypescript();
-  const { srcPath, buildPath } = getConfig();
   const config = getParsedTSConfig();
 
+  const esmDistPath = lib?.esm?.output?.path;
+  const cjsDistPath = lib?.cjs?.output?.path;
+
+  let outDir = buildPath;
+  if (fse.existsSync(esmDistPath)) {
+    outDir = esmDistPath;
+  } else if (fse.existsSync(cjsDistPath)) {
+    outDir = cjsDistPath;
+  }
+
   const finalConfig: ParsedCommandLine = {
     ...config,
     options: {
@@ -80,8 +90,8 @@ function compileDTS(onlyTypeCheck = false) {
       declaration: true,
       noEmit: onlyTypeCheck,
       emitDeclarationOnly: true,
-      outDir: onlyTypeCheck ? undefined : buildPath,
       rootDir: srcPath,
+      outDir: onlyTypeCheck ? undefined : outDir,
     },
   };
 

src/transpiler/transpiler.ts

@@ -89,15 +89,14 @@ export const transformFilesAsync = async (
   }
 
   let moduleConfig: ModuleConfig;
-  let outPath = './';
-
   if (target === 'cjs') {
     moduleConfig = lib.cjs as ModuleConfig;
-    outPath = './cjs';
   } else if (target === 'esm') {
     moduleConfig = lib.esm as ModuleConfig;
   }
 
+  const outPath = moduleConfig?.output?.path;
+
   const outDir = path.resolve(
     buildPath,
     // It will support top level path