Skip to content

CONSOLE-5012: Migrate confirmModal to overlay pattern#15948

Merged
openshift-merge-bot[bot] merged 7 commits intoopenshift:mainfrom
rhamilto:CONSOLE-5012-5
Mar 7, 2026
Merged

CONSOLE-5012: Migrate confirmModal to overlay pattern#15948
openshift-merge-bot[bot] merged 7 commits intoopenshift:mainfrom
rhamilto:CONSOLE-5012-5

Conversation

@rhamilto
Copy link
Member

@rhamilto rhamilto commented Jan 23, 2026

Summary

This PR continues the modal migration effort by removing the deprecated confirmModal (which used createModalLauncher) and migrating to the modern overlay pattern with an imperative launchWarningModal() API.

API Design Change: Updated launchWarningModal to use callback-based API instead of Promises to better align with React patterns and the underlying modal system architecture.

Changes

Removed deprecated confirmModal

Created imperative warning modal API

  • ✅ Follows same pattern as launchErrorModal()
  • Callback-based API: accepts optional onConfirm and onCancel callbacks
  • ✅ Works from non-React contexts (drag-drop callbacks, utility functions)
  • ✅ Uses modern overlay system via useOverlay hook
  • Race condition guards: Only clears launcher if still active
  • Comprehensive JSDoc documentation with examples
  • Warning icon is optional via titleIconVariant prop (defaults to 'warning' per PatternFly)

Unified modal launcher initialization with race condition protection

  • ✅ Refactored SyncErrorModalLauncherSyncModalLaunchers in error-modal-handler.tsx
  • ✅ Single component syncs both error and warning modal launchers
  • Added reference-based cleanup guards to prevent race conditions
  • ✅ Mounted once in app.tsx after OverlayProvider

Consolidated modal hook implementations

  • Removed duplicate useErrorModal hook - consolidated into existing useErrorModalLauncher
  • Enhanced useErrorModalLauncher to support flexible prop merging (initialization + runtime)
  • Made ControlledWarningModal component private - internal implementation detail
  • Consistent pattern - both error and warning modals use the same flexible API
  • Single source of truth - no more duplicate hook implementations

Migrated moveNodeToGroup to use launchWarningModal

  • ✅ Updated moveNodeToGroup.tsx to use launchWarningModal() instead of confirmModal()
  • ✅ Wraps callback-based API in Promise internally to maintain backward compatibility
  • ✅ Preserved <Trans> components with <strong> tags for bold text formatting
  • ✅ Added onError parameter for custom error handling
  • ✅ Integrated with launchErrorModal() for error display
  • Proper error handling distinguishing user cancellation from actual errors
  • Hides warning icon for move/remove operations via titleIconVariant: null

Fixed accessibility violation

  • ✅ Blur active element before launching confirmation modal in moveNodeToGroup.tsx
  • ✅ Prevents focus from remaining on SVG elements in topology graph
  • ✅ Fixes browser warning: "Blocked aria-hidden on an element because its descendant retained focus"

Fixed useWarningModal type safety

  • ✅ Made ControlledWarningModal component private in useWarningModal.tsx
  • ✅ Uses proper OverlayComponent type instead of manual prop definition
  • ✅ Properly calls closeOverlay() on modal dismiss

Updated metal3-plugin modals

Updated shipwright-plugin

  • ✅ Cleaned up orphaned functions in logs-utils.ts
  • ✅ Removed getOrderedStepsFromPod (no references found - 20 lines removed)
  • ✅ Removed getDownloadAllLogsCallback (no references found - 111 lines removed)
  • ✅ Removed unused i18n key "Error downloading logs."

Test infrastructure

Architecture Benefits

  • No duplication - Single useErrorModalLauncher implementation (removed duplicate useErrorModal)
  • Consistent patterns - Error and warning modals use identical flexible prop merging API
  • Single source of truth - One canonical hook per modal type
  • Consistent with React patterns - Callbacks align with hooks and PatternFly components
  • Simpler than React Context - No provider/consumer boilerplate needed
  • Single initialization point - One SyncModalLaunchers component for all imperative modals
  • Works everywhere - Usable from both React components and non-React contexts
  • Type-safe - Throws clear errors when launchers not initialized
  • Race condition protection - Reference-based cleanup prevents clearing newer launchers
  • Proper cleanup - Via React lifecycle, not manual cleanup
  • WCAG 2.1 Level A compliant - No aria-hidden focus violations
  • Well-tested - Comprehensive unit tests for all scenarios (11/11 passing)
  • Well-documented - Clear JSDoc with examples and proper error types
  • Flexible icon display - Warning icon can be hidden when not needed
  • No impedance mismatch - Callback-based API matches underlying React/PatternFly architecture

Technical Details

Modal Hook Consolidation

Problem: We had duplicate implementations of error modal hooks:

  • useErrorModalLauncher (in public/components/modals/error-modal.tsx) - original, inflexible API
  • useErrorModal (in packages/console-shared/src/utils/error-modal-handler.tsx) - duplicate with flexible API

Solution: Enhanced the existing useErrorModalLauncher to support the flexible pattern, eliminating duplication:

// Before: inflexible - props fixed at hook creation
export const useErrorModalLauncher = (props) => {
  const launcher = useOverlay();
  return useCallback(() => launcher(ErrorModal, props), [launcher, props]);
};

// After: flexible - supports both initialization and runtime props
export const useErrorModalLauncher = (
  props?: Partial<ErrorModalProps>,
): ((overrides?: ErrorModalProps) => void) => {
  const launcher = useOverlay();
  return useCallback(
    (overrides?: ErrorModalProps) => {
      const mergedProps: ErrorModalProps = {
        error: '',
        ...(props || {}),
        ...(overrides || {}),
      };
      launcher<ErrorModalProps>(ErrorModal, mergedProps);
    },
    [launcher, props],
  );
};

Benefits:

  • ✅ Single source of truth for error modal launching
  • ✅ Matches the pattern used by useWarningModal
  • ✅ Supports both usage patterns: useErrorModalLauncher(props)() or useErrorModalLauncher()(props)
  • ✅ Better TypeScript types with proper inference
  • ✅ No breaking changes - backward compatible API

Callback-Based API Design

The imperative launchWarningModal uses callbacks instead of Promises to align with React patterns:

Why callbacks over Promises?

  1. React hooks use callbacks - useWarningModal hook accepts onConfirm/onClose callbacks
  2. PatternFly uses callbacks - WarningModal component uses callback props, not Promises
  3. Overlay system uses callbacks - closeOverlay is a callback, not a Promise
  4. No impedance mismatch - No need to wrap callbacks in Promises only to unwrap them
  5. More flexible - Consumers can wrap in Promises if needed (like moveNodeToGroup does)

API signature:

launchWarningModal(
  props: Omit<ControlledWarningModalProps, 'onConfirm' | 'onClose'>,
  onConfirm?: () => void,
  onCancel?: () => void,
): void

Example usage:

launchWarningModal(
  {
    title: 'Delete Resource',
    children: 'Are you sure you want to delete this resource?',
    confirmButtonLabel: 'Delete',
  },
  () => {
    // User confirmed - proceed with action
    deleteResource();
  },
  () => {
    // User canceled
    console.log('Action cancelled by user');
  }
);

Optional Warning Icon

The ControlledWarningModal wrapper passes through the titleIconVariant prop, allowing callers to:

  • Use default warning icon - Don't specify titleIconVariant (PatternFly defaults to 'warning')
  • Hide the icon - Pass titleIconVariant: null
  • Use a different icon - Pass titleIconVariant: 'danger' | 'success' | 'info' or a custom icon

Example usage in moveNodeToGroup.tsx:

launchWarningModal(
  {
    title: i18next.t(titleKey),
    children: message,
    confirmButtonLabel: i18next.t(btnTextKey),
    titleIconVariant: null, // Hides the warning icon
  },
  () => updateTopologyResourceApplication(...),
  () => console.log('User cancelled'),
)

Race Condition Protection

Problem: If components mount/unmount out of order, the cleanup could clear a newer launcher.

Solution: Reference-based cleanup in both launchers (error-modal-handler.tsx, warning-modal-handler.tsx):

useEffect(() => {
  moduleErrorModalLauncher = errorModalLauncher;
  
  return () => {
    // Only clear if we're still the active launcher
    if (moduleErrorModalLauncher === errorModalLauncher) {
      moduleErrorModalLauncher = null;
    }
  };
}, [errorModalLauncher]);

This prevents race conditions where unmounting could clear a newer launcher that was set by a remounting component.

Accessibility Fix - aria-hidden Focus Violation

Problem: When the confirmation modal opened during drag-drop operations, focus remained on an SVG <g> element in the topology graph. PatternFly's Modal sets aria-hidden="true" on the #app div, creating an accessibility violation.

Browser Warning (Fixed):

Blocked aria-hidden on an element because its descendant retained focus.
The focus must not be hidden from assistive technology users.
Element with focus: <g>
Ancestor with aria-hidden: <div#app>

Solution: Blur the active element before launching the modal (moveNodeToGroup.tsx):

// Blur active element to prevent aria-hidden focus violations when modal opens
if (
  document.activeElement instanceof HTMLElement ||
  document.activeElement instanceof SVGElement
) {
  document.activeElement.blur();
}

Test Plan

Automated Tests ✅

  • TypeScript compilation succeeds
  • ESLint passes
  • Build succeeds
  • i18n keys updated correctly
  • Unit tests pass (error-modal-handler.spec.tsx: 4/4)
  • Unit tests pass (warning-modal-handler.spec.tsx: 7/7)
  • All modal handler tests: 11/11 passing

Manual Testing Checklist

  • Verify topology node drag-and-drop with confirmation modal works
  • Verify clicking "Cancel" in confirmation modal restores node to original position
  • Verify clicking "Move"/"Remove" confirms the operation
  • Verify error modals display correctly for failed operations
  • Verify modals properly close and remove from DOM on both confirm and cancel
  • Verify bold text formatting appears correctly in modal messages
  • Verify no aria-hidden accessibility warnings in browser console
  • Verify modal receives focus when opened from drag-drop operation
  • Verify modal displays without warning icon for move/remove operations
  • Verify metal3-plugin maintenance modals work correctly
  • Verify "Stop maintenance" modal displays and functions properly

Breaking Changes

None - this is a refactoring that maintains the same functionality.

Related

🤖 Generated with Claude Code

@openshift-ci-robot openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Jan 23, 2026
@openshift-ci-robot
Copy link
Contributor

openshift-ci-robot commented Jan 23, 2026

@rhamilto: This pull request references CONSOLE-5012 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.22.0" version, but no target version was set.

Details

In response to this:

Summary

This PR migrates all instances of confirmModal to use the modern overlay pattern with useWarningModal, completing the modal migration effort.

Changes

  • ✅ Removed deprecated confirmModal launcher and confirm-modal.tsx file
  • ✅ Migrated topology moveNodeToGroup to use useWarningModal with proper cancel handling
  • ✅ Updated StopNodeMaintenanceModal to remove deprecated imperative API
  • ✅ Fixed useWarningModal to properly handle closeOverlay prop
  • ✅ Added try-catch in topology drag-drop to prevent optimistic update on cancel
  • ✅ Updated all metal3-plugin maintenance components to use hook-based approach

Technical Details

Topology Move Node Migration

The topology moveNodeToGroup function used confirmModal imperatively. Since it's not a React component, I implemented a global handler pattern similar to the existing error handler:

  • Added setMoveNodeToGroupConfirmHandler to set a global confirmation handler
  • Created useSetupMoveNodeToGroupHandlers hook that uses useWarningModal
  • Added cancel callback support to properly reject the promise when user cancels
  • Fixed drag-drop component to use try-catch and prevent optimistic update on rejection

StopNodeMaintenanceModal Migration

  • Removed the deprecated stopNodeMaintenanceModal function
  • Kept only the useStopNodeMaintenanceModal hook that already used useWarningModal
  • Updated all call sites to use the hook instead of the imperative function

useWarningModal Fix

  • Fixed closeOverlay prop warning by properly excluding it from the props spread
  • Added closeOverlay() calls in both onClose and onConfirm handlers to properly remove the modal from DOM

Dependencies

This PR builds upon and depends on:

Test Plan

  • Verify topology node drag-and-drop with confirmation works
  • Verify clicking "Cancel" restores node to original position
  • Verify clicking confirm button moves the node
  • Verify metal3-plugin node maintenance modals work
  • Verify no React DOM warnings about closeOverlay prop
  • Verify modal properly closes and removes from DOM on both confirm and cancel

🤖 Generated with Claude Code

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

@rhamilto rhamilto changed the title CONSOLE-5012: Migrate confirmModal to overlay pattern [WIP] CONSOLE-5012: Migrate confirmModal to overlay pattern Jan 23, 2026
@openshift-ci openshift-ci bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jan 23, 2026
@openshift-ci openshift-ci bot requested review from jhadvig and sg00dwin January 23, 2026 20:59
@openshift-ci openshift-ci bot added component/core Related to console core functionality component/dev-console Related to dev-console approved Indicates a PR has been approved by an approver from all required OWNERS files. component/knative Related to knative-plugin component/metal3 Related to metal3-plugin component/sdk Related to console-plugin-sdk component/shared Related to console-shared component/topology Related to topology kind/i18n Indicates issue or PR relates to internationalization or has content that needs to be translated labels Jan 23, 2026
@openshift-ci-robot
Copy link
Contributor

openshift-ci-robot commented Jan 23, 2026

@rhamilto: This pull request references CONSOLE-5012 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.22.0" version, but no target version was set.

Details

In response to this:

Summary

This PR migrates all instances of confirmModal to use the modern overlay pattern with useWarningModal, completing the modal migration effort.

Changes

  • ✅ Removed deprecated confirmModal launcher and confirm-modal.tsx file
  • ✅ Migrated topology moveNodeToGroup to use useWarningModal with proper cancel handling
  • ✅ Updated StopNodeMaintenanceModal to remove deprecated imperative API
  • ✅ Fixed useWarningModal to properly handle closeOverlay prop
  • ✅ Added try-catch in topology drag-drop to prevent optimistic update on cancel
  • ✅ Updated all metal3-plugin maintenance components to use hook-based approach

Technical Details

Topology Move Node Migration

The topology moveNodeToGroup function used confirmModal imperatively. Since it's not a React component, I implemented a global handler pattern similar to the existing error handler:

  • Added setMoveNodeToGroupConfirmHandler to set a global confirmation handler
  • Created useSetupMoveNodeToGroupHandlers hook that uses useWarningModal
  • Added cancel callback support to properly reject the promise when user cancels
  • Fixed drag-drop component to use try-catch and prevent optimistic update on rejection

StopNodeMaintenanceModal Migration

  • Removed the deprecated stopNodeMaintenanceModal function
  • Kept only the useStopNodeMaintenanceModal hook that already used useWarningModal
  • Updated all call sites to use the hook instead of the imperative function

useWarningModal Fix

  • Fixed closeOverlay prop warning by properly excluding it from the props spread
  • Added closeOverlay() calls in both onClose and onConfirm handlers to properly remove the modal from DOM

Dependencies

This PR builds upon and depends on:

Test Plan

  • Verify topology node drag-and-drop with confirmation works
  • Verify clicking "Cancel" restores node to original position
  • Verify clicking confirm button moves the node
  • Verify metal3-plugin node maintenance modals work
  • Verify no React DOM warnings about closeOverlay prop
  • Verify modal properly closes and removes from DOM on both confirm and cancel

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

  • Introduced global error modal handler for consistent error notifications across the application.

  • Implemented lazy-loading for modals to improve initial page load performance.

  • Bug Fixes

  • Enhanced modal overlay management for improved accessibility and proper focus handling.

  • Refactor

  • Consolidated modal system to use provider-based architecture.

  • Optimized component memoization to reduce unnecessary re-renders.

  • Simplified modal invocation patterns across the application.

✏️ Tip: You can customize this high-level summary in your review settings.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 23, 2026

📝 Walkthrough

Walkthrough

This pull request introduces a modal infrastructure refactor across the OpenShift Console codebase, shifting from a direct modal launcher pattern (via createModalLauncher) to an overlay-based provider pattern with React lazy loading. The changes include: introducing OverlayComponent-based modal providers wrapping existing modal components in ModalWrapper; implementing useOverlay() hooks to obtain launchModal functions for programmatic modal invocation; consolidating error handling through a new global error modal handler utility; creating lazy-loaded modal exports for code-splitting; removing launchModal from dependency arrays with ESLint suppressions to address potential max-depth errors; and updating action creators and modal invocation sites across frontend packages to use the new launchModal(ProviderComponent, props) pattern instead of direct function calls.

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check ✅ Passed The title 'CONSOLE-5012: Migrate confirmModal to overlay pattern' accurately summarizes the primary change—removing the legacy confirmModal launcher and migrating it to the overlay/useWarningModal pattern.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 8

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (4)
frontend/packages/console-shared/src/components/formik-fields/EnvironmentField.tsx (1)

64-80: Stabilize launchModal reference instead of suppressing hook deps

The dependency exhaustive-deps suppression masks a real issue: useOverlay() returns an unstable reference because OverlayContext.Provider creates a new value object on every render, even though the underlying callback is memoized. Adding launchModal to deps would trigger infinite re-runs (max depth exceeded), so the ref pattern below is the right approach at the consumer level.

♻️ Proposed refactor
-import { useMemo, useState, useCallback, useEffect } from 'react';
+import { useMemo, useState, useCallback, useEffect, useRef } from 'react';

 const { t } = useTranslation();
 const launchModal = useOverlay();
+const launchModalRef = useRef(launchModal);
+useEffect(() => {
+  launchModalRef.current = launchModal;
+}, [launchModal]);

 useEffect(() => {
   Promise.all([k8sGet(ConfigMapModel, null, namespace), k8sGet(SecretModel, null, namespace)])
     .then(([nsConfigMaps, nsSecrets]) => {
       setConfigMaps(nsConfigMaps);
       setSecrets(nsSecrets);
     })
     .catch(async (err) => {
       if (err?.response?.status !== 403) {
         try {
-          await launchModal(ErrorModal, { error: err?.message });
+          await launchModalRef.current(ErrorModal, { error: err?.message });
           // eslint-disable-next-line no-empty
         } catch (e) {}
       }
     });
-  // missing launchModal dependency, that causes max depth exceeded error
-  // eslint-disable-next-line react-hooks/exhaustive-deps
 }, [namespace]);
frontend/packages/topology/src/utils/moveNodeToGroup.tsx (1)

41-108: Fix the type contract: targetGroup should be optional and updateTopologyResourceApplication must accept string | null.

The function declares targetGroup: Node as required, but the implementation treats it as optional (see line 54's targetGroup?.getLabel() and line 58's conditional check). Line 82 passes null to updateTopologyResourceApplication, which expects application: string per the function signature in topology-utils.ts:137–140. Additionally, line 102 will crash if sourceGroup is falsy and targetGroup is somehow undefined, calling .getLabel() on a falsy value.

Update the type signature to match the implementation, and widen updateTopologyResourceApplication's application parameter to string | null to safely handle the "remove from application" case:

Proposed fix
export const moveNodeToGroup = (
  node: Node,
-  targetGroup: Node,
+  targetGroup: Node | null,
  onError?: (error: string) => void,
): Promise<void> => {

Then in topology-utils.ts:

export const updateTopologyResourceApplication = (
  item: Node,
-  application: string,
+  application: string | null,
): Promise<any> => {

and add an early guard:

  const itemData = item?.getData();
  const resource = getResource(item);
-  if (!item || !resource || !_.size(itemData.resources)) {
+  if (!item || !resource || application === null || !_.size(itemData.resources)) {
     return Promise.reject();
   }
frontend/packages/shipwright-plugin/src/actions/useBuildRunActions.ts (1)

4-4: Typo: Double slash in import path.

The import path contains actions//hooks with a double slash. While most bundlers normalize this, it's a minor inconsistency that should be cleaned up.

Suggested fix
-import { useCommonResourceActions } from '@console/app/src/actions//hooks/useCommonResourceActions';
+import { useCommonResourceActions } from '@console/app/src/actions/hooks/useCommonResourceActions';
frontend/packages/shipwright-plugin/src/actions/useBuildActions.ts (1)

75-89: Remove the duplicate Delete action at line 89.

The useCommonResourceActions hook returns all common actions including Delete via Object.values(commonActions) at line 75. Explicitly pushing commonActions.Delete again at line 89 creates a duplicate entry in the actions menu.

🤖 Fix all issues with AI agents
In
`@frontend/packages/console-app/src/components/modals/clone/clone-pvc-modal.tsx`:
- Around line 279-283: The spread props currently come after explicit close
props in ClonePVCModalProvider which allows props.closeOverlay to be overridden;
update the JSX so {...props} is spread first and then pass
cancel={props.closeOverlay} and close={props.closeOverlay} (affecting the
ClonePVCModal inside ModalWrapper) to ensure closeOverlay always wins and cannot
be overridden by incoming props.

In
`@frontend/packages/console-app/src/components/modals/restore-pvc/restore-pvc-modal.tsx`:
- Around line 282-287: The provider currently spreads props after passing
cancel/close to RestorePVCModal, allowing a caller to override those with their
own cancel/close; change RestorePVCModalProvider so you destructure closeOverlay
from props first (e.g., const { closeOverlay, ...rest } = props) then render
<RestorePVCModal cancel={closeOverlay} close={closeOverlay} {...rest} /> inside
ModalWrapper, ensuring props.closeOverlay cannot be overridden by
caller-supplied props.

In
`@frontend/packages/console-app/src/components/nodes/modals/ConfigureUnschedulableModal.tsx`:
- Around line 51-64: The provider currently spreads props after assigning cancel
and close which allows caller props to override them; update
ConfigureUnschedulableModalProvider to destructure props into { closeOverlay,
...rest } (or extract known keys) and then render ConfigureUnschedulableModal
with {...rest} followed by explicit cancel={closeOverlay} and
close={closeOverlay} so the overlay's close handlers cannot be overridden;
ensure ModalWrapper still uses closeOverlay for onClose and pass the same
closeOverlay to ConfigureUnschedulableModal.

In `@frontend/packages/console-shared/src/utils/error-modal-handler.ts`:
- Around line 35-50: The cleanup unconditionally clears the global launcher
causing newer launchers to be removed; fix useSetupGlobalErrorModalLauncher by
capturing the specific errorModalLauncher reference you set via
setGlobalErrorModalLauncher and, in the return cleanup, only call
setGlobalErrorModalLauncher(null) if the current global launcher equals that
captured reference (so use a stable local/ref for errorModalLauncher and guard
the cleanup), referencing the existing functions errorModalLauncher,
useSetupGlobalErrorModalLauncher, and setGlobalErrorModalLauncher to locate and
implement the guarded cleanup.

In `@frontend/packages/knative-plugin/src/actions/creators.ts`:
- Around line 4-5: The SDK currently forces imports from an internal path to
reach useOverlay; update the SDK public exports so useOverlay can be imported
from '@console/dynamic-plugin-sdk' by re-exporting the modal overlay API: add an
export for the modal-support module (e.g., export * from './modal-support') from
the SDK app index or alternatively export the dynamic-core-api module from the
SDK root so that the symbol useOverlay is publicly available; modify the module
that aggregates app exports to re-export useOverlay (and related modal types) so
consumers can import { useOverlay } from '@console/dynamic-plugin-sdk'.

In `@frontend/public/components/modals/configure-update-strategy-modal.tsx`:
- Around line 241-250: The provider currently spreads {...props} after setting
cancel/close so a caller can override cancel/close; update
ConfigureUpdateStrategyModalProvider to spread props first into
ConfigureUpdateStrategyModal (or omit cancel/close from the spread) and then
pass cancel={props.closeOverlay} and close={props.closeOverlay} to enforce using
props.closeOverlay; locate the ConfigureUpdateStrategyModalProvider and
ConfigureUpdateStrategyModal usages to apply this change so closeOverlay cannot
be overridden by caller props.

In `@frontend/public/components/modals/delete-modal.tsx`:
- Around line 183-188: The DeleteModalProvider currently spreads props after
passing cancel and close, allowing a caller to override cancel/close; in the
DeleteModalProvider component (and the ModalWrapper usage) spread {...props}
first and then pass cancel={props.closeOverlay} and close={props.closeOverlay}
so the enforced overlay handlers cannot be overridden by caller-provided props
(refer to DeleteModalProvider, ModalWrapper, DeleteModal, and
props.closeOverlay).

In `@frontend/public/components/modals/delete-pvc-modal.tsx`:
- Around line 87-91: The DeletePVCModalProvider currently spreads {...props}
after explicit cancel/close props which allows callers to override
props.closeOverlay; change the prop order in the JSX so you spread {...props}
first and then pass cancel={props.closeOverlay} close={props.closeOverlay} (on
ModalWrapper keep onClose={props.closeOverlay}) to ensure DeletePVCModal and
ModalWrapper always use props.closeOverlay for teardown and cannot be overridden
by incoming props.
♻️ Duplicate comments (2)
frontend/packages/console-app/src/actions/hooks/useJobActions.ts (1)

55-57: Same launcher-dep suppression pattern—please confirm stability.

If useConfigureCountModal() returns a new function over time, omitting it from deps can leave the action stale. This mirrors the earlier launcher-dep concern.

frontend/packages/console-app/src/actions/providers/build-config-provider.ts (1)

36-38: Launcher-dep suppression repeated here—confirm the hook’s launcher is stable.

Same dependency omission pattern as in other action hooks; please ensure the launcher identity is stable or the action can become stale.

Also applies to: 71-73

🧹 Nitpick comments (16)
frontend/public/components/utils/webhooks.tsx (1)

90-115: The isLoaded dependency may cause an unnecessary double-fetch.

The effect sets isLoaded = true at line 111, and isLoaded is also listed in the dependency array. On initial mount:

  1. isLoaded is false → effect runs → secrets fetched → setLoaded(true)
  2. isLoaded changes to true → effect re-runs → secrets fetched again

Consider adding a guard or removing isLoaded from deps if it's only meant to track completion:

  useEffect(() => {
-   if (!canGetSecret) {
+   if (!canGetSecret || isLoaded) {
      return;
    }

Alternatively, if the intent is to allow re-fetching when secretNames change, isLoaded should be removed from the dependency array entirely—it's not a meaningful trigger.


On the launchModal suppression: I see this pattern across the PR for avoiding the max-depth error. For long-term maintainability, the useOverlay hook should ideally return a stable (memoized) function reference. If that's not feasible right now, a useRef wrapper is a cleaner alternative to eslint-disable:

const launchModalRef = useRef(launchModal);
launchModalRef.current = launchModal;
// then use launchModalRef.current inside the effect

This keeps the linter happy and documents the intent more explicitly than a suppression comment.

frontend/packages/console-shared/src/hooks/useWarningModal.tsx (1)

37-52: Consider documenting memoization expectations.

The dependency array at line 50 includes props, which is an object reference. If callers pass inline objects (e.g., useWarningModal({ title: 'Title' })), the callback will be recreated on every render. This is fine for most use cases, but callers needing a stable callback reference should memoize their props.

Consider adding a note in the JSDoc (around line 30-36) mentioning this behavior, especially since other parts of the codebase may rely on stable callback references for effect dependencies.

📝 Suggested documentation addition
 /**
  * useWarningModal is a hook that provides a way to launch a WarningModal.
  * Supports two usage patterns:
  * - Pass props at hook initialization time: useWarningModal({ title: 'Title' })
  * - Pass props in the callback: const launch = useWarningModal(); launch({ title: 'Title' })
  * - Mix both (overrides have priority): const launch = useWarningModal({ title: 'Title' }); launch({ children: <Content /> })
+ *
+ * Note: If a stable callback reference is required, memoize the props object passed
+ * to this hook using useMemo to prevent the callback from being recreated on each render.
  */
frontend/packages/knative-plugin/src/components/add/SecretKeySelector.tsx (1)

51-63: Confirm useOverlay() provides a stable function or capture it safely.
Line 51–63 suppresses exhaustive-deps and drops launchModal. If useOverlay() ever returns a new function (e.g., provider change), this effect will keep a stale launcher and may miss error modals. Please confirm stability; if not guaranteed, capture it via a ref while keeping the namespace-only fetch behavior.

♻️ Optional safer pattern (ref keeps latest launcher)
-import { useState, useEffect } from 'react';
+import { useState, useEffect, useRef } from 'react';
...
-  const launchModal = useOverlay();
+  const launchModal = useOverlay();
+  const launchModalRef = useRef(launchModal);
+  useEffect(() => {
+    launchModalRef.current = launchModal;
+  }, [launchModal]);
...
-        if (err?.response?.status !== 403) {
-          launchModal(ErrorModal, { error: err?.message });
-        }
+        if (err?.response?.status !== 403) {
+          launchModalRef.current(ErrorModal, { error: err?.message });
+        }
frontend/packages/metal3-plugin/src/components/maintenance/actions.tsx (2)

42-42: Minor inconsistency in CTA assignment pattern

Line 34 assigns cta: startNodeMaintenanceModal directly as a function reference, whereas here you wrap with cta: () => stopNodeMaintenanceModalLauncher(). Both work, but the inconsistency is a bit puzzling.

If both launchers have the same signature (no-arg functions returning void/Promise), prefer consistency—either direct reference for both or arrow wrappers for both. This aids readability and avoids questions about subtle differences.

♻️ Suggested alignment (if signatures match)
-        cta: () => stopNodeMaintenanceModalLauncher(),
+        cta: stopNodeMaintenanceModalLauncher,

27-28: Guard the useStopNodeMaintenanceModal hook call or add undefined handling

findNodeMaintenance returns undefined when no matching maintenance is found, yet useStopNodeMaintenanceModal(nodeMaintenance) is invoked unconditionally at line 28. The hook immediately computes modal content by calling getNodeMaintenanceReason(nodeMaintenance) and getNodeMaintenanceNodeName(nodeMaintenance) with potentially undefined data. Additionally, getMaintenanceModel(nodeMaintenance) (invoked in the onConfirm callback) accesses nodeMaintenance.apiVersion without checking if it exists.

While the launcher is only invoked when nodeMaintenance is truthy (line 38), this pattern wastes renders and violates the hook's contract—the type signature doesn't reflect that undefined is acceptable. This can be fragile if the selector functions don't handle undefined gracefully.

Either guard the hook call with a conditional or update useStopNodeMaintenanceModal to explicitly handle and return a no-op launcher when nodeMaintenance is undefined.

frontend/packages/knative-plugin/src/actions/creators.ts (1)

130-130: Unnecessary template literal.

Use a plain string literal here since there's no interpolation.

✏️ Suggested fix
-      id: `delete-resource`,
+      id: 'delete-resource',
frontend/packages/console-app/src/actions/hooks/useRetryRolloutAction.ts (1)

98-100: Re-enable react-hooks/exhaustive-deps and include launchModal in the dependency array.

useOverlay returns a stable launcher—launchOverlay is memoized with useCallback(..., []) in OverlayProvider (line 40), so its identity never changes. The suppression is unnecessary; including it in the deps array will not cause infinite loops. Keeping the lint rule enabled ensures future maintainers catch unintended stale closures.

frontend/packages/console-app/src/actions/hooks/useCommonActions.ts (1)

47-85: Avoid suppressing exhaustive-deps; verify useOverlay stability.

launchModal is omitted from deps with an eslint-disable. If useOverlay ever returns a new function, this can capture a stale launcher. Prefer stabilizing the hook output (or memoizing) so the dependency can be included and the suppression removed.

Also applies to: 174-176

frontend/packages/console-app/src/actions/hooks/usePVCActions.ts (1)

7-11: Inconsistent lazy-loading for modal providers.

LazyExpandPVCModalProvider and LazyClonePVCModalProvider are lazy-loaded, but DeletePVCModalProvider is imported directly. For consistency and code-splitting benefits, consider using a lazy-loaded variant for DeletePVCModalProvider as well.

Does React lazy loading improve bundle size for modals?
frontend/public/components/modals/managed-resource-save-modal.tsx (1)

53-54: Consider excluding closeOverlay from prop spread.

The {...props} spread will pass closeOverlay to the inner ManagedResourceSaveModal, which doesn't use it (it uses close instead). While React ignores unknown props on function components, explicitly destructuring to exclude closeOverlay would be cleaner:

♻️ Suggested refinement
 export const ManagedResourceSaveModalProvider: OverlayComponent<ManagedResourceSaveModalProps> = (
   props,
 ) => {
+  const { closeOverlay, ...rest } = props;
   return (
-    <ModalWrapper blocking onClose={props.closeOverlay}>
-      <ManagedResourceSaveModal close={props.closeOverlay} {...props} />
+    <ModalWrapper blocking onClose={closeOverlay}>
+      <ManagedResourceSaveModal close={closeOverlay} {...rest} />
     </ModalWrapper>
   );
 };
frontend/public/components/namespace.jsx (1)

878-882: Simplify: pullSecret: undefined is redundant.

Passing pullSecret: undefined explicitly is unnecessary since the prop is already optional in ConfigureNamespacePullSecretProps. This adds noise without semantic value.

♻️ Suggested simplification
   const modal = () =>
     launchModal(LazyConfigureNamespacePullSecretModalProvider, {
       namespace,
-      pullSecret: undefined,
     });
frontend/packages/console-app/src/components/modals/resource-limits/index.ts (1)

4-9: The .then(m => ({ default: m.default })) is redundant.

Since ResourceLimitsModalLauncher already exports ResourceLimitsModalProvider as its default export, the transform is unnecessary. React.lazy expects a module with a default export, which is already satisfied.

♻️ Simplified lazy export
 export const LazyResourceLimitsModalProvider = lazy(() =>
-  import('./ResourceLimitsModalLauncher' /* webpackChunkName: "resource-limits-modal" */).then(
-    (m) => ({
-      default: m.default,
-    }),
-  ),
+  import('./ResourceLimitsModalLauncher' /* webpackChunkName: "resource-limits-modal" */),
 );

That said, if this pattern is intentional for consistency across the codebase or to handle potential named-export scenarios in the future, feel free to keep it.

frontend/packages/dev-console/src/actions/context-menu.ts (1)

14-40: Inconsistency: DeleteApplicationAction still uses i18next.t() directly.

This function uses i18next.t() for translations (line 23), while the new useDeleteResourceAction hook uses useTranslation(). Since DeleteApplicationAction is not a hook, it can't use useTranslation, but this creates an inconsistency in how translations are handled within the same file.

Consider migrating DeleteApplicationAction to a hook (useDeleteApplicationAction) in a future iteration to align with the hook-based pattern if the broader migration effort supports it.

frontend/packages/console-app/src/components/modals/resource-limits/ResourceLimitsModalLauncher.tsx (1)

64-70: Prop spread order could inadvertently override close.

The spread {...props} after close={props.closeOverlay} means if props somehow contains a close property, it would override the intended value. While OverlayComponent props shouldn't include close (they provide closeOverlay), defensive ordering is safer:

♻️ Defensive prop ordering
 export const ResourceLimitsModalProvider: OverlayComponent<ResourceLimitsModalLauncherProps> = (
   props,
 ) => (
   <ModalWrapper blocking onClose={props.closeOverlay}>
-    <ResourceLimitsModalLauncher close={props.closeOverlay} {...props} />
+    <ResourceLimitsModalLauncher {...props} close={props.closeOverlay} />
   </ModalWrapper>
 );

This ensures close is always bound to closeOverlay regardless of what's in props.

frontend/public/components/modals/configure-ns-pull-secret-modal.tsx (1)

317-329: Same prop spread order concern; also closeOverlay leaks into child props.

Two observations:

  1. Prop ordering: The spread {...props} after explicit cancel and close assignments could override them if props contains those keys.

  2. closeOverlay prop leakage: The OverlayComponent type injects closeOverlay into props. Spreading {...props} passes closeOverlay to ConfigureNamespacePullSecret, which doesn't expect it. This may cause a React warning about unknown DOM attributes if the prop propagates further.

♻️ Destructure to exclude closeOverlay and fix ordering
-export const ConfigureNamespacePullSecretModalProvider: OverlayComponent<ConfigureNamespacePullSecretProps> = (
-  props,
-) => {
+export const ConfigureNamespacePullSecretModalProvider: OverlayComponent<ConfigureNamespacePullSecretProps> = ({
+  closeOverlay,
+  ...restProps
+}) => {
   return (
-    <ModalWrapper blocking onClose={props.closeOverlay}>
+    <ModalWrapper blocking onClose={closeOverlay}>
       <ConfigureNamespacePullSecret
-        cancel={props.closeOverlay}
-        close={props.closeOverlay}
-        {...props}
+        {...restProps}
+        cancel={closeOverlay}
+        close={closeOverlay}
       />
     </ModalWrapper>
   );
 };

This prevents closeOverlay from leaking and ensures cancel/close are always correctly bound.

frontend/public/components/modals/index.ts (1)

87-92: Minor formatting inconsistency.

LazyClonePVCModalProvider and LazyRestorePVCModalProvider use single-line .then((m) => ({ default: m.default })) while the other six lazy providers use multi-line formatting. Consider aligning for consistency and easier diffing across providers.

📝 Suggested formatting alignment
 // Lazy-loaded OverlayComponent for Clone PVC Modal
 export const LazyClonePVCModalProvider = lazy(() =>
   import(
     '@console/app/src/components/modals/clone/clone-pvc-modal' /* webpackChunkName: "clone-pvc-modal" */
-  ).then((m) => ({ default: m.default })),
+  ).then((m) => ({
+    default: m.default,
+  })),
 );
 // Lazy-loaded OverlayComponent for Restore PVC Modal
 export const LazyRestorePVCModalProvider = lazy(() =>
   import(
     '@console/app/src/components/modals/restore-pvc/restore-pvc-modal' /* webpackChunkName: "restore-pvc-modal" */
-  ).then((m) => ({ default: m.default })),
+  ).then((m) => ({
+    default: m.default,
+  })),
 );

Also applies to: 113-118

@rhamilto
Copy link
Member Author

/retest

2 similar comments
@rhamilto
Copy link
Member Author

/retest

@rhamilto
Copy link
Member Author

/retest

@rhamilto rhamilto force-pushed the CONSOLE-5012-5 branch 3 times, most recently from d102d05 to 274b735 Compare January 27, 2026 20:39
@rhamilto
Copy link
Member Author

/retest

1 similar comment
@rhamilto
Copy link
Member Author

/retest

@rhamilto
Copy link
Member Author

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Feb 2, 2026

/assign @yanpzhan
/assign @vojtechszocs

Tech debt, so assigning labels
/label px-approved
/label docs-approved

@openshift-ci openshift-ci bot removed the lgtm Indicates that a PR is ready to be merged. label Mar 2, 2026
@rhamilto
Copy link
Member Author

rhamilto commented Mar 2, 2026

@rhamilto Checked on cluster launched against the latest pr code, still could see runtime error when clicking node action/kebab list button, the error occurred after installed Node Maintenance Operator on the cluster.

Great catch, @yanpzhan. This should be fixed.

Screen.Recording.2026-03-02.at.10.18.30.AM.mov

@logonoff or @vojtechszocs, mind re-tagging after fix?

Comment on lines +16 to +27
const launcher = useOverlay();

useEffect(() => {
const warningModalLauncher = (props: ControlledWarningModalProps) => {
launcher<ControlledWarningModalProps>(ControlledWarningModal, props);
};
moduleWarningModalLauncher = warningModalLauncher;

return () => {
// Only clear if we're still the active launcher
if (moduleWarningModalLauncher === warningModalLauncher) {
moduleWarningModalLauncher = null;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why can't we directly use useWarningModal here?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Claude says,
useWarningModal is a React hook that must be called inside a React component. It uses useOverlay() and useCallback(), which are React hooks.

launchWarningModal is a plain JavaScript function that works in non-React contexts like:

Promise callbacks (.then(), .catch())
Utility functions
Event handlers outside components
Legacy code that isn't inside a React component

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I mean like

  const warningModal = useWarningModal();

  useEffect(() => {
    moduleWarningModalLauncher = warningModal;

    return () => {
      // Only clear if we're still the active launcher
      if (moduleWarningModalLauncher === warningModal) {
        moduleWarningModalLauncher = null;
      }
    };
  }, [launcher]);

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah. Now we understand. Updated. And added a useErrorModal to do the same.

Comment on lines +56 to +63
export const useWarningModalLauncher = (): ((props: ControlledWarningModalProps) => void) => {
const launcher = useOverlay();

return useCallback(
(props: ControlledWarningModalProps) => {
launcher<ControlledWarningModalProps>(ControlledWarningModal, props);
},
[launcher],
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is just useWarningModal

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch. Removed/replaced.

id: 'remove-node-maintenance',
label: t('metal3-plugin~Stop Maintenance'),
cta: stopNodeMaintenanceModalLauncher,
cta: nodeMaintenance ? () => stopNodeMaintenanceModalLauncher(nodeMaintenance) : undefined,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

does this mean that if nodeMaintenance is falsy this will do nothing? maybe we should hide this action entirely in that case?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ternary shouldn't be there at all. Updated.

rhamilto and others added 2 commits March 2, 2026 16:01
…e action

- Remove useWarningModalLauncher hook (duplicates useWarningModal functionality)
- Update tests and mocks to remove useWarningModalLauncher references
- Simplify Stop Maintenance action CTA (action is already hidden when nodeMaintenance is falsy)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
…ooks

- Create useErrorModal hook (similar to useWarningModal pattern)
- Refactor useSyncErrorModalLauncher to use useErrorModal
- Refactor useSyncWarningModalLauncher to use useWarningModal
- Remove redundant useErrorModalLauncher hook
- Update tests and mocks accordingly

This eliminates code duplication and establishes a consistent pattern
for both error and warning modal launchers.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

export const useSyncWarningModalLauncher = jest.fn();

export const useWarningModalLauncher = jest.fn(() => mockLaunchWarningModal);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

mock still present

* };
* ```
*/
export const useErrorModal = (
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we already have a useErrorModalLauncher too

Comment on lines +10 to +13
export const ControlledWarningModal: OverlayComponent<WarningModalProps> = ({
closeOverlay,
...props
}) => {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this doesn't need to be exported anymore

Suggested change
export const ControlledWarningModal: OverlayComponent<WarningModalProps> = ({
closeOverlay,
...props
}) => {
const ControlledWarningModal: OverlayComponent<WarningModalProps> = ({
closeOverlay,
...props
}) => {

rhamilto and others added 2 commits March 2, 2026 16:38
…lLauncher

Enhanced the existing useErrorModalLauncher to support flexible prop merging,
eliminating the need for a duplicate useErrorModal hook. This ensures a single
source of truth for error modal launching while maintaining the same flexible
API pattern used by useWarningModal.

Changes:
- Enhanced useErrorModalLauncher to accept optional props at initialization
  and optional overrides at call time, with proper merging of both
- Removed duplicate useErrorModal hook from error-modal-handler.tsx
- Updated useSyncErrorModalLauncher to use the enhanced useErrorModalLauncher
- Removed useErrorModal from mock file to match production code
- Added proper TypeScript types for improved type safety

This maintains consistency across modal handlers and follows the same pattern
established for warning modals.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
ControlledWarningModal is an internal implementation detail of useWarningModal
and should not be exported. Only the hook and its types should be public API.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@openshift-ci-robot
Copy link
Contributor

openshift-ci-robot commented Mar 2, 2026

@rhamilto: This pull request references CONSOLE-5012 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the story to target the "4.22.0" version, but no target version was set.

Details

In response to this:

Summary

This PR continues the modal migration effort by removing the deprecated confirmModal (which used createModalLauncher) and migrating to the modern overlay pattern with an imperative launchWarningModal() API.

API Design Change: Updated launchWarningModal to use callback-based API instead of Promises to better align with React patterns and the underlying modal system architecture.

Changes

Removed deprecated confirmModal

Created imperative warning modal API

  • ✅ Follows same pattern as launchErrorModal()
  • Callback-based API: accepts optional onConfirm and onCancel callbacks
  • ✅ Works from non-React contexts (drag-drop callbacks, utility functions)
  • ✅ Uses modern overlay system via useOverlay hook
  • Race condition guards: Only clears launcher if still active
  • Comprehensive JSDoc documentation with examples
  • Warning icon is optional via titleIconVariant prop (defaults to 'warning' per PatternFly)

Unified modal launcher initialization with race condition protection

  • ✅ Refactored SyncErrorModalLauncherSyncModalLaunchers in error-modal-handler.tsx
  • ✅ Single component syncs both error and warning modal launchers
  • Added reference-based cleanup guards to prevent race conditions
  • ✅ Mounted once in app.tsx after OverlayProvider

Consolidated modal hook implementations

  • Removed duplicate useErrorModal hook - consolidated into existing useErrorModalLauncher
  • Enhanced useErrorModalLauncher to support flexible prop merging (initialization + runtime)
  • Made ControlledWarningModal component private - internal implementation detail
  • Consistent pattern - both error and warning modals use the same flexible API
  • Single source of truth - no more duplicate hook implementations

Migrated moveNodeToGroup to use launchWarningModal

  • ✅ Updated moveNodeToGroup.tsx to use launchWarningModal() instead of confirmModal()
  • ✅ Wraps callback-based API in Promise internally to maintain backward compatibility
  • ✅ Preserved <Trans> components with <strong> tags for bold text formatting
  • ✅ Added onError parameter for custom error handling
  • ✅ Integrated with launchErrorModal() for error display
  • Proper error handling distinguishing user cancellation from actual errors
  • Hides warning icon for move/remove operations via titleIconVariant: null

Fixed accessibility violation

  • ✅ Blur active element before launching confirmation modal in moveNodeToGroup.tsx
  • ✅ Prevents focus from remaining on SVG elements in topology graph
  • ✅ Fixes browser warning: "Blocked aria-hidden on an element because its descendant retained focus"

Fixed useWarningModal type safety

  • ✅ Made ControlledWarningModal component private in useWarningModal.tsx
  • ✅ Uses proper OverlayComponent type instead of manual prop definition
  • ✅ Properly calls closeOverlay() on modal dismiss

Updated metal3-plugin modals

Updated shipwright-plugin

  • ✅ Cleaned up orphaned functions in logs-utils.ts
  • ✅ Removed getOrderedStepsFromPod (no references found - 20 lines removed)
  • ✅ Removed getDownloadAllLogsCallback (no references found - 111 lines removed)
  • ✅ Removed unused i18n key "Error downloading logs."

Test infrastructure

Architecture Benefits

  • No duplication - Single useErrorModalLauncher implementation (removed duplicate useErrorModal)
  • Consistent patterns - Error and warning modals use identical flexible prop merging API
  • Single source of truth - One canonical hook per modal type
  • Consistent with React patterns - Callbacks align with hooks and PatternFly components
  • Simpler than React Context - No provider/consumer boilerplate needed
  • Single initialization point - One SyncModalLaunchers component for all imperative modals
  • Works everywhere - Usable from both React components and non-React contexts
  • Type-safe - Throws clear errors when launchers not initialized
  • Race condition protection - Reference-based cleanup prevents clearing newer launchers
  • Proper cleanup - Via React lifecycle, not manual cleanup
  • WCAG 2.1 Level A compliant - No aria-hidden focus violations
  • Well-tested - Comprehensive unit tests for all scenarios (11/11 passing)
  • Well-documented - Clear JSDoc with examples and proper error types
  • Flexible icon display - Warning icon can be hidden when not needed
  • No impedance mismatch - Callback-based API matches underlying React/PatternFly architecture

Technical Details

Modal Hook Consolidation

Problem: We had duplicate implementations of error modal hooks:

  • useErrorModalLauncher (in public/components/modals/error-modal.tsx) - original, inflexible API
  • useErrorModal (in packages/console-shared/src/utils/error-modal-handler.tsx) - duplicate with flexible API

Solution: Enhanced the existing useErrorModalLauncher to support the flexible pattern, eliminating duplication:

// Before: inflexible - props fixed at hook creation
export const useErrorModalLauncher = (props) => {
 const launcher = useOverlay();
 return useCallback(() => launcher(ErrorModal, props), [launcher, props]);
};

// After: flexible - supports both initialization and runtime props
export const useErrorModalLauncher = (
 props?: Partial<ErrorModalProps>,
): ((overrides?: ErrorModalProps) => void) => {
 const launcher = useOverlay();
 return useCallback(
   (overrides?: ErrorModalProps) => {
     const mergedProps: ErrorModalProps = {
       error: '',
       ...(props || {}),
       ...(overrides || {}),
     };
     launcher<ErrorModalProps>(ErrorModal, mergedProps);
   },
   [launcher, props],
 );
};

Benefits:

  • ✅ Single source of truth for error modal launching
  • ✅ Matches the pattern used by useWarningModal
  • ✅ Supports both usage patterns: useErrorModalLauncher(props)() or useErrorModalLauncher()(props)
  • ✅ Better TypeScript types with proper inference
  • ✅ No breaking changes - backward compatible API

Callback-Based API Design

The imperative launchWarningModal uses callbacks instead of Promises to align with React patterns:

Why callbacks over Promises?

  1. React hooks use callbacks - useWarningModal hook accepts onConfirm/onClose callbacks
  2. PatternFly uses callbacks - WarningModal component uses callback props, not Promises
  3. Overlay system uses callbacks - closeOverlay is a callback, not a Promise
  4. No impedance mismatch - No need to wrap callbacks in Promises only to unwrap them
  5. More flexible - Consumers can wrap in Promises if needed (like moveNodeToGroup does)

API signature:

launchWarningModal(
 props: Omit<ControlledWarningModalProps, 'onConfirm' | 'onClose'>,
 onConfirm?: () => void,
 onCancel?: () => void,
): void

Example usage:

launchWarningModal(
 {
   title: 'Delete Resource',
   children: 'Are you sure you want to delete this resource?',
   confirmButtonLabel: 'Delete',
 },
 () => {
   // User confirmed - proceed with action
   deleteResource();
 },
 () => {
   // User canceled
   console.log('Action cancelled by user');
 }
);

Optional Warning Icon

The ControlledWarningModal wrapper passes through the titleIconVariant prop, allowing callers to:

  • Use default warning icon - Don't specify titleIconVariant (PatternFly defaults to 'warning')
  • Hide the icon - Pass titleIconVariant: null
  • Use a different icon - Pass titleIconVariant: 'danger' | 'success' | 'info' or a custom icon

Example usage in moveNodeToGroup.tsx:

launchWarningModal(
 {
   title: i18next.t(titleKey),
   children: message,
   confirmButtonLabel: i18next.t(btnTextKey),
   titleIconVariant: null, // Hides the warning icon
 },
 () => updateTopologyResourceApplication(...),
 () => console.log('User cancelled'),
)

Race Condition Protection

Problem: If components mount/unmount out of order, the cleanup could clear a newer launcher.

Solution: Reference-based cleanup in both launchers (error-modal-handler.tsx, warning-modal-handler.tsx):

useEffect(() => {
 moduleErrorModalLauncher = errorModalLauncher;
 
 return () => {
   // Only clear if we're still the active launcher
   if (moduleErrorModalLauncher === errorModalLauncher) {
     moduleErrorModalLauncher = null;
   }
 };
}, [errorModalLauncher]);

This prevents race conditions where unmounting could clear a newer launcher that was set by a remounting component.

Accessibility Fix - aria-hidden Focus Violation

Problem: When the confirmation modal opened during drag-drop operations, focus remained on an SVG <g> element in the topology graph. PatternFly's Modal sets aria-hidden="true" on the #app div, creating an accessibility violation.

Browser Warning (Fixed):

Blocked aria-hidden on an element because its descendant retained focus.
The focus must not be hidden from assistive technology users.
Element with focus: <g>
Ancestor with aria-hidden: <div#app>

Solution: Blur the active element before launching the modal (moveNodeToGroup.tsx):

// Blur active element to prevent aria-hidden focus violations when modal opens
if (
 document.activeElement instanceof HTMLElement ||
 document.activeElement instanceof SVGElement
) {
 document.activeElement.blur();
}

Test Plan

Automated Tests ✅

  • TypeScript compilation succeeds
  • ESLint passes
  • Build succeeds
  • i18n keys updated correctly
  • Unit tests pass (error-modal-handler.spec.tsx: 4/4)
  • Unit tests pass (warning-modal-handler.spec.tsx: 7/7)
  • All modal handler tests: 11/11 passing

Manual Testing Checklist

  • Verify topology node drag-and-drop with confirmation modal works
  • Verify clicking "Cancel" in confirmation modal restores node to original position
  • Verify clicking "Move"/"Remove" confirms the operation
  • Verify error modals display correctly for failed operations
  • Verify modals properly close and remove from DOM on both confirm and cancel
  • Verify bold text formatting appears correctly in modal messages
  • Verify no aria-hidden accessibility warnings in browser console
  • Verify modal receives focus when opened from drag-drop operation
  • Verify modal displays without warning icon for move/remove operations
  • Verify metal3-plugin maintenance modals work correctly
  • Verify "Stop maintenance" modal displays and functions properly

Breaking Changes

None - this is a refactoring that maintains the same functionality.

Related

🤖 Generated with Claude Code

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

Copy link
Member

@logonoff logonoff left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm

@openshift-ci openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Mar 2, 2026
@openshift-ci
Copy link
Contributor

openshift-ci bot commented Mar 2, 2026

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: logonoff, rhamilto, vojtechszocs

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@rhamilto
Copy link
Member Author

rhamilto commented Mar 3, 2026

/retest

4 similar comments
@rhamilto
Copy link
Member Author

rhamilto commented Mar 3, 2026

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Mar 3, 2026

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Mar 3, 2026

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Mar 3, 2026

/retest

@yapei
Copy link
Contributor

yapei commented Mar 4, 2026

/assign @yanpzhan
for verification

@yanpzhan
Copy link
Contributor

yanpzhan commented Mar 4, 2026

Checked on cluster launched against the pr, regression test about confirm modal pages passed.
/verified by yanpzhan

@openshift-ci-robot openshift-ci-robot added the verified Signifies that the PR passed pre-merge verification criteria label Mar 4, 2026
@openshift-ci-robot
Copy link
Contributor

@yanpzhan: This PR has been marked as verified by yanpzhan.

Details

In response to this:

Checked on cluster launched against the pr, regression test about confirm modal pages passed.
/verified by yanpzhan

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

@rhamilto
Copy link
Member Author

rhamilto commented Mar 4, 2026

/retest

6 similar comments
@rhamilto
Copy link
Member Author

rhamilto commented Mar 4, 2026

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Mar 5, 2026

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Mar 5, 2026

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Mar 5, 2026

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Mar 6, 2026

/retest

@rhamilto
Copy link
Member Author

rhamilto commented Mar 6, 2026

/retest

@openshift-ci
Copy link
Contributor

openshift-ci bot commented Mar 6, 2026

@rhamilto: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

acknowledge-critical-fixes-only Indicates if the issuer of the label is OK with the policy. approved Indicates a PR has been approved by an approver from all required OWNERS files. component/core Related to console core functionality component/dev-console Related to dev-console component/knative Related to knative-plugin component/metal3 Related to metal3-plugin component/sdk Related to console-plugin-sdk component/shared Related to console-shared component/topology Related to topology docs-approved Signifies that Docs has signed off on this PR jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. kind/i18n Indicates issue or PR relates to internationalization or has content that needs to be translated lgtm Indicates that a PR is ready to be merged. px-approved Signifies that Product Support has signed off on this PR tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges. verified Signifies that the PR passed pre-merge verification criteria

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants