@equinor/fusion-framework-react-app 9.0.8 → 10.0.0

package/CHANGELOG.md

@@ -1,5 +1,90 @@
 # Change Log
 
+## 10.0.0
+
+### Major Changes
+
+- abffa53: Major version bump for Fusion Framework React 19 release.
+
+  All packages are bumped to the next major version as part of the React 19 upgrade. This release drops support for React versions below 18 and includes breaking changes across the framework.
+
+  **Breaking changes:**
+  - Peer dependencies now require React 18 or 19 (`^18.0.0 || ^19.0.0`)
+  - React Router upgraded from v6 to v7
+  - Navigation module refactored with new history API
+  - `renderComponent` and `renderApp` now use `createRoot` API
+
+  **Migration:**
+  - Update your React version to 18.0.0 or higher before upgrading
+  - Replace `NavigationProvider.createRouter()` with `@equinor/fusion-framework-react-router`
+  - See individual package changelogs for package-specific migration steps
+
+- abffa53: Modernize `renderComponent` and `renderApp` to use React 18's `createRoot` API. These functions are no longer deprecated.
+
+  The legacy `ReactDOM.render` path has been removed. Both functions now use `createRoot` internally, matching React 18+ best practices. No migration is required if you already use React 18+.
+
+- abffa53: Upgrade to React 19 and remove support for React versions lower than 18.
+
+  **Breaking changes:**
+  - Peer dependencies now require React 18 or 19 (`^18.0.0 || ^19.0.0`)
+  - React 16 and 17 are no longer supported
+  - Dev dependencies upgraded to React 19.2.1 and @types/react 19.2.7
+
+  **Migration:**
+  - Update your React version to 18.0.0 or higher before upgrading these packages
+  - If using React 16 or 17, upgrade to React 18 or 19 first
+
+  Closes https://github.com/equinor/fusion-framework/issues/3504
+
+### Minor Changes
+
+- abffa53: Export `Fusion` type from `@equinor/fusion-framework-react-app` for better type reusability.
+
+  The `Fusion` type is now available directly from the react-app package:
+
+  ```typescript
+  import type { Fusion } from "@equinor/fusion-framework-react-app";
+  ```
+
+### Patch Changes
+
+- abffa53: Add test suite for `renderApp` function using Vitest and React Testing Library.
+
+  Includes test coverage for component rendering, teardown functionality, and React 18 createRoot integration.
+
+- aaa3f74: fix(security): address undici multiple vulnerabilities (CVE-2026-1524, 1527, 1528, 2581)
+
+  Upgrade undici from 7.22.0 to 7.24.3 to fix multiple security vulnerabilities affecting WebSocket parsing, HTTP header validation, and request deduplication:
+  - **CVE-2026-1528** (HIGH): WebSocket 64-bit length integer overflow causing process crash
+  - **CVE-2026-1524** (MODERATE): HTTP/1.1 response field header injection
+  - **CVE-2026-1527** (MODERATE): CRLF injection via upgrade option enabling protocol smuggling
+  - **CVE-2026-2581** (MODERATE): Unbounded memory consumption in deduplication handler
+
+  These are non-breaking security patches that harden undici against untrusted upstream endpoints and malicious WebSocket frames.
+
+  **Advisories**: GHSA-f269-vfmq-vjvj, GHSA-v9p9-hfj2-hcw8, GHSA-4992-7rv2-5pvq, GHSA-phc3-fgpg-7m6h
+  **Fixed in**: undici 7.24.0+ (deployed 7.24.3)
+
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [abffa53]
+- Updated dependencies [aaa3f74]
+  - @equinor/fusion-framework-app@11.0.0
+  - @equinor/fusion-framework-module@6.0.0
+  - @equinor/fusion-framework-module-app@8.0.0
+  - @equinor/fusion-framework-module-http@8.0.0
+  - @equinor/fusion-framework-module-msal@8.0.0
+  - @equinor/fusion-framework-module-navigation@7.0.0
+  - @equinor/fusion-framework-react@8.0.0
+  - @equinor/fusion-framework-react-module@4.0.0
+  - @equinor/fusion-framework-react-module-http@11.0.0
+
 ## 9.0.8
 
 ### Patch Changes
@@ -130,7 +215,6 @@
 ### Patch Changes
 
 - [#3714](https://github.com/equinor/fusion-framework/pull/3714) [`11fe961`](https://github.com/equinor/fusion-framework/commit/11fe961794e4960ccb987bc320268cc9b263f1f8) Thanks [@odinr](https://github.com/odinr)! - Fix MSAL v4 compatibility issues in React app hooks.
-
   - Update useCurrentAccount to use account property instead of deprecated defaultAccount
   - Fix useToken hook to properly handle AcquireTokenResult type
   - Ensure proper null/undefined handling for account information
@@ -186,14 +270,12 @@
 - [#3075](https://github.com/equinor/fusion-framework/pull/3075) [`8fffbfb`](https://github.com/equinor/fusion-framework/commit/8fffbfb12daa9748bf5290e5084cd4d409aed253) Thanks [@odinr](https://github.com/odinr)! - Refactored the `Bookmark` type to be an intersection of `BookmarkWithoutData` and an optional `payload` property, improving type safety and flexibility. Updated `useBookmarkNavigate` to use proper TypeScript typing for bookmark events.
 
   **Module Bookmark Changes:**
-
   - Refactored `Bookmark` type in `packages/modules/bookmark/src/types.ts`
   - Added export for `BookmarkProviderEvents` type in `packages/modules/bookmark/src/index.ts`
   - Updated JSDoc comment from `@note` to `@remarks` in `packages/modules/bookmark/src/BookmarkClient.ts`
   - Reordered tsconfig references (event before services)
 
   **React Changes:**
-
   - Updated `packages/react/modules/bookmark/src/portal/useBookmarkNavigate.ts` to use proper TypeScript typing for bookmark provider events
   - Removed React paths configuration from `packages/react/app/tsconfig.json`
 
@@ -240,7 +322,6 @@
 ### Patch Changes
 
 - [#3088](https://github.com/equinor/fusion-framework/pull/3088) [`7441b13`](https://github.com/equinor/fusion-framework/commit/7441b13aa50dd7362d1629086a27b6b4e571575d) Thanks [@eikeland](https://github.com/eikeland)! - chore: update package typesVersions
-
   - Updated package.json typesVersions.
   - Ensures backward compatibility with older node versions.
   - Ensured consistency with workspace and repository configuration.
@@ -300,7 +381,6 @@
   `appKey (string)`: The key of the Fusion app to load and mount.
 
   ### Returns
-
   - **loading** `(boolean)`: true while the app is loading.
   - **error** `(Error | undefined)`: Error object if loading fails, otherwise undefined.
   - **appRef** `(React.RefObject<HTMLDivElement | null>)`: Ref to the DOM element where the child app is mounted.
@@ -334,7 +414,6 @@
   ```
 
   ### Notes
-
   - The hook is designed to be used in a parent Fusion app context.
   - The returned appRef should be appended to a container element in your component.
   - Handles subscription and cleanup automatically.
@@ -618,7 +697,6 @@
 ### Minor Changes
 
 - [#2577](https://github.com/equinor/fusion-framework/pull/2577) [`c3ba9f1`](https://github.com/equinor/fusion-framework/commit/c3ba9f109d9f96d6dc6ee2f0ddac00c8b3090982) Thanks [@eikeland](https://github.com/eikeland)! - #### Changes:
-
   1. **AppClient.ts**
      - Added `updateAppSettings` method to set app settings by appKey.
   2. **AppModuleProvider.ts**
@@ -666,7 +744,6 @@
 ### Minor Changes
 
 - [#2410](https://github.com/equinor/fusion-framework/pull/2410) [`9d1cb90`](https://github.com/equinor/fusion-framework/commit/9d1cb9003fa10e7ccaa95c20ef86f0a618034641) Thanks [@odinr](https://github.com/odinr)! - Updated bookmark namespace in `@equinor/fusion-react-app` to include new hooks and updated `useCurrentBookmark` hook.
-
   - Updated `index.ts` to re-export everything from `@equinor/fusion-framework-react-module-bookmark` instead of individual exports.
   - Marked `useBookmark` as deprecated in `useBookmark.ts`.
   - Enhanced `useCurrentBookmark` in `useCurrentBookmark.ts` to accept a `BookmarkPayloadGenerator` and use the `BookmarkModule` from `useAppModule`.
@@ -708,12 +785,10 @@
   > This will introduce breaking changes to the configuration of `AppConfigurator.client`.
 
   **Added**
-
   - Introduced `AppClient` class to handle application manifest and configuration queries.
   - Added `zod` to validate the application manifest.
 
   **Changed**
-
   - Updated `AppModuleProvider` to use `AppClient` for fetching application manifests and configurations.
   - Modified `AppConfigurator` to utilize `AppClient` for client configuration.
   - Updated `useApps` hook with new input parameter for `filterByCurrentUser` in `fusion-framework-react`.
@@ -845,7 +920,6 @@
 - [#2320](https://github.com/equinor/fusion-framework/pull/2320) [`1dd85f3`](https://github.com/equinor/fusion-framework/commit/1dd85f3a408a73df556d1812a5f280945cc100ee) Thanks [@odinr](https://github.com/odinr)! - Removed the `removeComments` option from the `tsconfig.base.json` file.
 
   Removing the `removeComments` option allows TypeScript to preserve comments in the compiled JavaScript output. This can be beneficial for several reasons:
-
   1. Improved debugging: Preserved comments can help developers understand the code better during debugging sessions.
   2. Documentation: JSDoc comments and other important code documentation will be retained in the compiled output.
   3. Source map accuracy: Keeping comments can lead to more accurate source maps, which is crucial for debugging and error tracking.
@@ -1214,7 +1288,6 @@
 ### Minor Changes
 
 - [#1646](https://github.com/equinor/fusion-framework/pull/1646) [`5eab8af`](https://github.com/equinor/fusion-framework/commit/5eab8afe3c3106cc67ad14ce4cbee6c7e4e8dfb1) Thanks [@odinr](https://github.com/odinr)! - Created namespace for MSAL:
-
   - Created hooks for accessing current authenticated account
   - Created hooks for acquiring token
   - Created hooks for acquiring access token
@@ -1441,7 +1514,6 @@
 ### Minor Changes
 
 - [#934](https://github.com/equinor/fusion-framework/pull/934) [`ea081696`](https://github.com/equinor/fusion-framework/commit/ea0816967244917b01a3aa43b75cd3cf59573958) Thanks [@odinr](https://github.com/odinr)! - **Add tooling for navigation in React App package**
-
   - add hook for using the navigation module
   - add hook for creating a react router
 
@@ -1472,7 +1544,6 @@
 ### Patch Changes
 
 - [#905](https://github.com/equinor/fusion-framework/pull/905) [`a7858a1c`](https://github.com/equinor/fusion-framework/commit/a7858a1c01542e2dc94370709f122b4b99c3219c) Thanks [@odinr](https://github.com/odinr)! - **🚧 Chore: dedupe packages**
-
   - align all versions of typescript
   - update types to build
     - a couple of typecasts did not [satisfies](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-5-0.html#satisfies-support-in-jsdoc) and was recasted as `unknwon`, marked with `TODO`, should be fixed in future

package/README.md

@@ -1,139 +1,216 @@
-# Fusion React App
+# @equinor/fusion-framework-react-app
 
-Package for developing applications that uses the `@equinor/fusion-framework`.
+React bindings for building modular Fusion Framework applications. Provides rendering helpers, configuration callbacks, and React hooks for accessing framework modules (HTTP, auth, context, navigation, bookmarks, settings, and more).
+
+## Features
+
+- **One-line app bootstrap** via `renderApp` — creates a render function that mounts your component with React 18's `createRoot`
+- **Module hooks** — `useAppModule` / `useAppModules` for type-safe access to any registered module
+- **Sub-path entry-points** for optional capabilities: MSAL auth, HTTP, context, navigation, bookmarks, feature flags, settings, analytics, AG Grid theming, help center, and apploader
+- **Environment variables** hook — `useAppEnvironmentVariables` for accessing app config at runtime
+- **Lazy loading** — components are wrapped in `React.lazy` + `Suspense` automatically
+
+## Installation
+
+```sh
+pnpm add @equinor/fusion-framework-react-app
+```
+
+## Usage
+
+### Bootstrap an application
 
-## Configure
 ```tsx
 // config.ts
-import { AppConfigurator } from '@equinor/fusion-framework-react-app';
-const configCallback: AppConfigurator = (configurator) => {
- configurator.http.configureClient(
-    'bar', {
-      baseUri: 'https://somewhere-test.com',
-      defaultScopes: ['foo/.default']
-    }
-  );
+import type { AppModuleInitiator } from '@equinor/fusion-framework-react-app';
+
+export const configure: AppModuleInitiator = (configurator) => {
+  configurator.http.configureClient('my-api', {
+    baseUri: 'https://api.example.com',
+    defaultScopes: ['api://my-api/.default'],
+  });
 };
 
 // App.tsx
-export const App = () => {
-  const client = useHttpClient('bar');
-  const [foo, setFoo] = useState('no value');
-  const onClick = useCallback(() => {
-    client.fetchAsync('api').then(x => x.json).then(setFoo);
-  }, [client]);
-  return <Button onClick={onClick}>{foo}</Button>
-}
+export const App = () => <h1>Hello Fusion</h1>;
 
 // index.ts
-import { createApp } from '@equinor/fusion-framework-react-app';
-export const render = createApp(App, configCallback);
+import { renderApp } from '@equinor/fusion-framework-react-app';
+import { App } from './App';
+import { configure } from './config';
+
+export const render = renderApp(App, configure);
 export default render;
 ```
 
-## Hooks
+### Access a module
 
-### useModule
 ```tsx
-import { useModule } from '@equinor/fusion-framework-react-app';
-const ShowToken = () => {
-  const auth = useModule('auth');
-  const [token, setToken] = useState<string>('');
-  useEffect(() => {
-    auth.acquireAccessToken().then(setToken);
-  }, [auth]);
-  return <span>{token ?? 'fetching token'}</span>
-}
+import { useAppModule } from '@equinor/fusion-framework-react-app';
+
+const MyComponent = () => {
+  const auth = useAppModule('auth');
+  // ...
+};
 ```
 
-## MSAL Authentication
+### HTTP requests
 
-> [!IMPORTANT]
-> `@equinor/fusion-framework-module-msal` must be installed to make MSAL hooks available
+```tsx
+import { useHttpClient } from '@equinor/fusion-framework-react-app/http';
 
-> [!CAUTION]
-> **Applications should NOT configure the MSAL module themselves.** The MSAL module must be configured by the host/portal application for proper module hoisting. Apps should only use the hooks to access the already-configured MSAL module.
+const MyComponent = () => {
+  const client = useHttpClient('my-api');
+  // client.fetch$('endpoint').subscribe(...)
+  // await client.fetchAsync('endpoint')
+};
+```
 
-This package includes React hooks for Microsoft authentication using MSAL v4.
+### MSAL authentication
 
-```tsx
-import { useCurrentAccount, useAccessToken, useToken } from '@equinor/fusion-framework-react-app/msal';
+> **Note:** Requires `@equinor/fusion-framework-module-msal`. The MSAL module must be configured by the host/portal — apps should only consume the hooks.
 
-const scopes = ['User.Read', 'api.read'];
+```tsx
+import { useCurrentAccount, useAccessToken } from '@equinor/fusion-framework-react-app/msal';
 
-function MyComponent() {
-  // Get current logged-in user
+const UserInfo = () => {
   const user = useCurrentAccount();
-  
-  // Get access token for API calls
-  const { token: accessToken } = useAccessToken( { scopes } );
-  
-  // Get full token details
-  const { token } = useToken( { scopes } );
-  
-  if (!user) return <div>Please log in</div>;
-  return <div>Welcome, {user.name}!</div>;
-}
+  const { token } = useAccessToken({ scopes: ['User.Read'] });
+  if (!user) return <p>Not signed in</p>;
+  return <p>Welcome, {user.name}</p>;
+};
 ```
 
-📖 **[See MSAL Authentication Documentation](docs/msal.md) for complete API reference, examples, and migration guide.**
+### Context
 
-## Http
+```tsx
+import { useCurrentContext } from '@equinor/fusion-framework-react-app/context';
+
+const ContextInfo = () => {
+  const context = useCurrentContext();
+  return <p>Selected: {context?.title ?? 'none'}</p>;
+};
+```
 
-### useHttpClient
+### Navigation / routing
 
 ```tsx
-import { useHttpClient } from '@equinor/fusion-framework-react-app/http';
+import { useRouter } from '@equinor/fusion-framework-react-app/navigation';
+import { RouterProvider } from '@equinor/fusion-framework-react-router';
+
+const routes = [{ path: '/', element: <Home /> }];
+
 const App = () => {
-  const fooClient = useHttpClient('foo');
-  
-  // using as stream
-  useEffect(() => {
-    const sub = client.fetch('api/all').subscribe((x) => {
-      setFoo(x.json());
-    });
-    return () => sub.unsubscribe();
-  },[fooClient]);
-
-  // using as promise
-  const barClient =  useHttpClient('bar');
-  useCallback(async() => {
-    const res = await portalClient.fetchAsync('api/bar');
-    console.log(res.json());
-  },[barClient]);
-  
-}
+  const router = useRouter(routes);
+  return <RouterProvider router={router} />;
+};
 ```
 
-## Feature Flag
+### Feature flags
 
-> [!IMPORTANT]
-> `@equinor/fusion-framework-module-feature-flag` must be installed to make this module available
+> **Note:** Requires `@equinor/fusion-framework-module-feature-flag`.
 
-### Simple
-```ts
-import { enableFeatureFlag } from '@equinor/fusion-framework-react-app/feature-flag'; 
-export const configure: ModuleInitiator = (appConfigurator, args) => {
-  /** provide a list of features that should be available in the application */
-  enableFeatureFlag(appConfigurator, [
-    {
-      key: MyFeatures.MyFlag,
-      title: 'this is a flag',
-    },
-    {
-      key: MyFeatures.MyUrlFlag,
-      title: 'this feature can be toggled by ?my-url-flag=true',
-      allowUrl: true,
-    }
+```tsx
+import { enableFeatureFlag } from '@equinor/fusion-framework-react-app/feature-flag';
+
+export const configure: AppModuleInitiator = (configurator) => {
+  enableFeatureFlag(configurator, [
+    { key: 'dark-mode', title: 'Dark mode' },
+    { key: 'beta-ui', title: 'Beta UI', allowUrl: true },
   ]);
-}
+};
+```
+
+```tsx
+import { useFeature } from '@equinor/fusion-framework-react-app/feature-flag';
+
+const Toggle = () => {
+  const { feature, toggleFeature } = useFeature('dark-mode');
+  return <Switch checked={feature?.enabled} onChange={() => toggleFeature()} />;
+};
+```
+
+### Bookmarks
+
+```tsx
+import { useCurrentBookmark } from '@equinor/fusion-framework-react-app/bookmark';
+
+const BookmarkView = () => {
+  const { currentBookmark } = useCurrentBookmark();
+  return <pre>{JSON.stringify(currentBookmark, null, 2)}</pre>;
+};
+```
+
+### Settings
+
+```tsx
+import { useAppSetting } from '@equinor/fusion-framework-react-app/settings';
+
+const ThemePicker = () => {
+  const [theme, setTheme] = useAppSetting('theme', 'light');
+  return <button onClick={() => setTheme('dark')}>Go dark</button>;
+};
+```
+
+### Environment variables
+
+```tsx
+import { useAppEnvironmentVariables } from '@equinor/fusion-framework-react-app';
+
+const EnvInfo = () => {
+  const env = useAppEnvironmentVariables();
+  if (!env.complete) return <p>Loading…</p>;
+  return <pre>{JSON.stringify(env.value, null, 2)}</pre>;
+};
 ```
 
-### Custom
+## API Reference
+
+### Core exports (main entry-point)
+
+| Export | Description |
+| --- | --- |
+| `renderApp` | Creates a mount function from a component and optional config callback |
+| `makeComponent` | Lazily initialises modules and wraps a component in framework providers |
+| `createComponent` | _(deprecated)_ Factory returning a `ComponentRenderer` |
+| `createLegacyApp` | _(deprecated)_ Wrapper for legacy Fusion CLI apps |
+| `renderComponent` | Lower-level helper: mounts a `ComponentRenderer` via `createRoot` |
+| `useAppModule(key)` | Returns a single module instance by key |
+| `useAppModules()` | Returns all initialised application modules |
+| `useAppEnvironmentVariables()` | Observable state of the app's environment config |
+
+### Sub-path entry-points
+
+| Path | Key exports |
+| --- | --- |
+| `/msal` | `useCurrentAccount`, `useAccessToken`, `useToken` |
+| `/http` | `useHttpClient` (re-export) |
+| `/http/selectors` | Response selector utilities |
+| `/context` | `useCurrentContext`, `useContextProvider`, `useFrameworkCurrentContext` |
+| `/navigation` | `useRouter`, `useNavigationModule` |
+| `/feature-flag` | `enableFeatureFlag`, `useFeature` |
+| `/bookmark` | `enableBookmark`, `useCurrentBookmark`, `useBookmark` |
+| `/settings` | `useAppSetting`, `useAppSettings` |
+| `/analytics` | `useTrackFeature` |
+| `/help-center` | `useHelpCenter` |
+| `/apploader` | `Apploader`, `useApploader` |
+| `/framework` | `useFramework`, `useCurrentUser`, `useFrameworkHttpClient` |
+| `/widget` | Widget entry-point |
+
+## Configuration
+
+Application configuration is done via a callback passed to `renderApp` (or `makeComponent`). The callback receives an `IAppConfigurator` with builders for each module:
+
 ```ts
-export const configure: ModuleInitiator = (appConfigurator, args) => {
-  appConfigurator.useFeatureFlags(builder => /** see module for building custom config */);
-}
+const configure: AppModuleInitiator = (configurator) => {
+  // HTTP clients
+  configurator.http.configureClient('my-api', { baseUri: '...' });
+
+  // Feature flags
+  enableFeatureFlag(configurator, [{ key: 'beta', title: 'Beta' }]);
+
+  // Navigation, context, etc. — see module docs
+};
 ```
 
-[see module](https://equinor.github.io/fusion-framework/modules/feature-flag/module.html) for more technical information;
+> The MSAL / auth module is configured by the host portal and hoisted to apps automatically. Do **not** configure it in application code.

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

@@ -1,4 +1,11 @@
 import { useAppModule } from '../useAppModule';
+/**
+ * React hook that returns the current AG Grid theme from the application-scoped
+ * AG Grid module.
+ *
+ * @returns The active {@link Theme} object.
+ * @throws If the AG Grid module is not registered in the application.
+ */
 export const useTheme = () => {
     const agGrid = useAppModule('agGrid');
     if (!agGrid) {

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

@@ -1 +1 @@
-{"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../../src/ag-grid/useTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI/C,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAU,EAAE;IAClC,MAAM,MAAM,GAAG,YAAY,CAAe,QAAQ,CAAC,CAAC;IAEpD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC,KAAc,CAAC;AAC/B,CAAC,CAAC"}
+{"version":3,"file":"useTheme.js","sourceRoot":"","sources":["../../../src/ag-grid/useTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAI/C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAU,EAAE;IAClC,MAAM,MAAM,GAAG,YAAY,CAAe,QAAQ,CAAC,CAAC;IAEpD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,MAAM,CAAC,KAAc,CAAC;AAC/B,CAAC,CAAC"}

package/dist/esm/analytics/index.js

@@ -1,2 +1,10 @@
+/**
+ * Analytics sub-path entry-point.
+ *
+ * Provides the {@link useTrackFeature} hook for tracking application-level
+ * analytics events through the Fusion analytics module.
+ *
+ * @packageDocumentation
+ */
 export { useTrackFeature } from './useTrackFeature';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/esm/analytics/useTrackFeature.js

@@ -1,7 +1,23 @@
 import { useFrameworkModule } from '@equinor/fusion-framework-react';
 import { useCallback } from 'react';
 /**
- * Hook for using analytics module configured in the framework.
+ * React hook that returns a callback for tracking application feature usage
+ * via the Fusion analytics module.
+ *
+ * The tracked event includes the current app key and context (if available)
+ * as attributes, enabling downstream analytics dashboards to group events
+ * by application and context.
+ *
+ * @returns A `trackFeature` callback: `(name: string, data?: AnyValueMap) => void`.
+ *
+ * @example
+ * ```tsx
+ * const trackFeature = useTrackFeature();
+ *
+ * const handleClick = useCallback(() => {
+ *   trackFeature('button-click', { section: 'header' });
+ * }, [trackFeature]);
+ * ```
  */
 export const useTrackFeature = () => {
     const analyticsProvider = useFrameworkModule('analytics');

package/dist/esm/analytics/useTrackFeature.js.map

@@ -1 +1 @@
-{"version":3,"file":"useTrackFeature.js","sourceRoot":"","sources":["../../../src/analytics/useTrackFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,MAAM,iBAAiB,GAAG,kBAAkB,CAAkB,WAAW,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,kBAAkB,CAAY,KAAK,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAY,EAAE,IAAkB,EAAE,EAAE;QACnC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,iBAAiB,EAAE,cAAc,CAAC;gBAChC,IAAI,EAAE,2BAA2B;gBACjC,SAAS,EAAE,IAAI,KAAK,CAAC,8BAA8B,CAAC;aACrD,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB,EAAE,aAAa,CAAC;YAC/B,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI;aACL;YACD,UAAU,EAAE;gBACV,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;gBACpC,OAAO,EAAE,eAAe,EAAE,cAAc;oBACtC,CAAC,CAAC;wBACE,EAAE,EAAE,eAAe,CAAC,cAAc,CAAC,EAAE;wBACrC,UAAU,EAAE,eAAe,CAAC,cAAc,CAAC,UAAU;wBACrD,KAAK,EAAE,eAAe,CAAC,cAAc,CAAC,KAAK;wBAC3C,IAAI,EAAE,eAAe,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE;wBAC5C,MAAM,EAAE,eAAe,CAAC,cAAc,CAAC,MAAM;qBAC9C;oBACH,CAAC,CAAC,SAAS;aACd;SACF,CAAC,CAAC;IACL,CAAC,EACD,CAAC,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,CAAC,CACrE,CAAC;IAEF,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}
+{"version":3,"file":"useTrackFeature.js","sourceRoot":"","sources":["../../../src/analytics/useTrackFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEpC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,MAAM,iBAAiB,GAAG,kBAAkB,CAAkB,WAAW,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,kBAAkB,CAAY,KAAK,CAAC,CAAC;IACzD,MAAM,eAAe,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,iBAAiB,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAE1D;;;;;;;OAOG;IACH,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,IAAY,EAAE,IAAkB,EAAE,EAAE;QACnC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACvB,iBAAiB,EAAE,cAAc,CAAC;gBAChC,IAAI,EAAE,2BAA2B;gBACjC,SAAS,EAAE,IAAI,KAAK,CAAC,8BAA8B,CAAC;aACrD,CAAC,CAAC;QACL,CAAC;QAED,iBAAiB,EAAE,aAAa,CAAC;YAC/B,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI;aACL;YACD,UAAU,EAAE;gBACV,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM;gBACpC,OAAO,EAAE,eAAe,EAAE,cAAc;oBACtC,CAAC,CAAC;wBACE,EAAE,EAAE,eAAe,CAAC,cAAc,CAAC,EAAE;wBACrC,UAAU,EAAE,eAAe,CAAC,cAAc,CAAC,UAAU;wBACrD,KAAK,EAAE,eAAe,CAAC,cAAc,CAAC,KAAK;wBAC3C,IAAI,EAAE,eAAe,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE;wBAC5C,MAAM,EAAE,eAAe,CAAC,cAAc,CAAC,MAAM;qBAC9C;oBACH,CAAC,CAAC,SAAS;aACd;SACF,CAAC,CAAC;IACL,CAAC,EACD,CAAC,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,CAAC,CACrE,CAAC;IAEF,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}

package/dist/esm/apploader/Apploader.js

@@ -9,7 +9,7 @@ import { useApploader } from './useApploader';
  *
  * @param { ApploaderProps } props - The props for the component.
  * @param { string } props.appKey - The key of the Fusion app to load and mount.
- * @returns { JSX.Element } The rendered component, which displays loading, error, or the embedded app.
+ * @returns { ReactElement } The rendered component, which displays loading, error, or the embedded app.
  *
  * @example
  * <Apploader appKey="my-app" />

package/dist/esm/apploader/Apploader.js.map

@@ -1 +1 @@
-{"version":3,"file":"Apploader.js","sourceRoot":"","sources":["../../../src/apploader/Apploader.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,MAAM,EAAkB,EAAe,EAAE;IACnE,MAAM,QAAQ,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAErB,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,sCAAc,MAAM,IAAO,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,4CACiB,MAAM,eAAW,KAAK,CAAC,OAAO,IACzC,CACP,CAAC;IACJ,CAAC;IAED,OAAO,cAAK,GAAG,EAAE,QAAQ,GAAI,CAAC;AAChC,CAAC,CAAC;AAEF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Apploader.js","sourceRoot":"","sources":["../../../src/apploader/Apploader.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAqB,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAM9C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EAAE,MAAM,EAAkB,EAAgB,EAAE;IACpE,MAAM,QAAQ,GAAG,MAAM,CAAwB,IAAI,CAAC,CAAC;IACrD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAE5D,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAErB,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,sCAAc,MAAM,IAAO,CAAC;IACrC,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,4CACiB,MAAM,eAAW,KAAK,CAAC,OAAO,IACzC,CACP,CAAC;IACJ,CAAC;IAED,OAAO,cAAK,GAAG,EAAE,QAAQ,GAAI,CAAC;AAChC,CAAC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/esm/apploader/index.js

@@ -1,3 +1,11 @@
+/**
+ * Apploader sub-path entry-point.
+ *
+ * Provides the {@link Apploader} component and {@link useApploader} hook
+ * for embedding Fusion child applications inside a parent Fusion application.
+ *
+ * @packageDocumentation
+ */
 export { Apploader } from './Apploader';
 export { useApploader } from './useApploader';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/apploader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/apploader/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAuB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/bookmark/index.js

@@ -1,3 +1,11 @@
+/**
+ * Bookmark sub-path entry-point.
+ *
+ * Provides helpers to enable and consume the Fusion bookmark module,
+ * allowing users to save and restore application state snapshots.
+ *
+ * @packageDocumentation
+ */
 export { enableBookmark } from '@equinor/fusion-framework-app/enable-bookmark';
 export { useCurrentBookmark } from './useCurrentBookmark';
 export { useBookmark } from './useBookmark';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bookmark/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/bookmark/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/context/index.js

@@ -1,3 +1,11 @@
+/**
+ * Context sub-path entry-point.
+ *
+ * Provides hooks for reading and interacting with the Fusion context
+ * (project, facility, etc.) at both the application and framework level.
+ *
+ * @packageDocumentation
+ */
 export * from '@equinor/fusion-framework-react-module-context';
 export { useContextProvider } from './useContextProvider';
 export { useCurrentContext } from './useCurrentContext';

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA,cAAc,gDAAgD,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/context/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,gDAAgD,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC"}