feat: auto build bin field

.gitignore

@@ -1,8 +1,14 @@
+# NPM
+node_modules/
 package-lock.json
-node_modules
-dist
+
+# Output
+dist/
+out/
+
+# Misc
+.DS_Store
 *.log
 .yalc
 yalc.lock
-test/**/*.js.map
-.DS_Store
+test/**/*.js.map

src/build-config.ts

@@ -10,7 +10,7 @@ import type {
 import type { InputOptions, OutputOptions, Plugin } from 'rollup'
 import { type TypescriptOptions } from './typescript'
 
-import { resolve, dirname } from 'path'
+import { resolve, dirname, extname } from 'path'
 import { wasm } from '@rollup/plugin-wasm'
 import { swc } from 'rollup-plugin-swc3'
 import commonjs from '@rollup/plugin-commonjs'
@@ -37,6 +37,7 @@ import {
 import {
   availableExportConventions,
   availableESExtensionsRegex,
+  dtsExtentions,
 } from './constants'
 
 const swcMinifyOptions = {
@@ -89,9 +90,7 @@ async function buildInputConfig(
     target: jscTarget,
     minify: shouldMinify,
   } = options
-  const hasSpecifiedTsTarget = Boolean(
-    tsCompilerOptions.target && tsConfigPath,
-  )
+  const hasSpecifiedTsTarget = Boolean(tsCompilerOptions.target && tsConfigPath)
 
   const swcParserConfig = {
     syntax: useTypescript ? 'typescript' : 'ecmascript',
@@ -141,10 +140,7 @@ async function buildInputConfig(
     jsx: tsCompilerOptions.jsx || 'react',
   }
 
-  const typesPlugins = [
-    ...commonPlugins,
-    inlineCss({ skip: true }),
-  ]
+  const typesPlugins = [...commonPlugins, inlineCss({ skip: true })]
 
   if (useTypescript) {
     const mergedOptions = {
@@ -159,7 +155,9 @@ async function buildInputConfig(
       delete mergedOptions.tsBuildInfoFile
     }
 
-    const dtsPlugin = (require('rollup-plugin-dts') as typeof import('rollup-plugin-dts')).default({
+    const dtsPlugin = (
+      require('rollup-plugin-dts') as typeof import('rollup-plugin-dts')
+    ).default({
       tsconfig: undefined,
       compilerOptions: mergedOptions,
     })
@@ -373,6 +371,58 @@ export async function buildEntryConfig(
     configs.push(...buildConfigs)
   })
 
+  if (pkg.bin) {
+    const isSinglePathBin = typeof pkg.bin === 'string'
+    const binDistPaths = isSinglePathBin
+      ? [pkg.bin as string]
+      : Object.values(pkg.bin)
+
+    for (const binDistPath of binDistPaths) {
+      // assuming in `./a/b/c.js` the `a` as the dist folder name
+      // convert `./a/b/c.js` to `./b/c.js` as if the entry of the exports
+      const startsWithDotSlash = binDistPath.startsWith('./')
+
+      const binPathWithoutDist = binDistPath
+        .split('/')
+        // [ '.', 'a', 'b', 'c.js'] => [ 'b', 'c.js']
+        // [ 'a', 'b', 'c.js'] => [ 'b', 'c.js']
+        .slice(startsWithDotSlash ? 2 : 1)
+        // [ 'b', 'c.js'] => 'b/c.js'
+        .join('/')
+
+      // 'b/c.js' => './b/c' as if the key of the exports
+      const assumedSourcePathFromDistPath = `./${binPathWithoutDist.replace(
+        extname(binPathWithoutDist),
+        '',
+      )}`
+
+      const source = await getSourcePathFromExportPath(
+        cwd,
+        assumedSourcePathFromDistPath,
+        '',
+      )
+
+      if (!source) continue
+
+      const binEntryPath = await resolveSourceFile(cwd, source)
+      const binEntryConfig = buildConfig(
+        binEntryPath,
+        pkg,
+        exportPaths,
+        bundleConfig,
+        {
+          source: binEntryPath,
+          name: binDistPath,
+          export: {},
+        },
+        cwd,
+        tsOptions,
+        dts,
+      )
+      configs.push(binEntryConfig)
+    }
+  }
+
   return (await Promise.all(configs)).filter(nonNullable)
 }
 
@@ -397,22 +447,52 @@ async function buildConfig(
     tsOptions,
     dts,
   )
-  const outputExports = getExportConditionDist(pkg, exportCondition, cwd)
+  const outputExports: Array<string | { format: 'cjs' | 'esm'; file: string }> =
+    dts
+      ? getExportTypeDist(exportCondition, cwd)
+      : getExportConditionDist(pkg, exportCondition, cwd)
+
+  if (pkg.bin) {
+    const isSinglePathBin = typeof pkg.bin === 'string'
+    const binDistPaths = isSinglePathBin
+      ? [pkg.bin as string]
+      : Object.values(pkg.bin)
+
+    for (const binDistPath of binDistPaths) {
+      const ext = extname(binDistPath).slice(1) as 'js' | 'cjs' | 'mjs'
+
+      if (dts) {
+        const dtsExt = dtsExtentions[ext]
+        const filename = filenameWithoutExtension(binDistPath)
+        if (!filename) continue
+
+        const binTypeFile = `${filename}${dtsExt}`
+        outputExports.push(binTypeFile)
+      } else {
+        // ESM by default, CJS if the file extension is .cjs
+        const isCJS = ext === 'cjs'
+
+        outputExports.push({
+          format: isCJS ? 'cjs' : 'esm',
+          file: binDistPath,
+        })
+      }
+    }
+  }
 
   let outputConfigs = []
 
   // Generate dts job - single config
   if (dts) {
-    const typeOutputExports = getExportTypeDist(exportCondition, cwd)
-    outputConfigs = typeOutputExports.map((v) =>
+    outputConfigs = outputExports.map((v) =>
       buildOutputConfigs(
         pkg,
         exportPaths,
         {
           ...bundleConfig,
           format: 'es',
           useTypescript,
-          file: v,
+          file: v as string,
         },
         exportCondition,
         cwd,
@@ -423,13 +503,18 @@ async function buildConfig(
   } else {
     // multi outputs with specified format
     outputConfigs = outputExports.map((exportDist) => {
+      const { file, format } = exportDist as {
+        format: 'cjs' | 'esm'
+        file: string
+      }
+
       return buildOutputConfigs(
         pkg,
         exportPaths,
         {
           ...bundleConfig,
-          file: exportDist.file,
-          format: exportDist.format,
+          file,
+          format,
           useTypescript,
         },
         exportCondition,
@@ -440,7 +525,11 @@ async function buildConfig(
     })
     // CLI output option is always prioritized
     if (file) {
-      const fallbackFormat = outputExports[0]?.format
+      const firstOutput = outputExports[0] as {
+        format: 'cjs' | 'esm'
+        file: string
+      }
+      const fallbackFormat = firstOutput?.format
       outputConfigs = [
         buildOutputConfigs(
           pkg,

src/bundle.ts

@@ -68,6 +68,7 @@ async function bundle(
   )
   // const exportPathsLength = Object.keys(exportPaths).length
   const isMultiEntries = hasMultiEntryExport(exportPaths) // exportPathsLength > 1
+  const hasBin = Boolean(pkg.bin)
 
   const tsConfig = await resolveTsConfig(cwd)
   const hasTsConfig = Boolean(tsConfig?.tsConfigPath)
@@ -135,7 +136,7 @@ async function bundle(
     ? (await fileExists(entryPath)) && (await fs.stat(entryPath)).isFile()
     : false
 
-  if (!hasSpecifiedEntryFile && !isMultiEntries) {
+  if (!hasSpecifiedEntryFile && !isMultiEntries && !hasBin) {
     const err = new Error(`Entry file \`${entryPath}\` is not existed`)
     err.name = 'NOT_EXISTED'
     return Promise.reject(err)

src/constants.ts

@@ -17,3 +17,9 @@ export const availableESExtensionsRegex = /\.(m|c)?[jt]sx?$/
 export const dtsExtensionRegex = /\.d\.(m|c)?ts$/
 
 export const SRC = 'src'
+
+export const dtsExtentions = {
+  js: '.d.ts',
+  cjs: '.d.cts',
+  mjs: '.d.mts',
+}

src/exports.ts

@@ -7,6 +7,7 @@ import type {
   ParsedExportCondition,
 } from './types'
 import { exit, filenameWithoutExtension, hasCjsExtension } from './utils'
+import { dtsExtentions } from './constants'
 
 export function getTypings(pkg: PackageMetadata) {
   return pkg.types || pkg.typings
@@ -235,12 +236,7 @@ export const getExportTypeDist = (
       existed.add(typeFile)
       continue
     }
-    const ext = extname(filePath).slice(1)
-    const dtsExtentions: Record<string, string> = {
-      js: '.d.ts',
-      cjs: '.d.cts',
-      mjs: '.d.mts',
-    }
+    const ext = extname(filePath).slice(1) as 'js' | 'cjs' | 'mjs'
     const typeFile = getDistPath(
       `${filenameWithoutExtension(filePath) || ''}${dtsExtentions[ext]}`,
       cwd,
@@ -250,6 +246,7 @@ export const getExportTypeDist = (
     }
     existed.add(typeFile)
   }
+
   return Array.from(existed)
 }
 
@@ -314,7 +311,7 @@ export function getExportConditionDist(
     dist.push({ format, file: distFile })
   }
 
-  if (dist.length === 0) {
+  if (dist.length === 0 && !pkg.bin) {
     // TODO: Deprecate this warning and behavior in v3
     console.error(
       `Doesn't fin any exports in ${pkg.name}, using default dist path dist/index.js`,

src/types.ts

@@ -43,6 +43,7 @@ type BundleConfig = {
 type PackageMetadata = {
   name?: string
   main?: string
+  bin?: string | Record<string, string>
   module?: string
   type?: 'commonjs' | 'module'
   dependencies?: Record<string, string>

src/utils.ts

@@ -125,6 +125,11 @@ export async function getSourcePathFromExportPath(
   return
 }
 
+export async function getSourcePathFromOutputPath(
+  cwd: string,
+  outputPath: string,
+) {}
+
 // Unlike path.basename, forcedly removing extension
 export function filenameWithoutExtension(file: string | undefined) {
   return file