nuxt-spec 0.2.0-alpha.7 → 0.2.0-alpha.9

package/README.md

@@ -37,7 +37,7 @@ If you don't want to use the CLI tool, or you want to understand its flow better
 1) Add following dependency into your `package.json`:
 
 ```
-"nuxt-spec": "0.2.0-alpha.7"
+"nuxt-spec": "0.2.0-alpha.9"
 ```
 
 2) Add following section into your `nuxt.config.ts`:
@@ -48,10 +48,10 @@ extends: [
 ]
 ```
 
-3) Add `.npmrc` file with following content (if you don't have it yet):
+3) Add `pnpm-workspace.yaml` file with following content (if you don't have it yet):
 
 ```
-shamefully-hoist=true
+shamefullyHoist: true
 ```
 
 4) Add `vitest.config.ts` file with following content (if you don't have it yet):
@@ -89,7 +89,7 @@ test/
     └── vitest-unit.test.ts
 ```
 
-You can use sample files from the [project repository](https://github.com/AloisSeckar/nuxt-spec/tree/v0.2.0-alpha.7/test).
+You can use sample files from the [project repository](https://github.com/AloisSeckar/nuxt-spec/tree/v0.2.0-alpha.9/test).
 
 ### Install and execute
 
@@ -249,11 +249,11 @@ Planned future development:
 - reason about (not) using Vitest browser mode (or make it optional)
 - solution for visual regression testing - (currently there is experimental custom solution)
 
-See [CHANGELOG.md](https://github.com/AloisSeckar/nuxt-spec/blob/v0.2.0-alpha.7/CHANGELOG.md) for the latest updates and features.
+See [CHANGELOG.md](https://github.com/AloisSeckar/nuxt-spec/blob/v0.2.0-alpha.9/CHANGELOG.md) for the latest updates and features.
 
 ## Configuration
 
-By default, `nuxt-spec` uses Vitest configuration defined in [`/config/index.mjs`](https://github.com/AloisSeckar/nuxt-spec/blob/v0.2.0-alpha.7/config/index.mjs). The configuration is based on [Nuxt team recommendations](https://nuxt.com/docs/4.x/getting-started/testing) and our best judgement.
+By default, `nuxt-spec` uses Vitest configuration defined in [`/config/index.mjs`](https://github.com/AloisSeckar/nuxt-spec/blob/v0.2.0-alpha.9/config/index.mjs). The configuration is based on [Nuxt team recommendations](https://nuxt.com/docs/4.x/getting-started/testing) and our best judgement.
 
 To add/override your custom config, you can create (or scaffold via CLI tool) a file named `vitest.config.ts` in the root of your project with the following content:
 
@@ -357,7 +357,7 @@ const html: string = await getAPIResultHtml('/', '#api-fetch', '/your-api', '#ap
 const html: string = await getAPIResultHtml(page, '#api-fetch', '/your-api', '#api-result')
 ```
 
-For detailed description, see [utils.d.ts](https://github.com/AloisSeckar/nuxt-spec/blob/v0.2.0-alpha.7/utils/index.d.ts).
+For detailed description, see [utils.d.ts](https://github.com/AloisSeckar/nuxt-spec/blob/v0.2.0-alpha.9/utils/index.d.ts).
 
 ## Contact
 

package/app/app.vue

@@ -1,6 +1,6 @@
 <template>
   <div>
-    <h1>Nuxt Spec</h1>
+    <NuxtWelcome />
     <div>
       Test-pack layer for <a href="https://nuxt.com/">Nuxt</a> applications
     </div>

package/app/components/index.ts

@@ -0,0 +1,2 @@
+export { default as NuxtSpecTestComponent } from './NuxtSpecTestComponent.vue'
+export { default as NuxtSpecApiTestComponent } from './NuxtSpecApiTestComponent.vue'

package/bin/setup.js

@@ -14,7 +14,7 @@ import {
  * Then it:
  *  1) adds `nuxt-spec` into `package.json` dependencies and removes `nuxt`, `vue` and `vue-router` if present
  *  2) adds `extends: ['nuxt-spec']` to `nuxt.config.ts`
- *  3) creates/updates `.npmrc` file (only if pnpm is used)
+ *  3) creates/updates `pnpm-workspace.yaml` file (only if pnpm is used)
  *  4) creates default `vitest.config.ts` file
  *  5) adds test-related scripts and pnpm approved build scripts (if using pnpm) in `package.json`
  *  6) creates sample test files
@@ -37,7 +37,7 @@ export async function specSetup(autoRun = false) {
   // add nuxt-spec
   try {
     await updateJsonFile('package.json', 'dependencies', {
-      'nuxt-spec': '0.2.0-alpha.7',
+      'nuxt-spec': '0.2.0-alpha.9',
     }, isAutoRun, 'This will add \'nuxt-spec\' dependency to your \'package.json\'. Continue?')
   } catch (error) {
     console.error('Error adding \'nuxt-spec\' dependency:\n', error.message)
@@ -101,23 +101,23 @@ export async function specSetup(autoRun = false) {
     console.error('Error updating \'nuxt.config.ts\':\n', error.message)
   }
 
-  // 3) .npmrc file (only if pnpm is used)
+  // 3) `pnpm-workspace.yaml` file (only if pnpm is used)
   if (packageManager === 'pnpm') {
     try {
-      if (pathExists('.npmrc')) {
-        await updateTextFile('.npmrc', ['shamefully-hoist=true'], isAutoRun, 'This will adjust \'.npmrc\' file in your project. Continue?')
+      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?')
       } else {
-        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.7/.npmrc',
-          '.npmrc', isAutoRun, 'This will add \'.npmrc\' file for your project. Continue?')
+        await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.9/config/templates/pnpm-workspace.yaml.template',
+          'pnpm-workspace.yaml', isAutoRun, 'This will add \'pnpm-workspace.yaml\' file for your project. Continue?')
       }
     } catch (error) {
-      console.error('Error setting up \'.npmrc\':\n', error.message)
+      console.error('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/v0.2.0-alpha.7/config/vitest.config.ts.template',
+    await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.9/config/templates/vitest.config.ts.template',
       'vitest.config.ts', isAutoRun, '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)
@@ -155,31 +155,31 @@ export async function specSetup(autoRun = false) {
   const createSampleTests = isAutoRun || await promptUser('Do you want to create sample tests in \'/test\' folder?')
   if (createSampleTests) {
     try {
-      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.7/test/browser/vitest-browser.test.ts',
+      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.9/test/browser/vitest-browser.test.ts',
         'test/browser/vitest-browser.test.ts', true)
     } catch (error) {
       console.error('Error setting up \'vitest-browser.test.ts\':\n', error.message)
     }
     try {
-      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.7/test/e2e/nuxt-e2e.test.ts',
+      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.9/test/e2e/nuxt-e2e.test.ts',
         'test/e2e/nuxt-e2e.test.ts', true)
     } catch (error) {
       console.error('Error setting up \'nuxt-e2e.test.ts\':\n', error.message)
     }
     try {
-      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.7/test/e2e/nuxt-visual.test.ts',
+      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.9/test/e2e/nuxt-visual.test.ts',
         'test/e2e/nuxt-visual.test.ts', true)
     } catch (error) {
       console.error('Error setting up \'nuxt-visual.test.ts\':\n', error.message)
     }
     try {
-      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.7/test/nuxt/nuxt-unit.test.ts',
+      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.9/test/nuxt/nuxt-unit.test.ts',
         'test/nuxt/nuxt-unit.test.ts', true)
     } catch (error) {
       console.error('Error setting up \'nuxt-unit.test.ts\':\n', error.message)
     }
     try {
-      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.7/test/unit/vitest-unit.test.ts',
+      await createFileFromWebTemplate('https://raw.githubusercontent.com/AloisSeckar/nuxt-spec/refs/tags/v0.2.0-alpha.9/test/unit/vitest-unit.test.ts',
         'test/unit/vitest-unit.test.ts', true)
     } catch (error) {
       console.error('Error setting up \'vitest-unit.test.ts\':\n', error.message)

package/config/index.mjs

@@ -2,7 +2,8 @@
 // based on https://nuxt.com/docs/4.x/getting-started/testing#setup
 // `projects=false` can be used to suspend the default usage of "projects" in Vitest config
 
-import { mergeConfig } from './merge.js' // defu-based merge function
+import { onConsoleLog } from './utils/warnings.mjs' // filter out unnecessary logs
+import { mergeConfig } from './utils/merge.mjs' // defu-based merge function
 import { defineConfig } from 'vitest/config'
 import { defineVitestProject } from '@nuxt/test-utils/config'
 import { playwright } from '@vitest/browser-playwright'
@@ -10,7 +11,12 @@ import vue from '@vitejs/plugin-vue'
 
 export async function loadVitestConfig(userVitestConfig, projects = true) {
   const baseConfig = {
-    test: {},
+    test: {
+      // filter-out unnecessary console logs coming from Vitest
+      // when the import is resolved, unnecessary stderr logs are also filtered-out
+      // as a side-effect
+      onConsoleLog,
+    },
   }
 
   if (projects === true) {

package/config/templates/pnpm-workspace.yaml.template

@@ -0,0 +1,4 @@
+# settings for Nuxt & pnpm
+
+# https://pnpm.io/settings#shamefullyhoist
+shamefullyHoist: true

package/config/{merge.js → utils/merge.mjs}

@@ -8,7 +8,7 @@
 import { createDefu } from 'defu'
 
 // in real Vitest config, "name" is nested inside another "test" object
-const getProjectName = (project) => project?.name ?? project?.test?.name
+const getProjectName = project => project?.name ?? project?.test?.name
 
 export const mergeConfig = createDefu((obj, key, value) => {
   if (key === 'projects' && Array.isArray(obj[key]) && Array.isArray(value)) {

package/config/utils/warnings.mjs

@@ -0,0 +1,26 @@
+const messageFilters = [
+  // remove once @nuxt/test-utils starts depending on Vitest 4.1
+  // https://github.com/nuxt/test-utils/pull/1620
+  'Importing from "vitest/environments" is deprecated',
+  // Node+Windows false positive
+  // https://github.com/nuxt/icon/issues/140
+  'Use of deprecated trailing slash pattern mapping',
+  // remove once Vue stops considering <Suspense> experimental
+  '<Suspense> is an experimental feature',
+]
+
+// 1) filter-out unnecessary stderr logs coming from Vitest
+// (applied as side-effect on import)
+
+const _stderrWrite = process.stderr.write.bind(process.stderr)
+process.stderr.write = (chunk, ...args) => {
+  if (typeof chunk === 'string' && messageFilters.some(f => chunk.includes(f))) return true
+  return _stderrWrite(chunk, ...args)
+}
+
+// 2) filter-out unnecessary console logs coming from Vitest
+// (used as Vitest onConsoleLog hook)
+
+export function onConsoleLog(log) {
+  if (messageFilters.some(f => log.includes(f))) return false
+}

package/package.json

@@ -1,13 +1,29 @@
 {
   "name": "nuxt-spec",
-  "version": "0.2.0-alpha.7",
+  "version": "0.2.0-alpha.9",
   "description": "Test-pack layer for Nuxt Applications",
-  "repository": "github:AloisSeckar/nuxt-spec",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AloisSeckar/nuxt-spec.git"
+  },
   "license": "MIT",
   "type": "module",
   "main": "./nuxt.config.ts",
+  "scripts": {
+    "analyze": "nuxt analyze",
+    "eslint": "eslint .",
+    "build": "pnpm test && nuxt build",
+    "dev": "nuxt dev",
+    "generate": "nuxt generate",
+    "prepublishOnly": "pnpm build",
+    "preview": "nuxt preview",
+    "start": "nuxt start",
+    "test": "vitest run",
+    "test-u": "vitest run -u",
+    "test-i": "vitest"
+  },
   "bin": {
-    "nuxt-spec": "./bin/cli.js"
+    "nuxt-spec": "bin/cli.js"
   },
   "exports": {
     ".": "./nuxt.config.ts",
@@ -20,6 +36,10 @@
       "types": "./utils/index.d.ts",
       "import": "./utils/index.ts",
       "default": "./utils/index.ts"
+    },
+    "./components": {
+      "import": "./app/components/index.ts",
+      "default": "./app/components/index.ts"
     }
   },
   "files": [
@@ -38,27 +58,27 @@
     "@vitest/ui": "4.1.0",
     "@vue/test-utils": "2.4.6",
     "elrh-cosca": "0.3.5",
+    "fast-png": "8.0.0",
     "happy-dom": "20.8.4",
     "nuxt": "4.4.2",
     "pixelmatch": "7.1.0",
     "playwright-core": "1.58.2",
-    "fast-png": "8.0.0",
     "typescript": "5.9.3",
     "vitest": "4.1.0",
     "vitest-browser-vue": "2.1.0",
     "vue": "3.5.30",
     "vue-router": "5.0.3"
   },
-  "scripts": {
-    "analyze": "nuxt analyze",
-    "eslint": "eslint .",
-    "build": "pnpm test && nuxt build",
-    "dev": "nuxt dev",
-    "generate": "nuxt generate",
-    "preview": "nuxt preview",
-    "start": "nuxt start",
-    "test": "vitest run",
-    "test-u": "vitest run -u",
-    "test-i": "vitest"
-  }
-}
+  "pnpm": {
+    "overrides": {
+      "vite": "npm:vite@8.0.1",
+      "minimatch": "^9.0.9",
+      "tar": "^7.5.10",
+      "h3@^1.0.0": "^1.15.8",
+      "h3-next": "npm:h3@^2.0.1-rc.15",
+      "serialize-javascript": "^7.0.3",
+      "devalue": "^5.6.4"
+    }
+  },
+  "packageManager": "pnpm@10.32.1"
+}

package/utils/screenshot.ts

@@ -86,4 +86,4 @@ function toRGBA(img: DecodedPng): Uint8Array {
     rgba[i * 4 + 3] = 255
   }
   return rgba
-}
+}

package/config/.npmrc.template

@@ -1,3 +0,0 @@
-# settings for Nuxt & pnpm
-# https://cuyl.github.io/pnpm.github.io/npmrc/
-shamefully-hoist=true

package/nuxt.config.ts

@@ -1,14 +0,0 @@
-export default defineNuxtConfig({
-  modules: [
-    '@nuxt/eslint',
-    '@nuxt/test-utils/module',
-  ],
-
-  compatibilityDate: '2026-03-15',
-
-  eslint: {
-    config: {
-      stylistic: true,
-    },
-  },
-})