feat: expose resolveUserConfig

sxzz · sxzz · commit c9acbf9b9d89 · 2026-01-08T04:32:48.000+08:00
diff --git a/dts.snapshot.json b/dts.snapshot.json
@@ -1,15 +1,8 @@
 {
-  "build.d.mts": {
-    "build": "declare function build(_: InlineConfig): Promise<TsdownBundle[]>",
-    "buildWithConfigs": "declare function buildWithConfigs(_: ResolvedConfig[], _: string[]): Promise<TsdownBundle[]>",
-    "#exports": [
-      "build",
-      "buildWithConfigs"
-    ]
-  },
-  "config-!~{00f}~.d.mts": {
+  "config-!~{00i}~.d.mts": {
     "defineConfig": "declare function defineConfig(_: UserConfigExport): UserConfigExport",
-    "mergeConfig": "declare function mergeConfig(_: InlineConfig, _: InlineConfig): InlineConfig"
+    "mergeConfig": "declare function mergeConfig(_: InlineConfig, _: InlineConfig): InlineConfig",
+    "resolveUserConfig": "declare function resolveUserConfig(_: UserConfig, _: InlineConfig): Promise<ResolvedConfig[]>"
   },
   "config.d.mts": {
     "#exports": [
@@ -21,6 +14,8 @@
     ]
   },
   "index.d.mts": {
+    "build": "declare function build(_: InlineConfig): Promise<TsdownBundle[]>",
+    "buildWithConfigs": "declare function buildWithConfigs(_: ResolvedConfig[], _: string[]): Promise<TsdownBundle[]>",
     "enableDebug": "declare function enableDebug(_: boolean | Arrayable<string>): void",
     "#exports": [
       "AttwOptions",
@@ -68,7 +63,8 @@
       "defineConfig",
       "enableDebug",
       "globalLogger",
-      "mergeConfig"
+      "mergeConfig",
+      "resolveUserConfig"
     ]
   },
   "plugins.d.mts": {
@@ -87,7 +83,7 @@
   "run.d.mts": {
     "#exports": []
   },
-  "types-!~{00d}~.d.mts": {
+  "types-!~{00g}~.d.mts": {
     "Arrayable": "type Arrayable<T> = T | T[]",
     "AttwOptions": "interface AttwOptions extends CheckPackageOptions {\n profile?: 'strict' | 'node16' | 'esm-only'\n level?: 'error' | 'warn'\n ignoreRules?: string[]\n}",
     "Awaitable": "type Awaitable<T> = T | Promise<T>",
diff --git a/package.json b/package.json
@@ -17,7 +17,6 @@
   },
   "exports": {
     ".": "./dist/index.mjs",
-    "./build": "./dist/build.mjs",
     "./config": "./dist/config.mjs",
     "./plugins": "./dist/plugins.mjs",
     "./run": "./dist/run.mjs",
diff --git a/src/build.ts b/src/build.ts
@@ -1,3 +1,5 @@
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
 import { bold, green } from 'ansis'
 import { clearRequireCache } from 'import-without-cache'
 import {
@@ -35,6 +37,10 @@ import { globalLogger } from './utils/logger.ts'
 const asyncDispose: typeof Symbol.asyncDispose =
   Symbol.asyncDispose || Symbol.for('Symbol.asyncDispose')
 
+const dirname = path.dirname(fileURLToPath(import.meta.url))
+const pkgRoot: string = path.resolve(dirname, '..')
+export const shimFile: string = path.resolve(pkgRoot, 'esm-shims.js')
+
 /**
  * Build with tsdown.
  */
@@ -50,8 +56,7 @@ export async function build(
 /**
  * Build with `ResolvedConfigs`.
  *
- * Internal API, not for public use
- *
+ * **Internal API, not for public use**
  * @private
  */
 export async function buildWithConfigs(
diff --git a/src/config/options.ts b/src/config/options.ts
@@ -34,6 +34,12 @@ import type {
 
 const debug = createDebug('tsdown:config:options')
 
+/**
+ * Resolve user config into resolved configs
+ *
+ * **Internal API, not for public use**
+ * @private
+ */
 export async function resolveUserConfig(
   userConfig: UserConfig,
   inlineConfig: InlineConfig,
diff --git a/src/features/external.ts b/src/features/external.ts
@@ -3,7 +3,7 @@ import path from 'node:path'
 import { blue, underline } from 'ansis'
 import { createDebug } from 'obug'
 import { RE_DTS, RE_NODE_MODULES } from 'rolldown-plugin-dts/filename'
-import { shimFile } from '../index.ts'
+import { shimFile } from '../build.ts'
 import { matchPattern } from '../utils/general.ts'
 import type { ResolvedConfig } from '../config/index.ts'
 import type { PackageJson } from 'pkg-types'
diff --git a/src/features/shims.ts b/src/features/shims.ts
@@ -1,4 +1,4 @@
-import { shimFile } from '../index.ts'
+import { shimFile } from '../build.ts'
 import type { NormalizedFormat, ResolvedConfig } from '../config/index.ts'
 
 export function getShimsInject(
diff --git a/src/index.ts b/src/index.ts
@@ -1,14 +1,6 @@
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-
-const dirname = path.dirname(fileURLToPath(import.meta.url))
-const pkgRoot: string = path.resolve(dirname, '..')
-
-/** @internal */
-export const shimFile: string = path.resolve(pkgRoot, 'esm-shims.js')
-
 export { build, buildWithConfigs } from './build.ts'
 export { defineConfig, mergeConfig } from './config.ts'
+export { resolveUserConfig } from './config/options.ts'
 export * from './config/types.ts'
 export { enableDebug } from './features/debug.ts'
 export { globalLogger, type Logger } from './utils/logger.ts'
diff --git a/tsdown.config.ts b/tsdown.config.ts
@@ -7,7 +7,7 @@ import { defineConfig } from './src/config.ts'
 
 export default defineConfig([
   {
-    entry: ['./src/{index,run,plugins,config,build}.ts'],
+    entry: ['./src/{index,run,plugins,config}.ts'],
     name: 'tsdown',
     inlineOnly: ['is-in-ci'],
     platform: 'node',

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-import { shimFile } from '../index.ts'`
	`1`	`+import { shimFile } from '../build.ts'`
`2`	`2`	`import type { NormalizedFormat, ResolvedConfig } from '../config/index.ts'`
`3`	`3`
`4`	`4`	`export function getShimsInject(`
Original file line number	Diff line number	Diff line change
`@@ -7,7 +7,7 @@ import { defineConfig } from './src/config.ts'`
`7`	`7`
`8`	`8`	`export default defineConfig([`
`9`	`9`	`{`
`10`		`- entry: ['./src/{index,run,plugins,config,build}.ts'],`
	`10`	`+ entry: ['./src/{index,run,plugins,config}.ts'],`
`11`	`11`	`name: 'tsdown',`
`12`	`12`	`inlineOnly: ['is-in-ci'],`
`13`	`13`	`platform: 'node',`