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

package/dist/types/app-test.d.ts

@@ -1,6 +1,7 @@
 export { renderAppHook, type RenderAppHookOptions, type RenderAppHookResult, } from './render-app-hook';
 export { renderAppComponent, type RenderAppComponentOptions, type RenderAppComponentResult, } from './render-app-component';
 export { testApp } from './test-app';
+export { mergeEnvConfig, type MergeEnvConfigOverrides } from './merge-env-config.js';
 export type { AppMockConfigureFn } from '@equinor/fusion-framework-app/mock';
 export { test } from './test';
 export { render } from './render';

package/dist/types/merge-env-config.d.ts

@@ -0,0 +1,33 @@
+import { AppConfig } from '@equinor/fusion-framework-module-app';
+import type { ConfigEnvironment } from '@equinor/fusion-framework-module-app';
+import type { AppEnv } from '@equinor/fusion-framework-app';
+type EndpointOverride = Partial<NonNullable<AppEnv['config']>['endpoints'][string]>;
+/**
+ * Overrides accepted by {@link mergeEnvConfig}.
+ */
+export type MergeEnvConfigOverrides<TConfig extends ConfigEnvironment = ConfigEnvironment> = {
+    environment?: Partial<TConfig>;
+    endpoints?: Record<string, EndpointOverride>;
+};
+/**
+ * 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 declare function mergeEnvConfig<TEnv extends AppEnv = AppEnv>(env: TEnv, overrides: MergeEnvConfigOverrides<TEnv['config'] extends AppConfig<infer TConfig> ? TConfig : ConfigEnvironment>): TEnv;
+export default mergeEnvConfig;

package/dist/types/resolve-app-test-env.d.ts

@@ -31,11 +31,11 @@ export type ResolveAppTestEnvOptions = {
  * 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.
@@ -48,8 +48,8 @@ export type ResolveAppTestEnvOptions = {
  * 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 declare const resolveAppTestEnv: (options?: ResolveAppTestEnvOptions) => Promise<AppTestEnv>;

package/dist/types/scope/resolve-fusion.d.ts

@@ -1,13 +1,23 @@
 import type { AppEnv } from '@equinor/fusion-framework-app';
 import type { Fusion } from '@equinor/fusion-framework';
+import { type FrameworkMockConfigureFn } from '@equinor/fusion-framework/mock';
+import type { AppModule } from '@equinor/fusion-framework-module-app';
+import type { NavigationModule } from '@equinor/fusion-framework-module-navigation';
 /**
  * Resolves the parent Fusion instance backing an application module scope, building a
  * fresh {@link mockFramework} instance with this app's own manifest served when none is
  * 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 declare function resolveFusion<TEnv extends AppEnv = AppEnv>(env?: TEnv, fusion?: Fusion): Promise<Fusion>;
+export declare function resolveFusion<TEnv extends AppEnv = AppEnv>(options?: {
+    env?: TEnv;
+    fusion?: Fusion;
+    configure?: FrameworkMockConfigureFn<[AppModule, NavigationModule]>;
+}): Promise<Fusion>;

package/dist/types/test-app.d.ts

@@ -2,12 +2,15 @@ import type { ReactElement } from 'react';
 import type { RenderOptions, RenderHookOptions } from 'vitest-browser-react';
 import type { AppMockConfigureFn } from '@equinor/fusion-framework-app/mock';
 import type { AppEnv } from '@equinor/fusion-framework-app';
+import type { AppModule } from '@equinor/fusion-framework-module-app';
+import type { NavigationModule } from '@equinor/fusion-framework-module-navigation';
+import type { FrameworkMockConfigureFn } from '@equinor/fusion-framework/mock';
 /**
  * `vitest`'s `test`, extended with an application module scope fixture.
  *
  * @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 +21,19 @@ import type { AppEnv } from '@equinor/fusion-framework-app';
  * 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 +45,7 @@ import type { AppEnv } from '@equinor/fusion-framework-app';
  * @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,30 +55,47 @@ import type { AppEnv } from '@equinor/fusion-framework-app';
  *   });
  * });
  * ```
+ *
+ * @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 declare const testApp: import("vitest").TestAPI<Omit<Omit<Omit<Omit<Omit<Omit<object, "$__test"> & Record<"env", AppEnv> & {
+export declare const testApp: import("vitest").TestAPI<Omit<Omit<Omit<Omit<Omit<Omit<Omit<object, "$__test"> & Record<"appEnv", AppEnv> & {
+    readonly $__worker?: object | undefined;
+    readonly $__file?: object | undefined;
+    readonly $__test?: (object & Record<"appEnv", AppEnv>) | undefined;
+}, "$__test"> & Record<"configureApp", AppMockConfigureFn | undefined> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", AppEnv>) | undefined;
-}, "$__test"> & Record<"configure", AppMockConfigureFn | undefined> & {
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"configureApp", AppMockConfigureFn | undefined>) | undefined;
+}, "$__test"> & Record<"configureFusion", FrameworkMockConfigureFn<[AppModule, NavigationModule]> | undefined> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", AppEnv> & Record<"configure", AppMockConfigureFn | undefined>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"configureApp", AppMockConfigureFn | undefined> & Record<"configureFusion", FrameworkMockConfigureFn<[AppModule, NavigationModule]> | undefined>) | undefined;
 }, "$__test"> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", AppEnv> & Record<"configure", AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>>) | undefined;
-}, "$__test"> & Record<"app", import("@equinor/fusion-framework-app").AppModulesInstance<unknown>> & {
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"configureApp", AppMockConfigureFn | undefined> & Record<"configureFusion", FrameworkMockConfigureFn<[AppModule, NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>>) | undefined;
+}, "$__test"> & Record<"app", import("@equinor/fusion-framework-module-app").AppModulesInstance<unknown>> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", AppEnv> & Record<"configure", AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("@equinor/fusion-framework-app").AppModulesInstance<unknown>>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"configureApp", AppMockConfigureFn | undefined> & Record<"configureFusion", FrameworkMockConfigureFn<[AppModule, NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("@equinor/fusion-framework-module-app").AppModulesInstance<unknown>>) | undefined;
 }, "$__test"> & Record<"render", (ui: ReactElement, options?: Omit<RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", AppEnv> & Record<"configure", AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("@equinor/fusion-framework-app").AppModulesInstance<unknown>> & Record<"render", (ui: ReactElement, options?: Omit<RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"configureApp", AppMockConfigureFn | undefined> & Record<"configureFusion", FrameworkMockConfigureFn<[AppModule, NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("@equinor/fusion-framework-module-app").AppModulesInstance<unknown>> & Record<"render", (ui: ReactElement, options?: Omit<RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>>) | undefined;
 }, "$__test"> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", AppEnv> & Record<"configure", AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("@equinor/fusion-framework-app").AppModulesInstance<unknown>> & Record<"render", (ui: ReactElement, options?: Omit<RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"configureApp", AppMockConfigureFn | undefined> & Record<"configureFusion", FrameworkMockConfigureFn<[AppModule, NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("@equinor/fusion-framework-module-app").AppModulesInstance<unknown>> & Record<"render", (ui: ReactElement, options?: Omit<RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>>) | undefined;
 }>;
 export default testApp;

package/dist/types/test.d.ts

@@ -7,8 +7,15 @@
  * 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
@@ -21,44 +28,48 @@
  * });
  * ```
  */
-export declare const test: import("vitest").TestAPI<Omit<Omit<Omit<Omit<Omit<Omit<Omit<Omit<object, "$__test"> & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & {
+export declare const test: import("vitest").TestAPI<Omit<Omit<Omit<Omit<Omit<Omit<Omit<Omit<Omit<object, "$__test"> & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & {
+    readonly $__worker?: object | undefined;
+    readonly $__file?: object | undefined;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv>) | undefined;
+}, "$__test"> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv>) | undefined;
-}, "$__test"> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & {
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined>) | undefined;
+}, "$__test"> & Record<"configureFusion", import("node_modules/@equinor/fusion-framework/src/mock/mock-framework").FrameworkMockConfigureFn<[import("node_modules/@equinor/fusion-framework-module-app/src/module").AppModule, import("node_modules/@equinor/fusion-framework-module-navigation/src/module").NavigationModule]> | undefined> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"configureFusion", import("node_modules/@equinor/fusion-framework/src/mock/mock-framework").FrameworkMockConfigureFn<[import("node_modules/@equinor/fusion-framework-module-app/src/module").AppModule, import("node_modules/@equinor/fusion-framework-module-navigation/src/module").NavigationModule]> | undefined>) | undefined;
 }, "$__test"> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"configureFusion", import("node_modules/@equinor/fusion-framework/src/mock/mock-framework").FrameworkMockConfigureFn<[import("node_modules/@equinor/fusion-framework-module-app/src/module").AppModule, import("node_modules/@equinor/fusion-framework-module-navigation/src/module").NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>>) | undefined;
 }, "$__test"> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"configureFusion", import("node_modules/@equinor/fusion-framework/src/mock/mock-framework").FrameworkMockConfigureFn<[import("node_modules/@equinor/fusion-framework-module-app/src/module").AppModule, import("node_modules/@equinor/fusion-framework-module-navigation/src/module").NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>>) | undefined;
 }, "$__test"> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"configureFusion", import("node_modules/@equinor/fusion-framework/src/mock/mock-framework").FrameworkMockConfigureFn<[import("node_modules/@equinor/fusion-framework-module-app/src/module").AppModule, import("node_modules/@equinor/fusion-framework-module-navigation/src/module").NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>>) | undefined;
 }, "$__test"> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>>) | undefined;
-}, "$__test"> & Record<"env", {
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"configureFusion", import("node_modules/@equinor/fusion-framework/src/mock/mock-framework").FrameworkMockConfigureFn<[import("node_modules/@equinor/fusion-framework-module-app/src/module").AppModule, import("node_modules/@equinor/fusion-framework-module-navigation/src/module").NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>>) | undefined;
+}, "$__test"> & Record<"appEnv", {
     manifest: import("@equinor/fusion-framework-cli/app").AppManifest;
     config: import("node_modules/@equinor/fusion-framework-module-app/src/AppConfig").AppConfig<import("node_modules/@equinor/fusion-framework-module-app/src/types").ConfigEnvironment> | undefined;
 }> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>> & Record<"env", {
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"configureFusion", import("node_modules/@equinor/fusion-framework/src/mock/mock-framework").FrameworkMockConfigureFn<[import("node_modules/@equinor/fusion-framework-module-app/src/module").AppModule, import("node_modules/@equinor/fusion-framework-module-navigation/src/module").NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>> & Record<"appEnv", {
         manifest: import("@equinor/fusion-framework-cli/app").AppManifest;
         config: import("node_modules/@equinor/fusion-framework-module-app/src/AppConfig").AppConfig<import("node_modules/@equinor/fusion-framework-module-app/src/types").ConfigEnvironment> | undefined;
     }>) | undefined;
-}, "$__test"> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & {
+}, "$__test"> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"env", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configure", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>> & Record<"env", {
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"configureApp", import("node_modules/@equinor/fusion-framework-app/src/mock/mock-app-modules").AppMockConfigureFn | undefined> & Record<"configureFusion", import("node_modules/@equinor/fusion-framework/src/mock/mock-framework").FrameworkMockConfigureFn<[import("node_modules/@equinor/fusion-framework-module-app/src/module").AppModule, import("node_modules/@equinor/fusion-framework-module-navigation/src/module").NavigationModule]> | undefined> & Record<"fusion", import("node_modules/@equinor/fusion-framework/src/types").Fusion<unknown>> & Record<"app", import("node_modules/@equinor/fusion-framework-module-app/src/types").AppModulesInstance<unknown>> & Record<"render", (ui: import("node_modules/@types/react").ReactElement, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderOptions, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderResult>> & Record<"renderHook", <Result, Props = undefined>(cb: (initialProps?: Props) => Result, options?: Omit<import("node_modules/vitest-browser-react/dist").RenderHookOptions<Props>, 'wrapper'>) => Promise<import("node_modules/vitest-browser-react/dist").RenderHookResult<Result, Props>>> & Record<"appEnv", {
         manifest: import("@equinor/fusion-framework-cli/app").AppManifest;
         config: import("node_modules/@equinor/fusion-framework-module-app/src/AppConfig").AppConfig<import("node_modules/@equinor/fusion-framework-module-app/src/types").ConfigEnvironment> | undefined;
     }>) | undefined;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "0.2.0-next.3";
+export declare const version = "1.0.0-next.4";

package/docs/advanced.md

@@ -1,10 +1,10 @@
 # Advanced Fusion app testing
 
-The `/test` entry point extends Vitest's test context with `env`, `configure`, `fusion`, `app`,
-`render`, and `renderHook`. Fixture declarations are reusable, while each test receives fresh
-framework and app module instances.
+The `/test` entry point extends Vitest's test context with `appEnv`, `configureApp`, `configureFusion`,
+`fusion`, `app`, `render`, and `renderHook`. Fixture declarations are reusable, while each test
+receives fresh framework and app module instances.
 
-This guide covers composing and overriding those six Fusion fixture values; see Vitest's own
+This guide covers composing and overriding those Fusion fixture values; see Vitest's own
 [Test Context](https://vitest.dev/guide/test-context) documentation for fixture scope, cleanup,
 and the general `test.extend`/`test.override` mechanics Fusion builds on.
 
@@ -24,7 +24,11 @@ module instances consumed by the rendered subject.
 
 ## Extend app configuration
 
-Create one reusable extended test when several cases need the same deterministic modules:
+Create one reusable extended test when several cases need the same deterministic modules.
+This must extend `test` from `/test`, not `testApp` from the main entry point:
+`testApp`'s `configureApp` defaults to `undefined` (no Vite dependency, so no way to load the
+real `src/config.ts` as live code), while `/test`'s `test` seeds it with the app's real
+`configure` export via `appTestVitePlugin`'s virtual modules.
 
 ```tsx
 import { enableContextMock } from '@equinor/fusion-framework-module-context/mock';
@@ -37,13 +41,13 @@ const project = {
   value: {},
 };
 
-export const test = baseTest.extend('configure', ({ configure }) => (configurator, args) => {
-  configure?.(configurator, args);
+export const test = baseTest.extend('configureApp', ({ configureApp }) => (configurator, args) => {
+  configureApp?.(configurator, args);
   enableContextMock(configurator, (mock) => mock.setCurrentContext(project));
 });
 ```
 
-Composing the original `configure` fixture preserves the application's production module
+Composing the original `configureApp` fixture preserves the application's production module
 configuration. See [Module mocks](module-mocks.md) for authentication, context, bookmark,
 feature-flag, HTTP, analytics, and telemetry boundaries.
 
@@ -51,6 +55,22 @@ feature-flag, HTTP, analytics, and telemetry boundaries.
 *files* need the same fixture default. Within one file, prefer `test.override(...)` (below):
 it replaces a fixture in place, so every test in that file keeps importing the same `test`.
 
+## Fake an endpoint URL with `mergeEnvConfig`
+
+`appEnv`'s `config` is an `AppConfig` instance — its `environment`/`endpoints` live behind
+private fields exposed only through getters, so `{ ...appEnv.config, endpoints: {...} }` copies
+nothing and silently drops the rest of the config. Use `mergeEnvConfig` to fake one endpoint's
+URL (e.g. the app's real backend, resolved from `app.config.ts`) while keeping every other
+endpoint and environment variable intact:
+
+```tsx
+import { mergeEnvConfig, test as baseTest } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
+
+export const test = baseTest.extend('appEnv', ({ appEnv }) =>
+  mergeEnvConfig(appEnv, { endpoints: { 'cpr-api': { url: backendBaseUrl } } }),
+);
+```
+
 ## Override a fixture for one test or a `describe` block
 
 `test.override('name', ...)` replaces a fixture's resolved value without creating a new `test`
@@ -59,6 +79,11 @@ and does not leak to sibling blocks or other files — each `describe` starts fr
 base `test` again. Called at the top of the file (outside any `describe`), it applies to every
 test in that file.
 
+**`configureApp`'s default value, from `/test`, *is* the app's real `src/config.ts` `configure`
+export.** `test.override('configureApp', ...)` replaces that default outright — an override
+that doesn't call the real `configure(configurator, args)` itself, as below, skips the app's
+production module setup entirely rather than composing with it.
+
 ```tsx
 import { test } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
 import { enableContextMock } from '@equinor/fusion-framework-module-context/mock';
@@ -69,7 +94,7 @@ import { configure } from '../config'; // the app's own, real module configurato
 const project = { id: 'project-a', title: 'Project A', type: { id: 'ProjectMaster' }, value: {} };
 
 describe('with an initial project', () => {
-  test.override('configure', { injected: true }, () => (configurator, args) => {
+  test.override('configureApp', { injected: true }, () => (configurator, args) => {
     configure(configurator, args); // compose the app's real configure, same as `.extend`
     enableContextMock(configurator, (mock) => mock.setCurrentContext(project));
   });
@@ -82,13 +107,13 @@ describe('with an initial project', () => {
 ```
 
 `fusion` itself can be overridden the same way, when a case needs a differently configured
-parent framework instance rather than a change to the app's own `configure`:
+parent framework instance rather than a change to the app's own `configureApp`:
 
 ```tsx
 describe('with a parent framework context', () => {
-  test.override('fusion', async ({ env }) =>
+  test.override('fusion', async ({ appEnv }) =>
     mockFramework<[AppModule, ContextModule]>((configurator) => {
-      enableAppManifestMock(configurator, env);
+      enableAppManifestMock(configurator, appEnv);
       enableContextMock(configurator, (mock) => mock.setCurrentContext(project));
     }),
   );
@@ -119,6 +144,45 @@ Use [`enableAppManifestMock`](../../../app/docs/testing.md#enableappmanifestmock
 when the custom parent must serve the app's manifest and config. Use
 [`mockFramework`](../../../framework/docs/testing.md) to seed the parent modules.
 
+## Extend the parent framework mock with `configureFusion`
+
+`fusion` (built by [`resolveFusion`](../src/scope/resolve-fusion.ts)) always carries a mocked
+`app` module (serving this app's manifest) and a `navigation` module with real browser history,
+matching Browser Mode. `configureFusion` runs on the same configurator afterwards, so a test can
+register extra framework-level modules or override that setup, without reimplementing it:
+
+```tsx
+import { enableFeatureFlagMock } from '@equinor/fusion-framework-module-feature-flag/mock';
+
+const test = baseTest.extend('configureFusion', { injected: true }, () => (configurator) => {
+  enableFeatureFlagMock(configurator);
+  configurator.serviceDiscovery.addServices([{ key: 'people', uri: baseUrl('people') }]);
+});
+```
+
+Note this is a **framework-scope** module set, distinct from the app-scope one `configureApp`
+seeds. A typical app registers its own `navigation` module independently, inside its own
+`config.ts`'s `configure` callback (what `configureApp` composes with) — so overriding history
+through `configureFusion` only affects framework-scope consumers, such as
+`useFramework<[NavigationModule]>().modules.navigation` or `useBookmarkNavigate`, not a
+rendered app's own router:
+
+```tsx
+import { enableNavigation, createHistory } from '@equinor/fusion-framework-module-navigation';
+
+test.override('configureFusion', { injected: true }, () => (configurator) =>
+  enableNavigation(configurator, {
+    configure: (config) => config.setHistory(createHistory('memory')),
+  }),
+);
+```
+
+**`.override('fusion', ...)` bypasses `configureFusion` entirely** — it replaces the resolver
+that calls it, so a `configureFusion` override on the same test/suite is silently never called.
+Reach for `configureFusion` to extend the base mock; reach for `fusion` only to replace it
+outright (e.g. with a fully custom or non-mocked instance) — see
+[Supply a custom parent framework](#supply-a-custom-parent-framework) above.
+
 ## Test routes and app lifecycle
 
 Render the complete `App` when assertions depend on route loaders, navigation, app

package/docs/migrating-an-existing-app.md

@@ -26,7 +26,7 @@ Browser Mode by providing its own renderer. See
 | `@testing-library/react`'s `render`/`renderHook`/`waitFor`/`act`, on `jsdom` or `happy-dom` | `vitest-browser-react`'s `render`/`renderHook` and `vitest`'s `waitFor`/`act`, on real Chromium (Vitest Browser Mode) |
 | `vi.mock('@equinor/fusion-framework-react/hooks', ...)`, `vi.mock('.../feature-flag', ...)`, and similar hand-rolled Fusion hook mocks | The owning module's `enable*Mock` from its own `/mock` entry point. See [Module mocks](module-mocks.md) |
 | A hand-written mock HTTP server (MirageJS, `msw/node`, `nock`) answering every backend call | `configurator.http.addMiddleware(...)` with a hand-written `HttpMiddleware`, or `createRouterMiddleware` for several routes under one base URI. See [HTTP testing](../../../modules/http/docs/testing.md) |
-| A hand-rolled test wrapper composing a router, context providers, and error boundaries around every render | `test.extend(...)` fixtures stacked on the base `render`/`configure` fixtures. See [Compose a router and a domain fixture](#compose-a-router-and-a-domain-fixture) below |
+| A hand-rolled test wrapper composing a router, context providers, and error boundaries around every render | `test.extend(...)` fixtures stacked on the base `render`/`configureApp` fixtures. See [Compose a router and a domain fixture](#compose-a-router-and-a-domain-fixture) below |
 | Synchronous assertions (`expect(screen.getByText(...))`) | Browser locators and `await expect.element(screen.getByText(...)).toBeVisible()` |
 
 ## Step 1: install Browser Mode dependencies
@@ -71,8 +71,8 @@ bookmark modules:
 +import { enableFeatureFlagMock } from '@equinor/fusion-framework-module-feature-flag/mock';
 +import { test as baseTest } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
 +
-+export const test = baseTest.extend('configure', ({ configure }) => (configurator, args) => {
-+  configure?.(configurator, args);
++export const test = baseTest.extend('configureApp', ({ configureApp }) => (configurator, args) => {
++  configureApp?.(configurator, args);
 +  configurator.msal.setAccount(null); // was: useCurrentUser returning undefined
 +  enableFeatureFlagMock(configurator, (mock) => mock.addFeature({ key: 'new-search', enabled: true }));
 +});
@@ -113,7 +113,7 @@ Use `createRouterMiddleware` for a mock server that handles several routes under
 +});
 ```
 
-Register the result with `configurator.http.addMiddleware(activityRoutes)` inside a `configure`
+Register the result with `configurator.http.addMiddleware(activityRoutes)` inside a `configureApp`
 fixture (see step 4). Port one route file at a time. Each ported file is independently testable.
 An unported route can fall through to the real network, so keep the old interceptor
 for tests that have not migrated yet or add a final fail-closed middleware; do not rely on a
@@ -128,7 +128,7 @@ router for the base URI used by the real client.
 ## Compose a router and a domain fixture
 
 Use a `render` extension for JSX wrappers such as routers and app-owned React providers. Use a
-`configure` extension for Fusion module state. Stack both extensions when a test needs both:
+`configureApp` extension for Fusion module state. Stack both extensions when a test needs both:
 
 ```tsx
 import type { ReactElement } from 'react';
@@ -143,9 +143,9 @@ const testWithRouter = baseTest.extend('render', () => (ui: ReactElement) => {
   return baseTest.render(<Router routes={routes} />);
 });
 
-// The domain fixture uses the same shape as any other `configure` extension.
-export const test = testWithRouter.extend('configure', ({ configure }) => (configurator, args) => {
-  configure?.(configurator, args);
+// The domain fixture uses the same shape as any other `configureApp` extension.
+export const test = testWithRouter.extend('configureApp', ({ configureApp }) => (configurator, args) => {
+  configureApp?.(configurator, args);
   enableContextMock(configurator, (mock) => mock.setCurrentContext(projectA));
 });
 ```
@@ -153,7 +153,7 @@ export const test = testWithRouter.extend('configure', ({ configure }) => (confi
 A test importing this `test` gets both the router wrapper and seeded Fusion context.
 
 Keep app-owned React providers, such as authorization, schema, or snackbar providers, in the
-`render` extension. Move only Fusion module state to `configure` and `enable*Mock`.
+`render` extension. Move only Fusion module state to `configureApp` and `enable*Mock`.
 
 ## Step 4: update renders and assertions
 

package/docs/module-mocks.md

@@ -93,8 +93,8 @@ const project = {
   value: {},
 };
 
-export const test = baseTest.extend('configure', ({ configure }) => (configurator, args) => {
-  configure?.(configurator, args);
+export const test = baseTest.extend('configureApp', ({ configureApp }) => (configurator, args) => {
+  configureApp?.(configurator, args);
   configurator.msal.setAccount({ name: 'Ada Lovelace' });
   enableContextMock(configurator, (mock) => mock.setCurrentContext(project));
   enableFeatureFlagMock(configurator, (mock) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-vitest-plugin-react-app",
-  "version": "0.2.0-next.3",
+  "version": "1.0.0-next.4",
   "description": "Vite plugin resolving an application's manifest, config, and module-configurator as virtual modules for testing.",
   "type": "module",
   "exports": {
@@ -47,13 +47,14 @@
     "access": "public"
   },
   "dependencies": {
-    "@equinor/fusion-framework-cli": "15.2.8-next.2",
     "@equinor/fusion-framework": "8.1.0-next.1",
+    "@equinor/fusion-framework-cli": "15.2.8-next.2",
+    "@equinor/fusion-framework-module": "6.1.3-next.0",
     "@equinor/fusion-framework-module-app": "8.1.0-next.0",
+    "@equinor/fusion-framework-module-navigation": "7.0.8-next.0",
     "@equinor/fusion-framework-react": "9.0.0-next.0",
-    "@equinor/fusion-framework-react-module": "4.0.3-next.0",
-    "@equinor/fusion-framework-module": "6.1.3-next.0",
     "@equinor/fusion-framework-app": "14.0.0-next.1",
+    "@equinor/fusion-framework-react-module": "4.0.3-next.0",
     "@equinor/fusion-imports": "2.0.3-next.0"
   },
   "devDependencies": {