nuxt-spec 0.3.3 → 0.4.0-alpha.1

package/bin/cli.js

@@ -1,14 +1,17 @@
 #!/usr/bin/env node
 
-import { getCmd } from './helpers/commands.js'
+import { getCmd, resolvePackageManager } from './helpers/commands.js'
 
 /**
  * CLI tool to scaffold necessary adjustments in project folder.
  *
  * Allows `setup` or `update` to be passed as parameter.
  *
- * Second parameter might be a boolean to indicate auto mode
+ * Second (optional) parameter might be a boolean to indicate auto mode
  * (no prompts, force = true) or manual mode (with prompts, force = false).
+ *
+ * Third (optional) parameter allows explicitly passing the package manager
+ * (`npm`, `pnpm`, `yarn`, `bun` or `deno`), bypassing auto-detection.
  */
 
 // get parameters passed by user
@@ -19,19 +22,22 @@ const args = process.argv.slice(2);
 (async () => {
   let status = 0
   try {
+    const packageManager = resolvePackageManager(args[2])
+    // CLI args are always strings, so 'false' must be parsed explicitly rather than treated as truthy
+    const autoRun = args[1] === 'true'
     switch (args[0]) {
       case 'setup':
-        await (await import('./setup.js')).specSetup(args[1] || false)
+        await (await import('./setup.js')).specSetup(autoRun, packageManager)
         break
       case 'update':
-        await (await import('./update.js')).specUpdate(args[1] || false)
+        await (await import('./update.js')).specUpdate(autoRun, packageManager)
         break
       default:
-        console.log(`Usage: \`${getCmd()} setup [true|false]\` or \`${getCmd()} update [true|false]\``)
+        console.log(`[Nuxt Spec] Usage: \`${getCmd(packageManager)} setup [true|false] [npm|pnpm|yarn|bun|deno]\` or \`${getCmd(packageManager)} update [true|false] [npm|pnpm|yarn|bun|deno]\``)
         status = 1
     }
   } catch (error) {
-    console.error('Setup failed:', error.message)
+    console.error('[Nuxt Spec] CLI failed:', error.message)
     status = 1
   }
   process.exit(status)

package/bin/helpers/commands.js

@@ -1,9 +1,22 @@
 import { getPackageManager } from 'elrh-cosca'
 
+export const SUPPORTED_PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun', 'deno']
+
+// get the package manager name for usage in commands
+// explicit override takes precedence over auto-detection
+export function resolvePackageManager(override) {
+  if (override) {
+    if (!SUPPORTED_PACKAGE_MANAGERS.includes(override)) {
+      throw new Error(`Unsupported package manager '${override}'. Use one of: ${SUPPORTED_PACKAGE_MANAGERS.join(', ')}`)
+    }
+    return override
+  }
+  return getPackageManager()
+}
+
 // use nuxt-spec CLI tool
-export function getCmd() {
+export function getCmd(packageManager) {
   const command = 'nuxt-spec'
-  const packageManager = getPackageManager()
   switch (packageManager) {
     case 'pnpm':
       return `pnpx ${command}`
@@ -24,19 +37,36 @@ export function getUpdateCmd(packageManager, target) {
     case 'pnpm':
       return `pnpm update ${target}`
     case 'yarn':
-      return `yarn upgrade ${target}`
+      return `yarn up ${target}`
     case 'bun':
       return `bun update ${target}`
     case 'deno':
       return `deno add npm:${target}`
     default:
-      return `npm update ${target}`
+      return `npm install ${target}`
+  }
+}
+
+// generate Nuxt types and auto-imports
+export function getPrepareCmd(packageManager) {
+  const command = 'nuxt prepare'
+  switch (packageManager) {
+    case 'pnpm':
+      return `pnpm exec ${command}`
+    case 'yarn':
+      return `yarn ${command}`
+    case 'bun':
+      return `bunx ${command}`
+    case 'deno':
+      return `deno run -A npm:${command}`
+    default:
+      return `npx ${command}`
   }
 }
 
 // install/update playwright
 export function getPlaywrightInstallCmd(packageManager) {
-  const command = 'playwright-core install'
+  const command = 'playwright install'
   switch (packageManager) {
     case 'pnpm':
       return `pnpm exec ${command}`

package/bin/setup.js

@@ -1,14 +1,17 @@
 #!/usr/bin/env node
 
 import { execSync } from 'node:child_process'
+import { readFileSync } from 'node:fs'
 import {
-  createFileFromWebTemplate, deletePath, getPackageManager, hasJsonKey,
+  createFileFromWebTemplate, deletePath,
   pathExists, promptUser, removeFromJsonFile, showMessage,
   updateConfigFile, updateJsonFile, updateTextFile,
 } from 'elrh-cosca'
-import { getPlaywrightInstallCmd } from './helpers/commands.js'
+import {
+  getPlaywrightInstallCmd, getPrepareCmd,
+} from './helpers/commands.js'
 
-const TARGET_VERSION = '0.3.3'
+const TARGET_VERSION = '0.4.0-alpha.1'
 
 /**
  * CLI tool to scaffold necessary adjustments in project folder.
@@ -23,246 +26,339 @@ const TARGET_VERSION = '0.3.3'
  *  5) creates default `.nuxtrc` file
  *  6) adds test-related scripts in `package.json`
  *  7) creates sample test files
- *  8) clear node_modules and lock file(s)
- *  9) run install command
- * 10) run Playwright setup command
+ *  8) adds nuxt-spec related entries to `.gitignore`
+ *  9) clear node_modules and lock file(s)
+ * 10) run install command
+ * 11) run Nuxt prepare command to generate types and auto-imports
+ * 12) run Playwright setup command
  *
  * @param {boolean} autoRun - Whether to run the setup automatically without any prompts (defaults to false).
+ * @param {string} [packageManager] - Package manager to be used (`npm`, `pnpm`, `yarn`, `bun` or `deno`).
  */
-export async function specSetup(autoRun = false) {
-  showMessage('NUXT SPEC SETUP')
-  showMessage('This CLI tool will help you include Nuxt Spec in your project.')
-  showMessage('Refer to the documentation for more information.', 2)
-
-  const isAutoRun = autoRun || await promptUser('Do you want to set everything up automatically (no more prompts)?')
-  showMessage('')
+export async function specSetup(autoRun = false, packageManager) {
+  showMessage({ message: 'NUXT SPEC SETUP' })
+  showMessage({ message: 'This CLI tool will help you include Nuxt Spec in your project.' })
+  showMessage({ message: 'Refer to the documentation for more information.', linesAfter: 2 })
 
-  const packageManager = getPackageManager()
+  const isAutoRun = autoRun || await promptUser({ question: '[Nuxt Spec] Do you want to set everything up automatically (no more prompts)?' })
+  showMessage({ message: '' })
 
   // 1) manage dependencies in package.json
 
   // add nuxt-spec
   try {
-    await updateJsonFile('package.json', 'dependencies', {
-      ['nuxt-spec']: TARGET_VERSION,
-    }, isAutoRun, `This will add 'nuxt-spec' dependency to your 'package.json'. Continue?`)
+    await updateJsonFile({
+      targetFile: 'package.json',
+      jsonKey: 'dependencies',
+      patch: {
+        ['nuxt-spec']: TARGET_VERSION,
+      },
+      force: isAutoRun,
+      prompt: `[Nuxt Spec] This will add 'nuxt-spec' dependency to your 'package.json'. Continue?`,
+    })
   } catch (error) {
-    console.error(`Error adding 'nuxt-spec' dependency:\n`, error.message)
+    console.error(`[Nuxt Spec] Error adding 'nuxt-spec' dependency:\n`, error.message)
   }
 
   // remove now obsolete nuxt, vue and vue-router
-  const removeDeps = isAutoRun || await promptUser(`As 'nuxt-spec' provides 'nuxt', 'vue' and 'vue-router' dependencies out of the box, do you want to remove them from your 'package.json' to avoid duplications and possible version clashes?`)
+  const removeDeps = isAutoRun || await promptUser({ question: `[Nuxt Spec] As 'nuxt-spec' provides 'nuxt', 'vue' and 'vue-router' dependencies out of the box, do you want to remove them from your 'package.json' to avoid duplications and possible version clashes?` })
   if (removeDeps) {
-    if (hasJsonKey('package.json', 'dependencies.nuxt')) {
-      try {
-        await removeFromJsonFile('package.json', 'dependencies.nuxt', true)
-      } catch (error) {
-        console.error('Error removing \'nuxt\' dependency:\n', error.message)
-      }
+    try {
+      await removeFromJsonFile({ targetFile: 'package.json', jsonKey: 'dependencies.nuxt', force: true })
+    } catch (error) {
+      console.error('[Nuxt Spec] Error removing \'nuxt\' dependency:\n', error.message)
     }
-    if (hasJsonKey('package.json', 'dependencies.vue')) {
-      try {
-        await removeFromJsonFile('package.json', 'dependencies.vue', true)
-      } catch (error) {
-        console.error('Error removing \'vue\' dependency:\n', error.message)
-      }
+    try {
+      await removeFromJsonFile({ targetFile: 'package.json', jsonKey: 'dependencies.vue', force: true })
+    } catch (error) {
+      console.error('[Nuxt Spec] Error removing \'vue\' dependency:\n', error.message)
     }
-    if (hasJsonKey('package.json', 'dependencies.vue-router')) {
-      try {
-        await removeFromJsonFile('package.json', 'dependencies.vue-router', true)
-      } catch (error) {
-        console.error('Error removing \'vue-router\' dependency:\n', error.message)
-      }
+    try {
+      await removeFromJsonFile({ targetFile: 'package.json', jsonKey: 'dependencies.vue-router', force: true })
+    } catch (error) {
+      console.error('[Nuxt Spec] Error removing \'vue-router\' dependency:\n', error.message)
     }
-    if (hasJsonKey('package.json', 'devDependencies.nuxt')) {
-      try {
-        await removeFromJsonFile('package.json', 'devDependencies.nuxt', true)
-      } catch (error) {
-        console.error('Error removing \'nuxt\' devDependency:\n', error.message)
-      }
+    try {
+      await removeFromJsonFile({ targetFile: 'package.json', jsonKey: 'devDependencies.nuxt', force: true })
+    } catch (error) {
+      console.error('[Nuxt Spec] Error removing \'nuxt\' devDependency:\n', error.message)
     }
-    if (hasJsonKey('package.json', 'devDependencies.vue')) {
-      try {
-        await removeFromJsonFile('package.json', 'devDependencies.vue', true)
-      } catch (error) {
-        console.error('Error removing \'vue\' devDependency:\n', error.message)
-      }
+    try {
+      await removeFromJsonFile({ targetFile: 'package.json', jsonKey: 'devDependencies.vue', force: true })
+    } catch (error) {
+      console.error('[Nuxt Spec] Error removing \'vue\' devDependency:\n', error.message)
     }
-    if (hasJsonKey('package.json', 'devDependencies.vue-router')) {
-      try {
-        await removeFromJsonFile('package.json', 'devDependencies.vue-router', true)
-      } catch (error) {
-        console.error('Error removing \'vue-router\' devDependency:\n', error.message)
-      }
+    try {
+      await removeFromJsonFile({ targetFile: 'package.json', jsonKey: 'devDependencies.vue-router', force: true })
+    } catch (error) {
+      console.error('[Nuxt Spec] Error removing \'vue-router\' devDependency:\n', error.message)
     }
   }
 
   // 2) modify nuxt.config.ts
   try {
-    await updateConfigFile('nuxt.config.ts', {
-      extends: [
-        'nuxt-spec',
-      ],
-    }, isAutoRun, `This will add 'nuxt-spec' module to your 'nuxt.config.ts'. Continue?`)
+    await updateConfigFile({
+      targetFile: 'nuxt.config.ts',
+      newConfig: {
+        extends: [
+          'nuxt-spec',
+        ],
+      },
+      force: isAutoRun,
+      prompt: `[Nuxt Spec] This will add 'nuxt-spec' module to your 'nuxt.config.ts'. Continue?`,
+    })
   } catch (error) {
-    console.error('Error updating \'nuxt.config.ts\':\n', error.message)
+    console.error('[Nuxt Spec] Error updating \'nuxt.config.ts\':\n', error.message)
   }
 
   // 3) `pnpm-workspace.yaml` file (only if pnpm is used)
   if (packageManager === 'pnpm') {
     try {
-      if (pathExists('pnpm-workspace.yaml')) {
-        await updateTextFile('pnpm-workspace.yaml', ['shamefully-hoist: true'], isAutoRun, 'This will adjust \'pnpm-workspace.yaml\' file in your project. Continue?')
+      if (pathExists({ targetPath: 'pnpm-workspace.yaml' })) {
+        await updateTextFile({
+          targetFile: 'pnpm-workspace.yaml',
+          rowsToAdd: ['shamefullyHoist: true'],
+          force: isAutoRun,
+          prompt: '[Nuxt Spec] This will adjust \'pnpm-workspace.yaml\' file in your project. Continue?',
+        })
       } else {
-        await createFileFromWebTemplate(`https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/config/templates/pnpm-workspace.yaml.template`,
-          'pnpm-workspace.yaml', isAutoRun, 'This will add \'pnpm-workspace.yaml\' file for your project. Continue?')
+        await createFileFromWebTemplate({
+          url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/config/templates/pnpm-workspace.yaml.template`,
+          targetFile: 'pnpm-workspace.yaml',
+          force: isAutoRun,
+          prompt: '[Nuxt Spec] This will add \'pnpm-workspace.yaml\' file for your project. Continue?',
+        })
       }
     } catch (error) {
-      console.error('Error setting up \'pnpm-workspace.yaml\':\n', error.message)
+      console.error('[Nuxt Spec] Error setting up \'pnpm-workspace.yaml\':\n', error.message)
     }
   }
 
   // 4) create vitest.config.ts
   try {
-    await createFileFromWebTemplate(`https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/config/templates/vitest.config.ts.template`,
-      'vitest.config.ts', isAutoRun, 'This will create a new \'vitest.config.ts\' file for your project. Continue?')
+    await createFileFromWebTemplate({
+      url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/config/templates/vitest.config.ts.template`,
+      targetFile: 'vitest.config.ts',
+      force: isAutoRun,
+      prompt: '[Nuxt Spec] This will create a new \'vitest.config.ts\' file for your project. Continue?',
+    })
   } catch (error) {
-    console.error('Error setting up \'vitest.config.ts\':\n', error.message)
+    console.error('[Nuxt Spec] Error setting up \'vitest.config.ts\':\n', error.message)
   }
 
   // 5) create .nuxtrc to prevent @nuxt/test-utils setup from running automatically on first start
-  if (!pathExists('.nuxtrc')) {
+  if (!pathExists({ targetPath: '.nuxtrc' })) {
     try {
-      await createFileFromWebTemplate(`https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/.nuxtrc`, '.nuxtrc', isAutoRun, 'This will create a \'.nuxtrc\' file to prevent @nuxt/test-utils setup from running automatically when dev server starts. Continue?')
+      await createFileFromWebTemplate({
+        url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/.nuxtrc`,
+        targetFile: '.nuxtrc',
+        force: isAutoRun,
+        prompt: '[Nuxt Spec] This will create a \'.nuxtrc\' file to prevent @nuxt/test-utils setup from running automatically when dev server starts. Continue?',
+      })
     } catch (error) {
-      console.error('Error creating \'.nuxtrc\':\n', error.message)
+      console.error('[Nuxt Spec] Error creating \'.nuxtrc\':\n', error.message)
     }
   }
 
   // 6) modify package.json with test scripts
   try {
-    await updateJsonFile('package.json', 'scripts', {
-      'test': 'vitest run',
-      'test-u': 'vitest run -u',
-      'test-i': 'vitest',
-    }, isAutoRun, 'This will adjust the test-related commands in your \'package.json\'. Continue?')
+    await updateJsonFile({
+      targetFile: 'package.json',
+      jsonKey: 'scripts',
+      patch: {
+        'test': 'vitest run',
+        'test-u': 'vitest run -u',
+        'test-i': 'vitest',
+      },
+      force: isAutoRun,
+      prompt: '[Nuxt Spec] This will adjust the test-related commands in your \'package.json\'. Continue?',
+    })
   } catch (error) {
-    console.error('Error adjusting scripts in \'package.json\':\n', error.message)
+    console.error('[Nuxt Spec] Error adjusting scripts in \'package.json\':\n', error.message)
   }
 
   // 7) create sample test files
-  const createSampleTests = isAutoRun || await promptUser('Do you want to create sample tests in \'/test\' folder?')
+  const createSampleTests = isAutoRun || await promptUser({ question: '[Nuxt Spec] Do you want to create sample tests in \'/test\' folder?' })
   if (createSampleTests) {
     try {
-      await createFileFromWebTemplate(`https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/browser/vitest-browser.test.ts`,
-        'test/browser/vitest-browser.test.ts', true)
+      await createFileFromWebTemplate({
+        url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/browser/vitest-browser.test.ts`,
+        targetFile: 'test/browser/vitest-browser.test.ts',
+        force: true,
+      })
+    } catch (error) {
+      console.error('[Nuxt Spec] Error setting up \'vitest-browser.test.ts\':\n', error.message)
+    }
+    try {
+      await createFileFromWebTemplate({
+        url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/e2e/nuxt-e2e.test.ts`,
+        targetFile: 'test/e2e/nuxt-e2e.test.ts',
+        force: true,
+      })
     } catch (error) {
-      console.error('Error setting up \'vitest-browser.test.ts\':\n', error.message)
+      console.error('[Nuxt Spec] Error setting up \'nuxt-e2e.test.ts\':\n', error.message)
     }
     try {
-      await createFileFromWebTemplate(`https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/e2e/nuxt-e2e.test.ts`,
-        'test/e2e/nuxt-e2e.test.ts', true)
+      await createFileFromWebTemplate({
+        url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/e2e/nuxt-visual.test.ts`,
+        targetFile: 'test/e2e/nuxt-visual.test.ts',
+        force: true,
+      })
     } catch (error) {
-      console.error('Error setting up \'nuxt-e2e.test.ts\':\n', error.message)
+      console.error('[Nuxt Spec] Error setting up \'nuxt-visual.test.ts\':\n', error.message)
     }
+    // pre-existing baseline ensures the sample "wrong" visual test fails as intended
     try {
-      await createFileFromWebTemplate(`https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/e2e/nuxt-visual.test.ts`,
-        'test/e2e/nuxt-visual.test.ts', true)
+      await createFileFromWebTemplate({
+        url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/e2e/__baseline__/wrong.png`,
+        targetFile: 'test/e2e/__baseline__/wrong.png',
+        force: true,
+      })
     } catch (error) {
-      console.error('Error setting up \'nuxt-visual.test.ts\':\n', error.message)
+      console.error('[Nuxt Spec] Error setting up \'wrong.png\':\n', error.message)
     }
     try {
-      await createFileFromWebTemplate(`https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/nuxt/nuxt-unit.test.ts`,
-        'test/nuxt/nuxt-unit.test.ts', true)
+      await createFileFromWebTemplate({
+        url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/nuxt/nuxt-unit.test.ts`,
+        targetFile: 'test/nuxt/nuxt-unit.test.ts',
+        force: true,
+      })
     } catch (error) {
-      console.error('Error setting up \'nuxt-unit.test.ts\':\n', error.message)
+      console.error('[Nuxt Spec] Error setting up \'nuxt-unit.test.ts\':\n', error.message)
     }
     try {
-      await createFileFromWebTemplate(`https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/unit/vitest-unit.test.ts`,
-        'test/unit/vitest-unit.test.ts', true)
+      await createFileFromWebTemplate({
+        url: `https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v${TARGET_VERSION}/test/unit/vitest-unit.test.ts`,
+        targetFile: 'test/unit/vitest-unit.test.ts',
+        force: true,
+      })
     } catch (error) {
-      console.error('Error setting up \'vitest-unit.test.ts\':\n', error.message)
+      console.error('[Nuxt Spec] Error setting up \'vitest-unit.test.ts\':\n', error.message)
     }
   }
 
-  // 8) clear node_modules and lock file(s)
-  const prepareForReinstall = isAutoRun || await promptUser('Dependencies should be re-installed now. Do you want to remove node_modules and the lock file?')
+  // 8) add nuxt-spec related entries to .gitignore
+  try {
+    const gitignoreEntries = [
+      ['# vitest output folder', '.vitest'],
+      ['# nuxt-spec screenshots folder', '__current__'],
+      ['# nuxt-spec HTML test reports folder', '__reports__'],
+    ]
+    // if .gitignore exists, we rather check for duplicates
+    const gitignoreExists = pathExists({ targetPath: '.gitignore' })
+    const gitignoreRows = gitignoreExists ? readFileSync('.gitignore', 'utf8').split(/\r?\n/) : []
+    const rowsToAdd = gitignoreEntries
+      .filter(([, entry]) => !gitignoreRows.includes(entry))
+      .flatMap(([comment, entry]) => ['', comment, entry])
+      .slice(gitignoreExists ? 0 : 1)
+    //
+    if (rowsToAdd.length > 0) {
+      await updateTextFile({
+        targetFile: '.gitignore',
+        rowsToAdd,
+        allowDuplicates: true,
+        createMissing: true,
+        force: isAutoRun,
+        prompt: '[Nuxt Spec] This will add nuxt-spec related entries to your \'.gitignore\' file. Continue?',
+      })
+    }
+  } catch (error) {
+    console.error('[Nuxt Spec] Error updating \'.gitignore\':\n', error.message)
+  }
+
+  // 9) clear node_modules and lock file(s)
+  const prepareForReinstall = isAutoRun || await promptUser({ question: '[Nuxt Spec] Dependencies should be re-installed now. Do you want to remove node_modules and the lock file?' })
   if (prepareForReinstall) {
-    if (pathExists('node_modules')) {
+    if (pathExists({ targetPath: 'node_modules' })) {
       try {
-        await deletePath('node_modules', true)
+        await deletePath({ targetPath: 'node_modules', force: true })
       } catch (error) {
-        console.error('Error deleting \'node_modules\':\n', error.message)
+        console.error('[Nuxt Spec] Error deleting \'node_modules\':\n', error.message)
       }
     }
-    if (pathExists('package-lock.json')) {
+    if (pathExists({ targetPath: 'package-lock.json' })) {
       try {
-        await deletePath('package-lock.json', true)
+        await deletePath({ targetPath: 'package-lock.json', force: true })
       } catch (error) {
-        console.error('Error deleting \'package-lock.json\':\n', error.message)
+        console.error('[Nuxt Spec] Error deleting \'package-lock.json\':\n', error.message)
       }
     }
-    if (pathExists('pnpm-lock.yaml')) {
+    if (pathExists({ targetPath: 'pnpm-lock.yaml' })) {
       try {
-        await deletePath('pnpm-lock.yaml', true)
+        await deletePath({ targetPath: 'pnpm-lock.yaml', force: true })
       } catch (error) {
-        console.error('Error deleting \'pnpm-lock.yaml\':\n', error.message)
+        console.error('[Nuxt Spec] Error deleting \'pnpm-lock.yaml\':\n', error.message)
       }
     }
-    if (pathExists('yarn.lock')) {
+    if (pathExists({ targetPath: 'yarn.lock' })) {
       try {
-        await deletePath('yarn.lock', true)
+        await deletePath({ targetPath: 'yarn.lock', force: true })
       } catch (error) {
-        console.error('Error deleting \'yarn.lock\':\n', error.message)
+        console.error('[Nuxt Spec] Error deleting \'yarn.lock\':\n', error.message)
       }
     }
-    if (pathExists('bun.lockb')) {
+    if (pathExists({ targetPath: 'bun.lockb' })) {
       try {
-        await deletePath('bun.lockb', true)
+        await deletePath({ targetPath: 'bun.lockb', force: true })
       } catch (error) {
-        console.error('Error deleting \'bun.lockb\':\n', error.message)
+        console.error('[Nuxt Spec] Error deleting \'bun.lockb\':\n', error.message)
       }
     }
-    if (pathExists('deno.lock')) {
+    if (pathExists({ targetPath: 'deno.lock' })) {
       try {
-        await deletePath('deno.lock', true)
+        await deletePath({ targetPath: 'deno.lock', force: true })
       } catch (error) {
-        console.error('Error deleting \'deno.lock\':\n', error.message)
+        console.error('[Nuxt Spec] Error deleting \'deno.lock\':\n', error.message)
       }
     }
   }
 
-  // 9) run install command
-  const runInstall = isAutoRun || await promptUser(`Fresh \`${packageManager} install\` is required. Do you want to run it now?`)
+  // 10) run install command
+  const runInstall = isAutoRun || await promptUser({ question: `[Nuxt Spec] Fresh \`${packageManager} install\` is required. Do you want to run it now?` })
   if (runInstall) {
     try {
-      showMessage(`Running \`${packageManager} install\`...`)
+      showMessage({ message: `Running \`${packageManager} install\`...` })
       execSync(`${packageManager} install`, { stdio: 'inherit' })
     } catch (error) {
-      console.error(`Error running \`${packageManager} install\`:\n`, error.message)
+      console.error(`[Nuxt Spec] Error running \`${packageManager} install\`:\n`, error.message)
     }
   }
 
-  // 10) run Playwright browser install command
+  // 11) run Nuxt prepare command to generate types and auto-imports
+  const prepareCmd = getPrepareCmd(packageManager)
+  const runPrepare = isAutoRun || await promptUser({ question: `[Nuxt Spec] Nuxt needs to generate types and auto-imports before the project is fully usable. Do you want to run \`${prepareCmd}\` now?` })
+  if (runPrepare) {
+    try {
+      showMessage({ message: `Running \`${prepareCmd}\`...` })
+      execSync(prepareCmd, { stdio: 'inherit' })
+    } catch (error) {
+      console.error(`[Nuxt Spec] Error running \`${prepareCmd}\`:\n`, error.message)
+    }
+  }
+
+  // 12) run Playwright browser install command
   const playwrightInstallCmd = getPlaywrightInstallCmd(packageManager)
-  const runPlaywrightInstall = isAutoRun || await promptUser(`Playwright browser runtimes might need to be installed locally for e2e tests. Do you want to run \`${playwrightInstallCmd}\` now?`)
+  const runPlaywrightInstall = isAutoRun || await promptUser({ question: `[Nuxt Spec] Playwright browser runtimes might need to be installed locally for e2e tests. Do you want to run \`${playwrightInstallCmd}\` now?` })
   if (runPlaywrightInstall) {
     try {
-      showMessage(`Running \`${playwrightInstallCmd}\`...`)
+      showMessage({ message: `Running \`${playwrightInstallCmd}\`...` })
       execSync(playwrightInstallCmd, { stdio: 'inherit' })
     } catch (error) {
-      console.error(`Error running \`${playwrightInstallCmd}\`:\n`, error.message)
+      console.error(`[Nuxt Spec] Error running \`${playwrightInstallCmd}\`:\n`, error.message)
     }
   }
 
-  // 11) inform user
-  showMessage('')
-  showMessage('NUXT SPEC SETUP COMPLETE', 2)
+  // 13) inform user
+  showMessage({ message: '' })
+  showMessage({ message: 'NUXT SPEC SETUP COMPLETE', linesAfter: 2 })
   if (!runInstall) {
-    showMessage(`Proceed with \`${packageManager} install\` to install dependencies.`)
+    showMessage({ message: `Proceed with \`${packageManager} install\` to install dependencies.` })
+  }
+  if (!runPrepare) {
+    showMessage({ message: `Run \`${prepareCmd}\` to generate the required Nuxt types and auto-imports.` })
   }
   if (!runPlaywrightInstall) {
-    showMessage(`Run \`${playwrightInstallCmd}\` to setup the Playwright browser runtimes for e2e tests.`)
+    showMessage({ message: `Run \`${playwrightInstallCmd}\` to setup the Playwright browser runtimes for e2e tests.` })
   }
 
   // force exit to prevent #20