From fcffd8db63f225262f60ee96ac7be5e2dee3f031 Mon Sep 17 00:00:00 2001
From: platex-rehor-bot <platform-experience-services@redhat.com>
Date: Tue, 30 Jun 2026 13:09:59 +0000
Subject: [PATCH 1/4] fix(help-panel): use client-side navigation for internal
 links

RHCLOUD-47951
Replace <a href> anchor tags with useNavigateKeepPanel hook in
APIPanel and LearnPanel. Anchor tags trigger full page reloads which
destroy the React tree, reset Jotai atoms, and close the help panel.
The useNavigateKeepPanel hook performs SPA navigation via
chromeHistory.push and re-asserts drawer state to keep the panel open.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .../HelpPanel/HelpPanelTabs/APIPanel.test.tsx |  1 +
 .../HelpPanel/HelpPanelTabs/APIPanel.tsx      | 25 ++++++++++++++-----
 .../HelpPanel/HelpPanelTabs/LearnPanel.tsx    |  5 ++--
 3 files changed, 23 insertions(+), 8 deletions(-)

diff --git a/src/components/HelpPanel/HelpPanelTabs/APIPanel.test.tsx b/src/components/HelpPanel/HelpPanelTabs/APIPanel.test.tsx
index 504a498f..c090b1b9 100644
--- a/src/components/HelpPanel/HelpPanelTabs/APIPanel.test.tsx
+++ b/src/components/HelpPanel/HelpPanelTabs/APIPanel.test.tsx
@@ -19,6 +19,7 @@ jest.mock('@redhat-cloud-services/frontend-components/useChrome', () => ({
     getBundleData: () => ({ bundleId: 'insights' }),
     getAvailableBundles: () => [{ id: 'insights', title: 'RHEL' }],
     chromeHistory: { push: jest.fn(), replace: jest.fn() },
+    drawerActions: { setDrawerPanelContent: jest.fn() },
     getEnvironment: () => 'prod',
   }),
 }));
diff --git a/src/components/HelpPanel/HelpPanelTabs/APIPanel.tsx b/src/components/HelpPanel/HelpPanelTabs/APIPanel.tsx
index a2bffbeb..47964483 100644
--- a/src/components/HelpPanel/HelpPanelTabs/APIPanel.tsx
+++ b/src/components/HelpPanel/HelpPanelTabs/APIPanel.tsx
@@ -29,6 +29,7 @@ import {
   fetchBundles,
 } from '../../../utils/fetchBundleInfoAPI';
 import { getBundleDisplayName } from '../../../utils/bundleUtils';
+import useNavigateKeepPanel from '../../../hooks/useNavigateKeepPanel';
 
 interface APIDoc {
   name: string;
@@ -233,10 +234,23 @@ const mapBundleInfoWithTitles = async (): Promise<APIDoc[]> => {
 
 const APIResourceItem: React.FC<{ resource: APIDoc }> = ({ resource }) => {
   const chrome = useChrome();
+  const navigateKeepPanel = useNavigateKeepPanel();
 
-  const getConsoleDocsUrl = () => {
+  const handleClick = () => {
     const environment = chrome.getEnvironment();
-    return convertToConsoleDocsUrl(resource.name, resource.url, environment);
+    const fullUrl = convertToConsoleDocsUrl(
+      resource.name,
+      resource.url,
+      environment
+    );
+    // Extract the pathname for client-side navigation
+    try {
+      const url = new URL(fullUrl);
+      navigateKeepPanel(url.pathname);
+    } catch {
+      // Fallback for relative paths
+      navigateKeepPanel(fullUrl);
+    }
   };
 
   return (
@@ -254,8 +268,7 @@ const APIResourceItem: React.FC<{ resource: APIDoc }> = ({ resource }) => {
           <FlexItem>
             <Button
               variant="link"
-              component="a"
-              href={getConsoleDocsUrl()}
+              onClick={handleClick}
               isInline
               className="pf-v6-u-text-align-left pf-v6-u-p-0"
             >
@@ -282,6 +295,7 @@ const APIResourceItem: React.FC<{ resource: APIDoc }> = ({ resource }) => {
 const APIPanelContent: React.FC = () => {
   const intl = useIntl();
   const chrome = useChrome();
+  const navigateKeepPanel = useNavigateKeepPanel();
   const [activeToggle, setActiveToggle] = useState<string>('all');
   const [page, setPage] = useState(1);
   const [perPage, setPerPage] = useState(10);
@@ -366,8 +380,7 @@ const APIPanelContent: React.FC = () => {
           {intl.formatMessage(messages.apiPanelDescription)}{' '}
           <Button
             variant="link"
-            component="a"
-            href="/docs/api"
+            onClick={() => navigateKeepPanel('/docs/api')}
             data-ouia-component-id="help-panel-api-docs-link"
             isInline
           >
diff --git a/src/components/HelpPanel/HelpPanelTabs/LearnPanel.tsx b/src/components/HelpPanel/HelpPanelTabs/LearnPanel.tsx
index 1f55b01a..4cda1bcf 100644
--- a/src/components/HelpPanel/HelpPanelTabs/LearnPanel.tsx
+++ b/src/components/HelpPanel/HelpPanelTabs/LearnPanel.tsx
@@ -30,6 +30,7 @@ import {
 import { useChrome } from '@redhat-cloud-services/frontend-components/useChrome';
 import { suspenseLoader as useSuspenseLoader } from '@redhat-cloud-services/frontend-components-utilities/useSuspenseLoader';
 import fetchAllData from '../../../utils/fetchAllData';
+import useNavigateKeepPanel from '../../../hooks/useNavigateKeepPanel';
 import { ExtendedQuickstart } from '../../../utils/fetchQuickstarts';
 import {
   BookmarkedIcon,
@@ -176,6 +177,7 @@ const LearnPanelContent: React.FC<{
 }) => {
   const intl = useIntl();
   const chrome = useChrome();
+  const navigateKeepPanel = useNavigateKeepPanel();
   const { loader, purgeCache } = useSuspenseLoader(fetchAllData);
 
   const CONTENT_TYPE_OPTIONS = [
@@ -653,8 +655,7 @@ const LearnPanelContent: React.FC<{
               {intl.formatMessage(messages.learnPanelDescription)}{' '}
               <Button
                 variant="link"
-                component="a"
-                href="/learning-resources?tab=all"
+                onClick={() => navigateKeepPanel('/learning-resources?tab=all')}
                 isInline
                 iconPosition="end"
               >

From ea279f234e771f2dff612dac708cf9e900880e1a Mon Sep 17 00:00:00 2001
From: platex-rehor-bot <platform-experience-services@redhat.com>
Date: Tue, 30 Jun 2026 13:19:36 +0000
Subject: [PATCH 2/4] fix(help-panel): preserve anchor semantics for navigation
 links

RHCLOUD-47951
Restore native link behavior (href, component="a") on APIPanel and
LearnPanel navigation buttons so users retain open-in-new-tab,
copy-link, and assistive tech link semantics. Only intercept
unmodified same-tab clicks for client-side navigation via
navigateKeepPanel.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 .../HelpPanel/HelpPanelTabs/APIPanel.tsx      | 54 ++++++++++++++-----
 .../HelpPanel/HelpPanelTabs/LearnPanel.tsx    | 16 +++++-
 2 files changed, 57 insertions(+), 13 deletions(-)

diff --git a/src/components/HelpPanel/HelpPanelTabs/APIPanel.tsx b/src/components/HelpPanel/HelpPanelTabs/APIPanel.tsx
index 47964483..1beae42e 100644
--- a/src/components/HelpPanel/HelpPanelTabs/APIPanel.tsx
+++ b/src/components/HelpPanel/HelpPanelTabs/APIPanel.tsx
@@ -236,21 +236,35 @@ const APIResourceItem: React.FC<{ resource: APIDoc }> = ({ resource }) => {
   const chrome = useChrome();
   const navigateKeepPanel = useNavigateKeepPanel();
 
-  const handleClick = () => {
-    const environment = chrome.getEnvironment();
-    const fullUrl = convertToConsoleDocsUrl(
-      resource.name,
-      resource.url,
-      environment
-    );
-    // Extract the pathname for client-side navigation
+  const environment = chrome.getEnvironment();
+  const fullUrl = convertToConsoleDocsUrl(
+    resource.name,
+    resource.url,
+    environment
+  );
+
+  const path = (() => {
     try {
       const url = new URL(fullUrl);
-      navigateKeepPanel(url.pathname);
+      return `${url.pathname}${url.search}${url.hash}`;
     } catch {
-      // Fallback for relative paths
-      navigateKeepPanel(fullUrl);
+      return fullUrl;
     }
+  })();
+
+  const handleClick = (event: React.MouseEvent<HTMLAnchorElement>) => {
+    if (
+      event.button !== 0 ||
+      event.metaKey ||
+      event.ctrlKey ||
+      event.shiftKey ||
+      event.altKey
+    ) {
+      return;
+    }
+
+    event.preventDefault();
+    navigateKeepPanel(path);
   };
 
   return (
@@ -268,6 +282,8 @@ const APIResourceItem: React.FC<{ resource: APIDoc }> = ({ resource }) => {
           <FlexItem>
             <Button
               variant="link"
+              component="a"
+              href={path}
               onClick={handleClick}
               isInline
               className="pf-v6-u-text-align-left pf-v6-u-p-0"
@@ -380,7 +396,21 @@ const APIPanelContent: React.FC = () => {
           {intl.formatMessage(messages.apiPanelDescription)}{' '}
           <Button
             variant="link"
-            onClick={() => navigateKeepPanel('/docs/api')}
+            component="a"
+            href="/docs/api"
+            onClick={(event: React.MouseEvent<HTMLAnchorElement>) => {
+              if (
+                event.button !== 0 ||
+                event.metaKey ||
+                event.ctrlKey ||
+                event.shiftKey ||
+                event.altKey
+              ) {
+                return;
+              }
+              event.preventDefault();
+              navigateKeepPanel('/docs/api');
+            }}
             data-ouia-component-id="help-panel-api-docs-link"
             isInline
           >
diff --git a/src/components/HelpPanel/HelpPanelTabs/LearnPanel.tsx b/src/components/HelpPanel/HelpPanelTabs/LearnPanel.tsx
index 4cda1bcf..defcd439 100644
--- a/src/components/HelpPanel/HelpPanelTabs/LearnPanel.tsx
+++ b/src/components/HelpPanel/HelpPanelTabs/LearnPanel.tsx
@@ -655,7 +655,21 @@ const LearnPanelContent: React.FC<{
               {intl.formatMessage(messages.learnPanelDescription)}{' '}
               <Button
                 variant="link"
-                onClick={() => navigateKeepPanel('/learning-resources?tab=all')}
+                component="a"
+                href="/learning-resources?tab=all"
+                onClick={(event: React.MouseEvent<HTMLAnchorElement>) => {
+                  if (
+                    event.button !== 0 ||
+                    event.metaKey ||
+                    event.ctrlKey ||
+                    event.shiftKey ||
+                    event.altKey
+                  ) {
+                    return;
+                  }
+                  event.preventDefault();
+                  navigateKeepPanel('/learning-resources?tab=all');
+                }}
                 isInline
                 iconPosition="end"
               >

From 60d7a1ea4745781c566039ba181415024e06424f Mon Sep 17 00:00:00 2001
From: platex-rehor-bot <platform-experience-services@redhat.com>
Date: Tue, 30 Jun 2026 21:33:50 +0000
Subject: [PATCH 3/4] chore(deps): update build-tools submodule to latest

RHCLOUD-47951
Updates insights-frontend-builder-common to e2157f0 which includes
nodejs-22 image tag update (9.8-1780375952) and logging fixes.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 build-tools | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build-tools b/build-tools
index a96ba3d3..e2157f0b 160000
--- a/build-tools
+++ b/build-tools
@@ -1 +1 @@
-Subproject commit a96ba3d39e112031b7ce93056c6df7e013a4237e
+Subproject commit e2157f0b0be832e9125f139eaf77bdb479a36afa

From 0a452f18550ac39db1a7b83258ae62f29a9d82ff Mon Sep 17 00:00:00 2001
From: platex-rehor-bot <platform-experience-services@redhat.com>
Date: Wed, 1 Jul 2026 19:35:36 +0000
Subject: [PATCH 4/4] Revert "chore(deps): update build-tools submodule to
 latest"

This reverts commit 60d7a1ea4745781c566039ba181415024e06424f.
---
 build-tools | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/build-tools b/build-tools
index e2157f0b..a96ba3d3 160000
--- a/build-tools
+++ b/build-tools
@@ -1 +1 @@
-Subproject commit e2157f0b0be832e9125f139eaf77bdb479a36afa
+Subproject commit a96ba3d39e112031b7ce93056c6df7e013a4237e