nuxt-spec 0.4.0-alpha.2 → 0.4.0-alpha.3

package/utils/helpers/screenshot-utils.ts

@@ -1,27 +1,27 @@
-import { resolve, sep } from 'node:path'
-import type { DecodedPng } from 'fast-png'
-
-// helper to keep user-provided targetDir inside the current project root
-export function resolveWithin(base: string, segment: string): string {
-  const target = resolve(base, segment)
-  if (target !== base && !target.startsWith(base + sep)) {
-    throw new Error(`[Nuxt Spec] Invalid path: "${segment}" resolves outside of "${base}"`)
-  }
-  return target
-}
-
-// helper for bridging difference between Vitest PNG saving and fast-png encoding
-export function toRGBA(img: DecodedPng): Uint8Array {
-  const { width, height, data, channels = 4 } = img
-  if (channels === 4) return data as Uint8Array
-  const pixels = width * height
-  const rgba = new Uint8Array(pixels * 4)
-  for (let i = 0; i < pixels; i++) {
-    const src = i * 3
-    rgba[i * 4 + 0] = data[src + 0] ?? 0
-    rgba[i * 4 + 1] = data[src + 1] ?? 0
-    rgba[i * 4 + 2] = data[src + 2] ?? 0
-    rgba[i * 4 + 3] = 255
-  }
-  return rgba
-}
+import { resolve, sep } from 'node:path'
+import type { DecodedPng } from 'fast-png'
+
+// helper to keep user-provided targetDir inside the current project root
+export function resolveWithin(base: string, segment: string): string {
+  const target = resolve(base, segment)
+  if (target !== base && !target.startsWith(base + sep)) {
+    throw new Error(`[Nuxt Spec] Invalid path: "${segment}" resolves outside of "${base}"`)
+  }
+  return target
+}
+
+// helper for bridging difference between Vitest PNG saving and fast-png encoding
+export function toRGBA(img: DecodedPng): Uint8Array {
+  const { width, height, data, channels = 4 } = img
+  if (channels === 4) return data as Uint8Array
+  const pixels = width * height
+  const rgba = new Uint8Array(pixels * 4)
+  for (let i = 0; i < pixels; i++) {
+    const src = i * 3
+    rgba[i * 4 + 0] = data[src + 0] ?? 0
+    rgba[i * 4 + 1] = data[src + 1] ?? 0
+    rgba[i * 4 + 2] = data[src + 2] ?? 0
+    rgba[i * 4 + 3] = 255
+  }
+  return rgba
+}

package/utils/index.ts

@@ -1,12 +1,12 @@
-import { gotoPage, getDataHtml, getAPIResultHtml } from './e2e'
-import { compareScreenshot } from './screenshot'
-import type { CompareScreenshotOptions } from './screenshot'
-
-export {
-  compareScreenshot,
-  gotoPage,
-  getDataHtml,
-  getAPIResultHtml,
-}
-
-export type { CompareScreenshotOptions }
+import { gotoPage, getDataHtml, getAPIResultHtml } from './e2e'
+import { compareScreenshot } from './screenshot'
+import type { CompareScreenshotOptions } from './screenshot'
+
+export {
+  compareScreenshot,
+  gotoPage,
+  getDataHtml,
+  getAPIResultHtml,
+}
+
+export type { CompareScreenshotOptions }

package/utils/playwright.ts

@@ -1,28 +1,28 @@
-// Vitest setup file for the `e2e` project
-// allows connecting to an external Playwright instance,
-// if `spec.externalPlaywright` or NUXT_SPEC_EXTERNAL_PLAYWRIGHT is set
-
-import { inject } from 'vitest'
-import { chromium, firefox, webkit } from 'playwright-core'
-import type { Browser, BrowserType } from 'playwright-core'
-
-declare module 'vitest' {
-  interface ProvidedContext {
-    nuxtSpecExternalPlaywright?: string
-  }
-}
-
-// resolved and provided by `loadVitestConfig` (config/index.mjs)
-const externalPlaywright = inject('nuxtSpecExternalPlaywright')
-
-if (externalPlaywright) {
-  console.log(`[Nuxt Spec] Using external Playwright instance for e2e tests at: ${externalPlaywright}`)
-  for (const browserType of [chromium, firefox, webkit] as BrowserType[]) {
-    // @nuxt/test-utils always calls `playwright[type].launch()` with no way to opt into
-    // `connect()`, so the launch method is swapped for a connect against the WS endpoint
-    browserType.launch = (): Promise<Browser> => browserType.connect(externalPlaywright, {
-      // this allows reaching caller's localhost from within the external Playwright
-      exposeNetwork: '<loopback>',
-    })
-  }
-}
+// Vitest setup file for the `e2e` project
+// allows connecting to an external Playwright instance,
+// if `spec.externalPlaywright` or NUXT_SPEC_EXTERNAL_PLAYWRIGHT is set
+
+import { inject } from 'vitest'
+import { chromium, firefox, webkit } from 'playwright-core'
+import type { Browser, BrowserType } from 'playwright-core'
+
+declare module 'vitest' {
+  interface ProvidedContext {
+    nuxtSpecExternalPlaywright?: string
+  }
+}
+
+// resolved and provided by `loadVitestConfig` (config/index.mjs)
+const externalPlaywright = inject('nuxtSpecExternalPlaywright')
+
+if (externalPlaywright) {
+  console.log(`[Nuxt Spec] Using external Playwright instance for e2e tests at: ${externalPlaywright}`)
+  for (const browserType of [chromium, firefox, webkit] as BrowserType[]) {
+    // @nuxt/test-utils always calls `playwright[type].launch()` with no way to opt into
+    // `connect()`, so the launch method is swapped for a connect against the WS endpoint
+    browserType.launch = (): Promise<Browser> => browserType.connect(externalPlaywright, {
+      // this allows reaching caller's localhost from within the external Playwright
+      exposeNetwork: '<loopback>',
+    })
+  }
+}

package/utils/screenshot.ts

@@ -1,201 +1,201 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
-import { resolve } from 'node:path'
-import { decode } from 'fast-png'
-import { expect, recordArtifact, TestRunner } from 'vitest'
-import type { TestArtifactBase, TestAttachment } from 'vitest'
-import { resolveWithin, toRGBA } from './helpers/screenshot-utils'
-import pixelmatch from 'pixelmatch'
-import type { GotoOptions, NuxtPage } from '@nuxt/test-utils'
-import { checkNumberParam, checkPageParam, checkStringParam } from './helpers/check-params'
-import { gotoPage } from './e2e'
-
-/**
- * Test artifact recorded by `compareScreenshot()` on mismatch.
- * It is consumed by the Nuxt Spec HTML reporter.
- */
-export interface NuxtSpecScreenshotArtifact extends TestArtifactBase {
-  type: 'nuxt-spec:screenshot'
-  /** Name of the compared PNG file */
-  fileName: string
-  /** Description of the mismatch */
-  message: string
-  attachments: Array<TestAttachment & { name: 'baseline' | 'actual' }>
-}
-
-declare module 'vitest' {
-  interface TestArtifactRegistry {
-    'nuxt-spec:screenshot': NuxtSpecScreenshotArtifact
-  }
-}
-
-/**
- * Extra settings object for `compareScreenshot()` function.
- * All properties are optional.
- */
-export type CompareScreenshotOptions = {
-  /** Event to be awaited before NuxtPage instance is returned (defaults to `'hydration'`) */
-  waitUntil?: GotoOptions['waitUntil']
-  /** Name of the PNG file used for baseline storage and comparison (defaults to route and `index.png` for `/`) */
-  fileName?: string
-  /** Directory for baseline/current screenshots, relative to project root (defaults to `test/e2e`) */
-  targetDir?: string
-  /** CSS selector for a specific element to capture (defaults to full page) */
-  selector?: string
-  /** Max ratio of different pixels (0–1). Default: 0 (exact match) */
-  maxDiffPixelRatio?: number
-  /** Max absolute number of different pixels. Takes precedence over `maxDiffPixelRatio` when set. Default: 0 (exact match) */
-  maxDiffPixels?: number
-  /** Per-pixel color distance threshold (0–1). Lower = stricter. Default: 0.1 */
-  threshold?: number
-}
-
-/**
- * Capture a browser screenshot and compare it against a stored baseline PNG.
- * When run with `-u` / `--update`, or when no baseline exists yet, the current
- * screenshot is saved as the new baseline.
- *
- * Comparison uses pixelmatch for perceptual pixel diffing. By default,
- * zero differing pixels are allowed (exact match). Set `maxDiffPixelRatio`
- * or `maxDiffPixels` to tolerate cross-platform rendering differences.
- *
- * @param page - Playwright page instance, or a page name string (will call `gotoPage` internally)
- * @param options - Optional extra settings (see `CompareScreenshotOptions`)
- * @returns `true` when the screenshot matches the baseline (or a new baseline was saved)
- * @throws Fails the current Vitest test when a mismatch is detected
- */
-export async function compareScreenshot(page: NuxtPage | string, options?: CompareScreenshotOptions): Promise<boolean> {
-  const { waitUntil, fileName, targetDir, selector, maxDiffPixelRatio, maxDiffPixels, threshold } = options || {}
-
-  // get NuxtPage instance
-  const pageInstance = typeof page === 'string' ? await gotoPage(page, { waitUntil }) : page
-  checkPageParam('compareScreenshot:pageInstance', pageInstance)
-
-  // verify params
-  if (typeof page === 'string') {
-    checkStringParam('compareScreenshot:page', page)
-  }
-  if (waitUntil) {
-    checkStringParam('compareScreenshot:options.waitUntil', waitUntil)
-  }
-  if (fileName) {
-    checkStringParam('compareScreenshot:options.fileName', fileName)
-  }
-  if (targetDir) {
-    checkStringParam('compareScreenshot:options.targetDir', targetDir)
-  }
-  if (selector) {
-    checkStringParam('compareScreenshot:options.selector', selector)
-  }
-  if (maxDiffPixelRatio !== undefined) {
-    checkNumberParam('compareScreenshot:options.maxDiffPixelRatio', maxDiffPixelRatio)
-  }
-  if (maxDiffPixels !== undefined) {
-    checkNumberParam('compareScreenshot:options.maxDiffPixels', maxDiffPixels)
-  }
-  if (threshold !== undefined) {
-    checkNumberParam('compareScreenshot:options.threshold', threshold)
-  }
-
-  // ensure the target directory stays within the project root
-  const root = process.cwd()
-  const dir = resolveWithin(root, targetDir ?? 'test/e2e')
-  mkdirSync(dir, { recursive: true })
-
-  // ensure baseline/current directories exist
-  const baselineDir = resolve(dir, '__baseline__')
-  mkdirSync(baselineDir, { recursive: true })
-  const currentDir = resolve(dir, '__current__')
-  mkdirSync(currentDir, { recursive: true })
-
-  // compute screenshot file name
-  const route = pageInstance.url().substring(pageInstance.url().lastIndexOf('/') + 1) || 'index'
-  const screenshotFile = fileName ?? `${route}.png`
-
-  // warning on custom non-png file extensions
-  if (!screenshotFile.toLowerCase().endsWith('.png')) {
-    console.warn(`[Nuxt Spec] Screenshots from \`compareScreenshot\` are always saved as PNG. Consider different file name than '${screenshotFile}'.`)
-  }
-
-  // ensure the file name cannot escape its target directory
-  const baselinePath = resolveWithin(baselineDir, screenshotFile)
-  const currentPath = resolveWithin(currentDir, screenshotFile)
-
-  // capture element specified by locator or a full-page screenshot as PNG
-  const screenshot = selector
-    ? await pageInstance.locator(selector).screenshot()
-    : await pageInstance.screenshot({ fullPage: true })
-
-  // always save the current screenshot for inspection
-  writeFileSync(currentPath, screenshot)
-
-  // save baseline if not exist yet
-  if (!existsSync(baselinePath)) {
-    writeFileSync(baselinePath, screenshot)
-    return true
-  }
-
-  // @ts-expect-error - this is reliable way of reading Vitest "update" flag
-  const updateFlag = expect.getState().snapshotState?._updateSnapshot === 'all'
-
-  // compare against stored baseline PNG using pixelmatch
-  const baseline = readFileSync(baselinePath)
-  const baselineImg = decode(baseline)
-  const actualImg = decode(screenshot)
-  const { width, height } = baselineImg
-
-  if (actualImg.width !== width || actualImg.height !== height) {
-    // overwrite baseline if Vitest update flag is set
-    if (updateFlag) {
-      writeFileSync(baselinePath, screenshot)
-      return true
-    }
-    // otherwise report failure
-    const message = `Screenshot size mismatch: expected ${width}x${height}, got ${actualImg.width}x${actualImg.height}. Actual saved to: ${currentPath}`
-    await reportMismatch(screenshotFile, message, baseline, screenshot)
-    expect.fail(message)
-  }
-
-  const diffCount = pixelmatch(toRGBA(baselineImg), toRGBA(actualImg), undefined, width, height, {
-    threshold: threshold ?? 0.1,
-  })
-
-  const totalPixels = width * height
-  const maxAllowed = maxDiffPixels ?? Math.ceil(totalPixels * (maxDiffPixelRatio ?? 0))
-
-  if (diffCount > maxAllowed) {
-    // overwrite baseline if Vitest update flag is set
-    if (updateFlag) {
-      writeFileSync(baselinePath, screenshot)
-      return true
-    }
-    // otherwise report failure
-    const ratio = (diffCount / totalPixels * 100).toFixed(2)
-    const message = `Screenshot mismatch: ${diffCount} pixels differ (${ratio}%), allowed ${maxAllowed}. Actual saved to: ${currentPath}`
-    await reportMismatch(screenshotFile, message, baseline, screenshot)
-    expect.fail(message)
-  }
-
-  return true
-}
-
-// pass the baseline/actual pair to the Nuxt Spec HTML reporter via Vitest test artifacts
-// best-effort only - it must never mask the actual assertion failure
-async function reportMismatch(fileName: string, message: string, baseline: Uint8Array, actual: Uint8Array): Promise<void> {
-  // undefined when called outside of a running test (e.g. in `beforeAll`)
-  const test = TestRunner.getCurrentTest()
-  if (!test) return
-
-  try {
-    await recordArtifact(test, {
-      type: 'nuxt-spec:screenshot',
-      fileName,
-      message,
-      attachments: [
-        { name: 'baseline', contentType: 'image/png', body: baseline },
-        { name: 'actual', contentType: 'image/png', body: actual },
-      ],
-    })
-  } catch {
-    // reporting is optional
-  }
-}
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { decode } from 'fast-png'
+import { expect, recordArtifact, TestRunner } from 'vitest'
+import type { TestArtifactBase, TestAttachment } from 'vitest'
+import { resolveWithin, toRGBA } from './helpers/screenshot-utils'
+import pixelmatch from 'pixelmatch'
+import type { GotoOptions, NuxtPage } from '@nuxt/test-utils'
+import { checkNumberParam, checkPageParam, checkStringParam } from './helpers/check-params'
+import { gotoPage } from './e2e'
+
+/**
+ * Test artifact recorded by `compareScreenshot()` on mismatch.
+ * It is consumed by the Nuxt Spec HTML reporter.
+ */
+export interface NuxtSpecScreenshotArtifact extends TestArtifactBase {
+  type: 'nuxt-spec:screenshot'
+  /** Name of the compared PNG file */
+  fileName: string
+  /** Description of the mismatch */
+  message: string
+  attachments: Array<TestAttachment & { name: 'baseline' | 'actual' }>
+}
+
+declare module 'vitest' {
+  interface TestArtifactRegistry {
+    'nuxt-spec:screenshot': NuxtSpecScreenshotArtifact
+  }
+}
+
+/**
+ * Extra settings object for `compareScreenshot()` function.
+ * All properties are optional.
+ */
+export type CompareScreenshotOptions = {
+  /** Event to be awaited before NuxtPage instance is returned (defaults to `'hydration'`) */
+  waitUntil?: GotoOptions['waitUntil']
+  /** Name of the PNG file used for baseline storage and comparison (defaults to route and `index.png` for `/`) */
+  fileName?: string
+  /** Directory for baseline/current screenshots, relative to project root (defaults to `test/e2e`) */
+  targetDir?: string
+  /** CSS selector for a specific element to capture (defaults to full page) */
+  selector?: string
+  /** Max ratio of different pixels (0–1). Default: 0 (exact match) */
+  maxDiffPixelRatio?: number
+  /** Max absolute number of different pixels. Takes precedence over `maxDiffPixelRatio` when set. Default: 0 (exact match) */
+  maxDiffPixels?: number
+  /** Per-pixel color distance threshold (0–1). Lower = stricter. Default: 0.1 */
+  threshold?: number
+}
+
+/**
+ * Capture a browser screenshot and compare it against a stored baseline PNG.
+ * When run with `-u` / `--update`, or when no baseline exists yet, the current
+ * screenshot is saved as the new baseline.
+ *
+ * Comparison uses pixelmatch for perceptual pixel diffing. By default,
+ * zero differing pixels are allowed (exact match). Set `maxDiffPixelRatio`
+ * or `maxDiffPixels` to tolerate cross-platform rendering differences.
+ *
+ * @param page - Playwright page instance, or a page name string (will call `gotoPage` internally)
+ * @param options - Optional extra settings (see `CompareScreenshotOptions`)
+ * @returns `true` when the screenshot matches the baseline (or a new baseline was saved)
+ * @throws Fails the current Vitest test when a mismatch is detected
+ */
+export async function compareScreenshot(page: NuxtPage | string, options?: CompareScreenshotOptions): Promise<boolean> {
+  const { waitUntil, fileName, targetDir, selector, maxDiffPixelRatio, maxDiffPixels, threshold } = options || {}
+
+  // get NuxtPage instance
+  const pageInstance = typeof page === 'string' ? await gotoPage(page, { waitUntil }) : page
+  checkPageParam('compareScreenshot:pageInstance', pageInstance)
+
+  // verify params
+  if (typeof page === 'string') {
+    checkStringParam('compareScreenshot:page', page)
+  }
+  if (waitUntil) {
+    checkStringParam('compareScreenshot:options.waitUntil', waitUntil)
+  }
+  if (fileName) {
+    checkStringParam('compareScreenshot:options.fileName', fileName)
+  }
+  if (targetDir) {
+    checkStringParam('compareScreenshot:options.targetDir', targetDir)
+  }
+  if (selector) {
+    checkStringParam('compareScreenshot:options.selector', selector)
+  }
+  if (maxDiffPixelRatio !== undefined) {
+    checkNumberParam('compareScreenshot:options.maxDiffPixelRatio', maxDiffPixelRatio)
+  }
+  if (maxDiffPixels !== undefined) {
+    checkNumberParam('compareScreenshot:options.maxDiffPixels', maxDiffPixels)
+  }
+  if (threshold !== undefined) {
+    checkNumberParam('compareScreenshot:options.threshold', threshold)
+  }
+
+  // ensure the target directory stays within the project root
+  const root = process.cwd()
+  const dir = resolveWithin(root, targetDir ?? 'test/e2e')
+  mkdirSync(dir, { recursive: true })
+
+  // ensure baseline/current directories exist
+  const baselineDir = resolve(dir, '__baseline__')
+  mkdirSync(baselineDir, { recursive: true })
+  const currentDir = resolve(dir, '__current__')
+  mkdirSync(currentDir, { recursive: true })
+
+  // compute screenshot file name
+  const route = pageInstance.url().substring(pageInstance.url().lastIndexOf('/') + 1) || 'index'
+  const screenshotFile = fileName ?? `${route}.png`
+
+  // warning on custom non-png file extensions
+  if (!screenshotFile.toLowerCase().endsWith('.png')) {
+    console.warn(`[Nuxt Spec] Screenshots from \`compareScreenshot\` are always saved as PNG. Consider different file name than '${screenshotFile}'.`)
+  }
+
+  // ensure the file name cannot escape its target directory
+  const baselinePath = resolveWithin(baselineDir, screenshotFile)
+  const currentPath = resolveWithin(currentDir, screenshotFile)
+
+  // capture element specified by locator or a full-page screenshot as PNG
+  const screenshot = selector
+    ? await pageInstance.locator(selector).screenshot()
+    : await pageInstance.screenshot({ fullPage: true })
+
+  // always save the current screenshot for inspection
+  writeFileSync(currentPath, screenshot)
+
+  // save baseline if not exist yet
+  if (!existsSync(baselinePath)) {
+    writeFileSync(baselinePath, screenshot)
+    return true
+  }
+
+  // @ts-expect-error - this is reliable way of reading Vitest "update" flag
+  const updateFlag = expect.getState().snapshotState?._updateSnapshot === 'all'
+
+  // compare against stored baseline PNG using pixelmatch
+  const baseline = readFileSync(baselinePath)
+  const baselineImg = decode(baseline)
+  const actualImg = decode(screenshot)
+  const { width, height } = baselineImg
+
+  if (actualImg.width !== width || actualImg.height !== height) {
+    // overwrite baseline if Vitest update flag is set
+    if (updateFlag) {
+      writeFileSync(baselinePath, screenshot)
+      return true
+    }
+    // otherwise report failure
+    const message = `Screenshot size mismatch: expected ${width}x${height}, got ${actualImg.width}x${actualImg.height}. Actual saved to: ${currentPath}`
+    await reportMismatch(screenshotFile, message, baseline, screenshot)
+    expect.fail(message)
+  }
+
+  const diffCount = pixelmatch(toRGBA(baselineImg), toRGBA(actualImg), undefined, width, height, {
+    threshold: threshold ?? 0.1,
+  })
+
+  const totalPixels = width * height
+  const maxAllowed = maxDiffPixels ?? Math.ceil(totalPixels * (maxDiffPixelRatio ?? 0))
+
+  if (diffCount > maxAllowed) {
+    // overwrite baseline if Vitest update flag is set
+    if (updateFlag) {
+      writeFileSync(baselinePath, screenshot)
+      return true
+    }
+    // otherwise report failure
+    const ratio = (diffCount / totalPixels * 100).toFixed(2)
+    const message = `Screenshot mismatch: ${diffCount} pixels differ (${ratio}%), allowed ${maxAllowed}. Actual saved to: ${currentPath}`
+    await reportMismatch(screenshotFile, message, baseline, screenshot)
+    expect.fail(message)
+  }
+
+  return true
+}
+
+// pass the baseline/actual pair to the Nuxt Spec HTML reporter via Vitest test artifacts
+// best-effort only - it must never mask the actual assertion failure
+async function reportMismatch(fileName: string, message: string, baseline: Uint8Array, actual: Uint8Array): Promise<void> {
+  // undefined when called outside of a running test (e.g. in `beforeAll`)
+  const test = TestRunner.getCurrentTest()
+  if (!test) return
+
+  try {
+    await recordArtifact(test, {
+      type: 'nuxt-spec:screenshot',
+      fileName,
+      message,
+      attachments: [
+        { name: 'baseline', contentType: 'image/png', body: baseline },
+        { name: 'actual', contentType: 'image/png', body: actual },
+      ],
+    })
+  } catch {
+    // reporting is optional
+  }
+}

package/bin/_internal/prepublish-check.js

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-
-import { createInterface } from 'node:readline'
-
-const rl = createInterface({ input: process.stdin, output: process.stdout })
-
-rl.question('Are you sure the current solution was properly tested and verified? (y/n) ', (answer) => {
-  rl.close()
-  if (answer.trim().toLowerCase().startsWith('y')) {
-    console.log('Proceeding with publish...')
-    process.exit(0)
-  } else {
-    console.error('Publish aborted. Please run the tests and try again.')
-    process.exit(1)
-  }
-})

package/bin/cli.js

@@ -1,53 +0,0 @@
-#!/usr/bin/env node
-
-import { getCmd, resolvePackageManager } from './helpers/commands.js'
-
-/**
- * CLI tool to scaffold necessary adjustments in project folder.
- *
- * Allows `setup`, `update` or `ci` to be passed as parameter.
- *
- * `ci` requires the target Git host (`github` or `gitlab`) as the next parameter,
- * the remaining optional parameters are shifted by one position (package manager is not used yet).
- *
- * Next (optional) parameter might be a boolean to indicate auto mode
- * (no prompts, force = true) or manual mode (with prompts, force = false).
- *
- * Next (optional) parameter allows explicitly passing the package manager
- * (`npm`, `pnpm`, `yarn`, `bun` or `deno`), bypassing auto-detection.
- */
-
-// get parameters passed by user
-const args = process.argv.slice(2);
-
-// execute actions based on first param
-// additional params might be passed into the called functions
-(async () => {
-  let status = 0
-  try {
-    const command = args[0]
-    const host = command === 'ci' ? args[1] : undefined
-    const [autoRunArg, packageManagerArg] = args.slice(command === 'ci' ? 2 : 1)
-    const packageManager = resolvePackageManager(packageManagerArg)
-    // CLI args are always strings, so 'false' must be parsed explicitly rather than treated as truthy
-    const autoRun = autoRunArg === 'true'
-    switch (command) {
-      case 'setup':
-        await (await import('./commands/setup.js')).specSetup(autoRun, packageManager)
-        break
-      case 'update':
-        await (await import('./commands/update.js')).specUpdate(autoRun, packageManager)
-        break
-      case 'ci':
-        await (await import('./commands/ci.js')).specCi(host, autoRun)
-        break
-      default:
-        console.log(`[Nuxt Spec] Usage: \`${getCmd(packageManager)} setup [true|false] [npm|pnpm|yarn|bun|deno]\`, \`${getCmd(packageManager)} update [true|false] [npm|pnpm|yarn|bun|deno]\` or \`${getCmd(packageManager)} ci <github|gitlab> [true|false]\``)
-        status = 1
-    }
-  } catch (error) {
-    console.error('[Nuxt Spec] CLI failed:', error.message)
-    status = 1
-  }
-  process.exit(status)
-})()