@equinor/fusion-framework-react 8.0.0 → 8.0.1

package/dist/types/Framework.d.ts

@@ -43,5 +43,5 @@ export declare const Framework: (props: PropsWithChildren<{
     readonly configure: ConfigureCallback;
     readonly fallback: NonNullable<ReactNode> | null;
     readonly parent?: ModulesInstance<any>;
-}>) => import("react/jsx-runtime").JSX.Element;
+}>) => import("react").JSX.Element;
 export default Framework;

package/dist/types/app/useAppProvider.d.ts

@@ -13,5 +13,5 @@ import type { AppModule } from '@equinor/fusion-framework-module-app';
  * provider.getAppManifests().subscribe(console.log);
  * ```
  */
-export declare const useAppProvider: () => FusionModulesInstance<[AppModule]>["app"];
+export declare const useAppProvider: () => FusionModulesInstance<[AppModule]>['app'];
 export default useAppProvider;

package/dist/types/context.d.ts

@@ -1,20 +1 @@
-import type { Fusion } from '@equinor/fusion-framework';
-/**
- * Component for providing framework.
- *
- * @remarks
- * Should be created by {@link createFrameworkProvider}
- *
- * @example
- * ```tsx
- * import {FrameworkProvider} from '@equinor/fusion-framework-react';
- * export const Component = (args: React.PropsWithChildren<{framework: Fusion}>) => {
- *   return (
- *      <FrameworkProvider value={args.framework}>
- *        {args.children}
- *      </FrameworkProvider>
- *   );
- * }
- * ```
- */
-export declare const FrameworkProvider: import("react").Provider<Fusion<any> | null>;
+export {};

package/dist/types/framework-provider.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Component for providing framework.
+ *
+ * @remarks
+ * Should be created by {@link createFrameworkProvider}
+ *
+ * @example
+ * ```tsx
+ * import {FrameworkProvider} from '@equinor/fusion-framework-react';
+ * export const Component = (args: React.PropsWithChildren<{framework: Fusion}>) => {
+ *   return (
+ *      <FrameworkProvider value={args.framework}>
+ *        {args.children}
+ *      </FrameworkProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare const FrameworkProvider: import("react").Provider<import("@equinor/fusion-framework").Fusion<any> | null>;

package/dist/types/hooks/index.d.ts

@@ -6,5 +6,5 @@
  *
  * @module
  */
-export { useCurrentUser } from './use-current-user';
-export { useHttpClient } from './use-http-client';
+export { useCurrentUser } from './useCurrentUser';
+export { useHttpClient } from './useHttpClient';

package/dist/types/http/index.d.ts

@@ -8,5 +8,5 @@
  *
  * @module
  */
-export { useHttpClient as useFrameworkHttpClient } from '../hooks/use-http-client';
+export { useHttpClient as useFrameworkHttpClient } from '../hooks/useHttpClient';
 export * from '@equinor/fusion-framework-react-module-http';

package/dist/types/index.d.ts

@@ -13,7 +13,7 @@
 export type { Fusion } from '@equinor/fusion-framework';
 export { FusionConfigurator } from '@equinor/fusion-framework';
 export { createFrameworkProvider } from './create-framework-provider';
-export { FrameworkProvider } from './context';
+export { FrameworkProvider } from './framework-provider';
 export { useFramework } from './useFramework';
 export { useFrameworkModule } from './useFrameworkModule';
 export { default, Framework } from './Framework';

package/dist/types/signalr/index.d.ts

@@ -1,24 +1 @@
-import { useProviderTopic } from '@equinor/fusion-framework-react-module-signalr';
-/**
- * hook for subscribing to a topic of a SignalR hub
- *
- * @example
- ```ts
-// config.ts
-import {enableSignalR} from '@equinor/fusion-framework-react-module-signalr';
-(configurator) => enableSignalR(configurator, 'notifications');
-
-// myHook.ts
-const myHook = () => {
-    const topic = useSignalR('notifications', 'foo');
-    return useObservableState(topic).next;
-}
- ```
- *
- * @see {@link [module signalr](https://equinor.github.io/fusion-framework/modules/signalr)}
- *
- * @param hubId identifier of connection hub (must be configured)
- * @param topicId identifier of topic to connect to
- * @returns Topic
- */
-export declare const useSignalR: <T>(hubId: string, topicId: string) => ReturnType<typeof useProviderTopic<T>>;
+export { useSignalR } from './useSignalR.js';

package/dist/types/signalr/useSignalR.d.ts

@@ -0,0 +1,24 @@
+import { useProviderTopic } from '@equinor/fusion-framework-react-module-signalr';
+/**
+ * hook for subscribing to a topic of a SignalR hub
+ *
+ * @example
+ ```ts
+// config.ts
+import {enableSignalR} from '@equinor/fusion-framework-react-module-signalr';
+(configurator) => enableSignalR(configurator, 'notifications');
+
+// myHook.ts
+const myHook = () => {
+    const topic = useSignalR('notifications', 'foo');
+    return useObservableState(topic).next;
+}
+ ```
+ *
+ * @see {@link [module signalr](https://equinor.github.io/fusion-framework/modules/signalr)}
+ *
+ * @param hubId identifier of connection hub (must be configured)
+ * @param topicId identifier of topic to connect to
+ * @returns Topic
+ */
+export declare const useSignalR: <T>(hubId: string, topicId: string) => ReturnType<typeof useProviderTopic<T>>;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "8.0.0";
+export declare const version = "8.0.1";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-react",
-  "version": "8.0.0",
+  "version": "8.0.1",
   "description": "",
   "main": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -72,31 +72,31 @@
   },
   "dependencies": {
     "rxjs": "^7.8.1",
-    "@equinor/fusion-framework": "^8.0.0",
-    "@equinor/fusion-framework-module": "^6.0.0",
-    "@equinor/fusion-framework-react-module-http": "^11.0.0",
-    "@equinor/fusion-framework-react-module": "^4.0.0",
-    "@equinor/fusion-observable": "^9.0.0"
+    "@equinor/fusion-framework": "^8.0.11",
+    "@equinor/fusion-framework-react-module": "^4.0.2",
+    "@equinor/fusion-framework-react-module-http": "^11.0.1",
+    "@equinor/fusion-observable": "^9.1.1",
+    "@equinor/fusion-framework-module": "^6.1.1"
   },
   "devDependencies": {
     "@types/react": "^19.2.7",
     "@types/react-dom": "^19.2.3",
     "react": "^19.2.1",
     "react-dom": "^19.2.1",
-    "typescript": "^5.9.3",
-    "@equinor/fusion-framework-module-app": "^8.0.0",
-    "@equinor/fusion-framework-module-event": "^6.0.0",
-    "@equinor/fusion-framework-module-feature-flag": "^2.0.0",
-    "@equinor/fusion-framework-module-msal": "^8.0.0",
-    "@equinor/fusion-framework-react-module-context": "^7.0.0",
-    "@equinor/fusion-framework-react-module-signalr": "^4.0.0"
+    "typescript": "^7.0.2",
+    "@equinor/fusion-framework-module-app": "^8.0.3",
+    "@equinor/fusion-framework-module-event": "^6.0.1",
+    "@equinor/fusion-framework-module-msal": "^10.0.2",
+    "@equinor/fusion-framework-react-module-context": "^7.0.2",
+    "@equinor/fusion-framework-module-feature-flag": "^2.0.2",
+    "@equinor/fusion-framework-react-module-signalr": "^4.0.3"
   },
   "peerDependencies": {
     "@types/react": "^18.0.0 || ^19.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
-    "@equinor/fusion-framework-react-module-signalr": "^4.0.0",
-    "@equinor/fusion-framework-module-feature-flag": "^2.0.0"
+    "@equinor/fusion-framework-module-feature-flag": "^2.0.2",
+    "@equinor/fusion-framework-react-module-signalr": "^4.0.3"
   },
   "peerDependenciesMeta": {
     "@equinor/fusion-framework-module-event": {

package/src/app/useAppProvider.ts

@@ -18,6 +18,7 @@ import { useFramework } from '../useFramework';
  */
 export const useAppProvider = (): FusionModulesInstance<[AppModule]>['app'] => {
   const provider = useFramework<[AppModule]>().modules.app;
+  // Fail fast when the AppModule has not been configured on the framework
   if (!provider) {
     throw Error('Current framework does not have AppModule configured');
   }

package/src/app/useCurrentApp.ts

@@ -50,6 +50,7 @@ export const useCurrentApp = <
   error?: unknown;
 } => {
   const provider = useFramework<[AppModule]>().modules.app;
+  // Fail fast when the AppModule has not been configured on the framework
   if (!provider) {
     throw Error('Current framework does not have AppModule configured');
   }

package/src/app/useCurrentAppModule.ts

@@ -38,13 +38,19 @@ export const useCurrentAppModule = <
   complete: boolean;
 } => {
   const { modules, error, complete } = useCurrentAppModules();
-  const module =
-    modules === null
-      ? null
-      : modules === undefined
-        ? undefined
-        : // eslint-disable-next-line @typescript-eslint/no-explicit-any
-          (modules[moduleKey as keyof typeof modules] as any);
+  const module = (() => {
+    // Preserve an explicit null (modules not applicable) distinct from undefined (not yet loaded)
+    if (modules === null) {
+      return null;
+    }
+    // Modules are still loading; propagate undefined rather than throwing
+    if (modules === undefined) {
+      return undefined;
+    }
+    // Module lookup by dynamic key can't be statically narrowed to the exact module type; cast to any.
+    // biome-ignore lint/suspicious/noExplicitAny: dynamic key lookup can't be statically narrowed to the exact module type
+    return modules[moduleKey as keyof typeof modules] as any;
+  })();
   return { module, error, complete };
 };
 

package/src/context.ts

@@ -10,25 +10,5 @@ import type { Fusion } from '@equinor/fusion-framework';
  *
  * @internal
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
+// biome-ignore lint/suspicious/noExplicitAny: `Fusion<any>` widens the context to accept a Fusion instance with any concrete module set
 export const context = createContext<Fusion<any> | null>(null);
-
-/**
- * Component for providing framework.
- *
- * @remarks
- * Should be created by {@link createFrameworkProvider}
- *
- * @example
- * ```tsx
- * import {FrameworkProvider} from '@equinor/fusion-framework-react';
- * export const Component = (args: React.PropsWithChildren<{framework: Fusion}>) => {
- *   return (
- *      <FrameworkProvider value={args.framework}>
- *        {args.children}
- *      </FrameworkProvider>
- *   );
- * }
- * ```
- */
-export const FrameworkProvider = context.Provider;

package/src/create-framework-provider.tsx

@@ -3,7 +3,7 @@ import { lazy } from 'react';
 import initFusion from '@equinor/fusion-framework';
 import { FrameworkConfigurator } from '@equinor/fusion-framework';
 
-import { FrameworkProvider } from './context';
+import { FrameworkProvider } from './framework-provider';
 import type { AnyModule, ModulesInstanceType } from '@equinor/fusion-framework-module';
 import { ModuleProvider } from '@equinor/fusion-framework-react-module';
 
@@ -49,7 +49,7 @@ import { ModuleProvider } from '@equinor/fusion-framework-react-module';
  */
 export const createFrameworkProvider = <
   TModules extends Array<AnyModule> = [],
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // biome-ignore lint/suspicious/noExplicitAny: default must be bivariant `any`, not `unknown` \u2014 `unknown` breaks assignability when a concrete `TRef` is passed where the default-typed generic is expected
   TRef extends ModulesInstanceType<[AnyModule]> = any,
 >(
   cb: (configurator: FrameworkConfigurator<TModules>, ref?: TRef) => void | Promise<void>,

package/src/feature-flag/useFeature.ts

@@ -49,7 +49,14 @@ export const useFeature = <T = unknown>(
   provider: IFeatureFlagProvider,
   key: string,
 ): UseFeatureResult<T> => {
-  const feature$ = useMemo(() => provider.features$.pipe(findFeature<T>(key)), [provider, key]);
+  // Narrow the features stream down to just the one matching feature by key.
+  const feature$ = useMemo(
+    () =>
+      provider.features$
+        // Keep the observable scoped to the requested feature key.
+        .pipe(findFeature<T>(key)),
+    [provider, key],
+  );
   const { value: feature, error } = useObservableState(feature$ ?? EMPTY);
   const toggleFeature = useCallback(
     (enable?: boolean) => {

package/src/feature-flag/useFeatures.ts

@@ -58,11 +58,19 @@ export const useFeatures = (
    */
   const { value: features, error } = useObservableState(
     useMemo(() => {
+      // Only compute the feature list when a provider is available; otherwise there's nothing to observe
       if (provider) {
+        // Map the feature dictionary to a list, optionally narrowed by the caller-provided selector
         return provider?.features$.pipe(
           map((x) => {
             const values = Object.values(x);
-            return selector ? values.filter(selector) : values;
+            // Return everything when no selector is provided
+            if (!selector) {
+              return values;
+            }
+            // Apply the caller-provided selector to narrow down the feature list
+            const filtered = values.filter(selector);
+            return filtered;
           }),
         );
       }
@@ -79,6 +87,7 @@ export const useFeatures = (
    */
   const toggleFeature = useCallback(
     (key: string, enable?: boolean) => {
+      // Cannot toggle a feature without a provider to persist the change
       if (!provider) {
         throw new Error('Missing IFeatureFlagProvider.');
       }

package/src/feature-flag/useFrameworkFeature.ts

@@ -20,6 +20,7 @@ import { useFeature } from './useFeature';
  */
 export const useFrameworkFeature = <T>(key: string): ReturnType<typeof useFeature<T>> => {
   const provider = useFrameworkModule<FeatureFlagModule>('featureFlag');
+  // Fail fast when the FeatureFlagModule has not been enabled on the framework
   if (!provider) {
     throw Error('Feature flagging is not enabled in the framework');
   }

package/src/feature-flag/useFrameworkFeatures.ts

@@ -18,6 +18,7 @@ import { useFeatures } from './useFeatures';
  */
 export const useFrameworkFeatures = (): ReturnType<typeof useFeatures> => {
   const provider = useFrameworkModule<FeatureFlagModule>('featureFlag');
+  // Fail fast when the FeatureFlagModule has not been enabled on the framework
   if (!provider) {
     throw Error('Feature flagging is not enabled in the framework');
   }

package/src/framework-provider.ts

@@ -0,0 +1,21 @@
+import { context } from './context';
+
+/**
+ * Component for providing framework.
+ *
+ * @remarks
+ * Should be created by {@link createFrameworkProvider}
+ *
+ * @example
+ * ```tsx
+ * import {FrameworkProvider} from '@equinor/fusion-framework-react';
+ * export const Component = (args: React.PropsWithChildren<{framework: Fusion}>) => {
+ *   return (
+ *      <FrameworkProvider value={args.framework}>
+ *        {args.children}
+ *      </FrameworkProvider>
+ *   );
+ * }
+ * ```
+ */
+export const FrameworkProvider = context.Provider;

package/src/hooks/index.ts

@@ -6,5 +6,5 @@
  *
  * @module
  */
-export { useCurrentUser } from './use-current-user';
-export { useHttpClient } from './use-http-client';
+export { useCurrentUser } from './useCurrentUser';
+export { useHttpClient } from './useHttpClient';

package/src/hooks/{use-http-client.ts → useHttpClient.ts}

@@ -25,11 +25,12 @@ export const useHttpClient = (name: FrameworkHttpClient): HttpClient => {
   const framework = useFramework();
 
   const client = useMemo(() => {
+    // Reuse an already-configured client for this key when one exists
     if (framework.modules.http.hasClient(name)) {
       return framework.modules.http.createClient(name);
     }
     throw Error(`no configured client for key [${name}]`);
   }, [framework, name]);
-  // TODO - abort on unmount?
+  // TODO(#5085): abort on unmount?
   return client;
 };

package/src/http/index.ts

@@ -8,6 +8,6 @@
  *
  * @module
  */
-export { useHttpClient as useFrameworkHttpClient } from '../hooks/use-http-client';
+export { useHttpClient as useFrameworkHttpClient } from '../hooks/useHttpClient';
 
 export * from '@equinor/fusion-framework-react-module-http';

package/src/index.tsx

@@ -15,7 +15,7 @@ export type { Fusion } from '@equinor/fusion-framework';
 export { FusionConfigurator } from '@equinor/fusion-framework';
 
 export { createFrameworkProvider } from './create-framework-provider';
-export { FrameworkProvider } from './context';
+export { FrameworkProvider } from './framework-provider';
 
 export { useFramework } from './useFramework';
 export { useFrameworkModule } from './useFrameworkModule';

package/src/signalr/index.ts

@@ -1,39 +1 @@
-import { useFramework } from '../useFramework';
-
-import {
-  type SignalRModule,
-  useProviderTopic,
-} from '@equinor/fusion-framework-react-module-signalr';
-
-/**
- * hook for subscribing to a topic of a SignalR hub
- * 
- * @example
- ```ts
-// config.ts
-import {enableSignalR} from '@equinor/fusion-framework-react-module-signalr';
-(configurator) => enableSignalR(configurator, 'notifications');
-
-// myHook.ts
-const myHook = () => {
-    const topic = useSignalR('notifications', 'foo');
-    return useObservableState(topic).next;
-}
- ```
- *
- * @see {@link [module signalr](https://equinor.github.io/fusion-framework/modules/signalr)}
- *
- * @param hubId identifier of connection hub (must be configured)
- * @param topicId identifier of topic to connect to
- * @returns Topic
- */
-export const useSignalR = <T>(
-  hubId: string,
-  topicId: string,
-): ReturnType<typeof useProviderTopic<T>> => {
-  const provider = useFramework<[SignalRModule]>().modules.signalR;
-  if (!provider) {
-    throw Error('SignalR is not configured, see @equinor/fusion-framework-react-module-signalr');
-  }
-  return useProviderTopic(provider, hubId, topicId);
-};
+export { useSignalR } from './useSignalR.js';

package/src/signalr/useSignalR.ts

@@ -0,0 +1,40 @@
+import { useFramework } from '../useFramework';
+
+import {
+  type SignalRModule,
+  useProviderTopic,
+} from '@equinor/fusion-framework-react-module-signalr';
+
+/**
+ * hook for subscribing to a topic of a SignalR hub
+ * 
+ * @example
+ ```ts
+// config.ts
+import {enableSignalR} from '@equinor/fusion-framework-react-module-signalr';
+(configurator) => enableSignalR(configurator, 'notifications');
+
+// myHook.ts
+const myHook = () => {
+    const topic = useSignalR('notifications', 'foo');
+    return useObservableState(topic).next;
+}
+ ```
+ *
+ * @see {@link [module signalr](https://equinor.github.io/fusion-framework/modules/signalr)}
+ *
+ * @param hubId identifier of connection hub (must be configured)
+ * @param topicId identifier of topic to connect to
+ * @returns Topic
+ */
+export const useSignalR = <T>(
+  hubId: string,
+  topicId: string,
+): ReturnType<typeof useProviderTopic<T>> => {
+  const provider = useFramework<[SignalRModule]>().modules.signalR;
+  // Fail fast when the SignalRModule has not been configured on the framework
+  if (!provider) {
+    throw Error('SignalR is not configured, see @equinor/fusion-framework-react-module-signalr');
+  }
+  return useProviderTopic(provider, hubId, topicId);
+};

package/src/useFramework.ts

@@ -26,10 +26,12 @@ import { context } from './context';
  */
 export const useFramework = <TModules extends Array<AnyModule> = []>(): Fusion<TModules> => {
   let framework = useContext(context);
+  // Warn loudly when the framework context is missing so integrators notice the misuse
   if (!framework) {
     console.warn('could not locate fusion in context!');
   }
   framework ??= window.Fusion;
+  // Surface an error when neither context nor the global fallback has the framework instance
   if (!framework) {
     console.error('Could not load framework, might not be initiated?');
   }

package/src/useFrameworkModule.ts

@@ -32,10 +32,11 @@ export const useFrameworkModule = <
   ? ModuleType<TType> | undefined
   : FusionModulesInstance[Extract<keyof FusionModulesInstance, TKey>] | undefined => {
   const framework = useFramework();
-  // TODO
+  // TODO(#5082): tighten generics so this indexed lookup no longer needs @ts-expect-error
   // eslint-disable-next-line @typescript-eslint/ban-ts-comment
-  // @ts-ignore
+  // @ts-expect-error
   const module = framework.modules[name];
+  // Warn when the requested module key does not resolve to a registered module
   if (!module) {
     console.warn(`the requested module [${module}] is not included in the framework instance`);
   }

package/src/version.ts

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

package/dist/esm/hooks/use-current-user.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-current-user.js","sourceRoot":"","sources":["../../../src/hooks/use-current-user.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAA4B,EAAE;IAC1D,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS,CAAC;AACrD,CAAC,CAAC"}

package/dist/esm/hooks/use-http-client.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-http-client.js","sourceRoot":"","sources":["../../../src/hooks/use-http-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQ/C;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAyB,EAAc,EAAE;IACrE,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,KAAK,CAAC,iCAAiC,IAAI,GAAG,CAAC,CAAC;IACxD,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IACtB,2BAA2B;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}