@equinor/fusion-framework-vitest-plugin-react-app 0.2.0-next.0

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/render-app-component.js

@@ -0,0 +1,52 @@
+import { render } from 'vitest-browser-react';
+import { resolveAppScope, createAppScopeWrapper } from './scope';
+/**
+ * Renders a component inside a real, mock-backed application module scope.
+ *
+ * @remarks
+ * Wraps `vitest-browser-react`'s `render` with the same provider nesting
+ * `createComponent` uses in production — a `FrameworkProvider` (the parent Fusion
+ * instance, from `mockFramework`) around a `ModuleProvider` (this app's own modules,
+ * from `mockAppModules`, `@equinor/fusion-framework-app/mock`). See {@link renderAppHook}
+ * for the equivalent helper when testing a hook in isolation, rather than a component.
+ *
+ * @template TModules - Module descriptors beyond the default set.
+ * @template TEnv - The application environment descriptor.
+ * @param ui - The component to render.
+ * @param options - A `configure` callback and `env` for `mockAppModules`, plus any other `render` option.
+ * @returns The `render` result plus `fusion.framework` and `fusion.app`, once the mocked application module scope resolves.
+ *
+ * @example
+ * ```tsx
+ * const { getByText } = await renderAppComponent(<Apploader appKey="child-app" />, {
+ *   fusion: await mockFramework<[AppModule]>((configurator) => {
+ *     // register the child app's own manifest against the `app` module
+ *   }),
+ * });
+ * await expect.element(getByText(/mounted/)).toBeInTheDocument();
+ * ```
+ *
+ * @example Drive a module directly and assert the re-render
+ * ```tsx
+ * const { getByText, fusion } = await renderAppComponent<[ContextModule]>(<App />, {
+ *   configure: (configurator) => enableContextMock(configurator, (mock) => mock.setCurrentContext(projectA)),
+ * });
+ * await fusion.app.context.setCurrentContextByIdAsync(projectB.id);
+ * await expect.element(getByText(/project-b/)).toBeInTheDocument();
+ * ```
+ */
+export async function renderAppComponent(ui, options) {
+    const { configure, env, fusion: providedFusion, ...renderOptions } = options ?? {};
+    const { framework, app } = await resolveAppScope({
+        configure,
+        env,
+        fusion: providedFusion,
+    });
+    const result = await render(ui, {
+        ...renderOptions,
+        wrapper: createAppScopeWrapper({ framework, app }),
+    });
+    return { ...result, fusion: { framework, app } };
+}
+export default renderAppComponent;
+//# sourceMappingURL=render-app-component.js.map

package/dist/esm/render-app-component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-app-component.js","sourceRoot":"","sources":["../../src/render-app-component.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAQ9C,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAmDjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAItC,EAAgB,EAChB,OAAmD;IAEnD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACnF,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,eAAe,CAAiB;QAC/D,SAAS;QACT,GAAG;QACH,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,EAAE,EAAE;QAC9B,GAAG,aAAa;QAChB,OAAO,EAAE,qBAAqB,CAAW,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;KAC7D,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC;AACnD,CAAC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/esm/render-app-hook.js

@@ -0,0 +1,63 @@
+import { renderHook } from 'vitest-browser-react';
+import { resolveAppScope, createAppScopeWrapper } from './scope';
+/**
+ * Renders a hook inside a real, mock-backed application module scope.
+ *
+ * @remarks
+ * Wraps `vitest-browser-react`'s `renderHook` with the same provider nesting
+ * `createComponent` uses in production — a `FrameworkProvider` (the parent Fusion
+ * instance, from `mockFramework`) around a `ModuleProvider` (this app's own modules,
+ * from `mockAppModules`, `@equinor/fusion-framework-app/mock`) — the real
+ * `event`/`http`/`msal` module pipeline. Only requests a seeded middleware answers are
+ * faked; a request with no matching middleware still reaches the real network. Use this
+ * for any hook that reads from the application module scope or the parent framework
+ * (e.g. `useAppModule`, `useAccessToken`, `useFramework`), instead of hand-wiring
+ * `mockFramework`, `mockAppModules`, `FrameworkProvider` and `ModuleProvider` in every test.
+ *
+ * @template Result - The value returned by the rendered hook.
+ * @template Props - The props accepted by the rendered hook.
+ * @template TModules - Module descriptors beyond the default set.
+ * @template TEnv - The application environment descriptor.
+ * @param render - The hook to render, receiving `initialProps`.
+ * @param options - A `configure` callback and `env` for `mockAppModules`, plus any other
+ *   `renderHook` option.
+ * @returns The `renderHook` result plus `fusion.framework` and `fusion.app`, once the mocked application module scope resolves.
+ *
+ * @example
+ * ```tsx
+ * const { result } = await renderAppHook(() => useAccessToken({ scopes: ['User.Read'] }));
+ * await vi.waitFor(() => expect(result.current.pending).toBe(false));
+ * ```
+ *
+ * @example Sign in a named user
+ * ```tsx
+ * const { result } = await renderAppHook(() => useCurrentAccount(), {
+ *   configure: (configurator) => configurator.msal.setAccount({ name: 'Ada Lovelace' }),
+ * });
+ * ```
+ *
+ * @example Reuse a pre-built parent Fusion instance
+ * ```tsx
+ * const fusion = await mockFramework<[AppModule]>((configurator) =>
+ *   enableAppManifestMock(configurator, env),
+ * );
+ *
+ * const { result: a } = await renderAppHook(() => useAccessToken({ scopes: ['User.Read'] }), { fusion });
+ * const { result: b } = await renderAppHook(() => useCurrentAccount(), { fusion });
+ * ```
+ */
+export async function renderAppHook(render, options) {
+    const { configure, env, fusion: providedFusion, ...renderHookOptions } = options ?? {};
+    const { framework, app } = await resolveAppScope({
+        configure,
+        env,
+        fusion: providedFusion,
+    });
+    const result = await renderHook(render, {
+        ...renderHookOptions,
+        wrapper: createAppScopeWrapper({ framework, app }),
+    });
+    return { ...result, fusion: { framework, app } };
+}
+export default renderAppHook;
+//# sourceMappingURL=render-app-hook.js.map

package/dist/esm/render-app-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-app-hook.js","sourceRoot":"","sources":["../../src/render-app-hook.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAQlD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA0DjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAMjC,MAAwC,EACxC,OAAqD;IAErD,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,iBAAiB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IACvF,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,MAAM,eAAe,CAAiB;QAC/D,SAAS;QACT,GAAG;QACH,MAAM,EAAE,cAAc;KACvB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE;QACtC,GAAG,iBAAiB;QACpB,OAAO,EAAE,qBAAqB,CAAW,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;KAC7D,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC;AACnD,CAAC;AAED,eAAe,aAAa,CAAC"}

package/dist/esm/render.js

@@ -0,0 +1,49 @@
+import { renderAppComponent, } from './render-app-component';
+// resolved at test-time by `appTestVitePlugin` (@equinor/fusion-framework-vitest-plugin-react-app);
+// see virtual-modules.d.ts for the ambient module declarations
+import { manifest, config } from 'virtual:fusion-app-test-env';
+import { configure } from 'virtual:fusion-app-test-configure';
+/**
+ * Renders a component inside the application's own module scope for use in plain `describe`/`it`
+ * tests, using the manifest, config, and module-configurator resolved for this application — no
+ * per-test wiring, and no custom `test` fixture required.
+ *
+ * @remarks
+ * Requires `appTestVitePlugin` (`@equinor/fusion-framework-vitest-plugin-react-app`) registered in
+ * your `vitest.config.ts` `plugins`, which serves the virtual modules backing the resolved
+ * `env`/`configure`. Running the same test file without the plugin registered fails to resolve
+ * those imports.
+ *
+ * Pass `env` or `configure` in `options` to override the resolved values for a single render.
+ *
+ * @template TModules - Module descriptors beyond the default set.
+ * @param ui - The component to render.
+ * @param options - Overrides for `env`/`configure`, plus any other `renderAppComponent` option.
+ * @returns The `render` result plus `fusion.framework` and `fusion.app`, once the mocked application module scope resolves.
+ * @example
+ * ```tsx
+ * import { describe, expect, it } from 'vitest';
+ * import { render } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
+ * import { App } from '../App';
+ *
+ * describe('App', () => {
+ *   it('renders the app', async () => {
+ *     const { getByRole } = await render(<App />);
+ *     await expect.element(getByRole('heading')).toBeVisible();
+ *   });
+ * });
+ * ```
+ */
+export async function render(ui, options) {
+    const { configure: configureOverride, env: envOverride, ...renderOptions } = options ?? {};
+    return renderAppComponent(ui, {
+        ...renderOptions,
+        env: envOverride ?? { manifest, config },
+        // the resolved `configure` is generic over the app's own module set (`unknown`), while
+        // `TModules` here is caller-supplied *extra* modules — safe to widen for the common case
+        // where callers don't override it with a `TModules`-specific configurator
+        configure: (configureOverride ?? configure),
+    });
+}
+export default render;
+//# sourceMappingURL=render.js.map

package/dist/esm/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/render.tsx"],"names":[],"mappings":"AAMA,OAAO,EACL,kBAAkB,GAGnB,MAAM,wBAAwB,CAAC;AAEhC,oGAAoG;AACpG,+DAA+D;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,EAAgB,EAChB,OAAqD;IAErD,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAC3F,OAAO,kBAAkB,CAAmB,EAAE,EAAE;QAC9C,GAAG,aAAa;QAChB,GAAG,EAAE,WAAW,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE;QACxC,uFAAuF;QACvF,yFAAyF;QACzF,0EAA0E;QAC1E,SAAS,EAAE,CAAC,iBAAiB,IAAI,SAAS,CAAqD;KAChG,CAAC,CAAC;AACL,CAAC;AAED,eAAe,MAAM,CAAC"}

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

@@ -0,0 +1,85 @@
+import { FileNotFoundError } from '@equinor/fusion-imports';
+import { createAppManifestFromPackage, loadAppManifest, loadAppConfig, mergeAppManifests, ApiAppConfigSchema, } from '@equinor/fusion-framework-cli/app';
+import { resolvePackage } from '@equinor/fusion-framework-cli/utils';
+/**
+ * Resolves an application's manifest and config using the same pipeline `ffc app build`/
+ * `ffc app dev` use: a base manifest generated from `package.json`, merged with a local
+ * `app.manifest.ts` if one exists; and `app.config.ts` for endpoints/environment, falling
+ * 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
+ * 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', ...)`.
+ *
+ * @param options - Resolution options; `entrypoint` defaults to the current working directory.
+ * @returns The resolved application manifest and config.
+ * @throws If no `package.json` can be found from `entrypoint` upward, or an explicitly requested
+ * `manifest`/`config` file does not exist.
+ * @example
+ * ```ts
+ * import { resolveAppTestEnv } from '@equinor/fusion-framework-vitest-plugin-react-app';
+ * import { testApp } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
+ * import { configure } from '../config';
+ *
+ * const test = testApp
+ *   .extend('env', { injected: true }, () => resolveAppTestEnv())
+ *   .extend('configure', { injected: true }, () => configure);
+ * ```
+ */
+export const resolveAppTestEnv = async (options) => {
+    const pkg = await resolvePackage({ cwd: options?.entrypoint });
+    const env = { command: 'build', mode: 'test', root: pkg.root, environment: 'test' };
+    const baseManifest = createAppManifestFromPackage(env, pkg.packageJson);
+    const [manifest, config] = await Promise.all([
+        resolveManifest(env, baseManifest, options?.manifest),
+        resolveConfig(env, options?.config),
+    ]);
+    return { manifest, config };
+};
+/**
+ * Loads `app.manifest(.*)?` (or applies an inline {@link AppManifestFn}), falling back to the
+ * package-derived manifest when none exists — mirrors `ffc app build`'s own fallback so a test
+ * env matches a real build with zero manifest file.
+ */
+const resolveManifest = async (env, base, manifest) => {
+    // an inline function is applied directly, the same way a loaded `app.manifest.ts`'s default export would be
+    if (typeof manifest === 'function') {
+        const result = await manifest(env, { base });
+        return mergeAppManifests(base, result ?? {});
+    }
+    try {
+        return (await loadAppManifest(env, { base, file: manifest })).manifest;
+    }
+    catch (err) {
+        // an explicitly requested manifest that's missing is a real error; only the default lookup falls back
+        if (err instanceof FileNotFoundError && !manifest)
+            return base;
+        throw err;
+    }
+};
+/**
+ * Loads `app.config(.*)?` (or applies an inline {@link AppConfigFn}), falling back to an empty
+ * config when none exists — mirrors `ffc app build`'s own fallback so a test env matches a real
+ * build with zero config file.
+ */
+const resolveConfig = async (env, config) => {
+    // an inline function is applied directly, the same way a loaded `app.config.ts`'s default export would be
+    if (typeof config === 'function') {
+        const result = await config(env, { base: { environment: {} } });
+        return ApiAppConfigSchema.parse(result ?? { environment: {} });
+    }
+    try {
+        return (await loadAppConfig(env, { file: config })).config;
+    }
+    catch (err) {
+        // an explicitly requested config that's missing is a real error; only the default lookup falls back
+        if (err instanceof FileNotFoundError && !config)
+            return { environment: {} };
+        throw err;
+    }
+};
+export default resolveAppTestEnv;
+//# sourceMappingURL=resolve-app-test-env.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-app-test-env.js","sourceRoot":"","sources":["../../src/resolve-app-test-env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,EACL,4BAA4B,EAC5B,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GAInB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AA4BrE;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EACpC,OAAkC,EACb,EAAE;IACvB,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAe,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAEhG,MAAM,YAAY,GAAG,4BAA4B,CAAC,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACxE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC3C,eAAe,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAC;QACrD,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;KACpC,CAAC,CAAC;IAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,eAAe,GAAG,KAAK,EAC3B,GAAe,EACf,IAAiB,EACjB,QAAiC,EACX,EAAE;IACxB,4GAA4G;IAC5G,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,OAAO,iBAAiB,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,eAAe,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,sGAAsG;QACtG,IAAI,GAAG,YAAY,iBAAiB,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC/D,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,aAAa,GAAG,KAAK,EACzB,GAAe,EACf,MAA6B,EACN,EAAE;IACzB,0GAA0G;IAC1G,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,aAAa,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oGAAoG;QACpG,IAAI,GAAG,YAAY,iBAAiB,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;QAC5E,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/esm/scope/create-app-scope-wrapper.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { FrameworkProvider } from '@equinor/fusion-framework-react';
+import { ModuleProvider } from '@equinor/fusion-framework-react-module';
+/**
+ * The provider nesting `createComponent` uses in production, for wrapping a component or
+ * hook under test in its resolved {@link AppScope}.
+ *
+ * @template TModules - Module descriptors beyond the default set.
+ * @param scope - The resolved parent Fusion instance and application module scope.
+ * @returns A wrapper component nesting a `FrameworkProvider` around a `ModuleProvider`.
+ */
+export function createAppScopeWrapper({ framework, app, }) {
+    return ({ children }) => (_jsx(FrameworkProvider, { value: framework, children: _jsx(ModuleProvider, { value: app, children: children }) }));
+}
+//# sourceMappingURL=create-app-scope-wrapper.js.map

package/dist/esm/scope/create-app-scope-wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-app-scope-wrapper.js","sourceRoot":"","sources":["../../../src/scope/create-app-scope-wrapper.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAKxE;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAwD,EAC3F,SAAS,EACT,GAAG,GACgB;IACnB,OAAO,CAAC,EAAE,QAAQ,EAA2B,EAAE,EAAE,CAAC,CAChD,KAAC,iBAAiB,IAAC,KAAK,EAAE,SAAS,YACjC,KAAC,cAAc,IAAC,KAAK,EAAE,GAAG,YAAG,QAAQ,GAAkB,GACrC,CACrB,CAAC;AACJ,CAAC"}

package/dist/esm/scope/default-app-env.js

@@ -0,0 +1,12 @@
+/**
+ * The application environment used when a test does not care about its own app identity.
+ */
+export const defaultAppEnv = {
+    manifest: {
+        appKey: 'test-app',
+        displayName: 'Test App',
+        description: 'A test application',
+        type: 'standalone',
+    },
+};
+//# sourceMappingURL=default-app-env.js.map

package/dist/esm/scope/default-app-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-app-env.js","sourceRoot":"","sources":["../../../src/scope/default-app-env.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,QAAQ,EAAE;QACR,MAAM,EAAE,UAAU;QAClB,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,oBAAoB;QACjC,IAAI,EAAE,YAAY;KACnB;CACF,CAAC"}

package/dist/esm/scope/index.js

@@ -0,0 +1,5 @@
+export { defaultAppEnv } from './default-app-env';
+export { resolveFusion } from './resolve-fusion';
+export { resolveAppScope } from './resolve-app-scope';
+export { createAppScopeWrapper } from './create-app-scope-wrapper';
+//# sourceMappingURL=index.js.map

package/dist/esm/scope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scope/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}

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

@@ -0,0 +1,21 @@
+import { mockAppModules } from '@equinor/fusion-framework-app/mock';
+import { resolveFusion } from './resolve-fusion';
+import { defaultAppEnv } from './default-app-env';
+/**
+ * Resolves the parent Fusion instance and application module scope shared by every
+ * `packages/react/app` testing helper.
+ *
+ * @template TModules - Module descriptors beyond the default set.
+ * @template TEnv - The application environment descriptor.
+ * @param options - A `configure` callback and `env` for {@link mockAppModules}, plus an
+ *   already-built `fusion` instance to reuse instead of a fresh one.
+ * @returns The resolved {@link AppScope}.
+ */
+export async function resolveAppScope(options) {
+    const { configure, env, fusion: providedFusion } = options ?? {};
+    const resolvedEnv = env ?? defaultAppEnv;
+    const framework = await resolveFusion(resolvedEnv, providedFusion);
+    const app = await mockAppModules(configure, resolvedEnv, framework);
+    return { framework, app };
+}
+//# sourceMappingURL=resolve-app-scope.js.map

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

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

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

@@ -0,0 +1,18 @@
+import { mockFramework } from '@equinor/fusion-framework/mock';
+import { enableAppManifestMock } from '@equinor/fusion-framework-app/mock';
+import { defaultAppEnv } from './default-app-env';
+/**
+ * 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.
+ * @returns The given `fusion`, or a fresh mocked parent Fusion instance.
+ */
+export async function resolveFusion(env, fusion) {
+    return (fusion ??
+        mockFramework((configurator) => enableAppManifestMock(configurator, env ?? defaultAppEnv)));
+}
+//# sourceMappingURL=resolve-fusion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-fusion.js","sourceRoot":"","sources":["../../../src/scope/resolve-fusion.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAU,EACV,MAAe;IAEf,OAAO,CACL,MAAM;QACN,aAAa,CAAc,CAAC,YAAY,EAAE,EAAE,CAC1C,qBAAqB,CAAC,YAAY,EAAE,GAAG,IAAK,aAAsB,CAAC,CACpE,CACF,CAAC;AACJ,CAAC"}

package/dist/esm/test-app.js

@@ -0,0 +1,59 @@
+import { test as baseTest } from 'vitest';
+import { render, renderHook } from 'vitest-browser-react';
+import { mockAppModules } from '@equinor/fusion-framework-app/mock';
+import { defaultAppEnv, resolveFusion, createAppScopeWrapper } from './scope';
+/**
+ * `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,
+ * 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
+ * lazily: a test that only destructures `app` never pays for rendering anything, and one
+ * that only destructures `render`/`renderHook` gets the same fixture wiring automatically.
+ *
+ * Both entry points stay supported: reach for `renderAppComponent`/`renderAppHook` for a
+ * 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.
+ *
+ * @example
+ * ```tsx
+ * testApp('resolves current context', async ({ app, render }) => {
+ *   const screen = await render(<App />);
+ *   expect(app.context).toBeDefined();
+ * });
+ * ```
+ *
+ * @example Seed a module for every test in a suite
+ * ```tsx
+ * describe('with a seeded context module', () => {
+ *   const test = testApp.extend('configure', { injected: true }, () =>
+ *     (configurator) => enableContextMock(configurator, (mock) => mock.setCurrentContext(projectA)),
+ *   );
+ *
+ *   test('starts on the seeded context', async ({ render }) => {
+ *     const screen = await render(<App />);
+ *     await expect.element(screen.getByText(projectA.title)).toBeVisible();
+ *   });
+ * });
+ * ```
+ */
+export const testApp = baseTest
+    .extend('env', { injected: true }, defaultAppEnv)
+    // `test.extend`'s plain-`value` overload rejects function types (ambiguous with the
+    // resolver-`fn` overload), so a function-typed fixture default must go through `fn` instead.
+    .extend('configure', { injected: true }, () => undefined)
+    .extend('fusion', async ({ env }) => resolveFusion(env))
+    .extend('app', async ({ configure, env, fusion }) => mockAppModules(configure, env, fusion))
+    .extend('render', ({ fusion, app }) => {
+    const wrapper = createAppScopeWrapper({ framework: fusion, app });
+    return (ui, options) => render(ui, { ...options, wrapper });
+})
+    .extend('renderHook', ({ fusion, app }) => {
+    const wrapper = createAppScopeWrapper({ framework: fusion, app });
+    return (cb, options) => renderHook(cb, { ...options, wrapper });
+});
+export default testApp;
+//# sourceMappingURL=test-app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-app.js","sourceRoot":"","sources":["../../src/test-app.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIpE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ;KAC5B,MAAM,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,aAAa,CAAC;IACjD,oFAAoF;IACpF,6FAA6F;KAC5F,MAAM,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,SAA2C,CAAC;KAC1F,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAClD,cAAc,CAAkB,SAAS,EAAE,GAAa,EAAE,MAAM,CAAC,CAClE;KACA,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;IACpC,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,EAAgB,EAAE,OAAwC,EAAE,EAAE,CACpE,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;KACD,MAAM,CAAC,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,EAAE;IACxC,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,CACL,EAAoC,EACpC,OAAmD,EACnD,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEL,eAAe,OAAO,CAAC"}

package/dist/esm/test.js

@@ -0,0 +1,33 @@
+import { testApp as baseTestApp } from './test-app';
+// resolved at test-time by `appTestVitePlugin` (@equinor/fusion-framework-vitest-plugin-react-app);
+// see virtual-modules.d.ts for the ambient module declarations
+import { manifest, config } from 'virtual:fusion-app-test-env';
+import { configure } from 'virtual:fusion-app-test-configure';
+/**
+ * `vitest`'s `test`, pre-seeded with the application's own manifest, config, and
+ * module-configurator, resolved the same way `ffc app build`/`ffc app dev` resolve them.
+ *
+ * @remarks
+ * Requires `appTestVitePlugin` (`@equinor/fusion-framework-vitest-plugin-react-app`) registered in
+ * 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.
+ *
+ * @example
+ * ```tsx
+ * import { test } from '@equinor/fusion-framework-vitest-plugin-react-app/test';
+ * import { App } from '../App';
+ *
+ * test('renders the app', async ({ render }) => {
+ *   const screen = await render(<App />);
+ *   await expect.element(screen.getByRole('heading')).toBeVisible();
+ * });
+ * ```
+ */
+export const test = baseTestApp
+    .extend('env', { injected: true }, { manifest, config })
+    .extend('configure', { injected: true }, () => configure);
+export default test;
+//# sourceMappingURL=test.js.map

package/dist/esm/test.js.map

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

package/dist/esm/version.js

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

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC"}