feat(exe)!: add exe.outDir for separate executable output dir, defaults to build

Author: sxzz

dts.snapshot.json

@@ -127,7 +127,7 @@
     "DepPlugin": "declare function DepPlugin(_: ResolvedConfig, _: TsdownBundle): Plugin",
     "DepsConfig": "interface DepsConfig {\n neverBundle?: ExternalOption\n alwaysBundle?: Arrayable<string | RegExp> | NoExternalFn\n onlyAllowBundle?: Arrayable<string | RegExp> | false\n skipNodeModulesBundle?: boolean\n}",
     "DevtoolsOptions": "interface DevtoolsOptions extends NonNullable<InputOptions['devtools']> {\n ui?: boolean | Partial<StartOptions>\n clean?: boolean\n}",
-    "ExeOptions": "interface ExeOptions extends ExeExtensionOptions {\n seaConfig?: Omit<SeaConfig, 'main' | 'output' | 'mainFormat'>\n fileName?: string | ((_: RolldownChunk) => string)\n}",
+    "ExeOptions": "interface ExeOptions extends ExeExtensionOptions {\n seaConfig?: Omit<SeaConfig, 'main' | 'output' | 'mainFormat'>\n fileName?: string | ((_: RolldownChunk) => string)\n outDir?: string\n}",
     "ExportsOptions": "interface ExportsOptions {\n devExports?: boolean | string\n packageJson?: boolean\n all?: boolean\n exclude?: (RegExp | string)[]\n legacy?: boolean\n customExports?: Record<string, any> | ((_: Record<string, any>, _: { pkg: PackageJson; chunks: ChunksByFormat; isPublish: boolean }) => Awaitable<Record<string, any>>)\n inlinedDependencies?: boolean\n}",
     "Format": "type Format = ModuleFormat",
     "InlineConfig": "interface InlineConfig extends UserConfig {\n config?: boolean | string\n configLoader?: 'auto' | 'native' | 'unrun'\n filter?: RegExp | Arrayable<string>\n}",

src/features/clean.ts

@@ -19,6 +19,11 @@ export async function cleanOutDir(configs: ResolvedConfig[]): Promise<void> {
       config.clean.push('node_modules/.rolldown')
     }
 
+    if (config.exe) {
+      const exeOutDir = path.resolve(config.cwd, config.exe.outDir || 'build')
+      config.clean.push(exeOutDir)
+    }
+
     if (!config.clean.length) continue
     const files = await glob(config.clean, {
       cwd: config.cwd,

src/features/exe.ts

@@ -1,4 +1,4 @@
-import { mkdtemp, writeFile } from 'node:fs/promises'
+import { mkdir, mkdtemp, writeFile } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import path from 'node:path'
 import process from 'node:process'
@@ -9,7 +9,7 @@ import satisfies from 'semver/functions/satisfies.js'
 import { x } from 'tinyexec'
 import { formatBytes } from '../utils/format.ts'
 import { fsRemove, fsStat } from '../utils/fs.ts'
-import { importWithError } from '../utils/general.ts'
+import { importWithError, typeAssert } from '../utils/general.ts'
 import type { ResolvedConfig, RolldownChunk } from '../config/types.ts'
 import type { ExeExtensionOptions, ExeTarget } from '@tsdown/exe'
 
@@ -20,6 +20,11 @@ export interface ExeOptions extends ExeExtensionOptions {
    * For example, do not include `.exe`, platform suffixes, or architecture suffixes.
    */
   fileName?: string | ((chunk: RolldownChunk) => string)
+  /**
+   * Output directory for executables.
+   * @default 'build'
+   */
+  outDir?: string
 }
 
 /**
@@ -176,8 +181,12 @@ async function buildSingleExe(
   executable?: string,
   target?: ExeTarget,
 ): Promise<void> {
-  const exe = config.exe as ExeOptions
-  const outputPath = path.join(config.outDir, outputFile)
+  typeAssert(config.exe)
+  const exe = config.exe
+  const exeOutDir = path.resolve(config.cwd, exe.outDir || 'build')
+
+  await mkdir(exeOutDir, { recursive: true })
+  const outputPath = path.join(exeOutDir, outputFile)
   debug('Building SEA executable: %s -> %s', bundledFile, outputPath)
 
   const t = performance.now()

tests/exe.test.ts

@@ -38,11 +38,26 @@ describe.runIf(nodeSupportsBuiltinSea)('exe', () => {
       snapshot: false,
     })
 
-    const exePath = path.join(testDir, `dist/index${suffix}`)
+    const exePath = path.join(testDir, `build/index${suffix}`)
     const { stdout } = await x(exePath)
     expect(stdout.trim()).toBe('hello from sea')
   })
 
+  test('exe.outDir outputs executable to custom directory', async (context) => {
+    const { testDir } = await testBuild({
+      context,
+      files: {
+        'index.ts': 'console.log("hello from custom outdir")',
+      },
+      options: { exe: true },
+      snapshot: false,
+    })
+
+    const exePath = path.join(testDir, `build/index${suffix}`)
+    const { stdout } = await x(exePath)
+    expect(stdout.trim()).toBe('hello from custom outdir')
+  })
+
   test('bundles dynamic import() and executes correctly', async (context) => {
     const { testDir } = await testBuild({
       context,
@@ -64,7 +79,7 @@ describe.runIf(nodeSupportsBuiltinSea)('exe', () => {
       snapshot: false,
     })
 
-    const exePath = path.join(testDir, `dist/index${suffix}`)
+    const exePath = path.join(testDir, `build/index${suffix}`)
     const { stdout } = await x(exePath)
     expect(stdout.trim()).toBe('hello from dynamic import')
   })