@equinor/fusion-framework-vitest-plugin-react-app 1.0.0 → 1.0.1

package/dist/types/index.d.ts

@@ -34,9 +34,10 @@ export type AppTestVitePluginOptions = ResolveAppTestEnvOptions & {
  *   // ...your own browser-mode config
  * });
  * ```
- * Exposes two virtual modules: `virtual:fusion-app-test-env` (`manifest`/`config`, as JSON) and
- * `virtual:fusion-app-test-configure` (a re-export of the resolved `configure` module, or
- * `undefined` if none exists). Not intended to be imported directly by application code.
+ * Exposes two virtual modules: `virtual:fusion-app-test-env`
+ * (`manifest`/`config`/`runtimeDependencies`, as JSON) and `virtual:fusion-app-test-configure`
+ * (a re-export of the resolved `configure` module, or `undefined` if none exists). Not intended
+ * to be imported directly by application code.
  *
  * @param options - Resolution options; `entrypoint` defaults to the current working directory.
  * @returns A Vite plugin instance.

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

@@ -6,6 +6,8 @@ import { type AppManifestFn, type AppConfigFn, type ApiAppConfig } from '@equino
 export type AppTestEnv = {
     manifest: AppManifest;
     config: ApiAppConfig;
+    /** Package names declared by the application as runtime dependencies. */
+    runtimeDependencies: Array<string>;
 };
 /**
  * Options for {@link resolveAppTestEnv}.
@@ -38,7 +40,7 @@ export type ResolveAppTestEnvOptions = {
  * `test.override('appEnv', ...)`.
  *
  * @param options - Resolution options; `entrypoint` defaults to the current working directory.
- * @returns The resolved application manifest and config.
+ * @returns The resolved application manifest, config, and module capabilities.
  * @throws If no `package.json` can be found from `entrypoint` upward, or an explicitly requested
  * `manifest`/`config` file does not exist.
  * @example

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

@@ -10,17 +10,16 @@ import type { NavigationModule } from '@equinor/fusion-framework-module-navigati
  *
  * @template TEnv - The application environment descriptor.
  * @param options - `env` seeds the built-in app manifest mock; navigation defaults to in-memory
- *   history, so tests don't leak URL/history state between runs. Feature flags default to the
- *   in-memory feature-flag mock, with none enabled, when the optional
- *   `@equinor/fusion-framework-module-feature-flag` peer dependency is installed. `configure`
- *   runs afterwards on the same configurator — e.g. call `enableNavigation` or
- *   `enableFeatureFlagMock` again to override either, or register extra modules and service
- *   discovery entries. `fusion`, an already-built parent instance, is reused as-is and skips
- *   `configure` entirely.
+ *   history, so tests don't leak URL/history state between runs. `runtimeDependencies` enables
+ *   parent module mocks associated with packages declared by the tested app. `configure` runs
+ *   afterwards on the same configurator — e.g. call `enableNavigation` 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>(options?: {
     env?: TEnv;
     fusion?: Fusion;
     configure?: FrameworkMockConfigureFn<[AppModule, NavigationModule]>;
+    runtimeDependencies?: ReadonlyArray<string>;
 }): Promise<Fusion>;

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

@@ -85,16 +85,13 @@ import type { FrameworkMockConfigureFn } from '@equinor/fusion-framework/mock';
  * });
  * ```
  *
- * @example Extend the parent framework mock with an application module
+ * @example Extend the parent framework mock with service discovery
  * ```tsx
  * const test = testApp.extend(
  *   'configureFusion',
  *   { injected: true },
  *   (): FrameworkMockConfigureFn<[AppModule, NavigationModule]> =>
  *     (configurator) => {
- *       // seed a specific flag rather than merely enabling the mock — that's already the
- *       // default when the optional feature-flag peer dependency is installed
- *       enableFeatureFlagMock(configurator, (mock) => mock.addFeature({ key: 'new-search', enabled: true }));
  *       configurator.serviceDiscovery.addServices([
  *         { key: 'people', uri: baseUrl('people') },
  *         { key: 'context', uri: baseUrl('context') },
@@ -103,33 +100,37 @@ import type { FrameworkMockConfigureFn } from '@equinor/fusion-framework/mock';
  * );
  * ```
  */
-export declare const testApp: import("vitest").TestAPI<Omit<Omit<Omit<Omit<Omit<Omit<Omit<object, "$__test"> & Record<"appEnv", AppEnv> & {
+export declare const testApp: import("vitest").TestAPI<Omit<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<"runtimeDependencies", string[]> & {
+    readonly $__worker?: object | undefined;
+    readonly $__file?: object | undefined;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"runtimeDependencies", string[]>) | undefined;
 }, "$__test"> & Record<"configureApp", AppMockConfigureFn | undefined> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"configureApp", AppMockConfigureFn | undefined>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"runtimeDependencies", string[]> & Record<"configureApp", AppMockConfigureFn | undefined>) | undefined;
 }, "$__test"> & Record<"configureFusion", FrameworkMockConfigureFn<[AppModule, NavigationModule]> | undefined> & {
     readonly $__worker?: object | undefined;
     readonly $__file?: object | undefined;
-    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"configureApp", AppMockConfigureFn | undefined> & Record<"configureFusion", FrameworkMockConfigureFn<[AppModule, NavigationModule]> | undefined>) | undefined;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", AppEnv> & Record<"runtimeDependencies", string[]> & 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

@@ -28,48 +28,59 @@
  * });
  * ```
  */
-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> & {
+export declare const test: import("vitest").TestAPI<Omit<Omit<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<"runtimeDependencies", string[]> & {
+    readonly $__worker?: object | undefined;
+    readonly $__file?: object | undefined;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]>) | 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<"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;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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", {
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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<"runtimeDependencies", string[]> & {
+    readonly $__worker?: object | undefined;
+    readonly $__file?: object | undefined;
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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<"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<"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", {
+    readonly $__test?: (object & Record<"appEnv", import("node_modules/@equinor/fusion-framework-app/src/types").AppEnv> & Record<"runtimeDependencies", string[]> & 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 = "1.0.0";
+export declare const version = "1.0.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-vitest-plugin-react-app",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Vite plugin resolving an application's manifest, config, and module-configurator as virtual modules for testing.",
   "type": "module",
   "exports": {
@@ -43,19 +43,24 @@
     "testing"
   ],
   "license": "ISC",
+  "files": [
+    "dist"
+  ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@equinor/fusion-framework-app": "13.1.0",
-    "@equinor/fusion-framework": "8.1.0",
-    "@equinor/fusion-framework-cli": "15.3.0",
-    "@equinor/fusion-framework-module-app": "8.1.0",
-    "@equinor/fusion-framework-module": "6.1.3",
-    "@equinor/fusion-framework-react": "9.0.0",
-    "@equinor/fusion-imports": "2.0.3",
-    "@equinor/fusion-framework-react-module": "4.0.3",
-    "@equinor/fusion-framework-module-navigation": "7.0.9"
+    "@equinor/fusion-framework": "8.1.1",
+    "@equinor/fusion-framework-app": "13.1.1",
+    "@equinor/fusion-framework-cli": "15.3.1",
+    "@equinor/fusion-framework-module": "6.1.4",
+    "@equinor/fusion-framework-module-app": "8.1.1",
+    "@equinor/fusion-framework-module-feature-flag": "2.1.1",
+    "@equinor/fusion-framework-module-navigation": "7.0.10",
+    "@equinor/fusion-framework-module-telemetry": "7.1.1",
+    "@equinor/fusion-framework-react": "9.0.1",
+    "@equinor/fusion-framework-react-module": "4.0.4",
+    "@equinor/fusion-imports": "2.0.4"
   },
   "devDependencies": {
     "@types/react": "^19.2.7",
@@ -68,8 +73,7 @@
     "typescript": "^7.0.2",
     "vite": "^8.0.0",
     "vitest": "^4.1.10",
-    "vitest-browser-react": "^2.2.0",
-    "@equinor/fusion-framework-module-feature-flag": "2.1.0"
+    "vitest-browser-react": "^2.2.0"
   },
   "peerDependencies": {
     "@types/react": "^18.0.0 || ^19.0.0",
@@ -80,13 +84,7 @@
     "rxjs": "^7.0.0",
     "vite": "^8.0.0",
     "vitest": "^4.0.0",
-    "vitest-browser-react": "^2.2.0",
-    "@equinor/fusion-framework-module-feature-flag": "2.1.0"
-  },
-  "peerDependenciesMeta": {
-    "@equinor/fusion-framework-module-feature-flag": {
-      "optional": true
-    }
+    "vitest-browser-react": "^2.2.0"
   },
   "scripts": {
     "build": "tsc -b",

package/CHANGELOG.md

@@ -1,81 +0,0 @@
-# @equinor/fusion-framework-vitest-plugin-react-app
-
-## 1.0.0
-
-### Minor Changes
-
-- f663b46: Add `@equinor/fusion-framework-vitest-plugin-react-app`: Vitest/`vitest-browser-react` helpers for testing a Fusion Framework React application inside a real, mock-backed application module scope — the same `FrameworkProvider` + `ModuleProvider` nesting `renderApp`/`createComponent` wire up in production, backed by `mockFramework` and `mockAppModules` (`@equinor/fusion-framework-app/mock`).
-  
-  ```tsx
-  import { renderAppHook } from '@equinor/fusion-framework-vitest-plugin-react-app';
-  import { useAccessToken } from '@equinor/fusion-framework-react-app/msal';
-  
-  const { result } = await renderAppHook(() => useAccessToken({ scopes: ['User.Read'] }));
-  await vi.waitFor(() => expect(result.current.pending).toBe(false));
-  ```
-  
-  Highlights:
-  
-  - `renderAppHook`/`renderAppComponent` — render a hook or component against the real `event`/`http`/`msal` module pipeline, with only the network boundary faked; the result carries a nested `fusion: { framework, app }` for driving a module directly after the initial render.
-  - `testApp` — a `vitest` `test` extended with `appEnv`/`configureApp`/`configureFusion`/`app`/`render`/`renderHook` fixtures, for a test file whose cases share one mocked scope. `configureApp` composes with the base app-module mock; `configureFusion` composes with the base parent-framework mock (app manifest and navigation) for extending framework-scope modules such as feature flags, service discovery, or navigation history.
-  - `appTestVitePlugin` — a Vite plugin resolving an application's own manifest, config, and module-configurator (the same pipeline `ffc app build`/`ffc app dev` use) as virtual modules, with `entrypoint` inferred from the Vitest project's own root (via `configResolved`) when not given explicitly, so each cookbook's `vitest.config.ts` needs no `entrypoint` override when run as part of a multi-project Vitest run.
-  - A `/test` entry-point exporting `test`/`render`, pre-seeded from the resolved manifest/config/configure once `appTestVitePlugin` is registered — no per-test `env`/`configure` wiring — plus `mergeEnvConfig` for overriding one endpoint's URL (or an `environment` value) on `appEnv` without dropping the rest of the app's `AppConfig`.
-  - A `/config` entry-point exporting `defineProject`: a drop-in for Vitest's own `defineProject`, pre-wired with `appTestVitePlugin` and the `@vitest/browser-playwright`/`chromium` browser provider, so a consuming app's own `vitest.config.ts` needs no browser-provider boilerplate:
-  
-    ```ts
-    import { defineProject } from '@equinor/fusion-framework-vitest-plugin-react-app/config';
-    import { name, version } from './package.json' with { type: 'json' };
-  
-    export default defineProject({ test: { name: `${name}@${version}` } });
-    ```
-  
-    `defineProject` defaults `test.browser.viewport` to `1024x768` instead of Vitest's own mobile-sized default, matching the low, fixed resolution most Fusion apps see in production through Citrix (pass `test.browser.viewport` to use a different size), sets `server.warmup.clientFiles: ['src/**/*.{ts,tsx}']` so lazily/code-split-imported source (e.g. route components reached only through dynamic `import()`) is transformed up front instead of forcing a page reload mid-test, and excludes `.d.ts` files from the default `server.warmup.clientFiles`/`optimizeDeps.entries` globs so a CJS-style declaration file (e.g. one using `export =`) does not fail the Vite warmup scan. `override` is deep-merged onto the default config via Vite's own `mergeConfig` (a plain object), or applied to the default config outright (a function receiving it) — for changes `mergeConfig` can't express, such as swapping `test.browser.provider` for a different `@vitest/browser-*` provider.
-  - The mocked framework enables the feature-flag mock by default (no flags enabled) when `@equinor/fusion-framework-module-feature-flag` is installed, so `useFeature` needs no `localStorage`/URL seeding in tests, and defaults navigation to in-memory history rather than browser history (which leaked URL/history state between tests) — `configureFusion`/`enableNavigation` can still opt back into browser history for a test that specifically needs it.
-  
-  `@vitest/browser-playwright` and `playwright` are peer dependencies of the package. Package documentation provides task-focused guides for setup, configuration, advanced fixtures, module mocks, and troubleshooting so npm, GitHub, and retrieval clients use the same canonical source as the VuePress site.
-
-### Patch Changes
-
-- f663b46: Document `test.override(...)` for overriding a fixture (`configure`, `fusion`, etc.) within a
-  single test file or `describe` block, alongside the existing `test.extend(...)` guide, in the
-  package's "Advanced usage" doc (`docs/advanced.md`).
-- f663b46: Add a "Migrate an existing app" guide (`docs/migrating-an-existing-app.md`) covering how to
-  move a suite from `@testing-library/react`/jsdom/happy-dom onto this package: installing
-  Browser Mode, replacing hand-rolled `vi.mock`s of Fusion hooks with each module's `enable*Mock`
-  entry point, porting a hand-written mock HTTP server to `createRouterMiddleware`, composing a
-  router fixture with a domain-state fixture in one file, and updating renders/assertions to the
-  async `vitest-browser-react` API. Linked from the package README and from
-  `docs/overview.md` and `testing-choosing-a-layer.md`.
-- f663b46: Add a "Why Browser Mode is the default" guide (`docs/why-browser-mode.md`) explaining
-  the rationale for defaulting to real Chromium over DOM emulation (the documented React 19 peer
-  dependency crash in the previous renderer, plus the framework's real-module testing philosophy),
-  the actual performance tradeoff (a real browser is slower, not faster — this was a fidelity
-  choice, not a speed optimization), and how to bring your own renderer for a single test file by
-  composing `mockFramework`/`mockAppModules`/`FrameworkProvider`/`ModuleProvider` directly with a
-  different render function (e.g. `@testing-library/react` on `happy-dom`). Linked from the
-  package README and `docs/overview.md`.
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-- Updated dependencies [f663b46]
-  - @equinor/fusion-framework-app@13.1.0
-  - @equinor/fusion-framework-cli@15.3.0
-  - @equinor/fusion-framework@8.1.0
-  - @equinor/fusion-framework-module-feature-flag@2.1.0
-  - @equinor/fusion-imports@2.0.3
-  - @equinor/fusion-framework-module-app@8.1.0
-  - @equinor/fusion-framework-module@6.1.3
-  - @equinor/fusion-framework-module-navigation@7.0.9
-  - @equinor/fusion-framework-react-module@4.0.3
-  - @equinor/fusion-framework-react@9.0.0

package/docs/advanced.md

@@ -1,209 +0,0 @@
-# Advanced Fusion app testing
-
-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 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.
-
-## Choose a rendering API
-
-| API | Use it when |
-| --- | --- |
-| `test` from `/test` | The app's manifest, config, and module configurator should resolve automatically |
-| `render` from `/test` | A standard `describe` or `it` block needs the automatically resolved app scope |
-| `renderAppHook` | A hook needs an app scope with explicitly supplied options |
-| `renderAppComponent` | A component needs explicit `env`, `configure`, or parent `fusion` options |
-| `testApp` | A reusable fixture should not depend on Vite's automatic app-file resolution |
-
-All Fusion rendering APIs initialize modules asynchronously and must be awaited. The lower
-level helpers return `fusion.framework` and `fusion.app`, allowing a test to drive the exact
-module instances consumed by the rendered subject.
-
-## Extend app configuration
-
-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';
-import { test as baseTest } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
-
-const project = {
-  id: 'project-a',
-  title: 'Project A',
-  type: { id: 'ProjectMaster' },
-  value: {},
-};
-
-export const test = baseTest.extend('configureApp', ({ configureApp }) => (configurator, args) => {
-  configureApp?.(configurator, args);
-  enableContextMock(configurator, (mock) => mock.setCurrentContext(project));
-});
-```
-
-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.
-
-`.extend(...)` returns a new, separately exported `test` — reach for it when several test
-*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`
-export. Called at the top of a `describe` block, the override applies to every test inside it
-and does not leak to sibling blocks or other files — each `describe` starts from the file's
-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';
-import { describe } from 'vitest';
-
-import { configure } from '../config'; // the app's own, real module configurator
-
-const project = { id: 'project-a', title: 'Project A', type: { id: 'ProjectMaster' }, value: {} };
-
-describe('with an initial project', () => {
-  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));
-  });
-
-  test('displays the initial context the app resolves on startup', async ({ render }) => {
-    const { getByText } = await render(<App />);
-    await expect.element(getByText(/project-a/)).toBeInTheDocument();
-  });
-});
-```
-
-`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 `configureApp`:
-
-```tsx
-describe('with a parent framework context', () => {
-  test.override('fusion', async ({ appEnv }) =>
-    mockFramework<[AppModule, ContextModule]>((configurator) => {
-      enableAppManifestMock(configurator, appEnv);
-      enableContextMock(configurator, (mock) => mock.setCurrentContext(project));
-    }),
-  );
-
-  test('mirrors the context the parent sets', async ({ render, fusion }) => {
-    /* ... */
-  });
-});
-```
-
-The `{ injected: true }` option matches the fixture's original declaration (see
-`test-app.tsx`/`test.tsx`); it is not required for `.override(...)` itself, but keeping it
-consistent avoids re-deriving whether the base fixture accepts a config-injected value. See
-the [React context cookbook](../../../../cookbooks/app-react-context/src/App.test.tsx) and
-[feature-flag cookbook](../../../../cookbooks/app-react-feature-flag/src/components/FeatureFlags.test.tsx)
-for full working examples, and Vitest's own
-[Test Context](https://vitest.dev/guide/test-context) guide for fixture scope and cleanup
-mechanics beyond what Fusion adds.
-
-## Supply a custom parent framework
-
-Override or explicitly pass `fusion` when the scenario depends on portal-level context,
-service discovery, authentication, or app manifests. Build the parent with `mockFramework`,
-then initialize the app beneath it. This exercises parent-to-app propagation without a
-running portal.
-
-Use [`enableAppManifestMock`](../../../app/docs/testing.md#enableappmanifestmockconfigurator-env)
-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 in-memory history, so
-tests don't leak URL/history state between runs. It also mocks the `featureFlag` module — with
-no flags enabled, so `useFeature` needs no `localStorage` or URL seeding — but only when
-`@equinor/fusion-framework-module-feature-flag` (an optional peer dependency) is actually
-installed; apps that don't use feature flags aren't forced to add it. `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) => {
-  // seed a specific flag rather than merely enabling the mock — that's already the default
-  enableFeatureFlagMock(configurator, (mock) => mock.addFeature({ key: 'new-search', enabled: true }));
-  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('browser')),
-  }),
-);
-```
-
-**`.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
-configuration, or several modules working together. Set the initial browser URL before
-rendering, interact through visible controls or `app.navigation`, and assert the rendered
-result.
-
-The [React router cookbook](../../../../cookbooks/app-react-router/README.md) demonstrates
-route-unit tests, complete application navigation, and HTTP-backed loaders.
-
-## Runner-level advanced behavior
-
-Fusion does not wrap these Vitest capabilities:
-
-- [Browser interactions and assertions](https://vitest.dev/guide/browser/)
-- [Asynchronous tests](https://vitest.dev/guide/learn/async)
-- [Test projects](https://vitest.dev/guide/projects)
-- [Coverage](https://vitest.dev/guide/coverage)
-- [Debugging](https://vitest.dev/guide/debugging)