@equinor/fusion-framework-module-widget 16.0.2 → 16.0.4

package/dist/types/Widget.d.ts

@@ -32,7 +32,11 @@ export declare class Widget {
     config?: WidgetModuleConfig;
     /** Optional version or tag parameters forwarded to manifest/config endpoints. */
     widgetPrams?: GetWidgetParameters['args'];
-    /** Current snapshot of the widget's internal state (manifest, config, modules, status). */
+    /**
+     * Current snapshot of the widget's internal state (manifest, config, modules, status).
+     *
+     * @returns The current {@link WidgetState}.
+     */
     get state(): WidgetState;
     /**
      * Constructs a new `Widget` instance.

package/dist/types/WidgetManifestLoadError.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Discriminator for categorizing widget HTTP errors.
+ *
+ * - `'not_found'` — HTTP 404
+ * - `'unauthorized'` — HTTP 401
+ * - `'unknown'` — any other error
+ */
+export type WidgetErrorType = 'not_found' | 'unauthorized' | 'unknown';
+/**
+ * Error thrown when a widget manifest cannot be loaded from the backend API.
+ *
+ * Use the static {@link fromHttpResponse} factory to create instances from
+ * HTTP responses with appropriate type mapping.
+ */
+export declare class WidgetManifestLoadError extends Error {
+    readonly type: WidgetErrorType;
+    /**
+     * Creates a `WidgetManifestLoadError` from an HTTP `Response`.
+     *
+     * Maps HTTP 401 to `'unauthorized'`, 404 to `'not_found'`, and all other
+     * status codes to `'unknown'`.
+     *
+     * @param response - The failing HTTP response.
+     * @param options - Standard `ErrorOptions` (e.g., `cause`).
+     * @returns A typed `WidgetManifestLoadError`.
+     */
+    static fromHttpResponse(response: Response, options?: ErrorOptions): WidgetManifestLoadError;
+    /**
+     * @param type - Error category discriminator.
+     * @param message - Human-readable error description.
+     * @param options - Standard `ErrorOptions` (e.g., `cause`).
+     */
+    constructor(type: WidgetErrorType, message?: string, options?: ErrorOptions);
+}
+export { WidgetConfigLoadError } from './errors/WidgetConfigLoadError.js';
+export { WidgetScriptModuleError } from './errors/WidgetScriptModuleError.js';

package/dist/types/WidgetModuleProvider.d.ts

@@ -99,6 +99,7 @@ export declare class WidgetModuleProvider implements IWidgetModuleProvider {
      * @param widgetKey - Widget identifier.
      * @param args - Optional version or tag selector.
      * @returns Observable emitting the {@link WidgetConfig}.
+     * @throws {WidgetManifestLoadError} When the underlying query fails.
      */
     protected _getWidgetConfig(widgetKey: GetWidgetParameters['widgetKey'], args?: GetWidgetParameters['args']): Observable<WidgetConfig>;
     /**
@@ -108,6 +109,7 @@ export declare class WidgetModuleProvider implements IWidgetModuleProvider {
      * @param widgetKey - Widget identifier.
      * @param args - Optional version or tag selector.
      * @returns Observable emitting the {@link WidgetManifest}.
+     * @throws {WidgetConfigLoadError} When the underlying query fails.
      */
     protected _getWidget(widgetKey: GetWidgetParameters['widgetKey'], args?: GetWidgetParameters['args']): Observable<WidgetManifest>;
     /**

package/dist/types/errors/WidgetConfigLoadError.d.ts

@@ -0,0 +1,27 @@
+import type { WidgetErrorType } from '../WidgetManifestLoadError.js';
+/**
+ * Error thrown when a widget configuration cannot be loaded from the backend API.
+ *
+ * Use the static {@link fromHttpResponse} factory to create instances from
+ * HTTP responses with appropriate type mapping.
+ */
+export declare class WidgetConfigLoadError extends Error {
+    readonly type: WidgetErrorType;
+    /**
+     * Creates a `WidgetConfigLoadError` from an HTTP `Response`.
+     *
+     * Maps HTTP 401 to `'unauthorized'`, 404 to `'not_found'`, and all other
+     * status codes to `'unknown'`.
+     *
+     * @param response - The failing HTTP response.
+     * @param options - Standard `ErrorOptions` (e.g., `cause`).
+     * @returns A typed `WidgetConfigLoadError`.
+     */
+    static fromHttpResponse(response: Response, options?: ErrorOptions): WidgetConfigLoadError;
+    /**
+     * @param type - Error category discriminator.
+     * @param message - Human-readable error description.
+     * @param options - Standard `ErrorOptions` (e.g., `cause`).
+     */
+    constructor(type: WidgetErrorType, message?: string, options?: ErrorOptions);
+}

package/dist/types/errors/WidgetScriptModuleError.d.ts

@@ -0,0 +1,13 @@
+import type { WidgetErrorType } from '../WidgetManifestLoadError.js';
+/**
+ * Error thrown when a widget script module cannot be dynamically imported.
+ */
+export declare class WidgetScriptModuleError extends Error {
+    readonly type: WidgetErrorType;
+    /**
+     * @param type - Error category discriminator.
+     * @param message - Human-readable error description.
+     * @param options - Standard `ErrorOptions` (e.g., `cause`).
+     */
+    constructor(type: WidgetErrorType, message?: string, options?: ErrorOptions);
+}

package/dist/types/state/actions.d.ts

@@ -18,10 +18,10 @@ declare const createActions: () => {
     /** Async action triplet for fetching the widget manifest from the API. */
     fetchManifest: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[payload: {
         key: string;
-        args?: GetWidgetParameters["args"];
+        args?: GetWidgetParameters['args'];
     }, update?: boolean | undefined], {
         key: string;
-        args?: GetWidgetParameters["args"];
+        args?: GetWidgetParameters['args'];
     }, "fetch_manifest::request", never, {
         update: boolean | undefined;
     }> & {
@@ -33,10 +33,10 @@ declare const createActions: () => {
     /** Async action triplet for fetching the widget config from the API. */
     fetchConfig: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[payload: {
         key: string;
-        args?: GetWidgetParameters["args"];
+        args?: GetWidgetParameters['args'];
     }, update?: boolean | undefined], {
         key: string;
-        args?: GetWidgetParameters["args"];
+        args?: GetWidgetParameters['args'];
     }, "fetch_config::request", never, {
         update: boolean | undefined;
     }> & {
@@ -68,10 +68,10 @@ export declare const actions: {
     /** Async action triplet for fetching the widget manifest from the API. */
     fetchManifest: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[payload: {
         key: string;
-        args?: GetWidgetParameters["args"];
+        args?: GetWidgetParameters['args'];
     }, update?: boolean | undefined], {
         key: string;
-        args?: GetWidgetParameters["args"];
+        args?: GetWidgetParameters['args'];
     }, "fetch_manifest::request", never, {
         update: boolean | undefined;
     }> & {
@@ -83,10 +83,10 @@ export declare const actions: {
     /** Async action triplet for fetching the widget config from the API. */
     fetchConfig: import("@equinor/fusion-observable").ActionCreatorWithPreparedPayload<[payload: {
         key: string;
-        args?: GetWidgetParameters["args"];
+        args?: GetWidgetParameters['args'];
     }, update?: boolean | undefined], {
         key: string;
-        args?: GetWidgetParameters["args"];
+        args?: GetWidgetParameters['args'];
     }, "fetch_config::request", never, {
         update: boolean | undefined;
     }> & {

package/dist/types/state/create-reducer.d.ts

@@ -9,57 +9,57 @@ import type { WidgetStateInitial, WidgetState } from '../types';
  *   automatically as an empty `Set`).
  * @returns A reducer function compatible with `FlowSubject`.
  */
-export declare const createReducer: (value: WidgetStateInitial) => import("@equinor/fusion-observable").ReducerWithInitialState<WidgetState, import("@equinor/fusion-observable").PayloadAction<import("..").WidgetManifest, "set_manifest", {
-    created: number;
-    update: boolean | undefined;
-}, never> | import("@equinor/fusion-observable").PayloadAction<{
-    key: string;
-    args?: import("..").GetWidgetParameters["args"];
-}, "fetch_manifest::request", {
-    update: boolean | undefined;
-}, never> | {
-    payload: import("..").WidgetConfig;
-    type: "set_config";
-} | import("@equinor/fusion-observable").PayloadAction<{
-    key: string;
-    args?: import("..").GetWidgetParameters["args"];
-}, "fetch_config::request", {
-    update: boolean | undefined;
-}, never> | {
+export declare const createReducer: (value: WidgetStateInitial) => import("@equinor/fusion-observable").ReducerWithInitialState<WidgetState, {
     payload: any;
     type: "set_module";
 } | {
-    payload: string;
-    type: "import_widget::request";
+    payload: unknown;
+    type: "fetch_config::failure";
 } | {
-    payload: import("..").WidgetModulesInstance;
-    type: "set_instance";
+    payload: unknown;
+    type: "fetch_manifest::failure";
+} | {
+    payload: unknown;
+    type: "import_widget::failure";
+} | {
+    payload: unknown;
+    type: "initialize_widget::failure";
 } | {
     payload: null;
     type: "initialize_widget::request";
 } | {
-    payload: import("..").WidgetManifest;
-    type: "fetch_manifest::success";
+    payload: null;
+    type: "initialize_widget::success";
 } | {
-    payload: unknown;
-    type: "fetch_manifest::failure";
+    payload: string;
+    type: "import_widget::request";
 } | {
     payload: import("..").WidgetConfig;
     type: "fetch_config::success";
 } | {
-    payload: unknown;
-    type: "fetch_config::failure";
+    payload: import("..").WidgetConfig;
+    type: "set_config";
+} | {
+    payload: import("..").WidgetManifest;
+    type: "fetch_manifest::success";
 } | {
     payload: import("..").WidgetScriptModule;
     type: "import_widget::success";
 } | {
-    payload: unknown;
-    type: "import_widget::failure";
-} | {
-    payload: null;
-    type: "initialize_widget::success";
-} | {
-    payload: unknown;
-    type: "initialize_widget::failure";
-}>;
+    payload: import("..").WidgetModulesInstance;
+    type: "set_instance";
+} | import("@equinor/fusion-observable").PayloadAction<import("..").WidgetManifest, "set_manifest", {
+    created: number;
+    update: boolean | undefined;
+}, never> | import("@equinor/fusion-observable").PayloadAction<{
+    key: string;
+    args?: import("..").GetWidgetParameters['args'];
+}, "fetch_manifest::request", {
+    update: boolean | undefined;
+}, never> | import("@equinor/fusion-observable").PayloadAction<{
+    key: string;
+    args?: import("..").GetWidgetParameters['args'];
+}, "fetch_config::request", {
+    update: boolean | undefined;
+}, never>>;
 export default createReducer;

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const version = "16.0.2";
+export declare const version = "16.0.4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/fusion-framework-module-widget",
-  "version": "16.0.2",
+  "version": "16.0.4",
   "description": "",
   "main": "dist/esm/index.js",
   "types": "dist/types/index.d.ts",
@@ -38,22 +38,22 @@
   "dependencies": {
     "immer": "^11.0.0",
     "rxjs": "^7.8.1",
-    "@equinor/fusion-observable": "9.1.0",
-    "@equinor/fusion-query": "7.0.1"
+    "@equinor/fusion-observable": "9.1.1",
+    "@equinor/fusion-query": "7.0.3"
   },
   "devDependencies": {
-    "typescript": "^6.0.3",
-    "@equinor/fusion-framework-module": "^6.1.0",
-    "@equinor/fusion-framework-module-http": "^8.0.3",
-    "@equinor/fusion-framework-module-service-discovery": "^10.0.1",
-    "@equinor/fusion-framework-module-event": "^6.0.0",
-    "@equinor/fusion-query": "^7.0.1"
+    "typescript": "^7.0.2",
+    "@equinor/fusion-framework-module-http": "^8.0.5",
+    "@equinor/fusion-framework-module-event": "^6.0.1",
+    "@equinor/fusion-framework-module": "^6.1.1",
+    "@equinor/fusion-framework-module-service-discovery": "^10.0.2",
+    "@equinor/fusion-query": "^7.0.3"
   },
   "peerDependencies": {
-    "@equinor/fusion-framework-module": "6.1.0",
-    "@equinor/fusion-framework-module-event": "6.0.0",
-    "@equinor/fusion-framework-module-http": "8.0.3",
-    "@equinor/fusion-framework-module-service-discovery": "10.0.1"
+    "@equinor/fusion-framework-module": "6.1.1",
+    "@equinor/fusion-framework-module-http": "8.0.5",
+    "@equinor/fusion-framework-module-event": "6.0.1",
+    "@equinor/fusion-framework-module-service-discovery": "10.0.2"
   },
   "peerDependenciesMeta": {
     "@equinor/fusion-framework-module-event": {

package/src/Widget.ts

@@ -51,7 +51,11 @@ export class Widget {
 
   #subscription = new Subscription();
 
-  /** Current snapshot of the widget's internal state (manifest, config, modules, status). */
+  /**
+   * Current snapshot of the widget's internal state (manifest, config, modules, status).
+   *
+   * @returns The current {@link WidgetState}.
+   */
   get state(): WidgetState {
     return this.#state.value;
   }
@@ -165,8 +169,10 @@ export class Widget {
    */
   public getManifest(force_refresh = false): Observable<WidgetManifest> {
     return new Observable((subscriber) => {
+      // Emit the cached manifest immediately if one is already available
       if (this.#state.value.manifest) {
         subscriber.next(this.#state.value.manifest);
+        // Skip the fetch below unless the caller explicitly asked to refresh
         if (!force_refresh) {
           return subscriber.complete();
         }
@@ -209,8 +215,10 @@ export class Widget {
   public getConfig(force_refresh = false): Observable<WidgetConfig> {
     return new Observable((subscriber) => {
       const currentValue = this.#state.value;
+      // Emit the cached config immediately if the manifest and config are already available
       if (currentValue.manifest && currentValue.config) {
         subscriber.next(currentValue.config);
+        // Skip the fetch below unless the caller explicitly asked to refresh
         if (!force_refresh) {
           return subscriber.complete();
         }
@@ -273,8 +281,10 @@ export class Widget {
    */
   public getWidgetModule(force_refresh = false): Observable<WidgetScriptModule> {
     return new Observable((subscriber) => {
+      // Emit the cached script module immediately if one is already available
       if (this.#state.value.modules) {
         subscriber.next(this.#state.value.modules);
+        // Skip the import below unless the caller explicitly asked to refresh
         if (!force_refresh) {
           return subscriber.complete();
         }
@@ -345,7 +355,8 @@ export class Widget {
               },
             }),
           error: (err) => {
-            observer.error(err), this.#state.next(actions.initialize.failure(err));
+            observer.error(err);
+            this.#state.next(actions.initialize.failure(err));
           },
           complete: () => {
             this.#state.next(actions.initialize.success());

package/src/WidgetManifestLoadError.ts

@@ -0,0 +1,61 @@
+/**
+ * Discriminator for categorizing widget HTTP errors.
+ *
+ * - `'not_found'` — HTTP 404
+ * - `'unauthorized'` — HTTP 401
+ * - `'unknown'` — any other error
+ */
+export type WidgetErrorType = 'not_found' | 'unauthorized' | 'unknown';
+
+/**
+ * Error thrown when a widget manifest cannot be loaded from the backend API.
+ *
+ * Use the static {@link fromHttpResponse} factory to create instances from
+ * HTTP responses with appropriate type mapping.
+ */
+export class WidgetManifestLoadError extends Error {
+  /**
+   * Creates a `WidgetManifestLoadError` from an HTTP `Response`.
+   *
+   * Maps HTTP 401 to `'unauthorized'`, 404 to `'not_found'`, and all other
+   * status codes to `'unknown'`.
+   *
+   * @param response - The failing HTTP response.
+   * @param options - Standard `ErrorOptions` (e.g., `cause`).
+   * @returns A typed `WidgetManifestLoadError`.
+   */
+  static fromHttpResponse(response: Response, options?: ErrorOptions) {
+    // Map known status codes to a specific error type, otherwise fall through to 'unknown'
+    switch (response.status) {
+      case 401:
+        return new WidgetManifestLoadError(
+          'unauthorized',
+          'failed to load widget manifest, request not authorized',
+          options,
+        );
+      case 404:
+        return new WidgetManifestLoadError('not_found', 'widget manifest not found', options);
+    }
+    return new WidgetManifestLoadError(
+      'unknown',
+      `failed to load widget manifest, status code ${response.status}`,
+      options,
+    );
+  }
+  /**
+   * @param type - Error category discriminator.
+   * @param message - Human-readable error description.
+   * @param options - Standard `ErrorOptions` (e.g., `cause`).
+   */
+  constructor(
+    public readonly type: WidgetErrorType,
+    message?: string,
+    options?: ErrorOptions,
+  ) {
+    super(message, options);
+    this.name = 'GetWidgetLoadManifestErrors';
+  }
+}
+
+export { WidgetConfigLoadError } from './errors/WidgetConfigLoadError.js';
+export { WidgetScriptModuleError } from './errors/WidgetScriptModuleError.js';

package/src/WidgetModuleConfigurator.ts

@@ -63,6 +63,7 @@ export class WidgetModuleConfigurator extends BaseConfigBuilder<WidgetModuleConf
   private async _createHttpClient(clientId: string, init: ConfigBuilderCallbackArgs) {
     const http = await init.requireInstance('http');
 
+    // Reuse an already-registered client when one exists for this id
     if (http.hasClient(clientId)) {
       return http.createClient(clientId);
     } else {
@@ -86,6 +87,7 @@ export class WidgetModuleConfigurator extends BaseConfigBuilder<WidgetModuleConf
   ) {
     const httpClient = await this._createHttpClient('apps', _init);
 
+    // Only fall back to the default client when the caller hasn't set one
     if (!config.client) {
       config.client = createDefaultClient(httpClient);
     }

package/src/WidgetModuleProvider.ts

@@ -9,7 +9,7 @@ import { Query } from '@equinor/fusion-query';
 import type { GetWidgetParameters, WidgetConfig, WidgetManifest } from './types';
 
 import type { WidgetModuleConfig } from './WidgetModuleConfigurator';
-import { WidgetManifestLoadError, WidgetConfigLoadError } from './errors';
+import { WidgetManifestLoadError, WidgetConfigLoadError } from './WidgetManifestLoadError';
 import { Widget } from './Widget';
 
 /**
@@ -143,6 +143,7 @@ export class WidgetModuleProvider implements IWidgetModuleProvider {
    * @param widgetKey - Widget identifier.
    * @param args - Optional version or tag selector.
    * @returns Observable emitting the {@link WidgetConfig}.
+   * @throws {WidgetManifestLoadError} When the underlying query fails.
    */
   protected _getWidgetConfig(
     widgetKey: GetWidgetParameters['widgetKey'],
@@ -150,7 +151,9 @@ export class WidgetModuleProvider implements IWidgetModuleProvider {
   ): Observable<WidgetConfig> {
     const client = new Query(this.#config.client.getWidgetConfig);
     this.#subscription.add(() => client.complete());
+    // Execute the query and handle errors
     return Query.extractQueryValue(
+      // Map any query failure to a typed `WidgetManifestLoadError`
       client.query({ widgetKey, args }).pipe(
         catchError((err) => {
           // Extract the cause since the error will be a `QueryError`
@@ -160,6 +163,7 @@ export class WidgetModuleProvider implements IWidgetModuleProvider {
           if (cause instanceof WidgetManifestLoadError) {
             throw cause;
           }
+          // Map HTTP failures to a `WidgetManifestLoadError` carrying the response
           if (cause instanceof HttpResponseError) {
             throw WidgetManifestLoadError.fromHttpResponse(cause.response, {
               cause,
@@ -181,6 +185,7 @@ export class WidgetModuleProvider implements IWidgetModuleProvider {
    * @param widgetKey - Widget identifier.
    * @param args - Optional version or tag selector.
    * @returns Observable emitting the {@link WidgetManifest}.
+   * @throws {WidgetConfigLoadError} When the underlying query fails.
    */
   protected _getWidget(
     widgetKey: GetWidgetParameters['widgetKey'],
@@ -192,6 +197,7 @@ export class WidgetModuleProvider implements IWidgetModuleProvider {
 
     // Execute the query and handle errors
     return Query.extractQueryValue(
+      // Map any query failure to a typed `WidgetConfigLoadError`
       client.query({ widgetKey, args }).pipe(
         catchError((err) => {
           // Extract the cause since the error will be a `QueryError`
@@ -201,6 +207,7 @@ export class WidgetModuleProvider implements IWidgetModuleProvider {
           if (cause instanceof WidgetConfigLoadError) {
             throw cause;
           }
+          // Map HTTP failures to a `WidgetConfigLoadError` carrying the response
           if (cause instanceof HttpResponseError) {
             throw WidgetConfigLoadError.fromHttpResponse(cause.response, { cause });
           }

package/src/enable-widget-module.ts

@@ -22,7 +22,7 @@ import type { WidgetModuleConfigBuilderCallback } from './WidgetModuleConfigurat
  * ```
  */
 export const enableWidgetModule = (
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // biome-ignore lint/suspicious/noExplicitAny: `IModulesConfigurator<any, any>` widens to accept a configurator for any concrete module set — `unknown` would break assignability of a real configurator instance to this parameter
   configurator: IModulesConfigurator<any, any>,
   builder?: WidgetModuleConfigBuilderCallback,
 ): void => {

package/src/errors/WidgetConfigLoadError.ts

@@ -0,0 +1,51 @@
+import type { WidgetErrorType } from '../WidgetManifestLoadError.js';
+
+/**
+ * Error thrown when a widget configuration cannot be loaded from the backend API.
+ *
+ * Use the static {@link fromHttpResponse} factory to create instances from
+ * HTTP responses with appropriate type mapping.
+ */
+export class WidgetConfigLoadError extends Error {
+  /**
+   * Creates a `WidgetConfigLoadError` from an HTTP `Response`.
+   *
+   * Maps HTTP 401 to `'unauthorized'`, 404 to `'not_found'`, and all other
+   * status codes to `'unknown'`.
+   *
+   * @param response - The failing HTTP response.
+   * @param options - Standard `ErrorOptions` (e.g., `cause`).
+   * @returns A typed `WidgetConfigLoadError`.
+   */
+  static fromHttpResponse(response: Response, options?: ErrorOptions) {
+    // Map known status codes to a specific error type, otherwise fall through to 'unknown'
+    switch (response.status) {
+      case 401:
+        return new WidgetConfigLoadError(
+          'unauthorized',
+          'failed to load widget config, request not authorized',
+          options,
+        );
+      case 404:
+        return new WidgetConfigLoadError('not_found', 'widget config not found', options);
+    }
+    return new WidgetConfigLoadError(
+      'unknown',
+      `failed to load widget config, status code ${response.status}`,
+      options,
+    );
+  }
+  /**
+   * @param type - Error category discriminator.
+   * @param message - Human-readable error description.
+   * @param options - Standard `ErrorOptions` (e.g., `cause`).
+   */
+  constructor(
+    public readonly type: WidgetErrorType,
+    message?: string,
+    options?: ErrorOptions,
+  ) {
+    super(message, options);
+    this.name = 'GetWidgetLoadConfigError';
+  }
+}

package/src/errors/WidgetScriptModuleError.ts

@@ -0,0 +1,20 @@
+import type { WidgetErrorType } from '../WidgetManifestLoadError.js';
+
+/**
+ * Error thrown when a widget script module cannot be dynamically imported.
+ */
+export class WidgetScriptModuleError extends Error {
+  /**
+   * @param type - Error category discriminator.
+   * @param message - Human-readable error description.
+   * @param options - Standard `ErrorOptions` (e.g., `cause`).
+   */
+  constructor(
+    public readonly type: WidgetErrorType,
+    message?: string,
+    options?: ErrorOptions,
+  ) {
+    super(message, options);
+    this.name = 'WidgetScriptModuleError';
+  }
+}

package/src/module.ts

@@ -42,6 +42,8 @@ export const module: WidgetModule = {
     return new WidgetModuleProvider({ config, event });
   },
   dispose: (args) => {
+    // `args.instance` is typed as the generic module instance, but the module descriptor
+    // guarantees it was created as a `WidgetModuleProvider` — safe to cast for disposal.
     (args.instance as unknown as WidgetModuleProvider).dispose();
   },
 };

package/src/state/actions.ts

@@ -53,7 +53,7 @@ const createActions = () => ({
     (error: unknown) => ({ payload: error }),
   ),
   /** Sets the dynamically imported widget script module in state. */
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  // biome-ignore lint/suspicious/noExplicitAny: module payload widens to accept any script module shape when set
   setModule: createAction('set_module', (module: any) => ({ payload: module })),
   /** Async action triplet for dynamically importing the widget script. */
   importWidget: createAsyncAction(

package/src/state/create-reducer.ts

@@ -23,10 +23,13 @@ import type { WidgetStateInitial, WidgetState } from '../types';
  * @returns A reducer function compatible with `FlowSubject`.
  */
 export const createReducer = (value: WidgetStateInitial) =>
+  // Seed the reducer's initial state with an empty in-progress status set.
   makeReducer<WidgetState, Actions>({ ...value, status: new Set() } as WidgetState, (builder) =>
     builder
       .addCase(actions.setManifest, (state, action) => {
+        // Merge with existing state when caller requested an update, otherwise replace
         if (action.meta.update) {
+          // Shallow-merge the new payload over the existing manifest fields.
           state.manifest = { ...state.manifest, ...action.payload };
         } else {
           state.manifest = action.payload;