@testforgejs/vue-test-core 1.0.0-beta.1 → 1.0.0-beta.2

package/README.md

@@ -60,6 +60,58 @@ A preset controls:
 
 The preset system keeps the TestForge core independent from specific Vue ecosystem integrations. The core runtime does not need built-in knowledge of Pinia, Vue Router, Vue I18n, Vuetify, PrimeVue, or other integrations.
 
+### Single and Multiple Presets
+
+`createTestFramework()` supports two mutually exclusive ways to configure presets.
+
+Use `preset` when the framework needs a single runtime environment:
+
+```typescript
+createTestFramework({
+  preset: projectPreset,
+});
+```
+
+Use `presets` when the framework should provide multiple named runtime environments:
+
+```typescript
+createTestFramework({
+  presets: {
+    default: projectPreset,
+    i18n: i18nPreset,
+    router: routerPreset,
+  },
+});
+```
+
+These options cannot be used together.
+
+A single `preset` is treated as the framework's `default` preset internally. A `presets` registry allows individual factory invocations to select a named preset through `extraOptions.preset`.
+
+For example:
+
+```typescript
+const { testComponentFactory } = createTestFramework({
+  presets: {
+    default: defaultPreset,
+    i18n: i18nPreset,
+  },
+});
+
+const factory = testComponentFactory(MyComponent);
+
+factory(
+  {},
+  {},
+  {},
+  {
+    preset: "i18n",
+  },
+);
+```
+
+This distinction allows a project to start with a single custom runtime environment and introduce named runtime profiles later without changing the preset definition itself.
+
 ### Official preset packages
 
 TestForge provides a layered preset architecture:
@@ -100,7 +152,11 @@ The recommended presets include configurations for commonly used managed integra
 - Vue I18n;
 - Vue Router.
 
-The recommended preset packages are optional. You can also use the base presets directly or create and compose your own presets.
+The recommended preset is a convenient starting point for exploring TestForge and its approach to reusable component test environments.
+
+However, recommended presets are intentionally generic. Real applications usually have application-specific routes, managed plugins, and plugin defaults. Most projects will therefore eventually benefit from a project-specific preset that extends or adapts an existing preset to the application's runtime environment.
+
+The recommended preset packages are optional. You can also use the base preset directly or create your own project-specific preset.
 
 > [!TIP]
 > If you are getting started with TestForge, use the recommended preset that matches your test runner.
@@ -111,7 +167,7 @@ See the [Getting Started Guide](https://github.com/testforgejs/testforge/blob/ma
 
 ## Quick Usage
 
-The following example uses Vitest and the recommended Vitest preset.
+The following example uses Vitest and the recommended Vitest preset registry.
 
 ```typescript
 // tests/setup.ts
@@ -126,6 +182,8 @@ const { testComponentFactory } = createTestFramework({
 export { testComponentFactory };
 ```
 
+This setup is a good starting point for exploring TestForge. As the application-specific testing environment grows, the project can define its own preset while continuing to reuse the official preset as a base.
+
 The resulting `testComponentFactory` can then be imported and reused throughout your component tests.
 
 ```typescript
@@ -151,6 +209,30 @@ For Jest projects, use `@testforgejs/vue-test-preset-recommended-jest` instead.
 
 👉 For a complete walkthrough, continue with the [Getting Started Guide](https://github.com/testforgejs/testforge/blob/main/docs/getting-started.md).
 
+---
+
+## Project-Specific Presets
+
+Most applications will eventually benefit from some application-specific preset configuration.
+
+For example, a project can extend the recommended preset with its own locale configuration:
+
+```typescript
+import { extendPreset } from "@testforgejs/vue-test-core";
+import { presets as recommendedPresets } from "@testforgejs/vue-test-preset-recommended";
+
+const projectPreset = extendPreset(recommendedPresets.default, {
+  defaults: {
+    i18n: () => ({
+      ...recommendedPresets.default.defaults.i18n(),
+      locale: "uk",
+    }),
+  },
+});
+```
+
+---
+
 ## Documentation
 
 - [Getting Started Guide](https://github.com/testforgejs/testforge/blob/main/docs/getting-started.md) — Set up TestForge in a project and create reusable component test factories.

package/dist/index.cjs

@@ -56,16 +56,29 @@ var FRAMEWORK_NAME = "TestForge";
 var ERROR_PREFIX = `[${FRAMEWORK_NAME}]`;
 var DEFAULT_PRESET_NAME = "default";
 
+// src/guards/isPlainObject.ts
+function isPlainObject(item) {
+  if (item === null || typeof item !== "object" || Array.isArray(item)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(item);
+  return prototype === Object.prototype || prototype === null;
+}
+
 // src/presets/validators/validatePreset.ts
 function validatePreset(name, preset) {
   if (!preset) {
     throw new Error(`${ERROR_PREFIX} Preset "${name}" is null or undefined.`);
   }
-  if (!Array.isArray(preset.manifest)) {
+  if (!isPlainObject(preset)) {
+    throw new Error(`${ERROR_PREFIX} Preset "${name}" must be a plain object.`);
+  }
+  const manifest = preset.manifest;
+  if (!Array.isArray(manifest)) {
     throw new Error(`${ERROR_PREFIX} Preset "${name}" must have a "manifest" array.`);
   }
   const manifestPluginNames = /* @__PURE__ */ new Set();
-  preset.manifest.forEach((entry, index) => {
+  manifest.forEach((entry, index) => {
     const { module: module2, enabled } = entry;
     if (!module2 || typeof module2.getName !== "function") {
       throw new Error(`${ERROR_PREFIX} Invalid module at manifest[${index}] in preset "${name}".`);
@@ -83,22 +96,24 @@ function validatePreset(name, preset) {
     }
     manifestPluginNames.add(pluginName);
   });
-  if (preset.defaults) {
-    const defaultKeys = Object.keys(preset.defaults);
-    defaultKeys.forEach((key) => {
-      if (!manifestPluginNames.has(key)) {
-        throw new Error(
-          `${ERROR_PREFIX} Preset "${name}" contains defaults for unknown plugin "${key}". This plugin is not present in the manifest.`
-        );
-      }
-      const value = preset.defaults[key];
-      if (typeof value !== "function") {
-        throw new Error(
-          `${ERROR_PREFIX} Invalid default configuration for plugin "${key}" in preset "${name}". Expected a plugin options factory function, but received ${typeof value}.`
-        );
-      }
-    });
+  const defaults = preset.defaults;
+  if (!isPlainObject(defaults)) {
+    throw new Error(`${ERROR_PREFIX} Preset "${name}" must have a "defaults" plain object.`);
   }
+  const defaultKeys = Object.keys(defaults);
+  defaultKeys.forEach((key) => {
+    if (!manifestPluginNames.has(key)) {
+      throw new Error(
+        `${ERROR_PREFIX} Preset "${name}" contains defaults for unknown plugin "${key}". This plugin is not present in the manifest.`
+      );
+    }
+    const value = defaults[key];
+    if (typeof value !== "function") {
+      throw new Error(
+        `${ERROR_PREFIX} Invalid default configuration for plugin "${key}" in preset "${name}". Expected a plugin options factory function, but received ${typeof value}.`
+      );
+    }
+  });
 }
 
 // src/presets/getActivePreset.ts
@@ -331,15 +346,6 @@ var withBaseMountOptions = (ctx) => {
   });
 };
 
-// src/guards/isPlainObject.ts
-function isPlainObject(item) {
-  if (item === null || typeof item !== "object" || Array.isArray(item)) {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(item);
-  return prototype === Object.prototype || prototype === null;
-}
-
 // src/utils/mergeConfigs.ts
 function mergeConfigs(target, source) {
   const arrays = Array.isArray(target) && Array.isArray(source);
@@ -643,7 +649,7 @@ function mountWithPlugins(component, ctx, overrides = {}, runtimeOptions = {
 }
 
 // src/presets/validators/validatePresets.ts
-function validatePresets(presets = {}) {
+function validatePresets(presets) {
   if (!isPlainObject(presets)) {
     throw new Error(`${ERROR_PREFIX} Presets must be a plain object.`);
   }
@@ -652,8 +658,8 @@ function validatePresets(presets = {}) {
   });
 }
 
-// src/assertions/assertIsPlainObject.ts
-function assertIsPlainObject(value, name = "value") {
+// src/assertions/assertIsPlainObjectValue.ts
+function assertIsPlainObjectValue(value, name = "value") {
   if (!isPlainObject(value)) {
     throw new Error(`${name} must be a plain object.`);
   }
@@ -661,8 +667,14 @@ function assertIsPlainObject(value, name = "value") {
 
 // src/validators/validateCreateTestFrameworkOptions.ts
 function validateCreateTestFrameworkOptions(options = {}) {
-  assertIsPlainObject(options, "createTestFramework options");
-  const { shallowByDefault, presets } = options;
+  assertIsPlainObjectValue(options, "createTestFramework options");
+  const { preset, presets, shallowByDefault } = options;
+  if (preset !== void 0 && presets !== void 0) {
+    throw new Error(`${ERROR_PREFIX} "preset" and "presets" cannot be used together.`);
+  }
+  if (preset !== void 0) {
+    validatePreset("default", preset);
+  }
   if (presets !== void 0) {
     validatePresets(presets);
   }
@@ -765,10 +777,21 @@ function validateComponentFactoryArguments(props, mountOptions, slots, extraOpti
   validateComponentFactoryExtraOptions(extraOptions, presets);
 }
 
+// src/core/utils/resolvePresets.ts
+function resolvePresets(options) {
+  if (options.preset !== void 0) {
+    return {
+      default: options.preset
+    };
+  }
+  return options.presets ?? {};
+}
+
 // src/core/createTestFramework.ts
 function createTestFramework(options = {}) {
   validateCreateTestFrameworkOptions(options);
-  const { presets = {}, shallowByDefault = false } = options;
+  const { shallowByDefault = false } = options;
+  const presets = resolvePresets(options);
   const testComponentFactory = (component, defaultProps = {}, defaultMountOptions = {}, defaultSlots = {}) => {
     validateTestComponentFactoryArguments(
       component,

package/dist/index.d.cts

@@ -29,6 +29,12 @@ type SupportedPluginsMap = Record<PluginName, SupportedPluginState>;
 type RuntimePluginConfig = Record<string, any>;
 type RuntimePluginOption = RuntimePluginConfig | false;
 type ResolvedPluginOptions = Record<PluginName, RuntimePluginOption>;
+/**
+ * Default plugin configuration factories.
+ *
+ * Only plugins that require preset-level default configuration
+ * need to be included.
+ */
 type PluginConfigDefaults = Record<PluginName, PluginOptionsFactory<RuntimePluginConfig>>;
 type ResolvedPluginDefaults = Record<PluginName, RuntimePluginConfig>;
 interface PluginRuntimeMeta<TInstance> {
@@ -98,7 +104,15 @@ type ComponentFactoryExtraOptions = {
  * `plugin.getName()` for plugins declared in `manifest`.
  */
 interface PresetDefinition {
+    /** Plugins available to the preset and their enabled state. */
     manifest: PluginManifestEntry<any, any>[];
+    /**
+     * Default plugin configurations.
+     *
+     * A plugin declared in `manifest` does not have to be present here.
+     * Missing defaults mean that the preset provides no default configuration
+     * for that plugin.
+     */
     defaults: PluginConfigDefaults;
 }
 type TestFrameworkPresets = Record<string, PresetDefinition>;
@@ -160,9 +174,7 @@ type ComponentDataInput<T extends Component> = Partial<ComponentData<T>>;
  * instead of maintaining a parallel wrapper type hierarchy.
  */
 type ComponentFactory<T extends Component> = (props?: ComponentPropsInput<T>, mountOptions?: ComponentFactoryOptions<ComponentPropsInput<T>, ComponentSlotsInput<T>, ComponentDataInput<T>>, slots?: ComponentSlotsInput<T>, extraOptions?: ComponentFactoryExtraOptions) => ReturnType<typeof mount<T>>;
-interface CreateTestFrameworkOptions {
-    /** Preset configurations for plugins */
-    presets?: TestFrameworkPresets;
+interface CommonCreateTestFrameworkOptions {
     /**
      * Default value for Vue Test Utils `shallow` mounting.
      *
@@ -173,6 +185,17 @@ interface CreateTestFrameworkOptions {
      */
     shallowByDefault?: boolean;
 }
+interface SinglePresetOptions extends CommonCreateTestFrameworkOptions {
+    /** Single preset used by the framework. */
+    preset: PresetDefinition;
+    presets?: never;
+}
+interface MultiplePresetsOptions extends CommonCreateTestFrameworkOptions {
+    /** Named preset configurations for plugins. */
+    preset?: never;
+    presets?: TestFrameworkPresets;
+}
+type CreateTestFrameworkOptions = SinglePresetOptions | MultiplePresetsOptions;
 interface ComponentFactoryCreator {
     <T extends Component>(component: T, defaultProps?: ComponentPropsInput<T>, defaultMountOptions?: ComponentFactoryOptions<ComponentPropsInput<T>, ComponentSlotsInput<T>, ComponentDataInput<T>>, defaultSlots?: ComponentSlotsInput<T>): ComponentFactory<T>;
 }
@@ -193,10 +216,10 @@ declare function captureInstance<T = unknown>(): InstanceCapture<T>;
 
 declare function extendPreset(basePreset: PresetDefinition, extension: PresetExtension): PresetDefinition;
 
-declare function validatePreset(name: PluginName, preset: PresetDefinition): void;
+declare function validatePreset(name: string, preset: unknown): asserts preset is PresetDefinition;
 
-declare function validatePresets(presets?: TestFrameworkPresets): void;
+declare function validatePresets(presets: unknown): asserts presets is TestFrameworkPresets;
 
 declare const Types: {};
 
-export { type ComponentFactory, type ComponentFactoryCreator, type ComponentFactoryExtraOptions, type ComponentFactoryOptions, type MountPlugin, type PluginControlOptions, type PluginModule, type PluginOptionsFactory, type PluginOptionsInput, type PluginOptionsMap, type PluginOverridesInput, type PresetDefinition, type TestFramework, type TestFrameworkPresets, Types, captureInstance, createPluginInstance, createTestFramework, createVuePlugin, extendPreset, validatePreset, validatePresets };
+export { type ComponentFactory, type ComponentFactoryCreator, type ComponentFactoryExtraOptions, type ComponentFactoryOptions, type CreateTestFrameworkOptions, type MountPlugin, type PluginControlOptions, type PluginManifestEntry, type PluginModule, type PluginOptionsFactory, type PluginOptionsInput, type PluginOptionsMap, type PluginOverridesInput, type PresetDefinition, type PresetExtension, type TestFramework, type TestFrameworkPresets, Types, captureInstance, createPluginInstance, createTestFramework, createVuePlugin, extendPreset, validatePreset, validatePresets };

package/dist/index.d.ts

@@ -29,6 +29,12 @@ type SupportedPluginsMap = Record<PluginName, SupportedPluginState>;
 type RuntimePluginConfig = Record<string, any>;
 type RuntimePluginOption = RuntimePluginConfig | false;
 type ResolvedPluginOptions = Record<PluginName, RuntimePluginOption>;
+/**
+ * Default plugin configuration factories.
+ *
+ * Only plugins that require preset-level default configuration
+ * need to be included.
+ */
 type PluginConfigDefaults = Record<PluginName, PluginOptionsFactory<RuntimePluginConfig>>;
 type ResolvedPluginDefaults = Record<PluginName, RuntimePluginConfig>;
 interface PluginRuntimeMeta<TInstance> {
@@ -98,7 +104,15 @@ type ComponentFactoryExtraOptions = {
  * `plugin.getName()` for plugins declared in `manifest`.
  */
 interface PresetDefinition {
+    /** Plugins available to the preset and their enabled state. */
     manifest: PluginManifestEntry<any, any>[];
+    /**
+     * Default plugin configurations.
+     *
+     * A plugin declared in `manifest` does not have to be present here.
+     * Missing defaults mean that the preset provides no default configuration
+     * for that plugin.
+     */
     defaults: PluginConfigDefaults;
 }
 type TestFrameworkPresets = Record<string, PresetDefinition>;
@@ -160,9 +174,7 @@ type ComponentDataInput<T extends Component> = Partial<ComponentData<T>>;
  * instead of maintaining a parallel wrapper type hierarchy.
  */
 type ComponentFactory<T extends Component> = (props?: ComponentPropsInput<T>, mountOptions?: ComponentFactoryOptions<ComponentPropsInput<T>, ComponentSlotsInput<T>, ComponentDataInput<T>>, slots?: ComponentSlotsInput<T>, extraOptions?: ComponentFactoryExtraOptions) => ReturnType<typeof mount<T>>;
-interface CreateTestFrameworkOptions {
-    /** Preset configurations for plugins */
-    presets?: TestFrameworkPresets;
+interface CommonCreateTestFrameworkOptions {
     /**
      * Default value for Vue Test Utils `shallow` mounting.
      *
@@ -173,6 +185,17 @@ interface CreateTestFrameworkOptions {
      */
     shallowByDefault?: boolean;
 }
+interface SinglePresetOptions extends CommonCreateTestFrameworkOptions {
+    /** Single preset used by the framework. */
+    preset: PresetDefinition;
+    presets?: never;
+}
+interface MultiplePresetsOptions extends CommonCreateTestFrameworkOptions {
+    /** Named preset configurations for plugins. */
+    preset?: never;
+    presets?: TestFrameworkPresets;
+}
+type CreateTestFrameworkOptions = SinglePresetOptions | MultiplePresetsOptions;
 interface ComponentFactoryCreator {
     <T extends Component>(component: T, defaultProps?: ComponentPropsInput<T>, defaultMountOptions?: ComponentFactoryOptions<ComponentPropsInput<T>, ComponentSlotsInput<T>, ComponentDataInput<T>>, defaultSlots?: ComponentSlotsInput<T>): ComponentFactory<T>;
 }
@@ -193,10 +216,10 @@ declare function captureInstance<T = unknown>(): InstanceCapture<T>;
 
 declare function extendPreset(basePreset: PresetDefinition, extension: PresetExtension): PresetDefinition;
 
-declare function validatePreset(name: PluginName, preset: PresetDefinition): void;
+declare function validatePreset(name: string, preset: unknown): asserts preset is PresetDefinition;
 
-declare function validatePresets(presets?: TestFrameworkPresets): void;
+declare function validatePresets(presets: unknown): asserts presets is TestFrameworkPresets;
 
 declare const Types: {};
 
-export { type ComponentFactory, type ComponentFactoryCreator, type ComponentFactoryExtraOptions, type ComponentFactoryOptions, type MountPlugin, type PluginControlOptions, type PluginModule, type PluginOptionsFactory, type PluginOptionsInput, type PluginOptionsMap, type PluginOverridesInput, type PresetDefinition, type TestFramework, type TestFrameworkPresets, Types, captureInstance, createPluginInstance, createTestFramework, createVuePlugin, extendPreset, validatePreset, validatePresets };
+export { type ComponentFactory, type ComponentFactoryCreator, type ComponentFactoryExtraOptions, type ComponentFactoryOptions, type CreateTestFrameworkOptions, type MountPlugin, type PluginControlOptions, type PluginManifestEntry, type PluginModule, type PluginOptionsFactory, type PluginOptionsInput, type PluginOptionsMap, type PluginOverridesInput, type PresetDefinition, type PresetExtension, type TestFramework, type TestFrameworkPresets, Types, captureInstance, createPluginInstance, createTestFramework, createVuePlugin, extendPreset, validatePreset, validatePresets };

package/dist/index.js

@@ -23,16 +23,29 @@ var FRAMEWORK_NAME = "TestForge";
 var ERROR_PREFIX = `[${FRAMEWORK_NAME}]`;
 var DEFAULT_PRESET_NAME = "default";
 
+// src/guards/isPlainObject.ts
+function isPlainObject(item) {
+  if (item === null || typeof item !== "object" || Array.isArray(item)) {
+    return false;
+  }
+  const prototype = Object.getPrototypeOf(item);
+  return prototype === Object.prototype || prototype === null;
+}
+
 // src/presets/validators/validatePreset.ts
 function validatePreset(name, preset) {
   if (!preset) {
     throw new Error(`${ERROR_PREFIX} Preset "${name}" is null or undefined.`);
   }
-  if (!Array.isArray(preset.manifest)) {
+  if (!isPlainObject(preset)) {
+    throw new Error(`${ERROR_PREFIX} Preset "${name}" must be a plain object.`);
+  }
+  const manifest = preset.manifest;
+  if (!Array.isArray(manifest)) {
     throw new Error(`${ERROR_PREFIX} Preset "${name}" must have a "manifest" array.`);
   }
   const manifestPluginNames = /* @__PURE__ */ new Set();
-  preset.manifest.forEach((entry, index) => {
+  manifest.forEach((entry, index) => {
     const { module, enabled } = entry;
     if (!module || typeof module.getName !== "function") {
       throw new Error(`${ERROR_PREFIX} Invalid module at manifest[${index}] in preset "${name}".`);
@@ -50,22 +63,24 @@ function validatePreset(name, preset) {
     }
     manifestPluginNames.add(pluginName);
   });
-  if (preset.defaults) {
-    const defaultKeys = Object.keys(preset.defaults);
-    defaultKeys.forEach((key) => {
-      if (!manifestPluginNames.has(key)) {
-        throw new Error(
-          `${ERROR_PREFIX} Preset "${name}" contains defaults for unknown plugin "${key}". This plugin is not present in the manifest.`
-        );
-      }
-      const value = preset.defaults[key];
-      if (typeof value !== "function") {
-        throw new Error(
-          `${ERROR_PREFIX} Invalid default configuration for plugin "${key}" in preset "${name}". Expected a plugin options factory function, but received ${typeof value}.`
-        );
-      }
-    });
+  const defaults = preset.defaults;
+  if (!isPlainObject(defaults)) {
+    throw new Error(`${ERROR_PREFIX} Preset "${name}" must have a "defaults" plain object.`);
   }
+  const defaultKeys = Object.keys(defaults);
+  defaultKeys.forEach((key) => {
+    if (!manifestPluginNames.has(key)) {
+      throw new Error(
+        `${ERROR_PREFIX} Preset "${name}" contains defaults for unknown plugin "${key}". This plugin is not present in the manifest.`
+      );
+    }
+    const value = defaults[key];
+    if (typeof value !== "function") {
+      throw new Error(
+        `${ERROR_PREFIX} Invalid default configuration for plugin "${key}" in preset "${name}". Expected a plugin options factory function, but received ${typeof value}.`
+      );
+    }
+  });
 }
 
 // src/presets/getActivePreset.ts
@@ -298,15 +313,6 @@ var withBaseMountOptions = (ctx) => {
   });
 };
 
-// src/guards/isPlainObject.ts
-function isPlainObject(item) {
-  if (item === null || typeof item !== "object" || Array.isArray(item)) {
-    return false;
-  }
-  const prototype = Object.getPrototypeOf(item);
-  return prototype === Object.prototype || prototype === null;
-}
-
 // src/utils/mergeConfigs.ts
 function mergeConfigs(target, source) {
   const arrays = Array.isArray(target) && Array.isArray(source);
@@ -610,7 +616,7 @@ function mountWithPlugins(component, ctx, overrides = {}, runtimeOptions = {
 }
 
 // src/presets/validators/validatePresets.ts
-function validatePresets(presets = {}) {
+function validatePresets(presets) {
   if (!isPlainObject(presets)) {
     throw new Error(`${ERROR_PREFIX} Presets must be a plain object.`);
   }
@@ -619,8 +625,8 @@ function validatePresets(presets = {}) {
   });
 }
 
-// src/assertions/assertIsPlainObject.ts
-function assertIsPlainObject(value, name = "value") {
+// src/assertions/assertIsPlainObjectValue.ts
+function assertIsPlainObjectValue(value, name = "value") {
   if (!isPlainObject(value)) {
     throw new Error(`${name} must be a plain object.`);
   }
@@ -628,8 +634,14 @@ function assertIsPlainObject(value, name = "value") {
 
 // src/validators/validateCreateTestFrameworkOptions.ts
 function validateCreateTestFrameworkOptions(options = {}) {
-  assertIsPlainObject(options, "createTestFramework options");
-  const { shallowByDefault, presets } = options;
+  assertIsPlainObjectValue(options, "createTestFramework options");
+  const { preset, presets, shallowByDefault } = options;
+  if (preset !== void 0 && presets !== void 0) {
+    throw new Error(`${ERROR_PREFIX} "preset" and "presets" cannot be used together.`);
+  }
+  if (preset !== void 0) {
+    validatePreset("default", preset);
+  }
   if (presets !== void 0) {
     validatePresets(presets);
   }
@@ -732,10 +744,21 @@ function validateComponentFactoryArguments(props, mountOptions, slots, extraOpti
   validateComponentFactoryExtraOptions(extraOptions, presets);
 }
 
+// src/core/utils/resolvePresets.ts
+function resolvePresets(options) {
+  if (options.preset !== void 0) {
+    return {
+      default: options.preset
+    };
+  }
+  return options.presets ?? {};
+}
+
 // src/core/createTestFramework.ts
 function createTestFramework(options = {}) {
   validateCreateTestFrameworkOptions(options);
-  const { presets = {}, shallowByDefault = false } = options;
+  const { shallowByDefault = false } = options;
+  const presets = resolvePresets(options);
   const testComponentFactory = (component, defaultProps = {}, defaultMountOptions = {}, defaultSlots = {}) => {
     validateTestComponentFactoryArguments(
       component,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testforgejs/vue-test-core",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "type": "module",
   "description": "Core testing utilities and pipeline orchestration for the TestForge component testing framework",
   "homepage": "https://github.com/testforgejs/testforge#readme",
@@ -52,11 +52,7 @@
   },
   "devDependencies": {
     "@vue/test-utils": "^2.0.0",
-    "vue": "^3.3.0",
-    "vue-router": "^5.0.0",
-    "@testforgejs/vue-test-plugin-i18n": "1.0.0-beta.1",
-    "@testforgejs/vue-test-plugin-router": "1.0.0-beta.1",
-    "@testforgejs/vue-test-plugin-pinia": "1.0.0-beta.1"
+    "vue": "^3.3.0"
   },
   "tsd": {
     "directory": "test-d"