@equinor/fusion-framework-react-app 9.0.9-next.0 → 10.0.0

package/CHANGELOG.md

@@ -1,21 +1,89 @@
 # Change Log
 
-## 9.0.9-next.0
+## 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
 
-- [#3820](https://github.com/equinor/fusion-framework/pull/3820) [`f647825`](https://github.com/equinor/fusion-framework/commit/f647825cb5712763b09dafda21fd996211c78b78) Thanks [@odinr](https://github.com/odinr)! - relase next
+- 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 [[`f647825`](https://github.com/equinor/fusion-framework/commit/f647825cb5712763b09dafda21fd996211c78b78)]:
-  - @equinor/fusion-framework-react-module@3.1.15-next.0
-  - @equinor/fusion-framework-module-navigation@7.0.0-next.2
-  - @equinor/fusion-framework-react-module-http@10.0.2-next.0
-  - @equinor/fusion-framework-react@7.4.21-next.0
-  - @equinor/fusion-framework-module-app@7.4.2-next.0
-  - @equinor/fusion-framework-app@10.4.10-next.0
-  - @equinor/fusion-framework-module-http@7.0.9-next.0
-  - @equinor/fusion-framework-module@5.0.7-next.0
-  - @equinor/fusion-framework-module-msal@7.3.2-next.0
+- 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
 

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/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"}

package/dist/esm/context/useContextProvider.js

@@ -1,4 +1,10 @@
 import { useAppModule } from '../useAppModule';
+/**
+ * React hook that resolves the application-scoped context module provider.
+ *
+ * @returns The context module provider instance.
+ * @throws If the context module is not registered in the application scope.
+ */
 export const useContextProvider = () => useAppModule('context');
 export default useContextProvider;
 //# sourceMappingURL=useContextProvider.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useContextProvider.js","sourceRoot":"","sources":["../../../src/context/useContextProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,YAAY,CAAgB,SAAS,CAAC,CAAC;AAE/E,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"useContextProvider.js","sourceRoot":"","sources":["../../../src/context/useContextProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,YAAY,CAAgB,SAAS,CAAC,CAAC;AAE/E,eAAe,kBAAkB,CAAC"}

package/dist/esm/context/useCurrentContext.js

@@ -1,5 +1,19 @@
 import { useCurrentContext as _useCurrentContext } from '@equinor/fusion-framework-react-module-context';
 import useContextProvider from './useContextProvider';
+/**
+ * React hook that returns the currently selected Fusion context from the
+ * **application-scoped** context module.
+ *
+ * @returns The current context object, or `undefined` if no context is selected.
+ *
+ * @example
+ * ```tsx
+ * const context = useCurrentContext();
+ * if (context) {
+ *   console.log('Selected:', context.title);
+ * }
+ * ```
+ */
 export const useCurrentContext = () => _useCurrentContext(useContextProvider());
 export default useCurrentContext;
 //# sourceMappingURL=useCurrentContext.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"useCurrentContext.js","sourceRoot":"","sources":["../../../src/context/useCurrentContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzG,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEhF,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"useCurrentContext.js","sourceRoot":"","sources":["../../../src/context/useCurrentContext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,IAAI,kBAAkB,EAAE,MAAM,gDAAgD,CAAC;AACzG,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAEhF,eAAe,iBAAiB,CAAC"}

package/dist/esm/create-legacy-app.js

@@ -2,6 +2,19 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { Suspense, useMemo } from 'react';
 import { useFramework } from '@equinor/fusion-framework-react';
 import { createComponent } from './create-component';
+/**
+ * Creates a legacy wrapper component that bootstraps a Fusion React app within
+ * the older Fusion CLI hosting model.
+ *
+ * @deprecated Prefer {@link renderApp} for new applications. This helper exists
+ * only for backward-compatibility with apps that must run inside the legacy
+ * Fusion CLI.
+ *
+ * @template TModules - Array of additional module types to initialise.
+ * @param Component - The root React element to render.
+ * @param configure - Optional callback to configure application modules.
+ * @returns A React function component that initialises modules and renders the app.
+ */
 export const createLegacyApp = (Component, configure) => {
     const LegacyComponent = () => {
         const fusion = useFramework();

package/dist/esm/create-legacy-app.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-legacy-app.js","sourceRoot":"","sources":["../../src/create-legacy-app.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAoB,MAAM,OAAO,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAK/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,SAAsB,EACtB,SAAwC,EACxC,EAAE;IACF,MAAM,eAAe,GAAG,GAAG,EAAE;QAC3B,MAAM,MAAM,GAAG,YAAY,EAAe,CAAC;QAC3C,qFAAqF;QACrF,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE;YACnC,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACtD,YAAY;YACZ,oDAAoD;YACpD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;YACvC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;gBACzB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;gBACjD,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAuB,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,EAAE,EAAuB,CAAC,CAAC;QAClD,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACb,OAAO,CACL,KAAC,QAAQ,IAAC,QAAQ,EAAE,sCAAkB,YACpC,KAAC,eAAe,KAAG,GACV,CACZ,CAAC;IACJ,CAAC,CAAC;IACF,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC"}
+{"version":3,"file":"create-legacy-app.js","sourceRoot":"","sources":["../../src/create-legacy-app.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAoB,MAAM,OAAO,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAK/D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,SAAsB,EACtB,SAAwC,EACxC,EAAE;IACF,MAAM,eAAe,GAAG,GAAG,EAAE;QAC3B,MAAM,MAAM,GAAG,YAAY,EAAe,CAAC;QAC3C,qFAAqF;QACrF,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE;YACnC,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACtD,YAAY;YACZ,oDAAoD;YACpD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;YACvC,IAAI,WAAW,EAAE,OAAO,EAAE,CAAC;gBACzB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;gBACjD,OAAO,OAAO,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAuB,CAAC,CAAC;YACpE,CAAC;YACD,OAAO,OAAO,CAAC,MAAM,EAAE,EAAuB,CAAC,CAAC;QAClD,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACb,OAAO,CACL,KAAC,QAAQ,IAAC,QAAQ,EAAE,sCAAkB,YACpC,KAAC,eAAe,KAAG,GACV,CACZ,CAAC;IACJ,CAAC,CAAC;IACF,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC"}

package/dist/esm/feature-flag/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/feature-flag/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/feature-flag/index.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/feature-flag/useFeature.js

@@ -5,10 +5,26 @@ import { useObservableState } from '@equinor/fusion-observable/react';
 import { findFeature } from '@equinor/fusion-framework-module-feature-flag/selectors';
 import { useAppModule } from '../useAppModule';
 /**
- * Custom hook for accessing and manipulating feature flags.
- * @template T - The type of the feature flag value.
- * @param key - The key of the feature flag.
- * @returns An object containing the feature flag, toggle function, and error (if any).
+ * React hook for reading and toggling a single feature flag.
+ *
+ * Merges feature flags from both the framework and the application scope,
+ * so framework-level flags are visible alongside app-specific ones.
+ *
+ * @template T - The type of the feature flag's value payload.
+ * @param key - The unique key identifying the feature flag.
+ * @returns An object with:
+ *   - `feature` – the resolved {@link IFeatureFlag}, or `undefined` if not found.
+ *   - `toggleFeature` – callback to toggle the flag; pass `true`/`false` to
+ *     set explicitly, or omit to invert the current state.
+ *   - `error` – any error from the feature-flag observable.
+ *
+ * @example
+ * ```tsx
+ * const { feature, toggleFeature } = useFeature('dark-mode');
+ * return (
+ *   <Switch checked={feature?.enabled} onChange={() => toggleFeature()} />
+ * );
+ * ```
  */
 export const useFeature = (key) => {
     const appProvider = useAppModule('featureFlag');