@red-hat-developer-hub/backstage-plugin-quickstart 1.6.0 → 1.6.2

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @red-hat-developer-hub/backstage-plugin-quickstart
 
+## 1.6.2
+
+### Patch Changes
+
+- f1b0f1a: Add package.json exports configuration for alpha module support.
+
+  - Add exports field to support importing from alpha module
+  - Add typesVersions configuration for TypeScript support
+
+## 1.6.1
+
+### Patch Changes
+
+- def4673: Fixes the issue where the quickstart drawer was reserving space for users with no eligible items
+
+  - Centralize role determination at provider level to avoid re-fetching on drawer open/close
+  - Add multi-layer protection to prevent empty drawer space when user has no eligible quickstart items
+  - Remove complex caching logic from useQuickstartRole hook for cleaner implementation
+  - Update components to use role from context instead of calling hook directly
+  - Fix test mocks to work with new context-based architecture
+
+  This resolves the issue where the quickstart drawer would open an empty space when the current user has no quickstart items configured for their role.
+
 ## 1.6.0
 
 ### Minor Changes

package/dist/alpha.d.ts

@@ -0,0 +1,66 @@
+import * as _backstage_core_plugin_api_alpha from '@backstage/core-plugin-api/alpha';
+
+/**
+ * Translation reference for Quickstart plugin
+ * @public
+ */
+declare const quickstartTranslationRef: _backstage_core_plugin_api_alpha.TranslationRef<"plugin.quickstart", {
+    readonly "button.quickstart": string;
+    readonly "button.openQuickstartGuide": string;
+    readonly "button.closeDrawer": string;
+    readonly "button.gotIt": string;
+    readonly "footer.progress": string;
+    readonly "footer.hide": string;
+    readonly "footer.notStarted": string;
+    readonly "header.title": string;
+    readonly "header.subtitle": string;
+    readonly "content.emptyState.title": string;
+    readonly "item.expandAriaLabel": string;
+    readonly "item.collapseAriaLabel": string;
+    readonly "item.expandButtonAriaLabel": string;
+    readonly "item.collapseButtonAriaLabel": string;
+    readonly "steps.setupAuthentication.title": string;
+    readonly "steps.setupAuthentication.description": string;
+    readonly "steps.setupAuthentication.ctaTitle": string;
+    readonly "steps.configureRbac.title": string;
+    readonly "steps.configureRbac.description": string;
+    readonly "steps.configureRbac.ctaTitle": string;
+    readonly "steps.configureGit.title": string;
+    readonly "steps.configureGit.description": string;
+    readonly "steps.configureGit.ctaTitle": string;
+    readonly "steps.managePlugins.title": string;
+    readonly "steps.managePlugins.description": string;
+    readonly "steps.managePlugins.ctaTitle": string;
+    readonly "steps.importApplication.title": string;
+    readonly "steps.importApplication.description": string;
+    readonly "steps.importApplication.ctaTitle": string;
+    readonly "steps.learnAboutCatalog.title": string;
+    readonly "steps.learnAboutCatalog.description": string;
+    readonly "steps.learnAboutCatalog.ctaTitle": string;
+    readonly "steps.exploreSelfServiceTemplates.title": string;
+    readonly "steps.exploreSelfServiceTemplates.description": string;
+    readonly "steps.exploreSelfServiceTemplates.ctaTitle": string;
+    readonly "steps.findAllLearningPaths.title": string;
+    readonly "steps.findAllLearningPaths.description": string;
+    readonly "steps.findAllLearningPaths.ctaTitle": string;
+    readonly "dev.pageTitle": string;
+    readonly "dev.pageDescription": string;
+    readonly "dev.drawerControls": string;
+    readonly "dev.currentState": string;
+    readonly "dev.stateOpen": string;
+    readonly "dev.stateClosed": string;
+    readonly "dev.instructions": string;
+    readonly "dev.step1": string;
+    readonly "dev.step2": string;
+    readonly "dev.step3": string;
+    readonly "dev.step4": string;
+    readonly "dev.step5": string;
+}>;
+
+/**
+ * Translation Resource for Quickstart
+ * @public
+ */
+declare const quickstartTranslations: _backstage_core_plugin_api_alpha.TranslationResource<"plugin.quickstart">;
+
+export { quickstartTranslationRef, quickstartTranslations };

package/dist/alpha.esm.js

@@ -0,0 +1,3 @@
+export { quickstartTranslations } from './translations/index.esm.js';
+export { quickstartTranslationRef } from './translations/ref.esm.js';
+//# sourceMappingURL=alpha.esm.js.map

package/dist/alpha.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alpha.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/QuickstartButton/QuickstartButton.esm.js

@@ -9,7 +9,6 @@ import { useQuickstartDrawerContext } from '../../hooks/useQuickstartDrawerConte
 import { useTranslation } from '../../hooks/useTranslation.esm.js';
 import { useApiHolder, configApiRef } from '@backstage/core-plugin-api';
 import { filterQuickstartItemsByRole } from '../../utils/filterQuickstartItems.esm.js';
-import { useQuickstartRole } from '../../hooks/useQuickstartRole.esm.js';
 
 const QuickstartButton = ({
   title,
@@ -18,19 +17,18 @@ const QuickstartButton = ({
   }
 }) => {
   const { t } = useTranslation();
-  const { toggleDrawer } = useQuickstartDrawerContext();
+  const { toggleDrawer, userRole, roleLoading } = useQuickstartDrawerContext();
   const theme = useTheme();
   const apiHolder = useApiHolder();
   const config = apiHolder.get(configApiRef);
   const quickstartItems = config?.has("app.quickstart") ? config.get("app.quickstart") : [];
-  const { isLoading, userRole } = useQuickstartRole();
-  const filteredItems = !isLoading && userRole ? filterQuickstartItemsByRole(quickstartItems, userRole) : [];
+  const filteredItems = !roleLoading && userRole ? filterQuickstartItemsByRole(quickstartItems, userRole) : [];
   const defaultTitle = t("button.quickstart");
   const handleClick = useCallback(() => {
     toggleDrawer();
     onClick();
   }, [toggleDrawer, onClick]);
-  if (!isLoading && filteredItems.length === 0) {
+  if (!roleLoading && filteredItems.length === 0) {
     return null;
   }
   return /* @__PURE__ */ jsx(

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

@@ -1 +1 @@
-{"version":3,"file":"QuickstartButton.esm.js","sources":["../../../src/components/QuickstartButton/QuickstartButton.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 { CSSProperties, useCallback } from 'react';\nimport MenuItem from '@mui/material/MenuItem';\nimport Box from '@mui/material/Box';\nimport Typography from '@mui/material/Typography';\nimport { useTheme } from '@mui/material/styles';\nimport WavingHandIcon from '@mui/icons-material/WavingHandOutlined';\nimport { useQuickstartDrawerContext } from '../../hooks/useQuickstartDrawerContext';\nimport { useTranslation } from '../../hooks/useTranslation';\nimport { configApiRef, useApiHolder } from '@backstage/core-plugin-api';\nimport { QuickstartItemData } from '../../types';\nimport { filterQuickstartItemsByRole } from '../../utils';\nimport { useQuickstartRole } from '../../hooks/useQuickstartRole';\n\n/**\n * Props for the QuickstartButton component\n * @public\n */\nexport interface QuickstartButtonProps {\n  /**\n   * The title text to display in the button\n   * @defaultValue 'Quick start'\n   */\n  title?: string;\n  /**\n   * Custom CSS styles to apply to the button\n   */\n  style?: CSSProperties;\n  /**\n   * Optional callback function to execute when the button is clicked\n   */\n  onClick?: () => void;\n}\n\n/**\n * @public\n */\nexport const QuickstartButton = ({\n  title,\n  style,\n  onClick = () => {},\n}: QuickstartButtonProps) => {\n  // All hooks must be called at the top level, before any early returns\n  const { t } = useTranslation();\n  const { toggleDrawer } = useQuickstartDrawerContext();\n  const theme = useTheme();\n\n  // Check if there are any quickstart items available for the current user\n  const apiHolder = useApiHolder();\n  const config = apiHolder.get(configApiRef);\n  const quickstartItems: QuickstartItemData[] = config?.has('app.quickstart')\n    ? config.get('app.quickstart')\n    : [];\n\n  const { isLoading, userRole } = useQuickstartRole();\n  const filteredItems =\n    !isLoading && userRole\n      ? filterQuickstartItemsByRole(quickstartItems, userRole)\n      : [];\n\n  const defaultTitle = t('button.quickstart');\n\n  const handleClick = useCallback(() => {\n    toggleDrawer();\n    onClick();\n  }, [toggleDrawer, onClick]);\n\n  // Hide the button if there are no quickstart items for the user\n  if (!isLoading && filteredItems.length === 0) {\n    return null;\n  }\n\n  return (\n    <MenuItem\n      sx={{\n        width: '100%',\n        color: 'inherit',\n        ...style,\n      }}\n      data-testid=\"quickstart-button\"\n      onClick={handleClick}\n    >\n      <Box\n        sx={{\n          display: 'flex',\n          alignItems: 'center',\n          justifyContent: 'space-between',\n          margin: '8px 0',\n          color: 'inherit',\n          width: '100%',\n        }}\n      >\n        <Box sx={{ display: 'flex', alignItems: 'center' }}>\n          <WavingHandIcon\n            sx={{\n              fontSize: 20,\n              marginRight: '0.5rem',\n              flexShrink: 0,\n              display: 'flex',\n              alignItems: 'center',\n              color:\n                theme.palette.mode === 'dark'\n                  ? theme.palette.text.primary\n                  : theme.palette.text.disabled,\n            }}\n          />\n          <Box\n            sx={{\n              display: 'flex',\n              flexDirection: 'column',\n              justifyContent: 'center',\n            }}\n          >\n            <Typography variant=\"body2\" color={theme.palette.text.primary}>\n              {title || defaultTitle}\n            </Typography>\n          </Box>\n        </Box>\n      </Box>\n    </MenuItem>\n  );\n};\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"QuickstartButton.esm.js","sources":["../../../src/components/QuickstartButton/QuickstartButton.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 { CSSProperties, useCallback } from 'react';\nimport MenuItem from '@mui/material/MenuItem';\nimport Box from '@mui/material/Box';\nimport Typography from '@mui/material/Typography';\nimport { useTheme } from '@mui/material/styles';\nimport WavingHandIcon from '@mui/icons-material/WavingHandOutlined';\nimport { useQuickstartDrawerContext } from '../../hooks/useQuickstartDrawerContext';\nimport { useTranslation } from '../../hooks/useTranslation';\nimport { configApiRef, useApiHolder } from '@backstage/core-plugin-api';\nimport { QuickstartItemData } from '../../types';\nimport { filterQuickstartItemsByRole } from '../../utils';\n// Role is now provided through context\n\n/**\n * Props for the QuickstartButton component\n * @public\n */\nexport interface QuickstartButtonProps {\n  /**\n   * The title text to display in the button\n   * @defaultValue 'Quick start'\n   */\n  title?: string;\n  /**\n   * Custom CSS styles to apply to the button\n   */\n  style?: CSSProperties;\n  /**\n   * Optional callback function to execute when the button is clicked\n   */\n  onClick?: () => void;\n}\n\n/**\n * Quickstart button component for the global header help dropdown\n * @public\n */\nexport const QuickstartButton = ({\n  title,\n  style,\n  onClick = () => {},\n}: QuickstartButtonProps) => {\n  // All hooks must be called at the top level, before any early returns\n  const { t } = useTranslation();\n  const { toggleDrawer, userRole, roleLoading } = useQuickstartDrawerContext();\n  const theme = useTheme();\n\n  // Check if there are any quickstart items available for the current user\n  const apiHolder = useApiHolder();\n  const config = apiHolder.get(configApiRef);\n  const quickstartItems: QuickstartItemData[] = config?.has('app.quickstart')\n    ? config.get('app.quickstart')\n    : [];\n\n  const filteredItems =\n    !roleLoading && userRole\n      ? filterQuickstartItemsByRole(quickstartItems, userRole)\n      : [];\n\n  const defaultTitle = t('button.quickstart');\n\n  const handleClick = useCallback(() => {\n    toggleDrawer();\n    onClick();\n  }, [toggleDrawer, onClick]);\n\n  // Hide the button if there are no quickstart items for the user\n  if (!roleLoading && filteredItems.length === 0) {\n    return null;\n  }\n\n  return (\n    <MenuItem\n      sx={{\n        width: '100%',\n        color: 'inherit',\n        ...style,\n      }}\n      data-testid=\"quickstart-button\"\n      onClick={handleClick}\n    >\n      <Box\n        sx={{\n          display: 'flex',\n          alignItems: 'center',\n          justifyContent: 'space-between',\n          margin: '8px 0',\n          color: 'inherit',\n          width: '100%',\n        }}\n      >\n        <Box sx={{ display: 'flex', alignItems: 'center' }}>\n          <WavingHandIcon\n            sx={{\n              fontSize: 20,\n              marginRight: '0.5rem',\n              flexShrink: 0,\n              display: 'flex',\n              alignItems: 'center',\n              color:\n                theme.palette.mode === 'dark'\n                  ? theme.palette.text.primary\n                  : theme.palette.text.disabled,\n            }}\n          />\n          <Box\n            sx={{\n              display: 'flex',\n              flexDirection: 'column',\n              justifyContent: 'center',\n            }}\n          >\n            <Typography variant=\"body2\" color={theme.palette.text.primary}>\n              {title || defaultTitle}\n            </Typography>\n          </Box>\n        </Box>\n      </Box>\n    </MenuItem>\n  );\n};\n"],"names":[],"mappings":";;;;;;;;;;;;AAqDO,MAAM,mBAAmB,CAAC;AAAA,EAC/B,KAAA;AAAA,EACA,KAAA;AAAA,EACA,UAAU,MAAM;AAAA;AAClB,CAA6B,KAAA;AAE3B,EAAM,MAAA,EAAE,CAAE,EAAA,GAAI,cAAe,EAAA;AAC7B,EAAA,MAAM,EAAE,YAAA,EAAc,QAAU,EAAA,WAAA,KAAgB,0BAA2B,EAAA;AAC3E,EAAA,MAAM,QAAQ,QAAS,EAAA;AAGvB,EAAA,MAAM,YAAY,YAAa,EAAA;AAC/B,EAAM,MAAA,MAAA,GAAS,SAAU,CAAA,GAAA,CAAI,YAAY,CAAA;AACzC,EAAM,MAAA,eAAA,GAAwC,QAAQ,GAAI,CAAA,gBAAgB,IACtE,MAAO,CAAA,GAAA,CAAI,gBAAgB,CAAA,GAC3B,EAAC;AAEL,EAAM,MAAA,aAAA,GACJ,CAAC,WAAe,IAAA,QAAA,GACZ,4BAA4B,eAAiB,EAAA,QAAQ,IACrD,EAAC;AAEP,EAAM,MAAA,YAAA,GAAe,EAAE,mBAAmB,CAAA;AAE1C,EAAM,MAAA,WAAA,GAAc,YAAY,MAAM;AACpC,IAAa,YAAA,EAAA;AACb,IAAQ,OAAA,EAAA;AAAA,GACP,EAAA,CAAC,YAAc,EAAA,OAAO,CAAC,CAAA;AAG1B,EAAA,IAAI,CAAC,WAAA,IAAe,aAAc,CAAA,MAAA,KAAW,CAAG,EAAA;AAC9C,IAAO,OAAA,IAAA;AAAA;AAGT,EACE,uBAAA,GAAA;AAAA,IAAC,QAAA;AAAA,IAAA;AAAA,MACC,EAAI,EAAA;AAAA,QACF,KAAO,EAAA,MAAA;AAAA,QACP,KAAO,EAAA,SAAA;AAAA,QACP,GAAG;AAAA,OACL;AAAA,MACA,aAAY,EAAA,mBAAA;AAAA,MACZ,OAAS,EAAA,WAAA;AAAA,MAET,QAAA,kBAAA,GAAA;AAAA,QAAC,GAAA;AAAA,QAAA;AAAA,UACC,EAAI,EAAA;AAAA,YACF,OAAS,EAAA,MAAA;AAAA,YACT,UAAY,EAAA,QAAA;AAAA,YACZ,cAAgB,EAAA,eAAA;AAAA,YAChB,MAAQ,EAAA,OAAA;AAAA,YACR,KAAO,EAAA,SAAA;AAAA,YACP,KAAO,EAAA;AAAA,WACT;AAAA,UAEA,QAAA,kBAAA,IAAA,CAAC,OAAI,EAAI,EAAA,EAAE,SAAS,MAAQ,EAAA,UAAA,EAAY,UACtC,EAAA,QAAA,EAAA;AAAA,4BAAA,GAAA;AAAA,cAAC,cAAA;AAAA,cAAA;AAAA,gBACC,EAAI,EAAA;AAAA,kBACF,QAAU,EAAA,EAAA;AAAA,kBACV,WAAa,EAAA,QAAA;AAAA,kBACb,UAAY,EAAA,CAAA;AAAA,kBACZ,OAAS,EAAA,MAAA;AAAA,kBACT,UAAY,EAAA,QAAA;AAAA,kBACZ,KAAA,EACE,KAAM,CAAA,OAAA,CAAQ,IAAS,KAAA,MAAA,GACnB,KAAM,CAAA,OAAA,CAAQ,IAAK,CAAA,OAAA,GACnB,KAAM,CAAA,OAAA,CAAQ,IAAK,CAAA;AAAA;AAC3B;AAAA,aACF;AAAA,4BACA,GAAA;AAAA,cAAC,GAAA;AAAA,cAAA;AAAA,gBACC,EAAI,EAAA;AAAA,kBACF,OAAS,EAAA,MAAA;AAAA,kBACT,aAAe,EAAA,QAAA;AAAA,kBACf,cAAgB,EAAA;AAAA,iBAClB;AAAA,gBAEA,QAAA,kBAAA,GAAA,CAAC,UAAW,EAAA,EAAA,OAAA,EAAQ,OAAQ,EAAA,KAAA,EAAO,MAAM,OAAQ,CAAA,IAAA,CAAK,OACnD,EAAA,QAAA,EAAA,KAAA,IAAS,YACZ,EAAA;AAAA;AAAA;AACF,WACF,EAAA;AAAA;AAAA;AACF;AAAA,GACF;AAEJ;;;;"}

package/dist/components/QuickstartDrawer.esm.js

@@ -4,27 +4,25 @@ 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 { useQuickstartRole } from '../hooks/useQuickstartRole.esm.js';
 import { useMemo } from 'react';
 
 const QuickstartDrawer = () => {
-  const { isDrawerOpen, closeDrawer, drawerWidth } = useQuickstartDrawerContext();
+  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 { isLoading, userRole } = useQuickstartRole();
   const eligibleItems = useMemo(() => {
-    return !isLoading && userRole ? filterQuickstartItemsByRole(quickstartItems, userRole) : [];
-  }, [isLoading, userRole, quickstartItems]);
+    return !roleLoading && userRole ? filterQuickstartItemsByRole(quickstartItems, userRole) : [];
+  }, [roleLoading, userRole, quickstartItems]);
   const filteredItems = useMemo(() => {
     return isDrawerOpen ? eligibleItems : [];
   }, [isDrawerOpen, eligibleItems]);
   if (quickstartItems.length === 0) {
     return null;
   }
-  if (!isLoading && eligibleItems.length === 0) {
+  if (!roleLoading && eligibleItems.length === 0) {
     return null;
   }
   return /* @__PURE__ */ jsx(
@@ -53,7 +51,7 @@ const QuickstartDrawer = () => {
         {
           quickstartItems: filteredItems,
           handleDrawerClose: closeDrawer,
-          isLoading
+          isLoading: roleLoading
         }
       )
     }

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

@@ -1 +1 @@
-{"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';\nimport { useQuickstartRole } from '../hooks/useQuickstartRole';\nimport { useMemo } from 'react';\n\nexport const QuickstartDrawer = () => {\n  const { isDrawerOpen, closeDrawer, drawerWidth } =\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  const { isLoading, userRole } = useQuickstartRole();\n\n  // Items available to the user based on cached/derived role\n  const eligibleItems = useMemo(() => {\n    return !isLoading && userRole\n      ? filterQuickstartItemsByRole(quickstartItems, userRole)\n      : [];\n  }, [isLoading, 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 (!isLoading && 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={isLoading}\n      />\n    </Drawer>\n  );\n};\n"],"names":[],"mappings":";;;;;;;;;AA0BO,MAAM,mBAAmB,MAAM;AACpC,EAAA,MAAM,EAAE,YAAA,EAAc,WAAa,EAAA,WAAA,KACjC,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;AAEX,EAAA,MAAM,EAAE,SAAA,EAAW,QAAS,EAAA,GAAI,iBAAkB,EAAA;AAGlD,EAAM,MAAA,aAAA,GAAgB,QAAQ,MAAM;AAClC,IAAA,OAAO,CAAC,SAAa,IAAA,QAAA,GACjB,4BAA4B,eAAiB,EAAA,QAAQ,IACrD,EAAC;AAAA,GACJ,EAAA,CAAC,SAAW,EAAA,QAAA,EAAU,eAAe,CAAC,CAAA;AAGzC,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,SAAA,IAAa,aAAc,CAAA,MAAA,KAAW,CAAG,EAAA;AAC5C,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;AAAA;AAAA;AACF;AAAA,GACF;AAEJ;;;;"}
+{"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;;;;"}

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

@@ -1 +1 @@
-{"version":3,"file":"QuickstartDrawerContext.esm.js","sources":["../../src/components/QuickstartDrawerContext.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 { createContext } from 'react';\n\n/**\n * Type for QuickstartDrawerContext\n *\n *  @public\n */\nexport interface QuickstartDrawerContextType {\n  /**\n   * The prop to check if the drawer is open\n   */\n  isDrawerOpen: boolean;\n  /**\n   * The function to open the drawer\n   */\n  openDrawer: () => void;\n  /**\n   * The function to close the drawer\n   */\n  closeDrawer: () => void;\n  /**\n   * The function to toggle the drawer state\n   */\n  toggleDrawer: () => void;\n  /**\n   * The prop for drawer width\n   */\n  drawerWidth: number;\n  /**\n   * The function for setting the drawer width\n   */\n  setDrawerWidth: React.Dispatch<React.SetStateAction<number>>;\n}\n\n/**\n * @public\n */\nexport const QuickstartDrawerContext = createContext<\n  QuickstartDrawerContextType | undefined\n>(undefined);\n"],"names":[],"mappings":";;AAqDa,MAAA,uBAAA,GAA0B,cAErC,MAAS;;;;"}
+{"version":3,"file":"QuickstartDrawerContext.esm.js","sources":["../../src/components/QuickstartDrawerContext.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 { createContext } from 'react';\nimport { UserRole } from '../types';\n\n/**\n * Type for QuickstartDrawerContext\n *\n *  @public\n */\nexport interface QuickstartDrawerContextType {\n  /**\n   * The prop to check if the drawer is open\n   */\n  isDrawerOpen: boolean;\n  /**\n   * The function to open the drawer\n   */\n  openDrawer: () => void;\n  /**\n   * The function to close the drawer\n   */\n  closeDrawer: () => void;\n  /**\n   * The function to toggle the drawer state\n   */\n  toggleDrawer: () => void;\n  /**\n   * The prop for drawer width\n   */\n  drawerWidth: number;\n  /**\n   * The function for setting the drawer width\n   */\n  setDrawerWidth: React.Dispatch<React.SetStateAction<number>>;\n  /**\n   * The user's role for quickstart functionality\n   */\n  userRole: UserRole | null;\n  /**\n   * Whether the role is still loading\n   */\n  roleLoading: boolean;\n}\n\n/**\n * @public\n */\nexport const QuickstartDrawerContext = createContext<\n  QuickstartDrawerContextType | undefined\n>(undefined);\n"],"names":[],"mappings":";;AA8Da,MAAA,uBAAA,GAA0B,cAErC,MAAS;;;;"}

package/dist/components/QuickstartDrawerProvider.esm.js

@@ -6,6 +6,8 @@ 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';
 
 const QuickstartDrawerProvider = ({ children }) => {
   const [isDrawerOpen, setIsDrawerOpen] = useState(false);
@@ -15,6 +17,7 @@ const QuickstartDrawerProvider = ({ children }) => {
   const [userKey, setUserKey] = useState("guest");
   const identityApi = useApi(identityApiRef);
   const configApi = useApi(configApiRef);
+  const { isLoading: roleLoading, userRole } = useQuickstartRole();
   useEffect(() => {
     if (isDrawerOpen) {
       document.body.classList.add("quickstart-drawer-open");
@@ -65,6 +68,15 @@ const QuickstartDrawerProvider = ({ children }) => {
       localStorage.setItem(openKey, "false");
       return;
     }
+    const quickstartItems = configApi?.has(
+      "app.quickstart"
+    ) ? configApi.get("app.quickstart") : [];
+    const eligibleItems = !roleLoading && userRole ? filterQuickstartItemsByRole(quickstartItems, userRole) : [];
+    if (!roleLoading && eligibleItems.length === 0) {
+      setIsDrawerOpen(false);
+      localStorage.setItem(openKey, "false");
+      return;
+    }
     const wasOpen = localStorage.getItem(openKey);
     const hasVisited = localStorage.getItem(visitedKey);
     const notificationShown = localStorage.getItem(notificationKey);
@@ -78,11 +90,17 @@ const QuickstartDrawerProvider = ({ children }) => {
       setIsDrawerOpen(false);
     }
     setHasShownNotification(notificationShown === "true");
-  }, [userKey, configApi]);
+  }, [userKey, configApi, roleLoading, userRole]);
   const openDrawer = () => {
-    setIsDrawerOpen(true);
-    const openKey = `quickstart-open:${userKey}`;
-    localStorage.setItem(openKey, "true");
+    const quickstartItems = configApi?.has(
+      "app.quickstart"
+    ) ? configApi.get("app.quickstart") : [];
+    const eligibleItems = !roleLoading && userRole ? filterQuickstartItemsByRole(quickstartItems, userRole) : [];
+    if (!roleLoading && eligibleItems.length > 0) {
+      setIsDrawerOpen(true);
+      const openKey = `quickstart-open:${userKey}`;
+      localStorage.setItem(openKey, "true");
+    }
   };
   const closeDrawer = () => {
     setIsDrawerOpen(false);
@@ -111,7 +129,9 @@ const QuickstartDrawerProvider = ({ children }) => {
         closeDrawer,
         toggleDrawer,
         setDrawerWidth,
-        drawerWidth
+        drawerWidth,
+        userRole,
+        roleLoading
       },
       children: [
         children,

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';\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  // 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    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]);\n\n  const openDrawer = () => {\n    setIsDrawerOpen(true);\n    const openKey = `quickstart-open:${userKey}`;\n    localStorage.setItem(openKey, 'true');\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      }}\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 { 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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"}

package/dist/hooks/useQuickstartRole.esm.js

@@ -15,9 +15,9 @@ const useQuickstartRole = () => {
       const credentials = await identityApi.getCredentials();
       const identity = await identityApi.getBackstageIdentity();
       const hasValidToken = credentials?.token && credentials.token.length > 10;
-      const userEntityRef2 = identity?.userEntityRef || "";
+      const userEntityRef = identity?.userEntityRef || "";
       const ownershipRefs = identity?.ownershipEntityRefs || [];
-      const isGuest = userEntityRef2.toLowerCase().includes("guest") || userEntityRef2 === "user:default/guest" || !hasValidToken && ownershipRefs.length === 0;
+      const isGuest = userEntityRef.toLowerCase().includes("guest") || userEntityRef === "user:default/guest" || !hasValidToken && ownershipRefs.length === 0;
       const isAuthenticated = !isGuest;
       return { isAuthenticated, identity, credentials };
     } catch (error) {
@@ -25,29 +25,17 @@ const useQuickstartRole = () => {
     }
   }, [identityApi]);
   if (authLoading) return { isLoading: true, userRole: null };
-  const userEntityRef = authResult?.identity?.userEntityRef || "guest";
-  const cacheKey = `quickstart-role:${userEntityRef}:rbac:${isRBACEnabled ? "1" : "0"}`;
-  const cachedRole = typeof window !== "undefined" ? sessionStorage.getItem(cacheKey) : null;
-  if (cachedRole === "admin" || cachedRole === "developer") {
-    return { isLoading: false, userRole: cachedRole };
-  }
   if (loading) return { isLoading: true, userRole: null };
   const isUserAuthorized = authResult?.isAuthenticated ?? false;
   if (!isUserAuthorized) {
     return { isLoading: false, userRole: "admin" };
   }
   if (!isRBACEnabled) {
-    if (typeof window !== "undefined")
-      sessionStorage.setItem(cacheKey, "admin");
     return { isLoading: false, userRole: "admin" };
   }
   if (allowed) {
-    if (typeof window !== "undefined")
-      sessionStorage.setItem(cacheKey, "admin");
     return { isLoading: false, userRole: "admin" };
   }
-  if (typeof window !== "undefined")
-    sessionStorage.setItem(cacheKey, "developer");
   return { isLoading: false, userRole: "developer" };
 };
 

package/dist/hooks/useQuickstartRole.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"useQuickstartRole.esm.js","sources":["../../src/hooks/useQuickstartRole.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 { usePermission } from '@backstage/plugin-permission-react';\nimport {\n  configApiRef,\n  identityApiRef,\n  useApi,\n} from '@backstage/core-plugin-api';\nimport { policyEntityCreatePermission } from '@backstage-community/plugin-rbac-common';\nimport { useAsync } from 'react-use';\nimport { UserRole } from '../types';\n\n/**\n * Determines the user's role for quickstart functionality based on RBAC permissions and user authorization.\n *\n * Business Logic:\n * - Guest user(unauthorized): show admin items\n * - Authorized user + NO RBAC enabled: show admin items\n * - Authorized user + RBAC enabled:\n *   - if user has admin permission => show configured admin items\n *   - if user doesn't have admin permission => show configured developer items\n *\n * @returns Object with isLoading boolean and userRole ('admin' | 'developer' | null)\n */\nexport const useQuickstartRole = (): {\n  isLoading: boolean;\n  userRole: UserRole | null;\n} => {\n  const config = useApi(configApiRef);\n  const identityApi = useApi(identityApiRef);\n  const isRBACEnabled =\n    config.getOptionalBoolean('permission.enabled') ?? false;\n  const { loading, allowed } = usePermission({\n    permission: policyEntityCreatePermission,\n  });\n\n  // Check user authorization status by examining identity and credentials\n  const { value: authResult, loading: authLoading } = useAsync(async () => {\n    try {\n      const credentials = await identityApi.getCredentials();\n      const identity = await identityApi.getBackstageIdentity();\n\n      // Check multiple indicators to determine if user is authenticated (not a guest)\n      const hasValidToken = credentials?.token && credentials.token.length > 10; // Real tokens are longer\n      const userEntityRef = identity?.userEntityRef || '';\n      const ownershipRefs = identity?.ownershipEntityRefs || [];\n\n      const isGuest =\n        userEntityRef.toLowerCase().includes('guest') ||\n        userEntityRef === 'user:default/guest' ||\n        (!hasValidToken && ownershipRefs.length === 0);\n\n      const isAuthenticated = !isGuest;\n\n      return { isAuthenticated, identity, credentials };\n    } catch (error) {\n      return { isAuthenticated: false, identity: null, credentials: null };\n    }\n  }, [identityApi]);\n\n  // When auth is still resolving, return loading\n  if (authLoading) return { isLoading: true, userRole: null };\n\n  // After auth resolves, attempt to serve cached role (session scoped)\n  const userEntityRef = authResult?.identity?.userEntityRef || 'guest';\n  const cacheKey = `quickstart-role:${userEntityRef}:rbac:${\n    isRBACEnabled ? '1' : '0'\n  }`;\n  const cachedRole =\n    typeof window !== 'undefined' ? sessionStorage.getItem(cacheKey) : null;\n  if (cachedRole === 'admin' || cachedRole === 'developer') {\n    return { isLoading: false, userRole: cachedRole as UserRole };\n  }\n\n  // If permission is still loading and there's no cache, report loading\n  if (loading) return { isLoading: true, userRole: null };\n\n  // Check if user is authorized (authenticated, not a guest)\n  const isUserAuthorized = authResult?.isAuthenticated ?? false;\n\n  // Unauthorized user: show admin items\n  if (!isUserAuthorized) {\n    return { isLoading: false, userRole: 'admin' };\n  }\n\n  // Authorized user + NO RBAC enabled: show admin items\n  if (!isRBACEnabled) {\n    if (typeof window !== 'undefined')\n      sessionStorage.setItem(cacheKey, 'admin');\n    return { isLoading: false, userRole: 'admin' };\n  }\n\n  // Authorized user + RBAC enabled: check permissions\n  // If user has admin permission => show configured admin items\n  if (allowed) {\n    if (typeof window !== 'undefined')\n      sessionStorage.setItem(cacheKey, 'admin');\n    return { isLoading: false, userRole: 'admin' };\n  }\n\n  // If user doesn't have admin permission => show configured developer items\n  if (typeof window !== 'undefined')\n    sessionStorage.setItem(cacheKey, 'developer');\n  return { isLoading: false, userRole: 'developer' };\n};\n"],"names":["userEntityRef"],"mappings":"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"}
+{"version":3,"file":"useQuickstartRole.esm.js","sources":["../../src/hooks/useQuickstartRole.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 { usePermission } from '@backstage/plugin-permission-react';\nimport {\n  configApiRef,\n  identityApiRef,\n  useApi,\n} from '@backstage/core-plugin-api';\nimport { policyEntityCreatePermission } from '@backstage-community/plugin-rbac-common';\nimport { useAsync } from 'react-use';\nimport { UserRole } from '../types';\n\n/**\n * Determines the user's role for quickstart functionality based on RBAC permissions and user authorization.\n *\n * Business Logic:\n * - Guest user(unauthorized): show admin items\n * - Authorized user + NO RBAC enabled: show admin items\n * - Authorized user + RBAC enabled:\n *   - if user has admin permission => show configured admin items\n *   - if user doesn't have admin permission => show configured developer items\n *\n * @returns Object with isLoading boolean and userRole ('admin' | 'developer' | null)\n */\nexport const useQuickstartRole = (): {\n  isLoading: boolean;\n  userRole: UserRole | null;\n} => {\n  const config = useApi(configApiRef);\n  const identityApi = useApi(identityApiRef);\n  const isRBACEnabled =\n    config.getOptionalBoolean('permission.enabled') ?? false;\n  const { loading, allowed } = usePermission({\n    permission: policyEntityCreatePermission,\n  });\n\n  // Check user authorization status by examining identity and credentials\n  const { value: authResult, loading: authLoading } = useAsync(async () => {\n    try {\n      const credentials = await identityApi.getCredentials();\n      const identity = await identityApi.getBackstageIdentity();\n\n      // Check multiple indicators to determine if user is authenticated (not a guest)\n      const hasValidToken = credentials?.token && credentials.token.length > 10; // Real tokens are longer\n      const userEntityRef = identity?.userEntityRef || '';\n      const ownershipRefs = identity?.ownershipEntityRefs || [];\n\n      const isGuest =\n        userEntityRef.toLowerCase().includes('guest') ||\n        userEntityRef === 'user:default/guest' ||\n        (!hasValidToken && ownershipRefs.length === 0);\n\n      const isAuthenticated = !isGuest;\n\n      return { isAuthenticated, identity, credentials };\n    } catch (error) {\n      return { isAuthenticated: false, identity: null, credentials: null };\n    }\n  }, [identityApi]);\n\n  // When auth is still resolving, return loading\n  if (authLoading) return { isLoading: true, userRole: null };\n\n  // If permission is still loading, report loading\n  if (loading) return { isLoading: true, userRole: null };\n\n  // Check if user is authorized (authenticated, not a guest)\n  const isUserAuthorized = authResult?.isAuthenticated ?? false;\n\n  // Unauthorized user: show admin items\n  if (!isUserAuthorized) {\n    return { isLoading: false, userRole: 'admin' };\n  }\n\n  // Authorized user + NO RBAC enabled: show admin items\n  if (!isRBACEnabled) {\n    return { isLoading: false, userRole: 'admin' };\n  }\n\n  // Authorized user + RBAC enabled: check permissions\n  // If user has admin permission => show configured admin items\n  if (allowed) {\n    return { isLoading: false, userRole: 'admin' };\n  }\n\n  // If user doesn't have admin permission => show configured developer items\n  return { isLoading: false, userRole: 'developer' };\n};\n"],"names":[],"mappings":";;;;;AAsCO,MAAM,oBAAoB,MAG5B;AACH,EAAM,MAAA,MAAA,GAAS,OAAO,YAAY,CAAA;AAClC,EAAM,MAAA,WAAA,GAAc,OAAO,cAAc,CAAA;AACzC,EAAA,MAAM,aACJ,GAAA,MAAA,CAAO,kBAAmB,CAAA,oBAAoB,CAAK,IAAA,KAAA;AACrD,EAAA,MAAM,EAAE,OAAA,EAAS,OAAQ,EAAA,GAAI,aAAc,CAAA;AAAA,IACzC,UAAY,EAAA;AAAA,GACb,CAAA;AAGD,EAAA,MAAM,EAAE,KAAO,EAAA,UAAA,EAAY,SAAS,WAAY,EAAA,GAAI,SAAS,YAAY;AACvE,IAAI,IAAA;AACF,MAAM,MAAA,WAAA,GAAc,MAAM,WAAA,CAAY,cAAe,EAAA;AACrD,MAAM,MAAA,QAAA,GAAW,MAAM,WAAA,CAAY,oBAAqB,EAAA;AAGxD,MAAA,MAAM,aAAgB,GAAA,WAAA,EAAa,KAAS,IAAA,WAAA,CAAY,MAAM,MAAS,GAAA,EAAA;AACvE,MAAM,MAAA,aAAA,GAAgB,UAAU,aAAiB,IAAA,EAAA;AACjD,MAAM,MAAA,aAAA,GAAgB,QAAU,EAAA,mBAAA,IAAuB,EAAC;AAExD,MAAA,MAAM,OACJ,GAAA,aAAA,CAAc,WAAY,EAAA,CAAE,QAAS,CAAA,OAAO,CAC5C,IAAA,aAAA,KAAkB,oBACjB,IAAA,CAAC,aAAiB,IAAA,aAAA,CAAc,MAAW,KAAA,CAAA;AAE9C,MAAA,MAAM,kBAAkB,CAAC,OAAA;AAEzB,MAAO,OAAA,EAAE,eAAiB,EAAA,QAAA,EAAU,WAAY,EAAA;AAAA,aACzC,KAAO,EAAA;AACd,MAAA,OAAO,EAAE,eAAiB,EAAA,KAAA,EAAO,QAAU,EAAA,IAAA,EAAM,aAAa,IAAK,EAAA;AAAA;AACrE,GACF,EAAG,CAAC,WAAW,CAAC,CAAA;AAGhB,EAAA,IAAI,aAAoB,OAAA,EAAE,SAAW,EAAA,IAAA,EAAM,UAAU,IAAK,EAAA;AAG1D,EAAA,IAAI,SAAgB,OAAA,EAAE,SAAW,EAAA,IAAA,EAAM,UAAU,IAAK,EAAA;AAGtD,EAAM,MAAA,gBAAA,GAAmB,YAAY,eAAmB,IAAA,KAAA;AAGxD,EAAA,IAAI,CAAC,gBAAkB,EAAA;AACrB,IAAA,OAAO,EAAE,SAAA,EAAW,KAAO,EAAA,QAAA,EAAU,OAAQ,EAAA;AAAA;AAI/C,EAAA,IAAI,CAAC,aAAe,EAAA;AAClB,IAAA,OAAO,EAAE,SAAA,EAAW,KAAO,EAAA,QAAA,EAAU,OAAQ,EAAA;AAAA;AAK/C,EAAA,IAAI,OAAS,EAAA;AACX,IAAA,OAAO,EAAE,SAAA,EAAW,KAAO,EAAA,QAAA,EAAU,OAAQ,EAAA;AAAA;AAI/C,EAAA,OAAO,EAAE,SAAA,EAAW,KAAO,EAAA,QAAA,EAAU,WAAY,EAAA;AACnD;;;;"}

package/dist/index.d.ts

@@ -1,7 +1,9 @@
 /// <reference types="react" />
 import * as _backstage_core_plugin_api from '@backstage/core-plugin-api';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { CSSProperties, PropsWithChildren } from 'react';
-import * as _backstage_core_plugin_api_alpha from '@backstage/core-plugin-api/alpha';
+export { quickstartTranslationRef, quickstartTranslations } from './alpha.js';
+import '@backstage/core-plugin-api/alpha';
 
 /**
  * Props for the QuickstartButton component
@@ -22,6 +24,11 @@ interface QuickstartButtonProps {
      */
     onClick?: () => void;
 }
+/**
+ * Quickstart button component for the global header help dropdown
+ * @public
+ */
+declare const QuickstartButton: ({ title, style, onClick, }: QuickstartButtonProps) => react_jsx_runtime.JSX.Element | null;
 
 /**
  * Quick start plugin
@@ -29,18 +36,44 @@ interface QuickstartButtonProps {
  * @public
  */
 declare const quickstartPlugin: _backstage_core_plugin_api.BackstagePlugin<{}, {}, {}>;
+
 /**
- * Quick start drawer provider
- *
+ * Call-to-action data for quickstart items
  * @public
  */
-declare const QuickstartDrawerProvider: React.ComponentType<PropsWithChildren>;
+interface QuickstartItemCtaData {
+    /** The text to display for the CTA button */
+    text: string;
+    /** Translation key for the CTA text */
+    textKey?: string;
+    /** The URL to navigate to when clicked */
+    link: string;
+}
 /**
- * Quick start button for global header help dropdown
- *
+ * Configuration data for a quickstart item
  * @public
  */
-declare const QuickstartButton: React.ComponentType<QuickstartButtonProps>;
+interface QuickstartItemData {
+    /** The title of the quickstart item */
+    title: string;
+    /** Translation key for the title */
+    titleKey?: string;
+    /** Array of roles that can access this item (defaults to ['admin'] if not specified) */
+    roles?: string[];
+    /** Icon identifier for the item */
+    icon?: string;
+    /** Description text for the item */
+    description: string;
+    /** Translation key for the description */
+    descriptionKey?: string;
+    /** Call-to-action configuration */
+    cta?: QuickstartItemCtaData;
+}
+/**
+ * User role type for quickstart functionality
+ * @public
+ */
+type UserRole = 'admin' | 'developer';
 
 /**
  * Type for QuickstartDrawerContext
@@ -72,6 +105,14 @@ interface QuickstartDrawerContextType {
      * The function for setting the drawer width
      */
     setDrawerWidth: React.Dispatch<React.SetStateAction<number>>;
+    /**
+     * The user's role for quickstart functionality
+     */
+    userRole: UserRole | null;
+    /**
+     * Whether the role is still loading
+     */
+    roleLoading: boolean;
 }
 
 /**
@@ -82,67 +123,21 @@ interface QuickstartDrawerContextType {
 declare const useQuickstartDrawerContext: () => QuickstartDrawerContextType;
 
 /**
- * Translation reference for Quickstart plugin
+ * Provider component for the Quickstart Drawer functionality
  * @public
  */
-declare const quickstartTranslationRef: _backstage_core_plugin_api_alpha.TranslationRef<"plugin.quickstart", {
-    readonly "button.quickstart": string;
-    readonly "button.openQuickstartGuide": string;
-    readonly "button.closeDrawer": string;
-    readonly "button.gotIt": string;
-    readonly "footer.progress": string;
-    readonly "footer.hide": string;
-    readonly "footer.notStarted": string;
-    readonly "header.title": string;
-    readonly "header.subtitle": string;
-    readonly "content.emptyState.title": string;
-    readonly "item.expandAriaLabel": string;
-    readonly "item.collapseAriaLabel": string;
-    readonly "item.expandButtonAriaLabel": string;
-    readonly "item.collapseButtonAriaLabel": string;
-    readonly "steps.setupAuthentication.title": string;
-    readonly "steps.setupAuthentication.description": string;
-    readonly "steps.setupAuthentication.ctaTitle": string;
-    readonly "steps.configureRbac.title": string;
-    readonly "steps.configureRbac.description": string;
-    readonly "steps.configureRbac.ctaTitle": string;
-    readonly "steps.configureGit.title": string;
-    readonly "steps.configureGit.description": string;
-    readonly "steps.configureGit.ctaTitle": string;
-    readonly "steps.managePlugins.title": string;
-    readonly "steps.managePlugins.description": string;
-    readonly "steps.managePlugins.ctaTitle": string;
-    readonly "steps.importApplication.title": string;
-    readonly "steps.importApplication.description": string;
-    readonly "steps.importApplication.ctaTitle": string;
-    readonly "steps.learnAboutCatalog.title": string;
-    readonly "steps.learnAboutCatalog.description": string;
-    readonly "steps.learnAboutCatalog.ctaTitle": string;
-    readonly "steps.exploreSelfServiceTemplates.title": string;
-    readonly "steps.exploreSelfServiceTemplates.description": string;
-    readonly "steps.exploreSelfServiceTemplates.ctaTitle": string;
-    readonly "steps.findAllLearningPaths.title": string;
-    readonly "steps.findAllLearningPaths.description": string;
-    readonly "steps.findAllLearningPaths.ctaTitle": string;
-    readonly "dev.pageTitle": string;
-    readonly "dev.pageDescription": string;
-    readonly "dev.drawerControls": string;
-    readonly "dev.currentState": string;
-    readonly "dev.stateOpen": string;
-    readonly "dev.stateClosed": string;
-    readonly "dev.instructions": string;
-    readonly "dev.step1": string;
-    readonly "dev.step2": string;
-    readonly "dev.step3": string;
-    readonly "dev.step4": string;
-    readonly "dev.step5": string;
-}>;
+declare const QuickstartDrawerProvider: ({ children }: PropsWithChildren) => react_jsx_runtime.JSX.Element;
 
 /**
- * Translation Resource for Quickstart
+ * Filters quickstart items based on user role.
+ *
+ * @param items - Array of quickstart items to filter
+ * @param userRole - The user's role ('admin' or 'developer')
+ * @returns Filtered array of quickstart items available to the user
+ *
  * @public
  */
-declare const quickstartTranslations: _backstage_core_plugin_api_alpha.TranslationResource<"plugin.quickstart">;
+declare const filterQuickstartItemsByRole: (items: QuickstartItemData[], userRole: string) => QuickstartItemData[];
 
-export { QuickstartButton, QuickstartDrawerProvider, quickstartPlugin, quickstartTranslationRef, quickstartTranslations, useQuickstartDrawerContext };
-export type { QuickstartButtonProps, QuickstartDrawerContextType };
+export { QuickstartButton, QuickstartDrawerProvider, filterQuickstartItemsByRole, quickstartPlugin, useQuickstartDrawerContext };
+export type { QuickstartButtonProps, QuickstartDrawerContextType, QuickstartItemCtaData, QuickstartItemData, UserRole };

package/dist/index.esm.js

@@ -1,7 +1,10 @@
 import { unstable_ClassNameGenerator } from '@mui/material/className';
-export { QuickstartButton, QuickstartDrawerProvider, quickstartPlugin } from './plugin.esm.js';
+export { quickstartPlugin } from './plugin.esm.js';
 export { useQuickstartDrawerContext } from './hooks/useQuickstartDrawerContext.esm.js';
+export { QuickstartButton } from './components/QuickstartButton/QuickstartButton.esm.js';
+export { QuickstartDrawerProvider } from './components/QuickstartDrawerProvider.esm.js';
 export { quickstartTranslations } from './translations/index.esm.js';
+export { filterQuickstartItemsByRole } from './utils/filterQuickstartItems.esm.js';
 export { quickstartTranslationRef } from './translations/ref.esm.js';
 
 unstable_ClassNameGenerator.configure((componentName) => {

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\nexport {\n  quickstartTranslations,\n  quickstartTranslationRef,\n} from './translations';\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';\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

@@ -9,7 +9,7 @@ const quickstartPlugin = createPlugin({
     resources: [quickstartTranslationRef]
   }
 });
-const QuickstartDrawerProvider = quickstartPlugin.provide(
+quickstartPlugin.provide(
   createComponentExtension({
     name: "QuickstartDrawerProvider",
     component: {
@@ -19,7 +19,7 @@ const QuickstartDrawerProvider = quickstartPlugin.provide(
     }
   })
 );
-const QuickstartButton = quickstartPlugin.provide(
+quickstartPlugin.provide(
   createComponentExtension({
     name: "QuickstartButton",
     component: {
@@ -30,5 +30,5 @@ const QuickstartButton = quickstartPlugin.provide(
   })
 );
 
-export { QuickstartButton, QuickstartDrawerProvider, quickstartPlugin };
+export { 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', 'fr', 'es'],\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,kBAAoB,EAAA,CAAC,IAAM,EAAA,IAAA,EAAM,MAAM,IAAI,CAAA;AAAA,IAC3C,SAAA,EAAW,CAAC,wBAAwB;AAAA;AAExC,CAAQ;AAOD,MAAM,2BACX,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,mBACX,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', 'fr', 'es'],\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,kBAAoB,EAAA,CAAC,IAAM,EAAA,IAAA,EAAM,MAAM,IAAI,CAAA;AAAA,IAC3C,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;;;;"}

package/dist/utils/filterQuickstartItems.esm.js.map

@@ -1 +1 @@
-{"version":3,"file":"filterQuickstartItems.esm.js","sources":["../../src/utils/filterQuickstartItems.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 { QuickstartItemData } from '../types';\n\nexport const filterQuickstartItemsByRole = (\n  items: QuickstartItemData[],\n  userRole: string,\n): QuickstartItemData[] => {\n  return items.filter(item => {\n    // If roles is undefined or empty, default to 'admin'\n    const roles = item.roles?.length ? item.roles : ['admin'];\n    return roles.includes(userRole);\n  });\n};\n"],"names":[],"mappings":"AAkBa,MAAA,2BAAA,GAA8B,CACzC,KAAA,EACA,QACyB,KAAA;AACzB,EAAO,OAAA,KAAA,CAAM,OAAO,CAAQ,IAAA,KAAA;AAE1B,IAAA,MAAM,QAAQ,IAAK,CAAA,KAAA,EAAO,SAAS,IAAK,CAAA,KAAA,GAAQ,CAAC,OAAO,CAAA;AACxD,IAAO,OAAA,KAAA,CAAM,SAAS,QAAQ,CAAA;AAAA,GAC/B,CAAA;AACH;;;;"}
+{"version":3,"file":"filterQuickstartItems.esm.js","sources":["../../src/utils/filterQuickstartItems.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 { QuickstartItemData } from '../types';\n\n/**\n * Filters quickstart items based on user role.\n *\n * @param items - Array of quickstart items to filter\n * @param userRole - The user's role ('admin' or 'developer')\n * @returns Filtered array of quickstart items available to the user\n *\n * @public\n */\nexport const filterQuickstartItemsByRole = (\n  items: QuickstartItemData[],\n  userRole: string,\n): QuickstartItemData[] => {\n  return items.filter(item => {\n    // If roles is undefined or empty, default to 'admin'\n    const roles = item.roles?.length ? item.roles : ['admin'];\n    return roles.includes(userRole);\n  });\n};\n"],"names":[],"mappings":"AA2Ba,MAAA,2BAAA,GAA8B,CACzC,KAAA,EACA,QACyB,KAAA;AACzB,EAAO,OAAA,KAAA,CAAM,OAAO,CAAQ,IAAA,KAAA;AAE1B,IAAA,MAAM,QAAQ,IAAK,CAAA,KAAA,EAAO,SAAS,IAAK,CAAA,KAAA,GAAQ,CAAC,OAAO,CAAA;AACxD,IAAO,OAAA,KAAA,CAAM,SAAS,QAAQ,CAAA;AAAA,GAC/B,CAAA;AACH;;;;"}

package/package.json

@@ -1,13 +1,11 @@
 {
   "name": "@red-hat-developer-hub/backstage-plugin-quickstart",
-  "version": "1.6.0",
+  "version": "1.6.2",
   "license": "Apache-2.0",
-  "main": "dist/index.esm.js",
-  "types": "dist/index.d.ts",
+  "main": "./dist/index.esm.js",
+  "types": "./dist/index.d.ts",
   "publishConfig": {
-    "access": "public",
-    "main": "dist/index.esm.js",
-    "types": "dist/index.d.ts"
+    "access": "public"
   },
   "repository": {
     "type": "git",
@@ -39,6 +37,7 @@
     "@backstage/theme": "^0.6.8",
     "@mui/icons-material": "5.18.0",
     "@mui/material": "5.18.0",
+    "@red-hat-developer-hub/backstage-plugin-theme": "^0.10.0",
     "react-use": "^17.6.0"
   },
   "peerDependencies": {
@@ -50,26 +49,41 @@
     "@backstage/dev-utils": "^1.1.13",
     "@backstage/plugin-permission-common": "^0.9.1",
     "@backstage/test-utils": "^1.7.11",
-    "@red-hat-developer-hub/backstage-plugin-theme": "^0.10.0",
     "@testing-library/jest-dom": "^6.0.0",
     "@testing-library/react": "^14.0.0",
     "@testing-library/user-event": "^14.0.0",
     "msw": "^1.0.0",
     "react": "^16.13.1 || ^17.0.0 || ^18.0.0"
   },
-  "files": [
-    "dist",
-    "dist-scalprum",
-    "config.d.ts",
-    "app-config.dynamic.yaml"
-  ],
-  "configSchema": "config.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.esm.js"
+    },
+    "./alpha": {
+      "import": "./dist/alpha.esm.js",
+      "types": "./dist/alpha.d.ts",
+      "default": "./dist/alpha.esm.js"
+    },
+    "./package.json": "./package.json"
+  },
   "typesVersions": {
     "*": {
+      "alpha": [
+        "dist/alpha.d.ts"
+      ],
       "package.json": [
         "package.json"
       ]
     }
   },
+  "files": [
+    "dist",
+    "dist-scalprum",
+    "config.d.ts",
+    "app-config.dynamic.yaml"
+  ],
+  "configSchema": "config.d.ts",
   "module": "./dist/index.esm.js"
 }