build: use tsdown + isolated declarations (#1095)

Author: danielroe

.devcontainer/devcontainer.json

@@ -14,7 +14,7 @@
       ]
     }
   },
-  "postStartCommand": "corepack enable && pnpm install && pnpm build --stub",
+  "postStartCommand": "corepack enable && pnpm install",
   "mounts": [
     "type=volume,target=${containerWorkspaceFolder}/node_modules",
     "type=volume,target=${containerWorkspaceFolder}/dist"

README.md

@@ -12,14 +12,14 @@ All commands are listed on https://nuxt.com/docs/api/commands.
 # Install dependencies
 pnpm i
 
-# Generate type stubs
-pnpm dev:prepare
+# Build project and start watcher
+pnpm dev
 
 # Go to the playground directory
 cd playground
 
 # And run any commands
-pnpm nuxi <command>
+pnpm nuxt <command>
 ```
 
 ## License

package.json

@@ -7,15 +7,14 @@
   "license": "MIT",
   "repository": "nuxt/cli",
   "scripts": {
-    "dev:prepare": "pnpm -r dev:prepare",
     "build": "pnpm -r build",
-    "build:stub": "pnpm -r dev:prepare",
+    "dev": "pnpm -r build --watch",
     "lint": "eslint .",
     "lint:fix": "eslint --fix .",
     "nuxi": "node ./packages/nuxi/bin/nuxi.mjs",
     "nuxt": "node ./packages/nuxt-cli/bin/nuxi.mjs",
-    "nuxi-bun": "bun --bun ./packages/nuxi/bin/nuxi.mjs",
-    "prepack": "pnpm -r build",
+    "nuxi-bun": "bun --bun ./packages/nuxt-cli/bin/nuxi.mjs",
+    "postinstall": "pnpm build",
     "test:types": "tsc --noEmit",
     "test:knip": "knip",
     "test:dist": "pnpm -r test:dist",

packages/create-nuxt/build.config.ts

@@ -25,9 +25,8 @@
     "node": "^16.10.0 || >=18.0.0"
   },
   "scripts": {
-    "dev:prepare": "unbuild --stub",
-    "build": "unbuild",
-    "prepack": "unbuild"
+    "build": "tsdown",
+    "prepack": "tsdown"
   },
   "dependencies": {
     "citty": "^0.1.6"
@@ -36,8 +35,8 @@
     "@types/node": "^22.18.12",
     "rollup": "^4.52.5",
     "rollup-plugin-visualizer": "^6.0.5",
+    "tsdown": "^0.15.9",
     "typescript": "^5.9.3",
-    "unbuild": "^3.6.1",
     "unplugin-purge-polyfills": "^0.1.0"
   }
 }

packages/create-nuxt/package.json

@@ -1,3 +1,4 @@
+import type { CommandDef } from 'citty'
 import { defineCommand } from 'citty'
 import { provider } from 'std-env'
 
@@ -7,7 +8,7 @@ import { checkEngines } from '../../nuxi/src/utils/engines'
 import { logger } from '../../nuxi/src/utils/logger'
 import { description, name, version } from '../package.json'
 
-export const main = defineCommand({
+const _main = defineCommand({
   meta: {
     name,
     version,
@@ -25,3 +26,5 @@ export const main = defineCommand({
     await init.run?.(ctx)
   },
 })
+
+export const main = _main as CommandDef<any>

packages/create-nuxt/src/main.ts

@@ -19,13 +19,13 @@ globalThis.__nuxt_cli__ = globalThis.__nuxt_cli__ || {
   ),
 }
 
-export const runMain = () => _runMain(main)
+export const runMain = (): Promise<void> => _runMain(main)
 
 export async function runCommand(
   name: 'init',
   argv: string[] = process.argv.slice(2),
   data: { overrides?: Record<string, any> } = {},
-) {
+): Promise<{ result: unknown }> {
   return await _runCommand(init, {
     rawArgs: argv,
     data: {

packages/create-nuxt/src/run.ts

@@ -0,0 +1,20 @@
+import type { UserConfig } from 'tsdown'
+import process from 'node:process'
+import { visualizer } from 'rollup-plugin-visualizer'
+import { defineConfig } from 'tsdown'
+import { purgePolyfills } from 'unplugin-purge-polyfills'
+
+const isAnalysingSize = process.env.BUNDLE_SIZE === 'true'
+
+export default defineConfig({
+  entry: ['src/index.ts'],
+  fixedExtension: true,
+  dts: !isAnalysingSize && {
+    oxc: true,
+  },
+  failOnWarn: !isAnalysingSize,
+  plugins: [
+    purgePolyfills.rolldown({ logLevel: 'verbose' }),
+    ...(isAnalysingSize ? [visualizer({ template: 'raw-data' })] : []),
+  ],
+}) satisfies UserConfig as UserConfig

packages/create-nuxt/tsdown.config.ts

@@ -28,15 +28,8 @@
     "node": "^16.10.0 || >=18.0.0"
   },
   "scripts": {
-    "dev:prepare": "unbuild --stub",
-    "build": "unbuild",
-    "build:stub": "unbuild --stub",
-    "dev": "node ./bin/nuxi.mjs dev ./playground",
-    "dev:bun": "bun --bun ./bin/nuxi.mjs dev ./playground",
-    "nuxi": "node ./bin/nuxi.mjs",
-    "nuxi-bun": "bun --bun ./bin/nuxi.mjs",
-    "prepack": "unbuild",
-    "test:dist": "node ./bin/nuxi.mjs info ./playground"
+    "build": "tsdown",
+    "prepack": "tsdown"
   },
   "devDependencies": {
     "@nuxt/kit": "^4.1.3",
@@ -72,9 +65,9 @@
     "srvx": "^0.8.16",
     "std-env": "^3.10.0",
     "tinyexec": "^1.0.1",
+    "tsdown": "^0.15.9",
     "typescript": "^5.9.3",
     "ufo": "^1.6.1",
-    "unbuild": "^3.6.1",
     "undici": "^7.16.0",
     "unplugin-purge-polyfills": "^0.1.0",
     "vitest": "^3.2.4",