fix(module-context): restore path-based initial context resolution (#5288)

* fix(module-context): restore path-based fallback in resolveInitialContext

The context-navigation plugin (#4751) removed URL-based resolution from
resolveInitialContext in favor of the plugin. Consumers not yet on the
plugin lost the ability to resolve initial context from the path, so
restore it as a deprecated fallback composed with parent-context
resolution.

* fix(resolve-initial-context): make options parameter optional in resolveInitialContext

Author: Noggling

.changeset/module-context_restore-path-based-initial-context.md

@@ -0,0 +1,5 @@
+---
+"@equinor/fusion-framework-module-context": patch
+---
+
+Restore path-based resolution as a fallback in `resolveInitialContext`, composed with parent-context resolution. The context-navigation plugin introduced in #4751 removed this from the module, but consumers not yet migrated to the plugin lost initial-context resolution from the URL. `resolveInitialContext` now accepts a `path` option (`extract`/`validate`) used to resolve context from the URL before falling back to the parent context.

.changeset/plugin-context-navigation_path-adapter-app-route-guard.md

@@ -0,0 +1,5 @@
+---
+"@equinor/fusion-framework-plugin-context-navigation": patch
+---
+
+Fix `createPathAdapter` matching on non-app routes. `canHandle` now rejects a URL when `currentURL.pathname` does not parse as a valid app route (e.g. portal chrome), preventing the path adapter from incorrectly claiming ownership of URLs where there is no app route to encode context into.

packages/modules/context/src/configurator.ts

@@ -249,7 +249,12 @@ export class ContextModuleConfigurator implements IContextModuleConfigurator {
       Promise.resolve({} as Partial<ContextModuleConfig>),
     );
 
-    config.resolveInitialContext ??= resolveInitialContext();
+    config.resolveInitialContext ??= resolveInitialContext({
+      path: {
+        extract: config.extractContextIdFromPath,
+        validate: config.extractContextIdFromPath ? () => true : undefined,
+      },
+    });
 
     // TODO(#5119) - make less lazy
     config.client ??= await (async (): Promise<ContextModuleConfig['client']> => {

packages/modules/context/src/utils/resolve-initial-context.ts

@@ -1,7 +1,9 @@
 import type { ModulesInstance } from '@equinor/fusion-framework-module';
 import type { ContextModule } from '../module';
 import type { ContextModuleConfig } from '../configurator';
-import { concat, EMPTY, of, take } from 'rxjs';
+import { concat, EMPTY, first, of } from 'rxjs';
+import resolveContextFromPath, { type ContextPathResolveArgs } from './resolve-context-from-path';
+import type { NavigationModule } from '@equinor/fusion-framework-module-navigation';
 
 /**
  * Resolves the initial context from the parent module.
@@ -11,6 +13,7 @@ import { concat, EMPTY, of, take } from 'rxjs';
  */
 export const resolveContextFromParent: ContextModuleConfig['resolveInitialContext'] = ({ ref }) => {
   const parentContext = (ref as ModulesInstance<[ContextModule]>)?.context;
+  // check if the parent has context module
   if (!parentContext) {
     // No parent context available — either portal level or parent lacks context module.
     return EMPTY;
@@ -22,19 +25,31 @@ export const resolveContextFromParent: ContextModuleConfig['resolveInitialContex
 /**
  * Resolves the initial context for a Fusion Framework context module.
  *
- * Attempts to resolve the initial context from the parent context provider.
- * URL-based resolution is handled by the context-navigation plugin.
+ * will try to resolve the initial context from the path, and if that fails, it will try to resolve the context from the parent.
  *
+ * @param options - Optional configuration for resolving the context path.
  * @returns A function that accepts the module's reference and modules, and returns an Observable of the resolved initial context.
  */
+
 // Deliberately co-located with resolveContextFromParent, which it composes with
 // fusion-lint-disable-next-line single-export-per-file
 export const resolveInitialContext =
-  (): Required<ContextModuleConfig>['resolveInitialContext'] =>
+  (options?: {
+    path?: ContextPathResolveArgs;
+  }): Required<ContextModuleConfig>['resolveInitialContext'] =>
   ({ ref, modules }) => {
-    // Resolve from parent context if available.
-    // URL-based resolution is handled by the context-navigation plugin.
-    return concat(resolveContextFromParent({ ref, modules })).pipe(take(1));
+    const { context, navigation } = modules;
+    // create a path resolver from the context module
+    const pathResolver = resolveContextFromPath(context, options?.path);
+    // use the path from the navigation module, or the path from the parent navigation module
+    const pathname =
+      navigation?.path.pathname ??
+      (ref as Partial<ModulesInstance<[NavigationModule]>>).navigation?.path.pathname;
+    // try to resolve the context from the path, and if that fails, try to resolve the context from the parent
+    return concat(
+      pathname ? pathResolver(pathname) : EMPTY,
+      resolveContextFromParent({ ref, modules }),
+    ).pipe(first());
   };
 
 export default resolveInitialContext;

packages/plugins/context-navigation/src/adapters/create-path-adapter.ts

@@ -41,12 +41,17 @@ export function createPathAdapter(): ContextNavigationAdapter {
      * Accepts apps with explicit `'path'` strategy or no declared strategy
      * (the path adapter serves as the system-wide default fallback).
      */
-    canHandle({ appContext, routingStrategy }: AdapterResolutionContext): boolean {
+    canHandle({ appContext, routingStrategy, currentURL }: AdapterResolutionContext): boolean {
       // Custom generators mean the app owns its URL shape — the custom adapter handles it, not us
       if (hasCustomContextGenerators(appContext)) {
         return false;
       }
 
+      // Not an app route (e.g. portal chrome) — nothing for this adapter to encode context into
+      if (!parseAppRoute(currentURL.pathname)) {
+        return false;
+      }
+
       const declared = routingStrategy;
       // App explicitly opted into path-segment routing — take ownership
       if (declared === 'path') {