@red-hat-developer-hub/backstage-plugin-quickstart 1.8.1 → 1.8.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @red-hat-developer-hub/backstage-plugin-quickstart
 
+## 1.8.2
+
+### Patch Changes
+
+- bb8ef80: Added drawer state management utilities for integration with application drawers.
+
 ## 1.8.1
 
 ### Patch Changes

package/README.md

@@ -13,6 +13,41 @@ The Quickstart plugin provides a guided onboarding experience for new users of R
 
 ## Installation
 
+### Installing as a dynamic plugin
+
+If you want to install the plugin as a dynamic plugin in Red Hat Developer Hub:
+
+- Follow the [Installing plugins guide](https://github.com/redhat-developer/rhdh/blob/main/docs/dynamic-plugins/installing-plugins.md)
+- Add the content of `app-config.dynamic.yaml` into your `app-config.local.yaml`
+
+#### Dynamic plugin configuration
+
+Add the extension point inside your `app-config.yaml` or `app-config.local.yaml` file:
+
+```yaml
+dynamicPlugins:
+  frontend:
+    red-hat-developer-hub.backstage-plugin-quickstart:
+      translationResources:
+        - importName: quickstartTranslations
+          ref: quickstartTranslationRef
+      mountPoints:
+        - mountPoint: application/provider
+          importName: QuickstartDrawerProvider
+        - mountPoint: application/drawer-state
+          importName: QuickstartDrawerStateExposer
+        - mountPoint: application/drawer-content
+          importName: QuickstartDrawerContent
+          config:
+            id: quickstart
+        - mountPoint: global.header/help
+          importName: QuickstartButton
+          config:
+            priority: 100
+```
+
+### Static Installation
+
 1. Install the plugin package:
 
 ```bash

package/app-config.dynamic.yaml

@@ -1,9 +1,18 @@
 dynamicPlugins:
   frontend:
     red-hat-developer-hub.backstage-plugin-quickstart:
+      translationResources:
+        - importName: quickstartTranslations
+          ref: quickstartTranslationRef
       mountPoints:
         - mountPoint: application/provider
           importName: QuickstartDrawerProvider
+        - mountPoint: application/drawer-state
+          importName: QuickstartDrawerStateExposer
+        - mountPoint: application/drawer-content
+          importName: QuickstartDrawerContent
+          config:
+            id: quickstart
         - mountPoint: global.header/help
           importName: QuickstartButton
           config:

package/dist/components/QuickstartDrawerContent.esm.js

@@ -0,0 +1,37 @@
+import { jsx } from 'react/jsx-runtime';
+import { useMemo } from 'react';
+import { useApi, configApiRef } from '@backstage/core-plugin-api';
+import { Quickstart } from './Quickstart.esm.js';
+import { useQuickstartDrawerContext } from '../hooks/useQuickstartDrawerContext.esm.js';
+import { filterQuickstartItemsByRole } from '../utils/filterQuickstartItems.esm.js';
+
+const QuickstartDrawerContent = () => {
+  const { isDrawerOpen, closeDrawer, userRole, roleLoading } = useQuickstartDrawerContext();
+  const config = useApi(configApiRef);
+  const quickstartItems = useMemo(() => {
+    return config?.has("app.quickstart") ? config.get("app.quickstart") : [];
+  }, [config]);
+  const eligibleItems = useMemo(() => {
+    return !roleLoading && userRole ? filterQuickstartItemsByRole(quickstartItems, userRole) : [];
+  }, [roleLoading, userRole, quickstartItems]);
+  const filteredItems = useMemo(() => {
+    return isDrawerOpen ? eligibleItems : [];
+  }, [isDrawerOpen, eligibleItems]);
+  if (quickstartItems.length === 0) {
+    return null;
+  }
+  if (!roleLoading && eligibleItems.length === 0) {
+    return null;
+  }
+  return /* @__PURE__ */ jsx(
+    Quickstart,
+    {
+      quickstartItems: filteredItems,
+      handleDrawerClose: closeDrawer,
+      isLoading: roleLoading
+    }
+  );
+};
+
+export { QuickstartDrawerContent };
+//# sourceMappingURL=QuickstartDrawerContent.esm.js.map

package/dist/components/QuickstartDrawerContent.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuickstartDrawerContent.esm.js","sources":["../../src/components/QuickstartDrawerContent.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useMemo } from 'react';\nimport { configApiRef, useApi } from '@backstage/core-plugin-api';\nimport { Quickstart } from './Quickstart';\nimport { useQuickstartDrawerContext } from '../hooks/useQuickstartDrawerContext';\nimport { QuickstartItemData } from '../types';\nimport { filterQuickstartItemsByRole } from '../utils';\n\nexport const QuickstartDrawerContent = () => {\n  const { isDrawerOpen, closeDrawer, userRole, roleLoading } =\n    useQuickstartDrawerContext();\n\n  const config = useApi(configApiRef);\n  const quickstartItems: QuickstartItemData[] = useMemo(() => {\n    return config?.has('app.quickstart')\n      ? (config.get('app.quickstart') as QuickstartItemData[])\n      : [];\n  }, [config]);\n\n  // Items available to the user based on role from context\n  const eligibleItems = useMemo(() => {\n    return !roleLoading && userRole\n      ? filterQuickstartItemsByRole(quickstartItems, userRole)\n      : [];\n  }, [roleLoading, userRole, quickstartItems]);\n\n  // Only expose items to the body when drawer is open to avoid re-renders during close\n  const filteredItems = useMemo(() => {\n    return isDrawerOpen ? eligibleItems : [];\n  }, [isDrawerOpen, eligibleItems]);\n\n  // No auto-open logic here; the provider initializes per user (visited/open)\n\n  // If no quickstart items are configured at all, don't render the drawer to avoid reserving space\n  if (quickstartItems.length === 0) {\n    return null;\n  }\n\n  // If there are no items for the user, hide the drawer entirely\n  if (!roleLoading && eligibleItems.length === 0) {\n    return null;\n  }\n\n  // No role-fetching or filtering here when the drawer is closed\n\n  return (\n    <Quickstart\n      quickstartItems={filteredItems}\n      handleDrawerClose={closeDrawer}\n      isLoading={roleLoading}\n    />\n  );\n};\n"],"names":[],"mappings":";;;;;;;AAuBO,MAAM,0BAA0B,MAAM;AAC3C,EAAA,MAAM,EAAE,YAAc,EAAA,WAAA,EAAa,QAAU,EAAA,WAAA,KAC3C,0BAA2B,EAAA;AAE7B,EAAM,MAAA,MAAA,GAAS,OAAO,YAAY,CAAA;AAClC,EAAM,MAAA,eAAA,GAAwC,QAAQ,MAAM;AAC1D,IAAO,OAAA,MAAA,EAAQ,IAAI,gBAAgB,CAAA,GAC9B,OAAO,GAAI,CAAA,gBAAgB,IAC5B,EAAC;AAAA,GACP,EAAG,CAAC,MAAM,CAAC,CAAA;AAGX,EAAM,MAAA,aAAA,GAAgB,QAAQ,MAAM;AAClC,IAAA,OAAO,CAAC,WAAe,IAAA,QAAA,GACnB,4BAA4B,eAAiB,EAAA,QAAQ,IACrD,EAAC;AAAA,GACJ,EAAA,CAAC,WAAa,EAAA,QAAA,EAAU,eAAe,CAAC,CAAA;AAG3C,EAAM,MAAA,aAAA,GAAgB,QAAQ,MAAM;AAClC,IAAO,OAAA,YAAA,GAAe,gBAAgB,EAAC;AAAA,GACtC,EAAA,CAAC,YAAc,EAAA,aAAa,CAAC,CAAA;AAKhC,EAAI,IAAA,eAAA,CAAgB,WAAW,CAAG,EAAA;AAChC,IAAO,OAAA,IAAA;AAAA;AAIT,EAAA,IAAI,CAAC,WAAA,IAAe,aAAc,CAAA,MAAA,KAAW,CAAG,EAAA;AAC9C,IAAO,OAAA,IAAA;AAAA;AAKT,EACE,uBAAA,GAAA;AAAA,IAAC,UAAA;AAAA,IAAA;AAAA,MACC,eAAiB,EAAA,aAAA;AAAA,MACjB,iBAAmB,EAAA,WAAA;AAAA,MACnB,SAAW,EAAA;AAAA;AAAA,GACb;AAEJ;;;;"}

package/dist/components/QuickstartDrawerProvider.esm.js

@@ -5,7 +5,6 @@ import Snackbar from '@mui/material/Snackbar';
 import CloseIcon from '@mui/icons-material/Close';
 import IconButton from '@mui/material/IconButton';
 import { QuickstartDrawerContext } from './QuickstartDrawerContext.esm.js';
-import { QuickstartDrawer } from './QuickstartDrawer.esm.js';
 import { filterQuickstartItemsByRole } from '../utils/filterQuickstartItems.esm.js';
 import { useQuickstartRole } from '../hooks/useQuickstartRole.esm.js';
 
@@ -18,22 +17,6 @@ const QuickstartDrawerProvider = ({ children }) => {
   const identityApi = useApi(identityApiRef);
   const configApi = useApi(configApiRef);
   const { isLoading: roleLoading, userRole } = useQuickstartRole();
-  useEffect(() => {
-    if (isDrawerOpen) {
-      document.body.classList.add("quickstart-drawer-open");
-      document.body.style.setProperty(
-        "--quickstart-drawer-width",
-        `${drawerWidth}px`
-      );
-    } else {
-      document.body.classList.remove("quickstart-drawer-open");
-      document.body.style.removeProperty("--quickstart-drawer-width");
-    }
-    return () => {
-      document.body.classList.remove("quickstart-drawer-open");
-      document.body.style.removeProperty("--quickstart-drawer-width");
-    };
-  }, [isDrawerOpen, drawerWidth]);
   useEffect(() => {
     let cancelled = false;
     (async () => {
@@ -135,7 +118,6 @@ const QuickstartDrawerProvider = ({ children }) => {
       },
       children: [
         children,
-        /* @__PURE__ */ jsx(QuickstartDrawer, {}),
         /* @__PURE__ */ jsx(
           Snackbar,
           {

package/dist/components/QuickstartDrawerProvider.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"QuickstartDrawerProvider.esm.js","sources":["../../src/components/QuickstartDrawerProvider.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useEffect, PropsWithChildren, useState } from 'react';\nimport {\n  configApiRef,\n  identityApiRef,\n  useApi,\n} from '@backstage/core-plugin-api';\nimport Snackbar from '@mui/material/Snackbar';\nimport CloseIcon from '@mui/icons-material/Close';\nimport IconButton from '@mui/material/IconButton';\nimport { QuickstartDrawerContext } from './QuickstartDrawerContext';\nimport { QuickstartDrawer } from './QuickstartDrawer';\nimport { QuickstartItemData } from '../types';\nimport { filterQuickstartItemsByRole } from '../utils';\nimport { useQuickstartRole } from '../hooks/useQuickstartRole';\n\n/**\n * Provider component for the Quickstart Drawer functionality\n * @public\n */\nexport const QuickstartDrawerProvider = ({ children }: PropsWithChildren) => {\n  const [isDrawerOpen, setIsDrawerOpen] = useState<boolean>(false);\n  const [showNotification, setShowNotification] = useState(false);\n  const [hasShownNotification, setHasShownNotification] = useState(false);\n  const [drawerWidth, setDrawerWidth] = useState<number>(500);\n  const [userKey, setUserKey] = useState<string>('guest');\n  const identityApi = useApi(identityApiRef);\n  const configApi = useApi(configApiRef);\n\n  // Determine role once at provider level to avoid re-fetching on drawer open/close\n  const { isLoading: roleLoading, userRole } = useQuickstartRole();\n\n  // Single useEffect - sets class on document.body\n  useEffect(() => {\n    if (isDrawerOpen) {\n      document.body.classList.add('quickstart-drawer-open');\n      document.body.style.setProperty(\n        '--quickstart-drawer-width',\n        `${drawerWidth}px`,\n      );\n    } else {\n      document.body.classList.remove('quickstart-drawer-open');\n      document.body.style.removeProperty('--quickstart-drawer-width');\n    }\n\n    return () => {\n      document.body.classList.remove('quickstart-drawer-open');\n      document.body.style.removeProperty('--quickstart-drawer-width');\n    };\n  }, [isDrawerOpen, drawerWidth]);\n\n  // Resolve the current user's identity to scope localStorage keys per user\n  useEffect(() => {\n    let cancelled = false;\n    (async () => {\n      try {\n        const identity = await identityApi.getBackstageIdentity();\n        const ref = identity?.userEntityRef?.toLowerCase() || 'guest';\n        if (!cancelled) setUserKey(ref);\n      } catch (e) {\n        if (!cancelled) setUserKey('guest');\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [identityApi]);\n\n  // Initialize drawer state based on per-user keys and only when quickstarts exist\n  useEffect(() => {\n    if (!userKey) return;\n\n    // Determine if there are any quickstart items configured globally\n    const hasAnyQuickstarts = (() => {\n      try {\n        if (!configApi?.has('app.quickstart')) return false;\n        const items = configApi.get('app.quickstart') as unknown;\n        return Array.isArray(items) && items.length > 0;\n      } catch {\n        return false;\n      }\n    })();\n\n    const openKey = `quickstart-open:${userKey}`;\n    const visitedKey = `quickstart-visited:${userKey}`;\n    const notificationKey = `quickstart-notification-shown:${userKey}`;\n\n    // If no quickstarts are configured, ensure the drawer is closed and don't mark as visited\n    if (!hasAnyQuickstarts) {\n      setIsDrawerOpen(false);\n      // Avoid persisting visited so future addition of items can auto-open\n      localStorage.setItem(openKey, 'false');\n      return;\n    }\n\n    // Check if user has any eligible quickstart items\n    const quickstartItems: QuickstartItemData[] = configApi?.has(\n      'app.quickstart',\n    )\n      ? (configApi.get('app.quickstart') as QuickstartItemData[])\n      : [];\n\n    const eligibleItems =\n      !roleLoading && userRole\n        ? filterQuickstartItemsByRole(quickstartItems, userRole)\n        : [];\n\n    // If user has no eligible items, close the drawer and don't mark as visited\n    if (!roleLoading && eligibleItems.length === 0) {\n      setIsDrawerOpen(false);\n      localStorage.setItem(openKey, 'false');\n      return;\n    }\n\n    // Only proceed with drawer logic if user has eligible items\n    const wasOpen = localStorage.getItem(openKey);\n    const hasVisited = localStorage.getItem(visitedKey);\n    const notificationShown = localStorage.getItem(notificationKey);\n\n    if (!hasVisited) {\n      setIsDrawerOpen(true);\n      localStorage.setItem(visitedKey, 'true');\n      localStorage.setItem(openKey, 'true');\n    } else if (wasOpen === 'true') {\n      setIsDrawerOpen(true);\n    } else {\n      setIsDrawerOpen(false);\n    }\n\n    setHasShownNotification(notificationShown === 'true');\n  }, [userKey, configApi, roleLoading, userRole]);\n\n  const openDrawer = () => {\n    // Check if user has eligible items before opening\n    const quickstartItems: QuickstartItemData[] = configApi?.has(\n      'app.quickstart',\n    )\n      ? (configApi.get('app.quickstart') as QuickstartItemData[])\n      : [];\n\n    const eligibleItems =\n      !roleLoading && userRole\n        ? filterQuickstartItemsByRole(quickstartItems, userRole)\n        : [];\n\n    // Only open if user has eligible items\n    if (!roleLoading && eligibleItems.length > 0) {\n      setIsDrawerOpen(true);\n      const openKey = `quickstart-open:${userKey}`;\n      localStorage.setItem(openKey, 'true');\n    }\n  };\n\n  const closeDrawer = () => {\n    setIsDrawerOpen(false);\n    if (!hasShownNotification) {\n      setShowNotification(true);\n      setHasShownNotification(true);\n      const notificationKey = `quickstart-notification-shown:${userKey}`;\n      localStorage.setItem(notificationKey, 'true');\n    }\n    const openKey = `quickstart-open:${userKey}`;\n    localStorage.setItem(openKey, 'false');\n  };\n\n  const toggleDrawer = () => {\n    const next = !isDrawerOpen;\n    setIsDrawerOpen(next);\n    const openKey = `quickstart-open:${userKey}`;\n    localStorage.setItem(openKey, next.toString());\n  };\n\n  const handleNotificationClose = () => setShowNotification(false);\n\n  return (\n    <QuickstartDrawerContext.Provider\n      value={{\n        isDrawerOpen,\n        openDrawer,\n        closeDrawer,\n        toggleDrawer,\n        setDrawerWidth,\n        drawerWidth,\n        userRole,\n        roleLoading,\n      }}\n    >\n      {children}\n      <QuickstartDrawer />\n      <Snackbar\n        sx={{ top: '80px !important' }}\n        open={showNotification}\n        autoHideDuration={10000}\n        onClose={handleNotificationClose}\n        anchorOrigin={{ vertical: 'top', horizontal: 'right' }}\n        message=\"Need help? Visit the Quick Start Guide by clicking on this (?) icon in the header!\"\n        action={\n          <IconButton\n            size=\"small\"\n            aria-label=\"close\"\n            color=\"inherit\"\n            onClick={handleNotificationClose}\n          >\n            <CloseIcon fontSize=\"small\" />\n          </IconButton>\n        }\n      />\n    </QuickstartDrawerContext.Provider>\n  );\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"QuickstartDrawerProvider.esm.js","sources":["../../src/components/QuickstartDrawerProvider.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useEffect, PropsWithChildren, useState } from 'react';\nimport {\n  configApiRef,\n  identityApiRef,\n  useApi,\n} from '@backstage/core-plugin-api';\nimport Snackbar from '@mui/material/Snackbar';\nimport CloseIcon from '@mui/icons-material/Close';\nimport IconButton from '@mui/material/IconButton';\nimport { QuickstartDrawerContext } from './QuickstartDrawerContext';\nimport { QuickstartItemData } from '../types';\nimport { filterQuickstartItemsByRole } from '../utils';\nimport { useQuickstartRole } from '../hooks/useQuickstartRole';\n\n/**\n * Provider component for the Quickstart Drawer functionality\n * @public\n */\nexport const QuickstartDrawerProvider = ({ children }: PropsWithChildren) => {\n  const [isDrawerOpen, setIsDrawerOpen] = useState<boolean>(false);\n  const [showNotification, setShowNotification] = useState(false);\n  const [hasShownNotification, setHasShownNotification] = useState(false);\n  const [drawerWidth, setDrawerWidth] = useState<number>(500);\n  const [userKey, setUserKey] = useState<string>('guest');\n  const identityApi = useApi(identityApiRef);\n  const configApi = useApi(configApiRef);\n\n  // Determine role once at provider level to avoid re-fetching on drawer open/close\n  const { isLoading: roleLoading, userRole } = useQuickstartRole();\n\n  // Resolve the current user's identity to scope localStorage keys per user\n  useEffect(() => {\n    let cancelled = false;\n    (async () => {\n      try {\n        const identity = await identityApi.getBackstageIdentity();\n        const ref = identity?.userEntityRef?.toLowerCase() || 'guest';\n        if (!cancelled) setUserKey(ref);\n      } catch (e) {\n        if (!cancelled) setUserKey('guest');\n      }\n    })();\n    return () => {\n      cancelled = true;\n    };\n  }, [identityApi]);\n\n  // Initialize drawer state based on per-user keys and only when quickstarts exist\n  useEffect(() => {\n    if (!userKey) return;\n\n    // Determine if there are any quickstart items configured globally\n    const hasAnyQuickstarts = (() => {\n      try {\n        if (!configApi?.has('app.quickstart')) return false;\n        const items = configApi.get('app.quickstart') as unknown;\n        return Array.isArray(items) && items.length > 0;\n      } catch {\n        return false;\n      }\n    })();\n\n    const openKey = `quickstart-open:${userKey}`;\n    const visitedKey = `quickstart-visited:${userKey}`;\n    const notificationKey = `quickstart-notification-shown:${userKey}`;\n\n    // If no quickstarts are configured, ensure the drawer is closed and don't mark as visited\n    if (!hasAnyQuickstarts) {\n      setIsDrawerOpen(false);\n      // Avoid persisting visited so future addition of items can auto-open\n      localStorage.setItem(openKey, 'false');\n      return;\n    }\n\n    // Check if user has any eligible quickstart items\n    const quickstartItems: QuickstartItemData[] = configApi?.has(\n      'app.quickstart',\n    )\n      ? (configApi.get('app.quickstart') as QuickstartItemData[])\n      : [];\n\n    const eligibleItems =\n      !roleLoading && userRole\n        ? filterQuickstartItemsByRole(quickstartItems, userRole)\n        : [];\n\n    // If user has no eligible items, close the drawer and don't mark as visited\n    if (!roleLoading && eligibleItems.length === 0) {\n      setIsDrawerOpen(false);\n      localStorage.setItem(openKey, 'false');\n      return;\n    }\n\n    // Only proceed with drawer logic if user has eligible items\n    const wasOpen = localStorage.getItem(openKey);\n    const hasVisited = localStorage.getItem(visitedKey);\n    const notificationShown = localStorage.getItem(notificationKey);\n\n    if (!hasVisited) {\n      setIsDrawerOpen(true);\n      localStorage.setItem(visitedKey, 'true');\n      localStorage.setItem(openKey, 'true');\n    } else if (wasOpen === 'true') {\n      setIsDrawerOpen(true);\n    } else {\n      setIsDrawerOpen(false);\n    }\n\n    setHasShownNotification(notificationShown === 'true');\n  }, [userKey, configApi, roleLoading, userRole]);\n\n  const openDrawer = () => {\n    // Check if user has eligible items before opening\n    const quickstartItems: QuickstartItemData[] = configApi?.has(\n      'app.quickstart',\n    )\n      ? (configApi.get('app.quickstart') as QuickstartItemData[])\n      : [];\n\n    const eligibleItems =\n      !roleLoading && userRole\n        ? filterQuickstartItemsByRole(quickstartItems, userRole)\n        : [];\n\n    // Only open if user has eligible items\n    if (!roleLoading && eligibleItems.length > 0) {\n      setIsDrawerOpen(true);\n      const openKey = `quickstart-open:${userKey}`;\n      localStorage.setItem(openKey, 'true');\n    }\n  };\n\n  const closeDrawer = () => {\n    setIsDrawerOpen(false);\n    if (!hasShownNotification) {\n      setShowNotification(true);\n      setHasShownNotification(true);\n      const notificationKey = `quickstart-notification-shown:${userKey}`;\n      localStorage.setItem(notificationKey, 'true');\n    }\n    const openKey = `quickstart-open:${userKey}`;\n    localStorage.setItem(openKey, 'false');\n  };\n\n  const toggleDrawer = () => {\n    const next = !isDrawerOpen;\n    setIsDrawerOpen(next);\n    const openKey = `quickstart-open:${userKey}`;\n    localStorage.setItem(openKey, next.toString());\n  };\n\n  const handleNotificationClose = () => setShowNotification(false);\n\n  return (\n    <QuickstartDrawerContext.Provider\n      value={{\n        isDrawerOpen,\n        openDrawer,\n        closeDrawer,\n        toggleDrawer,\n        setDrawerWidth,\n        drawerWidth,\n        userRole,\n        roleLoading,\n      }}\n    >\n      {children}\n      <Snackbar\n        sx={{ top: '80px !important' }}\n        open={showNotification}\n        autoHideDuration={10000}\n        onClose={handleNotificationClose}\n        anchorOrigin={{ vertical: 'top', horizontal: 'right' }}\n        message=\"Need help? Visit the Quick Start Guide by clicking on this (?) icon in the header!\"\n        action={\n          <IconButton\n            size=\"small\"\n            aria-label=\"close\"\n            color=\"inherit\"\n            onClick={handleNotificationClose}\n          >\n            <CloseIcon fontSize=\"small\" />\n          </IconButton>\n        }\n      />\n    </QuickstartDrawerContext.Provider>\n  );\n};\n"],"names":[],"mappings":"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"}

package/dist/components/QuickstartDrawerStateExposer.esm.js

@@ -0,0 +1,32 @@
+import { useRef, useCallback, useEffect } from 'react';
+import { useQuickstartDrawerContext } from '../hooks/useQuickstartDrawerContext.esm.js';
+
+const QuickstartDrawerStateExposer = ({
+  onStateChange
+}) => {
+  const { isDrawerOpen, drawerWidth, setDrawerWidth, closeDrawer } = useQuickstartDrawerContext();
+  const closeDrawerRef = useRef(closeDrawer);
+  closeDrawerRef.current = closeDrawer;
+  const closeQuickstart = useCallback(() => {
+    closeDrawerRef.current();
+  }, []);
+  useEffect(() => {
+    onStateChange({
+      id: "quickstart",
+      isDrawerOpen,
+      drawerWidth,
+      setDrawerWidth,
+      closeDrawer: closeQuickstart
+    });
+  }, [
+    isDrawerOpen,
+    drawerWidth,
+    setDrawerWidth,
+    onStateChange,
+    closeQuickstart
+  ]);
+  return null;
+};
+
+export { QuickstartDrawerStateExposer };
+//# sourceMappingURL=QuickstartDrawerStateExposer.esm.js.map

package/dist/components/QuickstartDrawerStateExposer.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuickstartDrawerStateExposer.esm.js","sources":["../../src/components/QuickstartDrawerStateExposer.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { useCallback, useEffect, useRef } from 'react';\nimport { useQuickstartDrawerContext } from '../hooks/useQuickstartDrawerContext';\n\n/**\n * Partial drawer state exposed to the ApplicationDrawer\n *\n * @public\n */\nexport type DrawerPartialState = {\n  id: string;\n  isDrawerOpen: boolean;\n  drawerWidth: number;\n  setDrawerWidth: (width: number) => void;\n  closeDrawer: () => void;\n};\n\n/**\n * Props for drawer state exposer components\n *\n * @public\n */\nexport type DrawerStateExposerProps = {\n  /**\n   * Callback called whenever the drawer state changes\n   */\n  onStateChange: (state: DrawerPartialState) => void;\n};\n\n/**\n * This exposes Quickstart Drawer's partial context to the ApplicationDrawer\n *\n * It reads the QuickstartDrawerContext and calls the onStateChange callback with the\n * partial state (id, isDrawerOpen, drawerWidth, setDrawerWidth).\n *\n * @public\n */\nexport const QuickstartDrawerStateExposer = ({\n  onStateChange,\n}: DrawerStateExposerProps) => {\n  const { isDrawerOpen, drawerWidth, setDrawerWidth, closeDrawer } =\n    useQuickstartDrawerContext();\n\n  const closeDrawerRef = useRef(closeDrawer);\n  closeDrawerRef.current = closeDrawer;\n\n  const closeQuickstart = useCallback(() => {\n    closeDrawerRef.current();\n  }, []);\n\n  useEffect(() => {\n    onStateChange({\n      id: 'quickstart',\n      isDrawerOpen,\n      drawerWidth,\n      setDrawerWidth,\n      closeDrawer: closeQuickstart,\n    });\n  }, [\n    isDrawerOpen,\n    drawerWidth,\n    setDrawerWidth,\n    onStateChange,\n    closeQuickstart,\n  ]);\n\n  return null;\n};\n"],"names":[],"mappings":";;;AAoDO,MAAM,+BAA+B,CAAC;AAAA,EAC3C;AACF,CAA+B,KAAA;AAC7B,EAAA,MAAM,EAAE,YAAc,EAAA,WAAA,EAAa,cAAgB,EAAA,WAAA,KACjD,0BAA2B,EAAA;AAE7B,EAAM,MAAA,cAAA,GAAiB,OAAO,WAAW,CAAA;AACzC,EAAA,cAAA,CAAe,OAAU,GAAA,WAAA;AAEzB,EAAM,MAAA,eAAA,GAAkB,YAAY,MAAM;AACxC,IAAA,cAAA,CAAe,OAAQ,EAAA;AAAA,GACzB,EAAG,EAAE,CAAA;AAEL,EAAA,SAAA,CAAU,MAAM;AACd,IAAc,aAAA,CAAA;AAAA,MACZ,EAAI,EAAA,YAAA;AAAA,MACJ,YAAA;AAAA,MACA,WAAA;AAAA,MACA,cAAA;AAAA,MACA,WAAa,EAAA;AAAA,KACd,CAAA;AAAA,GACA,EAAA;AAAA,IACD,YAAA;AAAA,IACA,WAAA;AAAA,IACA,cAAA;AAAA,IACA,aAAA;AAAA,IACA;AAAA,GACD,CAAA;AAED,EAAO,OAAA,IAAA;AACT;;;;"}

package/dist/index.d.ts

@@ -1,10 +1,43 @@
 /// <reference types="react" />
-import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
 import { CSSProperties, PropsWithChildren } from 'react';
 export { quickstartTranslationRef, quickstartTranslations } from './alpha.js';
 import '@backstage/core-plugin-api/alpha';
 
+/**
+ * Partial drawer state exposed to the ApplicationDrawer
+ *
+ * @public
+ */
+type DrawerPartialState = {
+    id: string;
+    isDrawerOpen: boolean;
+    drawerWidth: number;
+    setDrawerWidth: (width: number) => void;
+    closeDrawer: () => void;
+};
+/**
+ * Props for drawer state exposer components
+ *
+ * @public
+ */
+type DrawerStateExposerProps = {
+    /**
+     * Callback called whenever the drawer state changes
+     */
+    onStateChange: (state: DrawerPartialState) => void;
+};
+/**
+ * This exposes Quickstart Drawer's partial context to the ApplicationDrawer
+ *
+ * It reads the QuickstartDrawerContext and calls the onStateChange callback with the
+ * partial state (id, isDrawerOpen, drawerWidth, setDrawerWidth).
+ *
+ * @public
+ */
+declare const QuickstartDrawerStateExposer: ({ onStateChange, }: DrawerStateExposerProps) => null;
+
 /**
  * Props for the QuickstartButton component
  * @public
@@ -36,6 +69,12 @@ declare const QuickstartButton: ({ title, style, onClick, }: QuickstartButtonPro
  * @public
  */
 declare const quickstartPlugin: _backstage_core_plugin_api.BackstagePlugin<{}, {}, {}>;
+/**
+ * Quickstart Drawer Content component extension
+ *
+ * @public
+ */
+declare const QuickstartDrawerContent: () => react_jsx_runtime.JSX.Element | null;
 
 /**
  * Call-to-action data for quickstart items
@@ -139,5 +178,5 @@ declare const QuickstartDrawerProvider: ({ children }: PropsWithChildren) => rea
  */
 declare const filterQuickstartItemsByRole: (items: QuickstartItemData[], userRole: string) => QuickstartItemData[];
 
-export { QuickstartButton, QuickstartDrawerProvider, filterQuickstartItemsByRole, quickstartPlugin, useQuickstartDrawerContext };
-export type { QuickstartButtonProps, QuickstartDrawerContextType, QuickstartItemCtaData, QuickstartItemData, UserRole };
+export { QuickstartButton, QuickstartDrawerContent, QuickstartDrawerProvider, QuickstartDrawerStateExposer, filterQuickstartItemsByRole, quickstartPlugin, useQuickstartDrawerContext };
+export type { DrawerPartialState, DrawerStateExposerProps, QuickstartButtonProps, QuickstartDrawerContextType, QuickstartItemCtaData, QuickstartItemData, UserRole };

package/dist/index.esm.js

@@ -1,6 +1,7 @@
 import { unstable_ClassNameGenerator } from '@mui/material/className';
-export { quickstartPlugin } from './plugin.esm.js';
+export { QuickstartDrawerContent, quickstartPlugin } from './plugin.esm.js';
 export { useQuickstartDrawerContext } from './hooks/useQuickstartDrawerContext.esm.js';
+export { QuickstartDrawerStateExposer } from './components/QuickstartDrawerStateExposer.esm.js';
 export { QuickstartButton } from './components/QuickstartButton/QuickstartButton.esm.js';
 export { QuickstartDrawerProvider } from './components/QuickstartDrawerProvider.esm.js';
 export { quickstartTranslations } from './translations/index.esm.js';

package/dist/index.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { unstable_ClassNameGenerator as ClassNameGenerator } from '@mui/material/className';\n\nClassNameGenerator.configure(componentName => {\n  return componentName.startsWith('v5-')\n    ? componentName\n    : `v5-${componentName}`;\n});\n\nexport * from './plugin';\n\nexport { useQuickstartDrawerContext } from './hooks/useQuickstartDrawerContext';\nexport type { QuickstartDrawerContextType } from './components/QuickstartDrawerContext';\n/**\n * @public\n */\nexport type {\n  UserRole,\n  QuickstartItemData,\n  QuickstartItemCtaData,\n} from './types';\nexport { QuickstartButton } from './components/QuickstartButton/QuickstartButton';\nexport type { QuickstartButtonProps } from './components/QuickstartButton/QuickstartButton';\n/**\n * @public\n */\nexport { QuickstartDrawerProvider } from './components/QuickstartDrawerProvider';\n\nexport {\n  quickstartTranslations,\n  quickstartTranslationRef,\n} from './translations';\n\nexport { filterQuickstartItemsByRole } from './utils';\n"],"names":["ClassNameGenerator"],"mappings":";;;;;;;;;AAkBAA,2BAAA,CAAmB,UAAU,CAAiB,aAAA,KAAA;AAC5C,EAAA,OAAO,cAAc,UAAW,CAAA,KAAK,CACjC,GAAA,aAAA,GACA,MAAM,aAAa,CAAA,CAAA;AACzB,CAAC,CAAA"}
+{"version":3,"file":"index.esm.js","sources":["../src/index.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { unstable_ClassNameGenerator as ClassNameGenerator } from '@mui/material/className';\n\nClassNameGenerator.configure(componentName => {\n  return componentName.startsWith('v5-')\n    ? componentName\n    : `v5-${componentName}`;\n});\n\nexport * from './plugin';\n\nexport { useQuickstartDrawerContext } from './hooks/useQuickstartDrawerContext';\nexport type { QuickstartDrawerContextType } from './components/QuickstartDrawerContext';\nexport { QuickstartDrawerStateExposer } from './components/QuickstartDrawerStateExposer';\nexport type {\n  DrawerStateExposerProps,\n  DrawerPartialState,\n} from './components/QuickstartDrawerStateExposer';\n/**\n * @public\n */\nexport type {\n  UserRole,\n  QuickstartItemData,\n  QuickstartItemCtaData,\n} from './types';\nexport { QuickstartButton } from './components/QuickstartButton/QuickstartButton';\nexport type { QuickstartButtonProps } from './components/QuickstartButton/QuickstartButton';\n/**\n * @public\n */\nexport { QuickstartDrawerProvider } from './components/QuickstartDrawerProvider';\n\nexport {\n  quickstartTranslations,\n  quickstartTranslationRef,\n} from './translations';\n\nexport { filterQuickstartItemsByRole } from './utils';\n"],"names":["ClassNameGenerator"],"mappings":";;;;;;;;;;AAkBAA,2BAAA,CAAmB,UAAU,CAAiB,aAAA,KAAA;AAC5C,EAAA,OAAO,cAAc,UAAW,CAAA,KAAK,CACjC,GAAA,aAAA,GACA,MAAM,aAAa,CAAA,CAAA;AACzB,CAAC,CAAA"}

package/dist/plugin.esm.js

@@ -19,6 +19,16 @@ quickstartPlugin.provide(
     }
   })
 );
+const QuickstartDrawerContent = quickstartPlugin.provide(
+  createComponentExtension({
+    name: "QuickstartDrawerContent",
+    component: {
+      lazy: () => import('./components/QuickstartDrawerContent.esm.js').then(
+        (m) => m.QuickstartDrawerContent
+      )
+    }
+  })
+);
 quickstartPlugin.provide(
   createComponentExtension({
     name: "QuickstartButton",
@@ -29,6 +39,16 @@ quickstartPlugin.provide(
     }
   })
 );
+quickstartPlugin.provide(
+  createComponentExtension({
+    name: "QuickstartDrawerStateExposer",
+    component: {
+      lazy: () => import('./components/QuickstartDrawerStateExposer.esm.js').then(
+        (m) => m.QuickstartDrawerStateExposer
+      )
+    }
+  })
+);
 
-export { quickstartPlugin };
+export { QuickstartDrawerContent, quickstartPlugin };
 //# sourceMappingURL=plugin.esm.js.map

package/dist/plugin.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.esm.js","sources":["../src/plugin.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  createComponentExtension,\n  createPlugin,\n} from '@backstage/core-plugin-api';\nimport { PropsWithChildren } from 'react';\nimport { QuickstartButtonProps } from './components/QuickstartButton/QuickstartButton';\nimport { quickstartTranslationRef } from './translations';\n\nexport type { QuickstartButtonProps } from './components/QuickstartButton/QuickstartButton';\n\n/**\n * Quick start plugin\n *\n * @public\n */\nexport const quickstartPlugin = createPlugin({\n  id: 'quickstart',\n  __experimentalTranslations: {\n    availableLanguages: ['en', 'de', 'es', 'fr', 'it', 'ja'],\n    resources: [quickstartTranslationRef],\n  },\n} as any);\n\n/**\n * Quick start drawer provider\n *\n * @public\n */\nexport const QuickstartDrawerProvider: React.ComponentType<PropsWithChildren> =\n  quickstartPlugin.provide(\n    createComponentExtension({\n      name: 'QuickstartDrawerProvider',\n      component: {\n        lazy: () =>\n          import('./components/QuickstartDrawerProvider').then(\n            m => m.QuickstartDrawerProvider,\n          ),\n      },\n    }),\n  );\n\n/**\n * Quick start button for global header help dropdown\n *\n * @public\n */\nexport const QuickstartButton: React.ComponentType<QuickstartButtonProps> =\n  quickstartPlugin.provide(\n    createComponentExtension({\n      name: 'QuickstartButton',\n      component: {\n        lazy: () =>\n          import('./components/QuickstartButton/QuickstartButton').then(\n            m => m.QuickstartButton,\n          ),\n      },\n    }),\n  );\n"],"names":[],"mappings":";;;;AA+BO,MAAM,mBAAmB,YAAa,CAAA;AAAA,EAC3C,EAAI,EAAA,YAAA;AAAA,EACJ,0BAA4B,EAAA;AAAA,IAC1B,oBAAoB,CAAC,IAAA,EAAM,MAAM,IAAM,EAAA,IAAA,EAAM,MAAM,IAAI,CAAA;AAAA,IACvD,SAAA,EAAW,CAAC,wBAAwB;AAAA;AAExC,CAAQ;AAQN,gBAAiB,CAAA,OAAA;AAAA,EACf,wBAAyB,CAAA;AAAA,IACvB,IAAM,EAAA,0BAAA;AAAA,IACN,SAAW,EAAA;AAAA,MACT,IAAM,EAAA,MACJ,OAAO,8CAAuC,CAAE,CAAA,IAAA;AAAA,QAC9C,OAAK,CAAE,CAAA;AAAA;AACT;AACJ,GACD;AACH;AAQA,gBAAiB,CAAA,OAAA;AAAA,EACf,wBAAyB,CAAA;AAAA,IACvB,IAAM,EAAA,kBAAA;AAAA,IACN,SAAW,EAAA;AAAA,MACT,IAAM,EAAA,MACJ,OAAO,uDAAgD,CAAE,CAAA,IAAA;AAAA,QACvD,OAAK,CAAE,CAAA;AAAA;AACT;AACJ,GACD;AACH;;;;"}
+{"version":3,"file":"plugin.esm.js","sources":["../src/plugin.ts"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  createComponentExtension,\n  createPlugin,\n} from '@backstage/core-plugin-api';\nimport { PropsWithChildren } from 'react';\nimport { QuickstartButtonProps } from './components/QuickstartButton/QuickstartButton';\nimport { quickstartTranslationRef } from './translations';\n\nexport type { QuickstartButtonProps } from './components/QuickstartButton/QuickstartButton';\n\n/**\n * Quick start plugin\n *\n * @public\n */\nexport const quickstartPlugin = createPlugin({\n  id: 'quickstart',\n  __experimentalTranslations: {\n    availableLanguages: ['en', 'de', 'es', 'fr', 'it', 'ja'],\n    resources: [quickstartTranslationRef],\n  },\n} as any);\n\n/**\n * Quick start drawer provider\n *\n * @public\n */\nexport const QuickstartDrawerProvider: React.ComponentType<PropsWithChildren> =\n  quickstartPlugin.provide(\n    createComponentExtension({\n      name: 'QuickstartDrawerProvider',\n      component: {\n        lazy: () =>\n          import('./components/QuickstartDrawerProvider').then(\n            m => m.QuickstartDrawerProvider,\n          ),\n      },\n    }),\n  );\n\n/**\n * Quickstart Drawer Content component extension\n *\n * @public\n */\nexport const QuickstartDrawerContent = quickstartPlugin.provide(\n  createComponentExtension({\n    name: 'QuickstartDrawerContent',\n    component: {\n      lazy: () =>\n        import('./components/QuickstartDrawerContent').then(\n          m => m.QuickstartDrawerContent,\n        ),\n    },\n  }),\n);\n\n/**\n * Quick start button for global header help dropdown\n *\n * @public\n */\nexport const QuickstartButton: React.ComponentType<QuickstartButtonProps> =\n  quickstartPlugin.provide(\n    createComponentExtension({\n      name: 'QuickstartButton',\n      component: {\n        lazy: () =>\n          import('./components/QuickstartButton/QuickstartButton').then(\n            m => m.QuickstartButton,\n          ),\n      },\n    }),\n  );\n\n/**\n * Quickstart Drawer State Exposer exposes its drawer state\n *\n * @public\n */\nexport const QuickstartDrawerStateExposer = quickstartPlugin.provide(\n  createComponentExtension({\n    name: 'QuickstartDrawerStateExposer',\n    component: {\n      lazy: () =>\n        import('./components/QuickstartDrawerStateExposer').then(\n          m => m.QuickstartDrawerStateExposer,\n        ),\n    },\n  }),\n);\n"],"names":[],"mappings":";;;;AA+BO,MAAM,mBAAmB,YAAa,CAAA;AAAA,EAC3C,EAAI,EAAA,YAAA;AAAA,EACJ,0BAA4B,EAAA;AAAA,IAC1B,oBAAoB,CAAC,IAAA,EAAM,MAAM,IAAM,EAAA,IAAA,EAAM,MAAM,IAAI,CAAA;AAAA,IACvD,SAAA,EAAW,CAAC,wBAAwB;AAAA;AAExC,CAAQ;AAQN,gBAAiB,CAAA,OAAA;AAAA,EACf,wBAAyB,CAAA;AAAA,IACvB,IAAM,EAAA,0BAAA;AAAA,IACN,SAAW,EAAA;AAAA,MACT,IAAM,EAAA,MACJ,OAAO,8CAAuC,CAAE,CAAA,IAAA;AAAA,QAC9C,OAAK,CAAE,CAAA;AAAA;AACT;AACJ,GACD;AACH;AAOK,MAAM,0BAA0B,gBAAiB,CAAA,OAAA;AAAA,EACtD,wBAAyB,CAAA;AAAA,IACvB,IAAM,EAAA,yBAAA;AAAA,IACN,SAAW,EAAA;AAAA,MACT,IAAM,EAAA,MACJ,OAAO,6CAAsC,CAAE,CAAA,IAAA;AAAA,QAC7C,OAAK,CAAE,CAAA;AAAA;AACT;AACJ,GACD;AACH;AAQE,gBAAiB,CAAA,OAAA;AAAA,EACf,wBAAyB,CAAA;AAAA,IACvB,IAAM,EAAA,kBAAA;AAAA,IACN,SAAW,EAAA;AAAA,MACT,IAAM,EAAA,MACJ,OAAO,uDAAgD,CAAE,CAAA,IAAA;AAAA,QACvD,OAAK,CAAE,CAAA;AAAA;AACT;AACJ,GACD;AACH;AAO0C,gBAAiB,CAAA,OAAA;AAAA,EAC3D,wBAAyB,CAAA;AAAA,IACvB,IAAM,EAAA,8BAAA;AAAA,IACN,SAAW,EAAA;AAAA,MACT,IAAM,EAAA,MACJ,OAAO,kDAA2C,CAAE,CAAA,IAAA;AAAA,QAClD,OAAK,CAAE,CAAA;AAAA;AACT;AACJ,GACD;AACH;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@red-hat-developer-hub/backstage-plugin-quickstart",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "license": "Apache-2.0",
   "main": "./dist/index.esm.js",
   "types": "./dist/index.d.ts",

package/dist/components/QuickstartDrawer.esm.js

@@ -1,62 +0,0 @@
-import { jsx } from 'react/jsx-runtime';
-import Drawer from '@mui/material/Drawer';
-import { useApiHolder, configApiRef } from '@backstage/core-plugin-api';
-import { Quickstart } from './Quickstart.esm.js';
-import { useQuickstartDrawerContext } from '../hooks/useQuickstartDrawerContext.esm.js';
-import { filterQuickstartItemsByRole } from '../utils/filterQuickstartItems.esm.js';
-import { useMemo } from 'react';
-
-const QuickstartDrawer = () => {
-  const { isDrawerOpen, closeDrawer, drawerWidth, userRole, roleLoading } = useQuickstartDrawerContext();
-  const apiHolder = useApiHolder();
-  const config = apiHolder.get(configApiRef);
-  const quickstartItems = useMemo(() => {
-    return config?.has("app.quickstart") ? config.get("app.quickstart") : [];
-  }, [config]);
-  const eligibleItems = useMemo(() => {
-    return !roleLoading && userRole ? filterQuickstartItemsByRole(quickstartItems, userRole) : [];
-  }, [roleLoading, userRole, quickstartItems]);
-  const filteredItems = useMemo(() => {
-    return isDrawerOpen ? eligibleItems : [];
-  }, [isDrawerOpen, eligibleItems]);
-  if (quickstartItems.length === 0) {
-    return null;
-  }
-  if (!roleLoading && eligibleItems.length === 0) {
-    return null;
-  }
-  return /* @__PURE__ */ jsx(
-    Drawer,
-    {
-      sx: {
-        "& .v5-MuiDrawer-paper": {
-          width: drawerWidth,
-          boxSizing: "border-box",
-          backgroundColor: (theme) => `${theme.palette?.rhdh?.general.sidebarBackgroundColor}`,
-          justifyContent: "space-between"
-        },
-        // Only apply header offset when global header exists
-        "body:has(#global-header) &": {
-          "& .v5-MuiDrawer-paper": {
-            top: "64px !important",
-            height: "calc(100vh - 64px) !important"
-          }
-        }
-      },
-      variant: "persistent",
-      anchor: "right",
-      open: isDrawerOpen,
-      children: /* @__PURE__ */ jsx(
-        Quickstart,
-        {
-          quickstartItems: filteredItems,
-          handleDrawerClose: closeDrawer,
-          isLoading: roleLoading
-        }
-      )
-    }
-  );
-};
-
-export { QuickstartDrawer };
-//# sourceMappingURL=QuickstartDrawer.esm.js.map

package/dist/components/QuickstartDrawer.esm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"QuickstartDrawer.esm.js","sources":["../../src/components/QuickstartDrawer.tsx"],"sourcesContent":["/*\n * Copyright Red Hat, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport Drawer from '@mui/material/Drawer';\nimport { ThemeConfig } from '@red-hat-developer-hub/backstage-plugin-theme';\nimport { configApiRef, useApiHolder } from '@backstage/core-plugin-api';\nimport { Quickstart } from './Quickstart';\nimport { useQuickstartDrawerContext } from '../hooks/useQuickstartDrawerContext';\nimport { QuickstartItemData } from '../types';\nimport { filterQuickstartItemsByRole } from '../utils';\n// Role is now provided through context to avoid re-fetching on drawer open/close\nimport { useMemo } from 'react';\n\nexport const QuickstartDrawer = () => {\n  const { isDrawerOpen, closeDrawer, drawerWidth, userRole, roleLoading } =\n    useQuickstartDrawerContext();\n\n  const apiHolder = useApiHolder();\n  const config = apiHolder.get(configApiRef);\n  const quickstartItems: QuickstartItemData[] = useMemo(() => {\n    return config?.has('app.quickstart')\n      ? (config.get('app.quickstart') as QuickstartItemData[])\n      : [];\n  }, [config]);\n\n  // Items available to the user based on role from context\n  const eligibleItems = useMemo(() => {\n    return !roleLoading && userRole\n      ? filterQuickstartItemsByRole(quickstartItems, userRole)\n      : [];\n  }, [roleLoading, userRole, quickstartItems]);\n\n  // Only expose items to the body when drawer is open to avoid re-renders during close\n  const filteredItems = useMemo(() => {\n    return isDrawerOpen ? eligibleItems : [];\n  }, [isDrawerOpen, eligibleItems]);\n\n  // No auto-open logic here; the provider initializes per user (visited/open)\n\n  // If no quickstart items are configured at all, don't render the drawer to avoid reserving space\n  if (quickstartItems.length === 0) {\n    return null;\n  }\n\n  // If there are no items for the user, hide the drawer entirely\n  if (!roleLoading && eligibleItems.length === 0) {\n    return null;\n  }\n\n  // No role-fetching or filtering here when the drawer is closed\n\n  return (\n    <Drawer\n      sx={{\n        '& .v5-MuiDrawer-paper': {\n          width: drawerWidth,\n          boxSizing: 'border-box',\n          backgroundColor: theme =>\n            `${\n              (theme as ThemeConfig).palette?.rhdh?.general\n                .sidebarBackgroundColor\n            }`,\n          justifyContent: 'space-between',\n        },\n        // Only apply header offset when global header exists\n        'body:has(#global-header) &': {\n          '& .v5-MuiDrawer-paper': {\n            top: '64px !important',\n            height: 'calc(100vh - 64px) !important',\n          },\n        },\n      }}\n      variant=\"persistent\"\n      anchor=\"right\"\n      open={isDrawerOpen}\n    >\n      <Quickstart\n        quickstartItems={filteredItems}\n        handleDrawerClose={closeDrawer}\n        isLoading={roleLoading}\n      />\n    </Drawer>\n  );\n};\n"],"names":[],"mappings":";;;;;;;;AA0BO,MAAM,mBAAmB,MAAM;AACpC,EAAA,MAAM,EAAE,YAAc,EAAA,WAAA,EAAa,aAAa,QAAU,EAAA,WAAA,KACxD,0BAA2B,EAAA;AAE7B,EAAA,MAAM,YAAY,YAAa,EAAA;AAC/B,EAAM,MAAA,MAAA,GAAS,SAAU,CAAA,GAAA,CAAI,YAAY,CAAA;AACzC,EAAM,MAAA,eAAA,GAAwC,QAAQ,MAAM;AAC1D,IAAO,OAAA,MAAA,EAAQ,IAAI,gBAAgB,CAAA,GAC9B,OAAO,GAAI,CAAA,gBAAgB,IAC5B,EAAC;AAAA,GACP,EAAG,CAAC,MAAM,CAAC,CAAA;AAGX,EAAM,MAAA,aAAA,GAAgB,QAAQ,MAAM;AAClC,IAAA,OAAO,CAAC,WAAe,IAAA,QAAA,GACnB,4BAA4B,eAAiB,EAAA,QAAQ,IACrD,EAAC;AAAA,GACJ,EAAA,CAAC,WAAa,EAAA,QAAA,EAAU,eAAe,CAAC,CAAA;AAG3C,EAAM,MAAA,aAAA,GAAgB,QAAQ,MAAM;AAClC,IAAO,OAAA,YAAA,GAAe,gBAAgB,EAAC;AAAA,GACtC,EAAA,CAAC,YAAc,EAAA,aAAa,CAAC,CAAA;AAKhC,EAAI,IAAA,eAAA,CAAgB,WAAW,CAAG,EAAA;AAChC,IAAO,OAAA,IAAA;AAAA;AAIT,EAAA,IAAI,CAAC,WAAA,IAAe,aAAc,CAAA,MAAA,KAAW,CAAG,EAAA;AAC9C,IAAO,OAAA,IAAA;AAAA;AAKT,EACE,uBAAA,GAAA;AAAA,IAAC,MAAA;AAAA,IAAA;AAAA,MACC,EAAI,EAAA;AAAA,QACF,uBAAyB,EAAA;AAAA,UACvB,KAAO,EAAA,WAAA;AAAA,UACP,SAAW,EAAA,YAAA;AAAA,UACX,iBAAiB,CACf,KAAA,KAAA,CAAA,EACG,MAAsB,OAAS,EAAA,IAAA,EAAM,QACnC,sBACL,CAAA,CAAA;AAAA,UACF,cAAgB,EAAA;AAAA,SAClB;AAAA;AAAA,QAEA,4BAA8B,EAAA;AAAA,UAC5B,uBAAyB,EAAA;AAAA,YACvB,GAAK,EAAA,iBAAA;AAAA,YACL,MAAQ,EAAA;AAAA;AACV;AACF,OACF;AAAA,MACA,OAAQ,EAAA,YAAA;AAAA,MACR,MAAO,EAAA,OAAA;AAAA,MACP,IAAM,EAAA,YAAA;AAAA,MAEN,QAAA,kBAAA,GAAA;AAAA,QAAC,UAAA;AAAA,QAAA;AAAA,UACC,eAAiB,EAAA,aAAA;AAAA,UACjB,iBAAmB,EAAA,WAAA;AAAA,UACnB,SAAW,EAAA;AAAA;AAAA;AACb;AAAA,GACF;AAEJ;;;;"}