@testforgejs/vue-test-preset-recommended 1.0.0-beta.0 → 1.0.0-beta.1

package/README.md

@@ -1,8 +1,10 @@
 # @testforgejs/vue-test-preset-recommended
 
-Recommended presets for the [TestForge](https://github.com/testforgejs/testforge) Vue 3 component testing framework.
+Recommended **Vitest** presets for the [TestForge](https://github.com/testforgejs/testforge) Vue 3 component testing framework.
 
-This package provides ready-to-use TestForge presets with sensible defaults for commonly used Vue plugins.
+This package builds on [`@testforgejs/vue-test-preset-base`](https://www.npmjs.com/package/@testforgejs/vue-test-preset-base) and provides recommended defaults for projects using **Vitest**.
+
+The main difference from the base presets is the Pinia configuration: the recommended presets configure Pinia to use Vitest's `vi.fn` as its `createSpy` implementation.
 
 ## Installation
 
@@ -26,7 +28,7 @@ npm install -D @testforgejs/vue-test-preset-recommended@beta
 yarn add -D @testforgejs/vue-test-preset-recommended@beta
 ```
 
-> `@testforgejs/vue-test-core` is required.
+> `@testforgejs/vue-test-core` and `@testforgejs/vue-test-preset-base` are required dependencies.
 
 ## Quick Usage
 
@@ -34,6 +36,7 @@ Import the `presets` object and pass it to `createTestFramework()`:
 
 ```typescript
 // tests/setup.ts
+
 import { createTestFramework } from "@testforgejs/vue-test-core";
 import { presets } from "@testforgejs/vue-test-preset-recommended";
 
@@ -63,17 +66,26 @@ describe("MyComponent", () => {
 
 ## Available Presets
 
-The package currently exports the following presets:
+The package exports four presets:
+
+- `presets.default`
+- `presets.piniaPreset`
+- `presets.i18nPreset`
+- `presets.routerPreset`
+
+The presets are based on the corresponding presets from `@testforgejs/vue-test-preset-base`.
 
 ### `presets.default`
 
-The default recommended preset enables the following managed plugins:
+The default recommended preset enables:
+
+- Pinia;
+- Vue I18n;
+- Vue Router — disabled by default.
 
-- Pinia
-- Vue I18n
-- Vue Router — disabled by default
+It also provides default option factories for these managed plugins.
 
-It also provides default configuration for Pinia, Vue I18n, and Vue Router.
+For Pinia, the recommended preset additionally configures Vitest's `vi.fn` as the `createSpy` implementation.
 
 ```typescript
 const { testComponentFactory } = createTestFramework({
@@ -83,11 +95,38 @@ const { testComponentFactory } = createTestFramework({
 });
 ```
 
+This is the preset intended for most Vitest-based TestForge projects.
+
+### `presets.piniaPreset`
+
+A minimal preset for tests that require Pinia.
+
+It enables Pinia and configures its spy factory to use Vitest:
+
+```typescript
+const { testComponentFactory } = createTestFramework({
+  presets: {
+    default: presets.piniaPreset,
+  },
+});
+```
+
+The Pinia option factory is based on the base preset and adds Vitest's `vi.fn`:
+
+```typescript
+pinia: () => ({
+  ...basePiniaOptions,
+  createSpy: vi.fn,
+});
+```
+
+This makes the preset immediately usable with `@pinia/testing` under Vitest.
+
 ### `presets.i18nPreset`
 
 A minimal preset for tests that require Vue I18n.
 
-It enables Vue I18n with:
+It enables Vue I18n using the base preset's default configuration:
 
 - Composition API mode (`legacy: false`);
 - English locale;
@@ -95,6 +134,8 @@ It enables Vue I18n with:
 - empty messages;
 - disabled missing-translation warnings.
 
+The plugin defaults are provided through a plugin options factory, so each pipeline context receives fresh plugin options.
+
 ```typescript
 const { testComponentFactory } = createTestFramework({
   presets: {
@@ -103,6 +144,127 @@ const { testComponentFactory } = createTestFramework({
 });
 ```
 
+### `presets.routerPreset`
+
+A minimal preset for tests that require Vue Router.
+
+It enables the managed Vue Router integration using the base preset's default router configuration.
+
+```typescript
+const { testComponentFactory } = createTestFramework({
+  presets: {
+    default: presets.routerPreset,
+  },
+});
+```
+
+The router preset provides a test-oriented router configuration suitable for isolated component tests.
+
+Its plugin defaults are provided through a plugin options factory, which produces fresh options for each pipeline context.
+
+## Recommended vs Base Presets
+
+`@testforgejs/vue-test-preset-base` provides framework-neutral preset definitions.
+
+`@testforgejs/vue-test-preset-recommended` builds on those presets and adds Vitest-specific configuration where necessary.
+
+In particular:
+
+```text
+@testforgejs/vue-test-preset-base
+        │
+        ├── default
+        ├── piniaPreset
+        ├── i18nPreset
+        └── routerPreset
+                │
+                ▼
+@testforgejs/vue-test-preset-recommended
+        │
+        ├── default       → adds Vitest vi.fn to Pinia
+        ├── piniaPreset   → adds Vitest vi.fn to Pinia
+        ├── i18nPreset    → inherited from base
+        └── routerPreset  → inherited from base
+```
+
+This separation keeps the base preset independent from a particular test runner while allowing the recommended preset to provide runner-specific defaults.
+
+The Vitest-specific Pinia defaults are implemented as a **plugin options factory**. The factory invokes the base Pinia options factory and adds `createSpy`:
+
+```typescript
+const defaultVitestPinia = (() => ({
+  ...defaultPinia(),
+  createSpy: vi.fn,
+})) satisfies PluginOptionsFactory<VueTestPiniaOptions>;
+```
+
+The resulting factory can be reused by both the `default` and `piniaPreset` profiles.
+
+## Switching Presets at Runtime
+
+A **component factory invocation** can select a different registered preset using the fourth `extraOptions` argument:
+
+```typescript
+const factory = testComponentFactory(MyComponent);
+
+factory(
+  {},
+  {},
+  {},
+  {
+    preset: "i18nPreset",
+  },
+);
+```
+
+The selected preset defines the complete managed plugin runtime for that component factory invocation.
+
+This allows the same TestForge framework instance to use different runtime environments without creating a separate framework instance.
+
+For example:
+
+```typescript
+factory(
+  {},
+  {},
+  {},
+  {
+    preset: "piniaPreset",
+  },
+);
+```
+
+selects the Pinia-only runtime environment for that invocation.
+
+## Customizing Presets
+
+The recommended presets are ordinary TestForge preset definitions and can be composed with [`extendPreset()`](https://github.com/testforgejs/testforge).
+
+For example, a project can create its own preset from the recommended default:
+
+```typescript
+import { extendPreset } from "@testforgejs/vue-test-core";
+
+import { presets as recommendedPresets } from "@testforgejs/vue-test-preset-recommended";
+
+const projectPresets = {
+  default: extendPreset(recommendedPresets.default, {
+    defaults: {
+      pinia: () => ({
+        ...recommendedPresets.default.defaults.pinia(),
+        // project-specific options
+      }),
+    },
+  }),
+};
+```
+
+Because `defaults.pinia` is a plugin options factory, the base Pinia options are obtained by invoking the factory.
+
+When extending a preset, explicitly preserve any base plugin options that should remain enabled. Managed plugin configuration is intentionally replaced when an extension provides configuration for that plugin.
+
+For details about preset composition and configuration layering, see the [TestForge core documentation](https://github.com/testforgejs/testforge/blob/main/packages/vue-test-core/README.md).
+
 ## Using a Preset with Other Framework Configuration
 
 The exported presets can be combined with other TestForge configuration options:
@@ -114,11 +276,22 @@ const { testComponentFactory } = createTestFramework({
 });
 ```
 
-The preset provides the baseline plugin configuration, while individual factories and tests can override configuration when needed.
+The preset provides the runtime plugin baseline, while individual component factory invocations and tests can override configuration when needed.
+
+## Plugin Options Factory Isolation
+
+The `defaults` values in the presets are **plugin options factories**, not shared plugin configuration objects.
+
+When a plugin options factory is invoked, it produces fresh plugin options for the current pipeline context.
+
+This keeps mutable configuration isolated between independent pipeline contexts.
+
+This is separate from component factory isolation: `testComponentFactory()` creates a reusable function for mounting a component, while each invocation of that component factory establishes its own runtime environment.
 
 ## Related Packages
 
-- [`@testforgejs/vue-test-core`](https://www.npmjs.com/package/@testforgejs/vue-test-core) — core TestForge testing framework
+- [`@testforgejs/vue-test-core`](https://www.npmjs.com/package/@testforgejs/vue-test-core) — TestForge core framework
+- [`@testforgejs/vue-test-preset-base`](https://www.npmjs.com/package/@testforgejs/vue-test-preset-base) — base, runner-neutral presets
 - [`@testforgejs/vue-test-plugin-pinia`](https://www.npmjs.com/package/@testforgejs/vue-test-plugin-pinia) — Pinia integration
 - [`@testforgejs/vue-test-plugin-i18n`](https://www.npmjs.com/package/@testforgejs/vue-test-plugin-i18n) — Vue I18n integration
 - [`@testforgejs/vue-test-plugin-router`](https://www.npmjs.com/package/@testforgejs/vue-test-plugin-router) — Vue Router integration

package/dist/index.cjs

@@ -24,61 +24,27 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/defaults/defaultI18n.ts
-var defaultI18n = {
-  legacy: false,
-  locale: "en",
-  fallbackLocale: "en",
-  messages: {},
-  fallbackWarn: false,
-  missingWarn: false
-};
-
-// src/defaults/defaultPinia.ts
-var defaultPinia = {
-  initialState: {},
-  stubActions: false,
-  createSpy: void 0
-};
-
-// src/defaults/defaultRouter.ts
-var import_vue_router = require("vue-router");
-var isBrowser = typeof window !== "undefined";
-var getDefaultRouter = () => ({
-  history: isBrowser ? (0, import_vue_router.createWebHistory)() : (0, import_vue_router.createMemoryHistory)(),
-  routes: [{ path: "/", component: { render: () => null } }]
-});
-
 // src/presets.ts
-var import_vue_test_plugin_pinia = require("@testforgejs/vue-test-plugin-pinia");
-var import_vue_test_plugin_i18n = require("@testforgejs/vue-test-plugin-i18n");
-var import_vue_test_plugin_router = require("@testforgejs/vue-test-plugin-router");
+var import_vue_test_core = require("@testforgejs/vue-test-core");
+var import_vue_test_preset_base = require("@testforgejs/vue-test-preset-base");
+var import_vitest = require("vitest");
+var defaultVitestPinia = (() => ({
+  ...(0, import_vue_test_preset_base.defaultPinia)(),
+  createSpy: import_vitest.vi.fn
+}));
 var presets = {
-  default: {
-    manifest: [
-      { module: import_vue_test_plugin_pinia.piniaPlugin, enabled: true },
-      { module: import_vue_test_plugin_i18n.i18nPlugin, enabled: true },
-      { module: import_vue_test_plugin_router.routerPlugin, enabled: false }
-    ],
+  default: (0, import_vue_test_core.extendPreset)(import_vue_test_preset_base.presets.default, {
     defaults: {
-      i18n: defaultI18n,
-      pinia: defaultPinia,
-      router: getDefaultRouter()
+      pinia: defaultVitestPinia
     }
-  },
-  i18nPreset: {
-    manifest: [{ module: import_vue_test_plugin_i18n.i18nPlugin, enabled: true }],
+  }),
+  piniaPreset: (0, import_vue_test_core.extendPreset)(import_vue_test_preset_base.presets.piniaPreset, {
     defaults: {
-      i18n: {
-        legacy: false,
-        locale: "en",
-        fallbackLocale: "en",
-        messages: {},
-        fallbackWarn: false,
-        missingWarn: false
-      }
+      pinia: defaultVitestPinia
     }
-  }
+  }),
+  i18nPreset: import_vue_test_preset_base.presets.i18nPreset,
+  routerPreset: import_vue_test_preset_base.presets.routerPreset
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.d.cts

@@ -1,43 +1,29 @@
 import * as _testforgejs_vue_test_plugin_router from '@testforgejs/vue-test-plugin-router';
 import * as vue_router from 'vue-router';
+import * as _testforgejs_vue_test_plugin_i18n from '@testforgejs/vue-test-plugin-i18n';
 import * as vue_i18n from 'vue-i18n';
 import * as _testforgejs_vue_test_core from '@testforgejs/vue-test-core';
-import * as _testforgejs_vue_test_plugin_pinia from '@testforgejs/vue-test-plugin-pinia';
-import * as pinia from 'pinia';
-import { VueTestI18nOptions } from '@testforgejs/vue-test-plugin-i18n';
+import { PluginOptionsFactory } from '@testforgejs/vue-test-core';
 
 declare const presets: {
-    default: {
-        manifest: ({
-            module: _testforgejs_vue_test_core.PluginModule<pinia.Pinia, _testforgejs_vue_test_plugin_pinia.VueTestPiniaOptions>;
-            enabled: true;
-        } | {
-            module: _testforgejs_vue_test_core.PluginModule<vue_i18n.I18n<{}, {}, {}, string, boolean>, VueTestI18nOptions>;
+    default: _testforgejs_vue_test_core.PresetDefinition;
+    piniaPreset: _testforgejs_vue_test_core.PresetDefinition;
+    i18nPreset: {
+        manifest: {
+            module: _testforgejs_vue_test_core.PluginModule<vue_i18n.I18n<{}, {}, {}, string, boolean>, _testforgejs_vue_test_plugin_i18n.VueTestI18nOptions>;
             enabled: true;
-        } | {
-            module: _testforgejs_vue_test_core.PluginModule<vue_router._RouterClassic, _testforgejs_vue_test_plugin_router.VueTestRouterOptions>;
-            enabled: false;
-        })[];
+        }[];
         defaults: {
-            i18n: VueTestI18nOptions;
-            pinia: _testforgejs_vue_test_plugin_pinia.VueTestPiniaOptions;
-            router: _testforgejs_vue_test_plugin_router.VueTestRouterOptions;
+            i18n: PluginOptionsFactory<_testforgejs_vue_test_plugin_i18n.VueTestI18nOptions>;
         };
     };
-    i18nPreset: {
+    routerPreset: {
         manifest: {
-            module: _testforgejs_vue_test_core.PluginModule<vue_i18n.I18n<{}, {}, {}, string, boolean>, VueTestI18nOptions>;
+            module: _testforgejs_vue_test_core.PluginModule<vue_router._RouterClassic, _testforgejs_vue_test_plugin_router.VueTestRouterOptions>;
             enabled: true;
         }[];
         defaults: {
-            i18n: {
-                legacy: false;
-                locale: string;
-                fallbackLocale: string;
-                messages: {};
-                fallbackWarn: false;
-                missingWarn: false;
-            };
+            router: PluginOptionsFactory<_testforgejs_vue_test_plugin_router.VueTestRouterOptions>;
         };
     };
 };

package/dist/index.d.ts

@@ -1,43 +1,29 @@
 import * as _testforgejs_vue_test_plugin_router from '@testforgejs/vue-test-plugin-router';
 import * as vue_router from 'vue-router';
+import * as _testforgejs_vue_test_plugin_i18n from '@testforgejs/vue-test-plugin-i18n';
 import * as vue_i18n from 'vue-i18n';
 import * as _testforgejs_vue_test_core from '@testforgejs/vue-test-core';
-import * as _testforgejs_vue_test_plugin_pinia from '@testforgejs/vue-test-plugin-pinia';
-import * as pinia from 'pinia';
-import { VueTestI18nOptions } from '@testforgejs/vue-test-plugin-i18n';
+import { PluginOptionsFactory } from '@testforgejs/vue-test-core';
 
 declare const presets: {
-    default: {
-        manifest: ({
-            module: _testforgejs_vue_test_core.PluginModule<pinia.Pinia, _testforgejs_vue_test_plugin_pinia.VueTestPiniaOptions>;
-            enabled: true;
-        } | {
-            module: _testforgejs_vue_test_core.PluginModule<vue_i18n.I18n<{}, {}, {}, string, boolean>, VueTestI18nOptions>;
+    default: _testforgejs_vue_test_core.PresetDefinition;
+    piniaPreset: _testforgejs_vue_test_core.PresetDefinition;
+    i18nPreset: {
+        manifest: {
+            module: _testforgejs_vue_test_core.PluginModule<vue_i18n.I18n<{}, {}, {}, string, boolean>, _testforgejs_vue_test_plugin_i18n.VueTestI18nOptions>;
             enabled: true;
-        } | {
-            module: _testforgejs_vue_test_core.PluginModule<vue_router._RouterClassic, _testforgejs_vue_test_plugin_router.VueTestRouterOptions>;
-            enabled: false;
-        })[];
+        }[];
         defaults: {
-            i18n: VueTestI18nOptions;
-            pinia: _testforgejs_vue_test_plugin_pinia.VueTestPiniaOptions;
-            router: _testforgejs_vue_test_plugin_router.VueTestRouterOptions;
+            i18n: PluginOptionsFactory<_testforgejs_vue_test_plugin_i18n.VueTestI18nOptions>;
         };
     };
-    i18nPreset: {
+    routerPreset: {
         manifest: {
-            module: _testforgejs_vue_test_core.PluginModule<vue_i18n.I18n<{}, {}, {}, string, boolean>, VueTestI18nOptions>;
+            module: _testforgejs_vue_test_core.PluginModule<vue_router._RouterClassic, _testforgejs_vue_test_plugin_router.VueTestRouterOptions>;
             enabled: true;
         }[];
         defaults: {
-            i18n: {
-                legacy: false;
-                locale: string;
-                fallbackLocale: string;
-                messages: {};
-                fallbackWarn: false;
-                missingWarn: false;
-            };
+            router: PluginOptionsFactory<_testforgejs_vue_test_plugin_router.VueTestRouterOptions>;
         };
     };
 };

package/dist/index.js

@@ -1,58 +1,24 @@
-// src/defaults/defaultI18n.ts
-var defaultI18n = {
-  legacy: false,
-  locale: "en",
-  fallbackLocale: "en",
-  messages: {},
-  fallbackWarn: false,
-  missingWarn: false
-};
-
-// src/defaults/defaultPinia.ts
-var defaultPinia = {
-  initialState: {},
-  stubActions: false,
-  createSpy: void 0
-};
-
-// src/defaults/defaultRouter.ts
-import { createMemoryHistory, createWebHistory } from "vue-router";
-var isBrowser = typeof window !== "undefined";
-var getDefaultRouter = () => ({
-  history: isBrowser ? createWebHistory() : createMemoryHistory(),
-  routes: [{ path: "/", component: { render: () => null } }]
-});
-
 // src/presets.ts
-import { piniaPlugin } from "@testforgejs/vue-test-plugin-pinia";
-import { i18nPlugin } from "@testforgejs/vue-test-plugin-i18n";
-import { routerPlugin } from "@testforgejs/vue-test-plugin-router";
+import { extendPreset } from "@testforgejs/vue-test-core";
+import { defaultPinia, presets as basePresets } from "@testforgejs/vue-test-preset-base";
+import { vi } from "vitest";
+var defaultVitestPinia = (() => ({
+  ...defaultPinia(),
+  createSpy: vi.fn
+}));
 var presets = {
-  default: {
-    manifest: [
-      { module: piniaPlugin, enabled: true },
-      { module: i18nPlugin, enabled: true },
-      { module: routerPlugin, enabled: false }
-    ],
+  default: extendPreset(basePresets.default, {
     defaults: {
-      i18n: defaultI18n,
-      pinia: defaultPinia,
-      router: getDefaultRouter()
+      pinia: defaultVitestPinia
     }
-  },
-  i18nPreset: {
-    manifest: [{ module: i18nPlugin, enabled: true }],
+  }),
+  piniaPreset: extendPreset(basePresets.piniaPreset, {
     defaults: {
-      i18n: {
-        legacy: false,
-        locale: "en",
-        fallbackLocale: "en",
-        messages: {},
-        fallbackWarn: false,
-        missingWarn: false
-      }
+      pinia: defaultVitestPinia
     }
-  }
+  }),
+  i18nPreset: basePresets.i18nPreset,
+  routerPreset: basePresets.routerPreset
 };
 export {
   presets

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testforgejs/vue-test-preset-recommended",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0-beta.1",
   "type": "module",
   "description": "Official recommended preset for getting started with the TestForge framework",
   "homepage": "https://github.com/testforgejs/testforge#readme",
@@ -37,21 +37,26 @@
     "preset",
     "configuration",
     "recommended",
+    "vitest",
     "testforge",
     "testforge-preset"
   ],
   "license": "MIT",
   "author": "Roman Levchenko",
   "dependencies": {
-    "@testforgejs/vue-test-plugin-pinia": "1.0.0-beta.0",
-    "@testforgejs/vue-test-plugin-i18n": "1.0.0-beta.0",
-    "@testforgejs/vue-test-plugin-router": "1.0.0-beta.0"
+    "@testforgejs/vue-test-plugin-i18n": "1.0.0-beta.1",
+    "@testforgejs/vue-test-plugin-pinia": "1.0.0-beta.1",
+    "@testforgejs/vue-test-plugin-router": "1.0.0-beta.1"
   },
   "peerDependencies": {
-    "@testforgejs/vue-test-core": "1.0.0-beta.0"
+    "vitest": "^3.0.0 || ^4.0.0",
+    "@testforgejs/vue-test-core": "1.0.0-beta.1",
+    "@testforgejs/vue-test-preset-base": "1.0.0-beta.1"
   },
   "devDependencies": {
-    "@testforgejs/vue-test-core": "1.0.0-beta.0"
+    "vitest": "^3.0.0 || ^4.0.0",
+    "@testforgejs/vue-test-core": "1.0.0-beta.1",
+    "@testforgejs/vue-test-preset-base": "1.0.0-beta.1"
   },
   "scripts": {
     "build": "tsup",