@equinor/fusion-framework-react-app 14.0.1 → 15.0.0-next.1

package/CHANGELOG.md

@@ -1,5 +1,95 @@
 # Change Log
 
+## 15.0.0-next.1
+
+### Minor Changes
+
+- e13cfa4: Add AG Grid sub-path entry-points:
+
+  - `@equinor/fusion-framework-react-app/ag-grid` — `AgGridReact`, `enableAgGrid`, and related types, forwarded from `@equinor/fusion-framework-react-ag-grid/react`.
+  - `@equinor/fusion-framework-react-app/ag-grid/community` — forwards `@equinor/fusion-framework-react-ag-grid/community` (`ag-grid-community`).
+  - `@equinor/fusion-framework-react-app/ag-grid/enterprise` — forwards `@equinor/fusion-framework-react-ag-grid/enterprise` (`ag-grid-enterprise`).
+  - `@equinor/fusion-framework-react-app/ag-grid/theme` — Fusion theme utilities (`fusionTheme`, `createTheme`, `createThemeFromTheme`, `Theme`) plus the application-scoped `useTheme` hook.
+  - `@equinor/fusion-framework-react-app/ag-grid/testing` — `suppressAgGridLicenseBanner`, forwarded from `@equinor/fusion-framework-module-ag-grid/testing`.
+
+  ```typescript
+  import { AgGridReact } from "@equinor/fusion-framework-react-app/ag-grid";
+  import { useTheme } from "@equinor/fusion-framework-react-app/ag-grid/theme";
+  import { suppressAgGridLicenseBanner } from "@equinor/fusion-framework-react-app/ag-grid/testing";
+  ```
+
+  `@equinor/fusion-framework-module-ag-grid` and `@equinor/fusion-framework-react-ag-grid` are now optional peer dependencies of `@equinor/fusion-framework-react-app`.
+
+### Patch Changes
+
+- Updated dependencies [e13cfa4]
+- Updated dependencies [e13cfa4]
+  - @equinor/fusion-framework-module-ag-grid@37.1.0-next.1
+  - @equinor/fusion-framework-react-ag-grid@37.1.0-next.1
+
+## 15.0.0-next.0
+
+### Patch Changes
+
+- e8aae1f: Internal: publish every package on the `next` pre-release tag so the whole framework can be installed as a coherent set.
+
+  Packages without their own changes are bumped only to receive a `-next.N` version and the `next` dist-tag on npm. Install with:
+
+  ```bash
+  pnpm add @equinor/fusion-framework-react-app@next
+  ```
+
+- 2836e0b: Fix documentation accuracy issues found while adding hook test coverage:
+
+  - The README and a deprecated `createComponent` example showed `configurator.http.configureClient(...)` for registering an app's HTTP client. That property only exists on the test/mock configurator (`AppMockConfigurator`) — real app configuration must use `configurator.configureHttpClient(...)` from `IAppConfigurator`. Both examples now use the correct API.
+  - `docs/context.md` and `docs/framework.md` documented `setCurrentContext`/`useFrameworkCurrentContext`'s setter as returning `void`. It actually returns `void | Promise<ContextItem | null>` — `void` when clearing the context, a `Promise` when setting by id or by item — and can be awaited to know when the switch completes.
+  - `docs/msal.md` documented `AuthenticationResult.account`/`expiresOn` as non-nullable; both are actually nullable (`AccountInfo | null`, `Date | null`), and the `useToken` example has been updated to guard against a `null` `expiresOn`.
+  - `docs/bookmark.md` now documents `useCurrentBookmark`'s deprecated fallback to the framework-scoped bookmark provider (and the `@deprecation` console warning it logs) when an app hasn't called `enableBookmark`.
+
+- 2836e0b: Remove `docs/testing.md` and replace the README's testing section with a pointer to `@equinor/fusion-framework-vitest-plugin-react-app`, now that `renderAppHook`, `renderAppComponent`, `testApp`, and the `appTestVitePlugin` Vite plugin live in that separate package instead of this one. Both described the old `./vitest` entry-point as requiring a legacy DOM test renderer and returning a top-level `modules` field, which no longer applies now that the helpers are built on `vitest-browser-react` and return a nested `fusion: { framework, app }` object. The README's API-reference table no longer lists a `/vitest` entry-point.
+- 2836e0b: Document the supported `renderAppHook` and `renderAppComponent` testing helpers so app teams can verify app-scoped hooks and components against a real, mock-backed application module scope.
+
+  Closes equinor/fusion-core-tasks#1716.
+
+- Updated dependencies [e8aae1f]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+- Updated dependencies [2836e0b]
+  - @equinor/fusion-framework@8.1.0-next.0
+  - @equinor/fusion-framework-app@14.0.0-next.0
+  - @equinor/fusion-framework-module@6.1.3-next.0
+  - @equinor/fusion-framework-module-app@8.1.0-next.0
+  - @equinor/fusion-framework-module-http@8.1.0-next.0
+  - @equinor/fusion-framework-module-msal@11.0.0-next.0
+  - @equinor/fusion-framework-module-navigation@7.0.8-next.0
+  - @equinor/fusion-framework-module-state@2.0.1-next.0
+  - @equinor/fusion-framework-react@9.0.0-next.0
+  - @equinor/fusion-framework-react-module@4.0.3-next.0
+  - @equinor/fusion-framework-react-module-http@12.0.0-next.0
+  - @equinor/fusion-framework-react-router@2.4.1-next.0
+
 ## 14.0.1
 
 ### Patch Changes

package/README.md

@@ -25,7 +25,7 @@ pnpm add @equinor/fusion-framework-react-app
 import type { AppModuleInitiator } from '@equinor/fusion-framework-react-app';
 
 export const configure: AppModuleInitiator = (configurator) => {
-  configurator.http.configureClient('my-api', {
+  configurator.configureHttpClient('my-api', {
     baseUri: 'https://api.example.com',
     defaultScopes: ['api://my-api/.default'],
   });
@@ -372,6 +372,13 @@ const EnvInfo = () => {
 };
 ```
 
+### Testing
+
+Testing utilities (`renderAppHook`, `renderAppComponent`, `testApp`, and a Vitest plugin
+resolving an app's own manifest/config as virtual modules) have moved to their own package,
+[`@equinor/fusion-framework-vitest-plugin-react-app`](../../vitest-plugin/react-app/README.md) —
+see that package's README for usage.
+
 ## API Reference
 
 ### Core exports (main entry-point)
@@ -412,7 +419,7 @@ Application configuration is done via a callback passed to `renderApp` (or `make
 ```ts
 const configure: AppModuleInitiator = (configurator) => {
   // HTTP clients
-  configurator.http.configureClient('my-api', { baseUri: '...' });
+  configurator.configureHttpClient('my-api', { baseUri: '...' });
 
   // Feature flags
   enableFeatureFlag(configurator, [{ key: 'beta', title: 'Beta' }]);

package/dist/esm/ag-grid/community.js

@@ -0,0 +1,12 @@
+/**
+ * AG Grid community-tier sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports every public symbol from
+ * `@equinor/fusion-framework-react-ag-grid/community` so the application
+ * resolves a single shared copy of `ag-grid-community`.
+ *
+ * @packageDocumentation
+ */
+export * from '@equinor/fusion-framework-react-ag-grid/community';
+//# sourceMappingURL=community.js.map

package/dist/esm/ag-grid/community.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"community.js","sourceRoot":"","sources":["../../../src/ag-grid/community.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,mDAAmD,CAAC"}

package/dist/esm/ag-grid/enterprise.js

@@ -0,0 +1,12 @@
+/**
+ * AG Grid enterprise-tier sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports every public symbol from
+ * `@equinor/fusion-framework-react-ag-grid/enterprise` so the application
+ * resolves a single shared copy of `ag-grid-enterprise`.
+ *
+ * @packageDocumentation
+ */
+export * from '@equinor/fusion-framework-react-ag-grid/enterprise';
+//# sourceMappingURL=enterprise.js.map

package/dist/esm/ag-grid/enterprise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enterprise.js","sourceRoot":"","sources":["../../../src/ag-grid/enterprise.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,oDAAoD,CAAC"}

package/dist/esm/ag-grid/react.js

@@ -0,0 +1,12 @@
+/**
+ * AG Grid React component sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports the AG Grid React bindings from
+ * `@equinor/fusion-framework-react-ag-grid/react`, including the
+ * `AgGridReact` component, `enableAgGrid`, and their associated types.
+ *
+ * @packageDocumentation
+ */
+export * from '@equinor/fusion-framework-react-ag-grid/react';
+//# sourceMappingURL=react.js.map

package/dist/esm/ag-grid/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../../../src/ag-grid/react.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,cAAc,+CAA+C,CAAC"}

package/dist/esm/ag-grid/testing.js

@@ -0,0 +1,19 @@
+/**
+ * AG Grid test helpers sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports the AG Grid test helpers from
+ * `@equinor/fusion-framework-module-ag-grid/testing`. Import from test setup
+ * files only — these helpers patch global state and are not meant for
+ * application runtime code.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Silences AG Grid Enterprise's unlicensed "License Key Not Found" banner on
+ * `console.error` so it doesn't bury real failures in test output.
+ *
+ * @returns A function that restores the original `console.error`.
+ */
+export { suppressAgGridLicenseBanner } from '@equinor/fusion-framework-module-ag-grid/testing';
+//# sourceMappingURL=testing.js.map

package/dist/esm/ag-grid/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../src/ag-grid/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;GAKG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,kDAAkD,CAAC"}

package/dist/esm/ag-grid/theme.js

@@ -0,0 +1,13 @@
+/**
+ * AG Grid theme sub-path entry-point.
+ *
+ * @remarks
+ * Re-exports the Fusion AG Grid theme utilities from
+ * `@equinor/fusion-framework-module-ag-grid/themes`, together with the
+ * application-scoped {@link useTheme} hook.
+ *
+ * @packageDocumentation
+ */
+export { fusionTheme, createThemeFromTheme, createTheme, } from '@equinor/fusion-framework-module-ag-grid/themes';
+export { useTheme } from './useTheme';
+//# sourceMappingURL=theme.js.map

package/dist/esm/ag-grid/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/ag-grid/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,WAAW,GACZ,MAAM,iDAAiD,CAAC;AAEzD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/esm/create-component.js

@@ -21,7 +21,7 @@ import { ModuleProvider as AppModuleProvider } from '@equinor/fusion-framework-r
  * @example
  * ```tsx
  * const configCallback: AppConfigurator = (configurator) => {
- *  configurator.http.configureClient(
+ *  configurator.configureHttpClient(
  *     'bar', {
  *       baseUri: 'https://somewhere-test.com',
  *       defaultScopes: ['foo/.default']

package/dist/esm/msal/useToken.js

@@ -1,4 +1,4 @@
-import { useEffect, useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
 import useAppModule from '../useAppModule';
 /**
  * React hook that acquires a full MSAL {@link AuthenticationResult} for the
@@ -26,11 +26,20 @@ export const useToken = (req) => {
     const [token, setToken] = useState(undefined);
     const [pending, setPending] = useState(false);
     const [error, setError] = useState(null);
+    // `req` is typically a fresh object literal each render; key the effect on its
+    // scopes' content instead of identity, so it doesn't re-run (and reset `pending`
+    // to `true` forever) every time the caller re-renders. `JSON.stringify` (rather than
+    // `.join(',')`) keeps scopes with different array boundaries (e.g. `['a,b']` vs.
+    // `['a', 'b']`) from colliding on the same key.
+    const scopesKey = JSON.stringify(req.scopes);
+    const reqRef = useRef(req);
+    reqRef.current = req;
+    // biome-ignore lint/correctness/useExhaustiveDependencies: scopesKey is a re-run trigger, not read in the body
     useEffect(() => {
         setPending(true);
         setToken(undefined);
         msalProvider
-            .acquireToken({ request: req })
+            .acquireToken({ request: reqRef.current })
             .then((result) => {
             // Only update state when a token was actually acquired
             if (result) {
@@ -39,7 +48,7 @@ export const useToken = (req) => {
         })
             .catch(setError)
             .finally(() => setPending(false));
-    }, [msalProvider, req]);
+    }, [msalProvider, scopesKey]);
     return { token, pending, error };
 };
 export default useToken;

package/dist/esm/msal/useToken.js.map

@@ -1 +1 @@
-{"version":3,"file":"useToken.js","sourceRoot":"","sources":["../../../src/msal/useToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAI5C,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAExB,EAAsE,EAAE;IACvE,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAmC,SAAS,CAAC,CAAC;IAChF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAU,IAAI,CAAC,CAAC;IAClD,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpB,YAAY;aACT,YAAY,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;aAC9B,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,uDAAuD;YACvD,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,QAAQ,CAAC;aACf,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"useToken.js","sourceRoot":"","sources":["../../../src/msal/useToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIpD,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAExB,EAAsE,EAAE;IACvE,MAAM,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAmC,SAAS,CAAC,CAAC;IAChF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAU,KAAK,CAAC,CAAC;IACvD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAU,IAAI,CAAC,CAAC;IAElD,+EAA+E;IAC/E,iFAAiF;IACjF,qFAAqF;IACrF,iFAAiF;IACjF,gDAAgD;IAChD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC;IAErB,+GAA+G;IAC/G,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,SAAS,CAAC,CAAC;QACpB,YAAY;aACT,YAAY,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;aACzC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,uDAAuD;YACvD,IAAI,MAAM,EAAE,CAAC;gBACX,QAAQ,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,QAAQ,CAAC;aACf,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACtC,CAAC,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/esm/version.js

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

package/dist/esm/version.js.map

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