@equinor/fusion-framework-dev-portal 8.0.3 → 9.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-dev-portal",
-  "version": "8.0.3",
+  "version": "9.0.0",
   "description": "",
   "type": "module",
   "module": "./dist/main.js",
@@ -28,54 +28,58 @@
     "@equinor/fusion-wc-person": "^3.5.5",
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
+    "@types/semver": "^7.7.1",
     "@vitejs/plugin-react": "^6.0.1",
     "dotenv": "^17.3.1",
     "react": "^19.2.1",
     "react-dom": "^19.2.1",
     "rxjs": "^7.8.1",
     "styled-components": "^6.3.11",
+    "semver": "^7.7.2",
     "tsx": "^4.19.3",
     "typescript": "^7.0.2",
     "vite": "^8.0.0",
-    "@equinor/fusion-framework": "8.0.12",
-    "@equinor/fusion-framework-app": "11.0.12",
-    "@equinor/fusion-framework-module-ag-grid": "37.0.1",
-    "@equinor/fusion-framework-module-analytics": "3.0.4",
-    "@equinor/fusion-framework-dev-server": "2.0.17",
+    "@equinor/fusion-framework-app": "12.0.0",
+    "@equinor/fusion-framework-dev-server": "2.0.18",
+    "@equinor/fusion-framework": "8.0.13",
     "@equinor/fusion-framework-module-app": "8.0.4",
     "@equinor/fusion-framework-module-bookmark": "4.0.4",
-    "@equinor/fusion-framework-module-context": "8.0.1",
+    "@equinor/fusion-framework-module-ag-grid": "37.0.1",
+    "@equinor/fusion-framework-module-context": "8.0.2",
+    "@equinor/fusion-framework-module-analytics": "3.0.5",
+    "@equinor/fusion-framework-plugin-context-navigation": "0.1.0",
     "@equinor/fusion-framework-module-feature-flag": "2.0.3",
-    "@equinor/fusion-framework-module-navigation": "7.0.6",
-    "@equinor/fusion-framework-module-services": "8.0.3",
-    "@equinor/fusion-framework-module-telemetry": "7.0.1",
+    "@equinor/fusion-framework-module-navigation": "7.0.7",
+    "@equinor/fusion-framework-module-telemetry": "7.0.2",
     "@equinor/fusion-framework-react": "8.0.1",
-    "@equinor/fusion-framework-react-module-bookmark": "6.0.1",
-    "@equinor/fusion-framework-react-components-people-provider": "2.0.4",
-    "@equinor/fusion-framework-react-router": "2.4.0",
+    "@equinor/fusion-framework-module-services": "8.0.3",
     "@equinor/fusion-framework-react-components-bookmark": "2.0.3",
+    "@equinor/fusion-framework-react-router": "2.4.0",
     "@equinor/fusion-observable": "9.1.1",
-    "@equinor/fusion-query": "7.0.3"
+    "@equinor/fusion-query": "7.0.3",
+    "@equinor/fusion-framework-react-components-people-provider": "2.0.4",
+    "@equinor/fusion-framework-react-module-bookmark": "6.0.1"
   },
   "peerDependencies": {
-    "@equinor/fusion-framework": "8.0.12",
-    "@equinor/fusion-framework-app": "11.0.12",
+    "@equinor/fusion-framework": "8.0.13",
+    "@equinor/fusion-framework-app": "12.0.0",
     "@equinor/fusion-framework-module-ag-grid": "37.0.1",
-    "@equinor/fusion-framework-module-analytics": "3.0.4",
+    "@equinor/fusion-framework-dev-server": "2.0.18",
     "@equinor/fusion-framework-module-app": "8.0.4",
+    "@equinor/fusion-framework-module-analytics": "3.0.5",
     "@equinor/fusion-framework-module-bookmark": "4.0.4",
-    "@equinor/fusion-framework-module-context": "8.0.1",
+    "@equinor/fusion-framework-module-context": "8.0.2",
+    "@equinor/fusion-framework-plugin-context-navigation": "0.1.0",
     "@equinor/fusion-framework-module-feature-flag": "2.0.3",
-    "@equinor/fusion-framework-dev-server": "2.0.17",
-    "@equinor/fusion-framework-module-navigation": "7.0.6",
+    "@equinor/fusion-framework-module-navigation": "7.0.7",
     "@equinor/fusion-framework-module-services": "8.0.3",
-    "@equinor/fusion-framework-module-telemetry": "7.0.1",
     "@equinor/fusion-framework-react-components-bookmark": "2.0.3",
+    "@equinor/fusion-framework-module-telemetry": "7.0.2",
     "@equinor/fusion-framework-react-components-people-provider": "2.0.4",
+    "@equinor/fusion-framework-react": "8.0.1",
     "@equinor/fusion-framework-react-module-bookmark": "6.0.1",
     "@equinor/fusion-observable": "9.1.1",
-    "@equinor/fusion-query": "7.0.3",
-    "@equinor/fusion-framework-react": "8.0.1"
+    "@equinor/fusion-query": "7.0.3"
   },
   "peerDependenciesMeta": {
     "@equinor/fusion-framework": {

package/src/Router.tsx

@@ -1,11 +1,10 @@
 import { useBookmarkNavigate } from '@equinor/fusion-framework-react-module-bookmark/portal';
 
-import { Outlet, Router as FusionRouter, useParams } from '@equinor/fusion-framework-react-router';
+import { Router as FusionRouter, Outlet, useParams } from '@equinor/fusion-framework-react-router';
 import AppLoader from './AppLoader';
 import { Header } from './Header';
 
 import { styled } from 'styled-components';
-import { useAppContextNavigation } from './useAppContextNavigation';
 
 const Styled = {
   ContentContainer: styled.div`
@@ -76,11 +75,9 @@ const routes = [
 /**
  * Top-level router for the Fusion Dev Portal.
  *
- * Renders the application via `FusionRouter`. Observes context changes through
- * {@link useAppContextNavigation} to keep the URL in sync.
+ * Uses `@equinor/fusion-framework-react-router` which automatically connects
+ * to the framework's navigation module for history and basename.
  */
 export const Router = () => {
-  // observe the context changes and navigate when the context changes
-  useAppContextNavigation();
   return <FusionRouter routes={routes} />;
 };

package/src/configure.ts

@@ -1,9 +1,13 @@
-import { enableAppModule } from '@equinor/fusion-framework-module-app';
+import { enableAppModule, type AppModule } from '@equinor/fusion-framework-module-app';
 import { enableBookmark } from '@equinor/fusion-framework-react-module-bookmark';
 import type { FrameworkConfigurator } from '@equinor/fusion-framework';
 import { enableAnalytics } from '@equinor/fusion-framework-module-analytics';
 import { ConsoleAnalyticsAdapter } from '@equinor/fusion-framework-module-analytics/adapters';
-import { enableNavigation } from '@equinor/fusion-framework-module-navigation';
+import { enableContext } from '@equinor/fusion-framework-module-context';
+import {
+  enableNavigation,
+  type NavigationModule,
+} from '@equinor/fusion-framework-module-navigation';
 import { enableServices } from '@equinor/fusion-framework-module-services';
 import { enableFeatureFlagging } from '@equinor/fusion-framework-module-feature-flag';
 import {
@@ -11,15 +15,22 @@ import {
   createUrlPlugin,
 } from '@equinor/fusion-framework-module-feature-flag/plugins';
 import { enableAgGrid } from '@equinor/fusion-framework-module-ag-grid';
-
 import { enableTelemetry } from '@equinor/fusion-framework-module-telemetry';
+import {
+  enableContextNavigation,
+  legacyAppNavigationFix,
+} from '@equinor/fusion-framework-plugin-context-navigation';
+import {
+  buildContextUrlForStrategy,
+  resolveContextIdFromUrl,
+} from '@equinor/fusion-framework-plugin-context-navigation/utils';
 import { version } from './version';
 
 declare global {
   interface Window {
     /**
-     * AG Grid license key for enabling enterprise features
-     * @remarks This is typically set via environment variables during build time
+     * AG Grid license key for enabling enterprise features.
+     * @remarks Typically set via environment variables during build time.
      */
     FUSION_AG_GRID_KEY?: string;
   }
@@ -28,10 +39,15 @@ declare global {
 /**
  * Configures the Fusion Dev Portal framework with all required modules.
  *
- * Enables and wires together:
+ * Modules enabled:
  * - **Telemetry** — portal-scoped usage analytics with version metadata.
- * - **App module** — application manifest loading and lifecycle.
- * - **Navigation** — router integration with optional telemetry.
+ * - **App** — application manifest loading and lifecycle.
+ * - **Context** — context routing URL hooks (path generator + extractor) wired to the shared context-navigation URL utilities.
+ * - **Context Navigation plugin** — keeps the browser URL in sync with the
+ *   active context, handles app-switch carry-over, and guards against
+ *   accidental context loss. Telemetry is auto-resolved from the framework
+ *   telemetry module.
+ * - **Navigation** — router integration with telemetry.
  * - **Services** — standard Fusion service integrations.
  * - **AG Grid** — enterprise license key from `window.FUSION_AG_GRID_KEY`.
  * - **Analytics** — console adapter gated by the `fusionLogAnalytics` feature flag.
@@ -51,10 +67,7 @@ export const configure = async (config: FrameworkConfigurator) => {
       builder.setMetadata(() => ({
         fusion: {
           type: 'portal-telemetry',
-          portal: {
-            version,
-            name: 'Fusion Dev Portal',
-          },
+          portal: { version, name: 'Fusion Dev Portal' },
         },
       }));
       // Scope telemetry events to portal-specific tracking
@@ -66,8 +79,26 @@ export const configure = async (config: FrameworkConfigurator) => {
 
   enableAppModule(config);
 
+  /**
+   * Configure context module with dev-portal URL conventions.
+   *
+   * This wires the context module's URL hooks — the path generator
+   * and path extractor — to the dev-portal's URL routing strategy.
+   *
+   * The context-navigation plugin keeps the browser URL in sync with the
+   * active context as it changes at runtime.
+   */
+  enableContext(config, (builder) => {
+    builder.setContextPathGenerator((context, path) =>
+      buildContextUrlForStrategy(context?.id, path),
+    );
+
+    builder.setContextPathExtractor((path) => resolveContextIdFromUrl(path));
+  });
+
   enableNavigation(config, {
     configure: (config) => {
+      config.setBasename('/');
       config.setTelemetry(async (args) => {
         // Only provide telemetry when the telemetry module was actually enabled
         if (args.hasModule('telemetry')) {
@@ -133,13 +164,23 @@ export const configure = async (config: FrameworkConfigurator) => {
     builder.addPlugin(createUrlPlugin(['fusionDebug']));
   });
 
-  // Expose framework modules globally for development debugging and inspection
-  config.onInitialized(async (modules) => {
-    // NOTE: TypeScript ignore needed due to window object extension
-    // This provides developer access to all initialized modules via window.Fusion
-    // @ts-expect-error
+  // Keep portal URLs aligned with the active app/context combination by using
+  // the shared context-navigation plugin and the dev-portal URL helpers.
+  enableContextNavigation(config, (builder) => {
+    builder.setPortalName('dev-portal');
+    builder.setDebug(true);
+    builder.setUrlGuard(true);
+    builder.setNavigationOptions({
+      replace: false, // Use pushState for navigation to allow back button support
+    });
+  });
+
+  config.onInitialized<[AppModule, NavigationModule]>((modules) => {
+    // Reset legacy app routers on context navigation for apps with navigation <v7.
+    legacyAppNavigationFix({ event: modules.event });
+
+    // Expose framework modules globally for development debugging and inspection.
+    // @ts-expect-error — `window` is not typed with `Fusion`
     window.Fusion = { modules };
   });
 };
-
-export default configure;

package/src/version.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '8.0.3';
+export const version = '9.0.0';

package/tsconfig.json

@@ -69,6 +69,9 @@
     },
     {
       "path": "../dev-server"
+    },
+    {
+      "path": "../plugins/context-navigation"
     }
   ],
   "include": ["src/**/*", "start.ts"],