@equinor/fusion-framework-vitest-plugin-react-app 0.2.0-next.3 → 1.0.0-next.4

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @equinor/fusion-framework-vitest-plugin-react-app
 
+## 1.0.0-next.4
+
+### Major Changes
+
+- b3d46e0: Rename the `testApp`/`test` fixtures for extending the mocked application and parent framework
+  configuration: `configure` is now `configureApp`, the new `configureFramework` fixture
+  introduced alongside it is now `configureFusion`, and `env` is now `appEnv`.
+
+  ```diff
+  -const test = testApp.extend('configure', { injected: true }, () => ...);
+  +const test = testApp.extend('configureApp', { injected: true }, () => ...);
+
+  -test.override('fusion', async ({ env }) => ...);
+  +test.override('fusion', async ({ appEnv }) => ...);
+  ```
+
+  `configureFusion` composes with the base parent-framework mock (app manifest and navigation) the same way `configureApp` composes with the base app-module mock — see [Advanced usage](docs/advanced.md#extend-the-parent-framework-mock-with-configurefusion) for extending framework-scope modules such as feature flags, service discovery, or navigation history.
+
+  Also adds `mergeEnvConfig`, a new utility exported from the `/test` entry point for overriding one endpoint's URL (or an `environment` value) on `appEnv` without dropping the rest of the app's `AppConfig` — a plain object spread over `AppConfig` copies nothing, since it stores `environment`/`endpoints` behind private fields exposed only through getters. See [Advanced usage](docs/advanced.md#fake-an-endpoint-url-with-mergeenvconfig).
+
+  ```ts
+  const test = baseTest.extend("appEnv", ({ appEnv }) =>
+    mergeEnvConfig(appEnv, {
+      endpoints: { "cpr-api": { url: backendBaseUrl } },
+    }),
+  );
+  ```
+
 ## 0.2.0-next.3
 
 ### Patch Changes

package/README.md

@@ -18,9 +18,12 @@ Use this package when you need to:
   resolution pipeline `ffc app build`/`ffc app dev` use, served as virtual modules by
   `appTestVitePlugin`.
 - **Share seeded fixture defaults across a test file** — `testApp`, a `vitest` `test` extended
-  with `env`/`configure`/`app`/`render`/`renderHook` fixtures, instead of repeating options on
+  with `appEnv`/`configureApp`/`app`/`render`/`renderHook` fixtures, instead of repeating options on
   every call. Each test still gets its own fresh `fusion`/`app` instances; only the seeded
   defaults are shared, not state between tests.
+- **Fake one endpoint's URL without losing the rest of the config** — `mergeEnvConfig` merges
+  `environment`/`endpoints` overrides into an `AppEnv`'s `config`; a plain object spread over
+  `AppConfig` (which stores both behind private fields) silently drops everything.
 
 ## Installation
 
@@ -78,7 +81,7 @@ entry-point's `test`/`render` when several cases in a file share one seeded scop
   `renderAppComponent`, `renderAppHook`, `testApp`. No app-specific resolution; you pass
   `env`/`configure` yourself.
 - **`@equinor/fusion-framework-vitest-plugin-react-app/test`** — `test`, `render`. Require
-  `appTestVitePlugin` registered in `vitest.config.ts`; `env`/`configure` are resolved
+  `appTestVitePlugin` registered in `vitest.config.ts`; `appEnv`/`configureApp` are resolved
   automatically from the application's own manifest, config, and module-configurator.
 - **`@equinor/fusion-framework-vitest-plugin-react-app/config`** — `defineProject`. Registers
   `appTestVitePlugin`, headless Playwright/Chromium, test-file inclusion, and lazy-import
@@ -94,7 +97,7 @@ import { defineProject } from '@equinor/fusion-framework-vitest-plugin-react-app
 export default defineProject();
 ```
 
-Then use the pre-seeded `test` fixture — no per-test `env`/`configure` wiring:
+Then use the pre-seeded `test` fixture — no per-test `appEnv`/`configureApp` wiring:
 
 ```tsx
 import { expect } from 'vitest';
@@ -280,7 +283,7 @@ test('mounts the child app once its script loads', async () => {
 
 `vitest`'s `test`, extended with an application module scope fixture — an alternative to
 `renderAppComponent`/`renderAppHook` for a test file whose cases share one mocked scope:
-`env`/`configure` become suite-level concerns, overridden once per file (or per `describe`
+`appEnv`/`configureApp` become suite-level concerns, overridden once per file (or per `describe`
 block) with `testApp.extend(...)`, rather than an options object repeated on every call.
 `fusion`/`app` resolve lazily — a test that only destructures `app` never pays for rendering
 anything, and one that only destructures `render`/`renderHook` gets the same mocked scope
@@ -299,7 +302,7 @@ Seed a module for every test in a suite:
 
 ```tsx
 describe('with a seeded context module', () => {
-  const test = testApp.extend('configure', { injected: true }, () =>
+  const test = testApp.extend('configureApp', { injected: true }, () =>
     (configurator) => enableContextMock(configurator, (mock) => mock.setCurrentContext(projectA)),
   );
 
@@ -316,7 +319,7 @@ A plain Vite plugin — Vitest configs are Vite configs, so this registers direc
 `vitest.config.ts`, no CLI command required. It serves an application's manifest/config
 (resolved the same way `ffc app build`/`ffc app dev` do) and its own module-configurator
 export as virtual modules, so the `/test` entry-point's `test`/`render` need no per-test
-`env`/`configure` wiring.
+`appEnv`/`configureApp` wiring.
 
 ```ts
 appTestVitePlugin({

package/dist/esm/app-test.js

@@ -1,6 +1,7 @@
 export { renderAppHook, } from './render-app-hook';
 export { renderAppComponent, } from './render-app-component';
 export { testApp } from './test-app';
+export { mergeEnvConfig } from './merge-env-config.js';
 // `test`/`render` import virtual modules only served once `appTestVitePlugin`
 // (@equinor/fusion-framework-vitest-plugin-react-app) is registered — using any export from
 // this module requires the plugin registered in your `vitest.config.ts` `plugins`.

package/dist/esm/app-test.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-test.js","sourceRoot":"","sources":["../../src/app-test.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAGd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,GAGnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,8EAA8E;AAC9E,4FAA4F;AAC5F,mFAAmF;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"app-test.js","sourceRoot":"","sources":["../../src/app-test.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,GAGd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,kBAAkB,GAGnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,cAAc,EAAgC,MAAM,uBAAuB,CAAC;AAGrF,8EAA8E;AAC9E,4FAA4F;AAC5F,mFAAmF;AACnF,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/esm/merge-env-config.js

@@ -0,0 +1,37 @@
+import { AppConfig } from '@equinor/fusion-framework-module-app';
+/**
+ * Merges `environment`/`endpoints` overrides into an `AppEnv`'s `config`.
+ *
+ * @remarks
+ * `AppConfig` stores both behind private fields exposed only through getters, so
+ * `{ ...env.config, endpoints: {...} }` silently drops everything it doesn't explicitly
+ * restate — a plain object spread copies no own enumerable properties off an `AppConfig`
+ * instance. Reach for this instead of hand-rolling that merge in a test fixture.
+ *
+ * @template TEnv - The `AppEnv` shape being merged into.
+ * @param env - The `AppEnv` to merge overrides into; left untouched, `config` may be omitted.
+ * @param overrides - Partial `environment`/`endpoints` values, merged over any existing config.
+ * @returns A new `AppEnv` with a new `AppConfig` reflecting the merge.
+ * @example
+ * ```ts
+ * const test = testApp.extend('appEnv', ({ appEnv }) =>
+ *   mergeEnvConfig(appEnv, { endpoints: { 'cpr-api': { url: backendBaseUrl } } }),
+ * );
+ * ```
+ */
+export function mergeEnvConfig(env, overrides) {
+    // each overridden endpoint keeps any field the caller didn't explicitly override
+    const endpoints = Object.entries(overrides.endpoints ?? {}).reduce(
+    // defaults, then any existing endpoint, then the override (override wins)
+    (acc, [key, override]) => Object.assign(acc, { [key]: Object.assign({ url: '', scopes: [] }, acc[key], override) }), { ...env.config?.endpoints });
+    // caller-supplied environment values win over the existing ones
+    return {
+        ...env,
+        config: new AppConfig({
+            environment: { ...env.config?.environment, ...overrides.environment },
+            endpoints,
+        }),
+    };
+}
+export default mergeEnvConfig;
+//# sourceMappingURL=merge-env-config.js.map

package/dist/esm/merge-env-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-env-config.js","sourceRoot":"","sources":["../../src/merge-env-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAcjE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAS,EACT,SAEC;IAED,iFAAiF;IACjF,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM;IAChE,0EAA0E;IAC1E,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,EAAE,CACvB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,EAC3F,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAC7B,CAAC;IACF,gEAAgE;IAChE,OAAO;QACL,GAAG,GAAG;QACN,MAAM,EAAE,IAAI,SAAS,CAAC;YACpB,WAAW,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE;YACrE,SAAS;SACV,CAAC;KACH,CAAC;AACJ,CAAC;AAED,eAAe,cAAc,CAAC"}

package/dist/esm/resolve-app-test-env.js

@@ -8,11 +8,11 @@ import { resolvePackage } from '@equinor/fusion-framework-cli/utils';
  * back to an empty config if none exists.
  *
  * @remarks
- * Intended to seed `@equinor/fusion-framework-vitest-plugin-react-app/test`'s `testApp` `env` fixture, so
+ * Intended to seed `@equinor/fusion-framework-vitest-plugin-react-app/test`'s `testApp` `appEnv` fixture, so
  * a test suite exercises the application's real manifest/config instead of a hand-maintained
  * duplicate. Anything a specific test still needs faked (a missing endpoint, a different
- * `appKey`) can be layered on top with `testApp.extend('env', ...)` or a per-test
- * `test.override('env', ...)`.
+ * `appKey`) can be layered on top with `testApp.extend('appEnv', ...)` or a per-test
+ * `test.override('appEnv', ...)`.
  *
  * @param options - Resolution options; `entrypoint` defaults to the current working directory.
  * @returns The resolved application manifest and config.
@@ -25,8 +25,8 @@ import { resolvePackage } from '@equinor/fusion-framework-cli/utils';
  * import { configure } from '../config';
  *
  * const test = testApp
- *   .extend('env', { injected: true }, () => resolveAppTestEnv())
- *   .extend('configure', { injected: true }, () => configure);
+ *   .extend('appEnv', { injected: true }, () => resolveAppTestEnv())
+ *   .extend('configureApp', { injected: true }, () => configure);
  * ```
  */
 export const resolveAppTestEnv = async (options) => {

package/dist/esm/scope/resolve-app-scope.js

@@ -14,7 +14,7 @@ import { defaultAppEnv } from './default-app-env';
 export async function resolveAppScope(options) {
     const { configure, env, fusion: providedFusion } = options ?? {};
     const resolvedEnv = env ?? defaultAppEnv;
-    const framework = await resolveFusion(resolvedEnv, providedFusion);
+    const framework = await resolveFusion({ env: resolvedEnv, fusion: providedFusion });
     const app = await mockAppModules(configure, resolvedEnv, framework);
     return { framework, app };
 }

package/dist/esm/scope/resolve-app-scope.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-app-scope.js","sourceRoot":"","sources":["../../../src/scope/resolve-app-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAelD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAGnC,OAID;IACC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACjE,MAAM,WAAW,GAAG,GAAG,IAAK,aAAsB,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IACnE,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACpE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"resolve-app-scope.js","sourceRoot":"","sources":["../../../src/scope/resolve-app-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAelD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAGnC,OAID;IACC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACjE,MAAM,WAAW,GAAG,GAAG,IAAK,aAAsB,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IACpF,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACpE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;AAC5B,CAAC"}

package/dist/esm/scope/resolve-fusion.js

@@ -1,5 +1,6 @@
 import { mockFramework } from '@equinor/fusion-framework/mock';
 import { enableAppManifestMock } from '@equinor/fusion-framework-app/mock';
+import { enableNavigation, createHistory } from '@equinor/fusion-framework-module-navigation';
 import { defaultAppEnv } from './default-app-env';
 /**
  * Resolves the parent Fusion instance backing an application module scope, building a
@@ -7,12 +8,22 @@ import { defaultAppEnv } from './default-app-env';
  * given.
  *
  * @template TEnv - The application environment descriptor.
- * @param env - The application environment; defaults to {@link defaultAppEnv}.
- * @param fusion - An already-built parent Fusion instance to reuse instead.
+ * @param options - `env` seeds the built-in app manifest mock; navigation defaults to real
+ *   browser history, matching Browser Mode. `configure` runs afterwards on the same
+ *   configurator — e.g. call `enableNavigation` again to override the history, or register
+ *   extra modules and service discovery entries. `fusion`, an already-built parent instance,
+ *   is reused as-is and skips `configure` entirely.
  * @returns The given `fusion`, or a fresh mocked parent Fusion instance.
  */
-export async function resolveFusion(env, fusion) {
+export async function resolveFusion(options) {
+    const { env, fusion, configure } = options ?? {};
     return (fusion ??
-        mockFramework((configurator) => enableAppManifestMock(configurator, env ?? defaultAppEnv)));
+        mockFramework(async (configurator) => {
+            enableAppManifestMock(configurator, env ?? defaultAppEnv);
+            enableNavigation(configurator, {
+                configure: (config) => config.setHistory(createHistory('browser')),
+            });
+            await configure?.(configurator);
+        }));
 }
 //# sourceMappingURL=resolve-fusion.js.map

package/dist/esm/scope/resolve-fusion.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-fusion.js","sourceRoot":"","sources":["../../../src/scope/resolve-fusion.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAU,EACV,MAAe;IAEf,OAAO,CACL,MAAM;QACN,aAAa,CAAc,CAAC,YAAY,EAAE,EAAE,CAC1C,qBAAqB,CAAC,YAAY,EAAE,GAAG,IAAK,aAAsB,CAAC,CACpE,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"resolve-fusion.js","sourceRoot":"","sources":["../../../src/scope/resolve-fusion.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAiC,MAAM,gCAAgC,CAAC;AAC9F,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAG9F,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAA+B,OAIjE;IACC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACjD,OAAO,CACL,MAAM;QACN,aAAa,CAAgC,KAAK,EAAE,YAAY,EAAE,EAAE;YAClE,qBAAqB,CAAC,YAAY,EAAE,GAAG,IAAK,aAAsB,CAAC,CAAC;YACpE,gBAAgB,CAAC,YAAY,EAAE;gBAC7B,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;aACnE,CAAC,CAAC;YACH,MAAM,SAAS,EAAE,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/esm/test-app.js

@@ -7,7 +7,7 @@ import { defaultAppEnv, resolveFusion, createAppScopeWrapper } from './scope';
  *
  * @remarks
  * An alternative to {@link renderAppComponent}/{@link renderAppHook} for a test file whose
- * cases share seeded fixture defaults: `env`/`configure` become suite-level concerns,
+ * cases share seeded fixture defaults: `appEnv`/`configureApp` become suite-level concerns,
  * overridden once per file (or per `describe` block) with `testApp.extend(...)`, rather than
  * an options object repeated on every call. `fusion`/`app` are still instantiated fresh per
  * test — only the seeded defaults are shared, not state between tests. They also resolve
@@ -18,6 +18,19 @@ import { defaultAppEnv, resolveFusion, createAppScopeWrapper } from './scope';
  * one-off test whose configuration is not shared by the rest of the file; reach for
  * `testApp` when several cases in a file share one set of seeded fixture defaults.
  *
+ * @remarks `configureApp`/`configureFusion` default to `undefined` here
+ * Unlike `@equinor/fusion-framework-vitest-plugin-react-app/test`'s `test`, this `testApp` does
+ * not resolve the app's real `src/config.ts` — it requires `appTestVitePlugin`'s Vite virtual
+ * modules to load that file as live code, which `testApp` (no Vite dependency) cannot do. Extend
+ * `test` from `/test` instead when a suite needs to compose with the app's real configuration.
+ *
+ * @remarks Overriding `fusion` bypasses `configureFusion`
+ * `fusion` and `configureFusion` are not independent: `fusion`'s default resolver is what
+ * calls `configureFusion`. `.override('fusion', ...)` replaces that resolver outright, so a
+ * `configureFusion` override on the same test/suite is silently never called. Use
+ * `configureFusion` to extend the base framework mock; use `fusion` only to replace it
+ * entirely (e.g. with a fully custom or non-mocked instance).
+ *
  * @example
  * ```tsx
  * testApp('resolves current context', async ({ app, render }) => {
@@ -29,7 +42,7 @@ import { defaultAppEnv, resolveFusion, createAppScopeWrapper } from './scope';
  * @example Seed a module for every test in a suite
  * ```tsx
  * describe('with a seeded context module', () => {
- *   const test = testApp.extend('configure', { injected: true }, () =>
+ *   const test = testApp.extend('configureApp', { injected: true }, () =>
  *     (configurator) => enableContextMock(configurator, (mock) => mock.setCurrentContext(projectA)),
  *   );
  *
@@ -39,14 +52,34 @@ import { defaultAppEnv, resolveFusion, createAppScopeWrapper } from './scope';
  *   });
  * });
  * ```
+ *
+ * @example Extend the parent framework mock with an application module
+ * ```tsx
+ * const test = testApp.extend('configureFusion', { injected: true }, () =>
+ *   (configurator) => {
+ *     enableFeatureFlagMock(configurator);
+ *     configurator.serviceDiscovery.addServices([
+ *       { key: 'people', uri: baseUrl('people') },
+ *       { key: 'context', uri: baseUrl('context') },
+ *     ]);
+ *   },
+ * );
+ * ```
  */
 export const testApp = baseTest
-    .extend('env', { injected: true }, defaultAppEnv)
+    .extend('appEnv', { injected: true }, defaultAppEnv)
     // `test.extend`'s plain-`value` overload rejects function types (ambiguous with the
     // resolver-`fn` overload), so a function-typed fixture default must go through `fn` instead.
-    .extend('configure', { injected: true }, () => undefined)
-    .extend('fusion', async ({ env }) => resolveFusion(env))
-    .extend('app', async ({ configure, env, fusion }) => mockAppModules(configure, env, fusion))
+    .extend('configureApp', { injected: true }, () => undefined)
+    // Runs after the built-in app manifest/navigation setup, so a test can register extra
+    // framework modules, service discovery entries, or call `enableNavigation` again to
+    // override the history, without reimplementing the base setup.
+    .extend('configureFusion', { injected: true }, () => undefined)
+    // IMPORTANT: `.override('fusion', ...)` replaces this resolver entirely, so `configureFusion`
+    // is never called — reach for `configureFusion` to extend the base mock, `fusion` only to
+    // replace it outright (e.g. with a fully custom or non-mocked instance).
+    .extend('fusion', async ({ appEnv, configureFusion }) => resolveFusion({ env: appEnv, configure: configureFusion }))
+    .extend('app', async ({ configureApp, appEnv, fusion }) => mockAppModules(configureApp, appEnv, fusion))
     .extend('render', ({ fusion, app }) => {
     const wrapper = createAppScopeWrapper({ framework: fusion, app });
     return (ui, options) => render(ui, { ...options, wrapper });

package/dist/esm/test-app.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-app.js","sourceRoot":"","sources":["../../src/test-app.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ;KAC5B,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,aAAa,CAAC;IACjD,oFAAoF;IACpF,6FAA6F;KAC5F,MAAM,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,SAA2C,CAAC;KAC1F,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAClD,cAAc,CAAkB,SAAS,EAAE,GAAa,EAAE,MAAM,CAAC,CAClE;KACA,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;IACpC,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,EAAgB,EAAE,OAAwC,EAAE,EAAE,CACpE,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;KACD,MAAM,CAAC,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;IACxC,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,CACL,EAAoC,EACpC,OAAmD,EACnD,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEL,eAAe,OAAO,CAAC"}
+{"version":3,"file":"test-app.js","sourceRoot":"","sources":["../../src/test-app.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAOpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ;KAC5B,MAAM,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,aAAa,CAAC;IACpD,oFAAoF;IACpF,6FAA6F;KAC5F,MAAM,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,SAA2C,CAAC;IAC9F,sFAAsF;IACtF,oFAAoF;IACpF,+DAA+D;KAC9D,MAAM,CACL,iBAAiB,EACjB,EAAE,QAAQ,EAAE,IAAI,EAAE,EAClB,GAAG,EAAE,CAAC,SAAgF,CACvF;IACD,8FAA8F;IAC9F,0FAA0F;IAC1F,yEAAyE;KACxE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE,EAAE,CACtD,aAAa,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC,CAC3D;KACA,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CACxD,cAAc,CAAkB,YAAY,EAAE,MAAgB,EAAE,MAAM,CAAC,CACxE;KACA,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;IACpC,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,EAAgB,EAAE,OAAwC,EAAE,EAAE,CACpE,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;KACD,MAAM,CAAC,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;IACxC,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,CACL,EAAoC,EACpC,OAAmD,EACnD,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEL,eAAe,OAAO,CAAC"}

package/dist/esm/test.js

@@ -2,7 +2,7 @@ import { testApp as baseTestApp } from './test-app';
 // resolved at test-time by `appTestVitePlugin` (@equinor/fusion-framework-vitest-plugin-react-app);
 // see virtual-modules.d.ts for the ambient module declarations
 import { manifest, config } from 'virtual:fusion-app-test-env';
-import { configure } from 'virtual:fusion-app-test-configure';
+import { configure as configureApp } from 'virtual:fusion-app-test-configure';
 /**
  * `vitest`'s `test`, pre-seeded with the application's own manifest, config, and
  * module-configurator, resolved the same way `ffc app build`/`ffc app dev` resolve them.
@@ -12,8 +12,15 @@ import { configure } from 'virtual:fusion-app-test-configure';
  * your `vitest.config.ts` `plugins`, which serves the virtual modules backing this fixture.
  * Running the same test file without the plugin registered fails to resolve those imports.
  *
- * Per-test mocking still works exactly like the base `testApp`: `.extend('configure', ...)` or
- * a per-case `test.override('env', ...)` layers on top of the resolved values.
+ * Per-test mocking still works exactly like the base `testApp`: `.extend('configureApp', ...)` or
+ * a per-case `test.override('appEnv', ...)` layers on top of the resolved values.
+ *
+ * @remarks `.override('configureApp', ...)` replaces the app's real `configure`
+ * This fixture's default value *is* the app's real `src/config.ts` `configure` export.
+ * `.override('configureApp', ...)` replaces that default outright, so an override that doesn't
+ * itself call the real `configure(configurator, args)` skips the app's production module setup
+ * entirely, rather than composing with it. See [Advanced usage](../docs/advanced.md) for the
+ * compose-safely pattern.
  *
  * @example
  * ```tsx
@@ -27,7 +34,7 @@ import { configure } from 'virtual:fusion-app-test-configure';
  * ```
  */
 export const test = baseTestApp
-    .extend('env', { injected: true }, { manifest, config })
-    .extend('configure', { injected: true }, () => configure);
+    .extend('appEnv', { injected: true }, { manifest, config })
+    .extend('configureApp', { injected: true }, () => configureApp);
 export default test;
 //# sourceMappingURL=test.js.map

package/dist/esm/test.js.map

@@ -1 +1 @@
-{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/test.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD,oGAAoG;AACpG,+DAA+D;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW;KAC5B,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;KACvD,MAAM,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAE5D,eAAe,IAAI,CAAC"}
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/test.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,YAAY,CAAC;AAEpD,oGAAoG;AACpG,+DAA+D;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,SAAS,IAAI,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,WAAW;KAC5B,MAAM,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;KAC1D,MAAM,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC;AAElE,eAAe,IAAI,CAAC"}

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 // Generated by genversion.
-export const version = '0.2.0-next.3';
+export const version = '1.0.0-next.4';
 //# sourceMappingURL=version.js.map