Rename testApp/test fixture configure to configureApp, add configureFusion (#5324)

* Rename testApp/test fixtures: configure -> configureApp, add configureFusion

Renames the app-scope mock-configuration fixture from 'configure' to
'configureApp', for symmetry with the new 'configureFusion' fixture that
composes with the parent framework mock (app manifest + navigation).

Updates all cookbook and package consumers, docs (README, advanced.md,
migrating-an-existing-app.md, module-mocks.md), and adds changesets.

* Rename testApp/test fixture 'env' to 'appEnv', add mergeEnvConfig

Renames the base env fixture to appEnv for symmetry with configureApp/
configureFusion, and exposes mergeEnvConfig (from the /test entry point)
for overriding one endpoint or environment value on an AppEnv's AppConfig
without dropping the rest of it -- a plain object spread over AppConfig
copies nothing, since it stores environment/endpoints behind private
fields exposed only through getters.

* Address review: fix renderAppComponent option name, add configureFusion test

- docs/advanced.md: the 'choose a rendering API' table row for
  renderAppComponent still said configureApp, but that imperative
  helper's own option was never renamed -- it's still configure.
- testApp.test.tsx: add coverage for the configureFusion fixture,
  asserting a memory history pushed onto ahead of framework
  initialization is observable from a rendered component, proving
  configureFusion ran before the framework finished resolving.

Author: odinr

.changeset/cookbook-app-react-context_rename-configure-fixture.md

@@ -0,0 +1,5 @@
+---
+"@equinor/fusion-framework-cookbook-app-react-context": patch
+---
+
+Internal: update the test suite for `@equinor/fusion-framework-vitest-plugin-react-app`'s `configure`→`configureApp` and `env`→`appEnv` fixture renames; no behavior changes.

.changeset/cookbook-app-react-module_rename-configure-fixture.md

@@ -0,0 +1,5 @@
+---
+"@equinor/fusion-framework-cookbook-app-react-module": patch
+---
+
+Internal: update the test suite for `@equinor/fusion-framework-vitest-plugin-react-app`'s `configure`→`configureApp` fixture rename; no behavior changes.

.changeset/cookbook-app-react-msal_rename-configure-fixture.md

@@ -0,0 +1,5 @@
+---
+"@equinor/fusion-framework-cookbook-app-react-msal": patch
+---
+
+Internal: update the test suite for `@equinor/fusion-framework-vitest-plugin-react-app`'s `configure`→`configureApp` fixture rename; no behavior changes.

.changeset/cookbook-app-react-router_rename-configure-fixture.md

@@ -0,0 +1,5 @@
+---
+"@equinor/fusion-framework-cookbook-app-react-router": patch
+---
+
+Internal: update the test suite for `@equinor/fusion-framework-vitest-plugin-react-app`'s `configure`→`configureApp` fixture rename; no behavior changes.

.changeset/vitest-plugin-react-app_rename-configure-fixtures.md

@@ -0,0 +1,26 @@
+---
+"@equinor/fusion-framework-vitest-plugin-react-app": major
+---
+
+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 } } }),
+);
+```
+

cookbooks/app-react-context/src/App.test.tsx

@@ -43,7 +43,7 @@ const withSeededContext =
     enableContextMock(configurator, seed);
   };
 
-// --- test setup: each variant seeds a different context scenario via the `configure` fixture ---
+// --- test setup: each variant seeds a different context scenario via the `configureApp` fixture ---
 
 // --- tests ---
 
@@ -59,7 +59,7 @@ test('renders the current and related context sections once the app configuratio
 });
 
 describe('with an initial project', () => {
-  test.override('configure', { injected: true }, () =>
+  test.override('configureApp', { injected: true }, () =>
     withSeededContext((mock) => {
       mock.setCurrentContext(project);
     }),
@@ -75,7 +75,7 @@ describe('with an initial project', () => {
 });
 
 describe('with related contexts', () => {
-  test.override('configure', { injected: true }, () =>
+  test.override('configureApp', { injected: true }, () =>
     withSeededContext((mock) => {
       // a realistic pool: related items are a different type than the current context, never the same
       mock.setContexts([project, facility, discipline]);
@@ -98,7 +98,7 @@ describe('with related contexts', () => {
 });
 
 describe('when the app context changes', () => {
-  test.override('configure', { injected: true }, () =>
+  test.override('configureApp', { injected: true }, () =>
     withSeededContext((mock) => {
       mock.setContexts([project, facility]);
       mock.setCurrentContext(project);
@@ -129,14 +129,14 @@ describe('when the app context changes', () => {
 
 describe('with a parent framework context', () => {
   // the app mirrors the parent's context, while its local mock pool resolves mirrored items without a network request
-  test.override('configure', { injected: true }, () =>
+  test.override('configureApp', { injected: true }, () =>
     withSeededContext((mock) => {
       mock.setContexts([project, facility]);
     }),
   );
-  test.override('fusion', async ({ env }) =>
+  test.override('fusion', async ({ appEnv }) =>
     mockFramework<[AppModule, ContextModule]>((configurator) => {
-      enableAppManifestMock(configurator, env);
+      enableAppManifestMock(configurator, appEnv);
       enableContextMock(configurator, (mock) => {
         mock.setContexts([project, facility]);
         mock.setCurrentContext(project);

cookbooks/app-react-module/src/App.test.tsx

@@ -33,7 +33,7 @@ test("renders the demo module's resolved foo/bar values", async ({ render }) =>
 });
 
 describe('with an overridden demo configuration', () => {
-  test.override('configure', { injected: true }, () => withDemoConfig('https://example.com', 7));
+  test.override('configureApp', { injected: true }, () => withDemoConfig('https://example.com', 7));
 
   test('renders the overridden foo/bar values instead of the app defaults', async ({ render }) => {
     const { getByText, unmount } = await render(<App />);

cookbooks/app-react-msal/src/App.test.tsx

@@ -7,7 +7,7 @@ import { App } from './App';
 /**
  * Sets a named mock account instead of the msal mock's default "Test User" —
  * signed in before the msal provider initializes, so the provider's own
- * start-up path observes it. The cookbook registers no `configure` of its own,
+ * start-up path observes it. The cookbook registers no `configureApp` of its own,
  * so this is the test's entire configuration, not a composition with one.
  */
 const withMockAccount =
@@ -33,7 +33,7 @@ test('renders the default signed-in mock user once the app configuration has ini
 });
 
 describe('with a configured account', () => {
-  test.override('configure', { injected: true }, () =>
+  test.override('configureApp', { injected: true }, () =>
     withMockAccount({ name: 'Ada Lovelace', username: 'ada@equinor.com' }),
   );
 

cookbooks/app-react-router/src/__tests__/test-with-api-mock.ts

@@ -23,9 +23,9 @@ import { apiMock } from '../mocks/api-mock';
  * });
  * ```
  */
-export const testWithApiMock = baseTest.extend('configure', ({ configure }) => {
+export const testWithApiMock = baseTest.extend('configureApp', ({ configureApp }) => {
   const withApiMock: AppMockConfigureFn = (configurator, args) => {
-    configure?.(configurator, args);
+    configureApp?.(configurator, args);
     configurator.http.addMiddleware(createOpenApiMockMiddleware(apiMock));
   };
   return withApiMock;

packages/react/app/src/__tests__/testApp.test.tsx

@@ -3,6 +3,9 @@ import { describe, expect } from 'vitest';
 import { enableContextMock } from '@equinor/fusion-framework-module-context/mock';
 import type { ContextItem } from '@equinor/fusion-framework-module-context';
 import { useCurrentContext } from '@equinor/fusion-framework-react-app/context';
+import { useFramework } from '@equinor/fusion-framework-react';
+import { createHistory, enableNavigation } from '@equinor/fusion-framework-module-navigation';
+import type { NavigationModule } from '@equinor/fusion-framework-module-navigation';
 
 import { testApp } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
 
@@ -33,7 +36,7 @@ describe('testApp', () => {
 
   describe('with a seeded context module', () => {
     const test = testApp.extend(
-      'configure',
+      'configureApp',
       { injected: true },
       () => (configurator) =>
         enableContextMock(configurator, (mock) => mock.setCurrentContext(projectA)),
@@ -44,4 +47,30 @@ describe('testApp', () => {
       await expect.element(screen.getByText(projectA.title as string)).toBeVisible();
     });
   });
+
+  describe('with a configured parent framework', () => {
+    const NavigationLocation = () => {
+      const { navigation } = useFramework<[NavigationModule]>().modules;
+      return <p>{navigation.history.location.pathname}</p>;
+    };
+
+    // pushed on the history instance itself, before it's handed to the framework configurator,
+    // so a passing assertion also proves `configureFusion` ran ahead of framework initialization
+    const history = createHistory('memory');
+    history.push('/configured-by-configure-fusion');
+
+    const test = testApp.extend(
+      'configureFusion',
+      { injected: true },
+      () => (configurator) =>
+        enableNavigation(configurator, { configure: (config) => config.setHistory(history) }),
+    );
+
+    test('resolves the fusion instance with the configured navigation history', async ({
+      render,
+    }) => {
+      const screen = await render(<NavigationLocation />);
+      await expect.element(screen.getByText('/configured-by-configure-fusion')).toBeVisible();
+    });
+  });
 });