@patternfly/quickstarts 1.2.1 → 1.4.0

package/dist/index.js

@@ -178,6 +178,7 @@ var en = {
 	"{{count, number}} item": "{{count, number}} item",
 	"{{count, number}} item_plural": "{{count, number}} items",
 	"Prerequisites ({{totalPrereqs}})": "Prerequisites ({{totalPrereqs}})",
+	"View Prerequisites ({{totalPrereqs}})": "View Prerequisites ({{totalPrereqs}})",
 	Prerequisites: Prerequisites,
 	"Show prerequisites": "Show prerequisites",
 	Complete: Complete,
@@ -617,6 +618,7 @@ const QuickStartContextDefaults = {
     footer: null,
     markdown: null,
     loading: false,
+    alwaysShowTaskReview: false,
 };
 const QuickStartContext = React.createContext(QuickStartContextDefaults);
 const getResource = (resource, options, resourceBundle, lng) => {
@@ -644,6 +646,7 @@ const useValuesForQuickStartContext = (value = {}) => {
         return getResource(resource, count !== undefined ? { count } : null, resourceBundle, language);
     }, [resourceBundle, language]);
     const [loading, setLoading] = React__default['default'].useState(combinedValue.loading);
+    const [alwaysShowTaskReview, setAlwaysShowTaskReview] = React__default['default'].useState(combinedValue.alwaysShowTaskReview);
     const initialSearchParams = new URLSearchParams(window.location.search);
     const initialSearchQuery = initialSearchParams.get(QUICKSTART_SEARCH_FILTER_KEY) || '';
     const initialStatusFilters = ((_a = initialSearchParams.get(QUICKSTART_STATUS_FILTER_KEY)) === null || _a === void 0 ? void 0 : _a.split(',')) || [];
@@ -714,6 +717,10 @@ const useValuesForQuickStartContext = (value = {}) => {
         });
         setAllQuickStartStates((qs) => (Object.assign(Object.assign({}, qs), { [quickStartId]: getDefaultQuickStartState(totalTasks, exports.QuickStartStatus.IN_PROGRESS) })));
     }, [setActiveQuickStartID, setAllQuickStartStates, useQueryParams]);
+    // When alwaysShowTaskReview preference is enabled, skip visited step and go directly to review
+    const stepAfterInitial = alwaysShowTaskReview
+        ? exports.QuickStartTaskStatus.REVIEW
+        : exports.QuickStartTaskStatus.VISITED;
     const nextStep = React.useCallback((totalTasks) => {
         if (!activeQuickStartID) {
             return;
@@ -740,19 +747,19 @@ const useValuesForQuickStartContext = (value = {}) => {
             if (taskNumber < totalTasks && !updatedTaskStatus) {
                 updatedTaskNumber = taskNumber + 1;
             }
-            const markInitialStepVisited = updatedTaskNumber > -1 &&
+            const markInitialStepVisitedOrReview = updatedTaskNumber > -1 &&
                 quickStart[getTaskStatusKey(updatedTaskNumber)] === exports.QuickStartTaskStatus.INIT
-                ? exports.QuickStartTaskStatus.VISITED
+                ? stepAfterInitial
                 : quickStart[getTaskStatusKey(updatedTaskNumber)];
             const newState = Object.assign(Object.assign({}, qs), { [activeQuickStartID]: Object.assign(Object.assign(Object.assign(Object.assign({}, quickStart), (updatedStatus ? { status: updatedStatus } : {})), (updatedTaskNumber > -1
                     ? {
                         taskNumber: updatedTaskNumber,
-                        [getTaskStatusKey(updatedTaskNumber)]: markInitialStepVisited,
+                        [getTaskStatusKey(updatedTaskNumber)]: markInitialStepVisitedOrReview,
                     }
                     : {})), (updatedTaskStatus ? { [getTaskStatusKey(taskNumber)]: updatedTaskStatus } : {})) });
             return newState;
         });
-    }, [activeQuickStartID, setAllQuickStartStates]);
+    }, [activeQuickStartID, setAllQuickStartStates, stepAfterInitial]);
     const previousStep = React.useCallback(() => {
         setAllQuickStartStates((qs) => {
             const quickStart = qs[activeQuickStartID];
@@ -774,7 +781,7 @@ const useValuesForQuickStartContext = (value = {}) => {
             let updatedTaskStatus = {};
             for (let taskIndex = 0; taskIndex <= taskNumber; taskIndex++) {
                 const taskStatus = quickStart[getTaskStatusKey(taskIndex)];
-                const newTaskStatus = taskStatus === exports.QuickStartTaskStatus.INIT ? exports.QuickStartTaskStatus.VISITED : undefined;
+                const newTaskStatus = taskStatus === exports.QuickStartTaskStatus.INIT ? stepAfterInitial : undefined;
                 if (newTaskStatus) {
                     updatedTaskStatus = Object.assign(Object.assign({}, updatedTaskStatus), { [getTaskStatusKey(taskIndex)]: newTaskStatus });
                 }
@@ -782,7 +789,7 @@ const useValuesForQuickStartContext = (value = {}) => {
             const updatedQuickStart = Object.assign(Object.assign(Object.assign(Object.assign({}, quickStart), (updatedStatus ? { status: updatedStatus } : {})), { taskNumber }), updatedTaskStatus);
             return Object.assign(Object.assign({}, qs), { [quickStartId]: updatedQuickStart });
         });
-    }, [setAllQuickStartStates]);
+    }, [setAllQuickStartStates, stepAfterInitial]);
     const setQuickStartTaskStatus = React.useCallback((taskStatus) => {
         const quickStart = allQuickStartStates[activeQuickStartID];
         const { taskNumber } = quickStart;
@@ -828,6 +835,8 @@ const useValuesForQuickStartContext = (value = {}) => {
         setFilter,
         loading,
         setLoading,
+        alwaysShowTaskReview,
+        setAlwaysShowTaskReview,
     };
 };
 const QuickStartContextProvider = ({ children, value }) => {
@@ -993,7 +1002,7 @@ const SimplePopper = ({ children }) => {
         }
     }, [destroy, isOpen]);
     return isOpen ? (React__namespace.createElement(Portal, null,
-        React__namespace.createElement("div", { ref: nodeRefCallback, style: { zIndex: 9999, position: 'absolute', top: 0, left: 0 } }, children))) : null;
+        React__namespace.createElement("div", { ref: nodeRefCallback, style: { zIndex: 9999, position: 'absolute', top: 0, left: 0 }, className: "pfext-quick-start__base" }, children))) : null;
 };
 
 const isInViewport = (elementToCheck) => {
@@ -1236,7 +1245,7 @@ const CopyClipboard = ({ element, rootSelector, docContext, }) => {
     useEventListener(element, 'mouseleave', React__namespace.useCallback(() => {
         setShowSuccessContent(false);
     }, []));
-    return showSuccessContent ? (React__namespace.createElement(reactCore.Tooltip, { key: "after-copy", isVisible: true, reference: () => element, content: getResource('Successfully copied to clipboard!') })) : (React__namespace.createElement(reactCore.Tooltip, { key: "before-copy", reference: () => element, content: getResource('Copy to clipboard') }));
+    return showSuccessContent ? (React__namespace.createElement(reactCore.Tooltip, { key: "after-copy", isVisible: true, reference: () => element, content: getResource('Successfully copied to clipboard!'), className: "pfext-quick-start__base" })) : (React__namespace.createElement(reactCore.Tooltip, { key: "before-copy", reference: () => element, content: getResource('Copy to clipboard'), className: "pfext-quick-start__base" }));
 };
 const MarkdownCopyClipboard = ({ docContext, rootSelector, }) => {
     const elements = docContext.querySelectorAll(`${rootSelector} [${MARKDOWN_COPY_BUTTON_ID}]`);
@@ -1561,10 +1570,11 @@ const QuickStartTileDescription = ({ description, prerequisites, }) => {
             React__namespace.createElement(reactCore.Text, { component: reactCore.TextVariants.h5, className: "pfext-quick-start-tile-prerequisites__text" },
                 getResource('Prerequisites ({{totalPrereqs}})').replace('{{totalPrereqs}}', prereqs.length),
                 ' '),
-            React__namespace.createElement(reactCore.Popover, { "aria-label": getResource('Prerequisites'), headerContent: getResource('Prerequisites'), className: "pfext-page-layout__base", bodyContent: React__namespace.createElement(reactCore.TextList, { "aria-label": getResource('Prerequisites'), className: "pfext-quick-start-tile-prerequisites-list" }, prereqs.map((prerequisite, index) => (
-                // eslint-disable-next-line react/no-array-index-key
-                React__namespace.createElement(reactCore.TextListItem, { key: index },
-                    React__namespace.createElement(QuickStartMarkdownView, { content: prerequisite }))))) },
+            React__namespace.createElement(reactCore.Popover, { "aria-label": getResource('Prerequisites'), headerContent: getResource('Prerequisites'), className: "pfext-quick-start__base", bodyContent: React__namespace.createElement("div", { className: "pfext-popover__base" },
+                    React__namespace.createElement(reactCore.TextList, { "aria-label": getResource('Prerequisites'), className: "pfext-quick-start-tile-prerequisites-list" }, prereqs.map((prerequisite, index) => (
+                    // eslint-disable-next-line react/no-array-index-key
+                    React__namespace.createElement(reactCore.TextListItem, { key: index },
+                        React__namespace.createElement(QuickStartMarkdownView, { content: prerequisite })))))) },
                 React__namespace.createElement(reactCore.Button, { variant: "link", isInline: true, className: "pfext-quick-start-tile-prerequisites__icon", "data-testid": "qs-card-prereqs", onClick: (e) => {
                         e.preventDefault();
                         e.stopPropagation();
@@ -1587,20 +1597,20 @@ const QuickStartTileFooter = ({ quickStartId, status, totalTasks, }) => {
     }, [quickStartId, restartQuickStart, totalTasks]);
     return (React__namespace.createElement(reactCore.Flex, { justifyContent: { default: 'justifyContentSpaceBetween' } },
         status === exports.QuickStartStatus.NOT_STARTED && (React__namespace.createElement(reactCore.FlexItem, null,
-            React__namespace.createElement(reactCore.Button, { onClick: start, variant: "link", isInline: true, "data-testid": "qs-card-notStarted-start" }, getResource('Start')))),
+            React__namespace.createElement(reactCore.Button, { onClick: start, variant: "link", isInline: true, "data-testid": "qs-card-notStarted-start", id: `${quickStartId}-start`, "aria-labelledby": `${quickStartId}-start ${quickStartId}` }, getResource('Start')))),
         status === exports.QuickStartStatus.IN_PROGRESS && activeQuickStartID !== quickStartId && (React__namespace.createElement(reactCore.FlexItem, null,
-            React__namespace.createElement(reactCore.Button, { variant: "link", isInline: true, "data-testid": "qs-card-inProgress-resume" }, getResource('Continue')))),
+            React__namespace.createElement(reactCore.Button, { variant: "link", isInline: true, "data-testid": "qs-card-inProgress-resume", id: `${quickStartId}-continue`, "aria-labelledby": `${quickStartId}-continue ${quickStartId}` }, getResource('Continue')))),
         status === exports.QuickStartStatus.COMPLETE && (React__namespace.createElement(reactCore.FlexItem, null,
-            React__namespace.createElement(reactCore.Button, { onClick: restart, variant: "link", isInline: true, "data-testid": "qs-card-complete-restart" }, getResource('Start')))),
+            React__namespace.createElement(reactCore.Button, { onClick: restart, variant: "link", isInline: true, "data-testid": "qs-card-complete-restart", id: `${quickStartId}-restart`, "aria-labelledby": `${quickStartId}-restart ${quickStartId}` }, getResource('Restart')))),
         status === exports.QuickStartStatus.IN_PROGRESS && (React__namespace.createElement(reactCore.FlexItem, null,
-            React__namespace.createElement(reactCore.Button, { onClick: restart, variant: "link", isInline: true, "data-testid": "qs-card-inProgress-restart" }, getResource('Restart'))))));
+            React__namespace.createElement(reactCore.Button, { onClick: restart, variant: "link", isInline: true, "data-testid": "qs-card-inProgress-restart", id: `${quickStartId}-restart`, "aria-labelledby": `${quickStartId}-restart ${quickStartId}` }, getResource('Restart'))))));
 };
 
-const QuickStartTileFooterExternal = ({ link }) => {
+const QuickStartTileFooterExternal = ({ link, quickStartId, }) => {
     const { href, text } = link;
     return (React__namespace.createElement(reactCore.Flex, { justifyContent: { default: 'justifyContentSpaceBetween' } },
         React__namespace.createElement(reactCore.FlexItem, null,
-            React__namespace.createElement(reactCore.Button, { component: "a", href: href, target: "_blank", rel: "noopener noreferrer", variant: "link", "aria-label": `Open documentation in new window`, isInline: true, icon: React__namespace.createElement(ExternalLinkAltIcon__default['default'], null), iconPosition: "right" }, text || href))));
+            React__namespace.createElement(reactCore.Button, { component: "a", href: href, target: "_blank", rel: "noopener noreferrer", variant: "link", "aria-label": `Open documentation in new window`, isInline: true, icon: React__namespace.createElement(ExternalLinkAltIcon__default['default'], null), iconPosition: "right", id: quickStartId, "aria-labelledby": `${quickStartId}-external ${quickStartId}` }, text || href))));
 };
 
 const statusColorMap = {
@@ -1608,7 +1618,7 @@ const statusColorMap = {
     [exports.QuickStartStatus.IN_PROGRESS]: 'purple',
     [exports.QuickStartStatus.NOT_STARTED]: 'grey',
 };
-const QuickStartTileHeader = ({ status, duration, name, type, }) => {
+const QuickStartTileHeader = ({ status, duration, name, type, quickStartId, }) => {
     const { getResource } = React__namespace.useContext(QuickStartContext);
     const statusLocaleMap = {
         [exports.QuickStartStatus.COMPLETE]: getResource('Complete'),
@@ -1616,7 +1626,7 @@ const QuickStartTileHeader = ({ status, duration, name, type, }) => {
         [exports.QuickStartStatus.NOT_STARTED]: getResource('Not started'),
     };
     return (React__namespace.createElement("div", { className: "pfext-quick-start-tile-header" },
-        React__namespace.createElement(reactCore.Title, { headingLevel: "h3", "data-test": "title" }, name),
+        React__namespace.createElement(reactCore.Title, { headingLevel: "h3", "data-test": "title", id: quickStartId }, name),
         React__namespace.createElement("div", { className: "pfext-quick-start-tile-header__status" },
             type && (React__namespace.createElement(reactCore.Label, { className: "pfext-quick-start-tile-header--margin", color: type.color }, type.text)),
             duration && (React__namespace.createElement(reactCore.Label, { variant: "outline", "data-test": "duration", icon: React__namespace.createElement(OutlinedClockIcon__default['default'], null), className: "pfext-quick-start-tile-header--margin" }, getResource('{{duration, number}} minutes', duration).replace('{{duration, number}}', duration))),
@@ -1627,8 +1637,14 @@ const QuickStartTile = ({ quickStart, status, isActive, onClick = () => { }, })
     const { metadata: { name: id }, spec: { icon, tasks, displayName, description, durationMinutes, prerequisites, link, type }, } = quickStart;
     const { setActiveQuickStart, footer } = React__namespace.useContext(QuickStartContext);
     const ref = React__namespace.useRef(null);
-    const quickStartIcon = (React__namespace.createElement(FallbackImg, { className: "pfext-catalog-item-icon__img--large", src: icon, alt: "", fallback: React__namespace.createElement(RocketIcon__default['default'], null) }));
-    const footerComponent = footer && footer.show === false ? null : link ? (React__namespace.createElement(QuickStartTileFooterExternal, { link: link })) : (React__namespace.createElement(QuickStartTileFooter, { quickStartId: id, status: status, totalTasks: tasks === null || tasks === void 0 ? void 0 : tasks.length }));
+    let quickStartIcon;
+    if (typeof icon === 'object') {
+        quickStartIcon = icon;
+    }
+    else {
+        quickStartIcon = (React__namespace.createElement(FallbackImg, { className: "pfext-catalog-item-icon__img--large", src: icon, alt: "", fallback: React__namespace.createElement(RocketIcon__default['default'], null) }));
+    }
+    const footerComponent = footer && footer.show === false ? null : link ? (React__namespace.createElement(QuickStartTileFooterExternal, { link: link, quickStartId: id })) : (React__namespace.createElement(QuickStartTileFooter, { quickStartId: id, status: status, totalTasks: tasks === null || tasks === void 0 ? void 0 : tasks.length }));
     const handleClick = (e) => {
         var _a;
         if ((_a = ref.current) === null || _a === void 0 ? void 0 : _a.contains(e.target)) {
@@ -1648,7 +1664,7 @@ const QuickStartTile = ({ quickStart, status, isActive, onClick = () => { }, })
             // @ts-ignore
             component: "div", style: {
                 cursor: 'pointer',
-            }, icon: quickStartIcon, className: "pfext-quick-start-tile", "data-testid": `qs-card-${camelize(displayName)}`, featured: isActive, title: React__namespace.createElement(QuickStartTileHeader, { name: displayName, status: status, duration: durationMinutes, type: type }), onClick: handleClick, "data-test": `tile ${id}`, description: React__namespace.createElement(QuickStartTileDescription, { description: description, prerequisites: prerequisites }), footer: footerComponent })));
+            }, icon: quickStartIcon, className: "pfext-quick-start-tile", "data-testid": `qs-card-${camelize(displayName)}`, featured: isActive, title: React__namespace.createElement(QuickStartTileHeader, { name: displayName, status: status, duration: durationMinutes, type: type, quickStartId: id }), onClick: handleClick, "data-test": `tile ${id}`, description: React__namespace.createElement(QuickStartTileDescription, { description: description, prerequisites: prerequisites }), footer: footerComponent })));
 };
 
 const QuickStartCatalog = ({ quickStarts }) => {
@@ -1841,7 +1857,7 @@ const QuickStartCatalogPage = ({ quickStarts, showFilter, sortFnc = (q1, q2) =>
     if (!allQuickStarts || allQuickStarts.length === 0) {
         return React__namespace.createElement(EmptyBox, { label: getResource('Quick Starts') });
     }
-    return (React__namespace.createElement(React__namespace.Fragment, null,
+    return (React__namespace.createElement("div", { className: "pfext-quick-start__base" },
         showTitle && (React__namespace.createElement("div", { className: "pfext-page-layout__header" },
             React__namespace.createElement(reactCore.Text, { component: "h1", className: "pfext-page-layout__title", "data-test": "page-title" }, title || getResource('Quick Starts')),
             hint && React__namespace.createElement("div", { className: "pfext-page-layout__hint" }, hint))),
@@ -1862,65 +1878,89 @@ const QuickStartCatalogToolbar = ({ children }) => (React__namespace.createEleme
 
 const QuickStartCloseModal = ({ isOpen, onConfirm, onCancel, }) => {
     const { getResource } = React__namespace.useContext(QuickStartContext);
-    return (React__namespace.createElement(Modal, { className: "pfext-quick-start-drawer__modal", isOpen: isOpen, variant: reactCore.ModalVariant.small, showClose: false, "data-test": "leave-quickstart", title: getResource('Leave quick start?'), footer: React__namespace.createElement(reactCore.Flex, null,
+    return (React__namespace.createElement(Modal, { className: "pfext-quick-start-drawer__modal pfext-quick-start__base", isOpen: isOpen, variant: reactCore.ModalVariant.small, showClose: false, "data-test": "leave-quickstart", title: getResource('Leave quick start?'), footer: React__namespace.createElement(reactCore.Flex, null,
             React__namespace.createElement(reactCore.FlexItem, { align: { default: 'alignRight' } },
                 React__namespace.createElement(reactCore.Button, { variant: "secondary", "data-test": "cancel button", onClick: onCancel }, getResource('Cancel'))),
             React__namespace.createElement(reactCore.FlexItem, null,
                 React__namespace.createElement(reactCore.Button, { variant: "primary", "data-test": "leave button", onClick: onConfirm }, getResource('Leave')))), isFullScreen: true }, getResource('Your progress will be saved.')));
 };
 
-const TaskIcon = ({ taskIndex, taskStatus, }) => {
+const TaskIcon = ({ taskIndex, taskStatus }) => {
     const { getResource } = React__namespace.useContext(QuickStartContext);
-    switch (taskStatus) {
-        case exports.QuickStartTaskStatus.SUCCESS:
-            return (React__namespace.createElement("span", { className: "pfext-icon-and-text__icon" },
-                React__namespace.createElement(CheckCircleIcon__default['default'], { size: "md", className: "pfext-quick-start-task-header__task-icon-success" })));
-        case exports.QuickStartTaskStatus.FAILED:
-            return (React__namespace.createElement("span", { className: "pfext-icon-and-text__icon" },
-                React__namespace.createElement(ExclamationCircleIcon__default['default'], { size: "md", className: "pfext-quick-start-task-header__task-icon-failed" })));
-        default:
-            return (React__namespace.createElement("span", { className: "pfext-icon-and-text__icon pfext-quick-start-task-header__task-icon-init" }, getResource('{{taskIndex, number}}', taskIndex).replace('{{taskIndex, number}}', taskIndex)));
+    const success = taskStatus === exports.QuickStartTaskStatus.SUCCESS;
+    const failed = taskStatus === exports.QuickStartTaskStatus.FAILED;
+    const classNames = reactStyles.css('pfext-icon-and-text__icon', {
+        'pfext-quick-start-task-header__task-icon-init': !failed && !success,
+    });
+    let content;
+    if (success) {
+        content = (React__namespace.createElement(CheckCircleIcon__default['default'], { size: "md", className: "pfext-quick-start-task-header__task-icon-success" }));
     }
+    else if (failed) {
+        content = (React__namespace.createElement(ExclamationCircleIcon__default['default'], { size: "md", className: "pfext-quick-start-task-header__task-icon-failed" }));
+    }
+    else {
+        content = getResource('{{taskIndex, number}}', taskIndex).replace('{{taskIndex, number}}', taskIndex);
+    }
+    return React__namespace.createElement("span", { className: classNames }, content);
 };
 const QuickStartTaskHeader = ({ title, taskIndex, subtitle, taskStatus, size, isActiveTask, onTaskSelect, }) => {
     const classNames = reactStyles.css('pfext-quick-start-task-header__title', {
         'pfext-quick-start-task-header__title-success': taskStatus === exports.QuickStartTaskStatus.SUCCESS,
-        'pfext-quick-start-task-header__title-failed': taskStatus === exports.QuickStartTaskStatus.FAILED,
+        'pfext-quick-start-task-header__title-failed': taskStatus === (exports.QuickStartTaskStatus.FAILED || exports.QuickStartTaskStatus.VISITED),
     });
-    const content = (React__namespace.createElement("span", { className: "pfext-quick-start-task-header" },
-        React__namespace.createElement(reactCore.Title, { headingLevel: "h3", size: size, className: classNames },
-            React__namespace.createElement(TaskIcon, { taskIndex: taskIndex, taskStatus: taskStatus }),
-            React__namespace.createElement("span", { dangerouslySetInnerHTML: { __html: removeParagraphWrap(markdownConvert(title)) } }),
-            isActiveTask && subtitle && (React__namespace.createElement(React__namespace.Fragment, null,
-                ' ',
-                React__namespace.createElement("span", { className: "pfext-quick-start-task-header__subtitle text-secondary", "data-test-id": "quick-start-task-subtitle" }, subtitle))))));
-    return (React__namespace.createElement(reactCore.WizardNavItem, { content: content, step: taskIndex, onNavItemClick: () => onTaskSelect(taskIndex - 1), navItemComponent: "button" }));
+    const notCompleted = taskStatus === exports.QuickStartTaskStatus.VISITED;
+    const skippedReviewOrFailed = taskStatus === exports.QuickStartTaskStatus.REVIEW || taskStatus === exports.QuickStartTaskStatus.FAILED;
+    const tryAgain = !isActiveTask && (skippedReviewOrFailed || notCompleted) && (React__namespace.createElement(reactCore.FlexItem, null,
+        React__namespace.createElement(reactCore.Title, { headingLevel: "h4", className: "pfext-quick-start-task-header__tryagain" }, "Try the steps again.")));
+    const content = (React__namespace.createElement(reactCore.Flex, { className: "pfext-quick-start-task-header", direction: { default: 'column' }, spaceItems: { default: 'spaceItemsXs' } },
+        React__namespace.createElement(reactCore.FlexItem, null,
+            React__namespace.createElement(reactCore.Title, { headingLevel: "h3", size: size, className: classNames },
+                React__namespace.createElement(TaskIcon, { taskIndex: taskIndex, taskStatus: taskStatus }),
+                React__namespace.createElement("span", { dangerouslySetInnerHTML: { __html: removeParagraphWrap(markdownConvert(title)) } }),
+                isActiveTask && subtitle && (React__namespace.createElement(React__namespace.Fragment, null,
+                    ' ',
+                    React__namespace.createElement("span", { className: "pfext-quick-start-task-header__subtitle", "data-test-id": "quick-start-task-subtitle" }, subtitle))))),
+        tryAgain));
+    return (React__namespace.createElement(reactCore.WizardNavItem, { content: content, step: taskIndex, onNavItemClick: () => onTaskSelect(taskIndex - 1), navItemComponent: "button", isCurrent: isActiveTask }));
 };
 
 const QuickStartTaskHeaderList = ({ tasks, allTaskStatuses, onTaskSelect, }) => {
     return tasks.length > 0 ? (React__namespace.createElement(reactCore.List, { className: "pfext-quick-start-task-header__list" }, tasks.map((task, index) => (React__namespace.createElement(QuickStartTaskHeader, { key: task.title, title: task.title, taskIndex: index + 1, size: "md", taskStatus: allTaskStatuses[index], onTaskSelect: onTaskSelect }))))) : null;
 };
 
-const QuickStartConclusion = ({ tasks, conclusion, allTaskStatuses, nextQuickStart, onQuickStartChange, onTaskSelect, }) => {
-    var _a;
+const QuickStartConclusion = ({ tasks, conclusion, allTaskStatuses, nextQuickStarts, onQuickStartChange, onTaskSelect, }) => {
     const hasFailedTask = allTaskStatuses.includes(exports.QuickStartTaskStatus.FAILED);
-    const nextQSDisplayName = (_a = nextQuickStart === null || nextQuickStart === void 0 ? void 0 : nextQuickStart.spec) === null || _a === void 0 ? void 0 : _a.displayName;
     const { getResource } = React__namespace.useContext(QuickStartContext);
     return (React__namespace.createElement(React__namespace.Fragment, null,
         React__namespace.createElement(QuickStartTaskHeaderList, { tasks: tasks, allTaskStatuses: allTaskStatuses, onTaskSelect: onTaskSelect }),
         React__namespace.createElement(QuickStartMarkdownView, { content: hasFailedTask
                 ? getResource('One or more verifications did not pass during this quick start. Revisit the tasks or the help links, and then try again.')
                 : conclusion }),
-        nextQuickStart && !hasFailedTask && (React__namespace.createElement(reactCore.Button, { variant: "link", onClick: () => onQuickStartChange(nextQuickStart.metadata.name), isInline: true },
-            getResource('Start {{nextQSDisplayName}} quick start').replace('{{nextQSDisplayName}}', nextQSDisplayName),
-            ' ',
-            React__namespace.createElement(ArrowRightIcon__default['default'], { style: { marginLeft: 'var(--pf-global--spacer--xs)', verticalAlign: 'middle' } })))));
+        !hasFailedTask &&
+            nextQuickStarts &&
+            nextQuickStarts.length > 0 &&
+            nextQuickStarts.map((nextQuickStart, index) => {
+                var _a;
+                return (React__namespace.createElement(reactCore.Button, { variant: "link", onClick: () => onQuickStartChange(nextQuickStart.metadata.name), isInline: true, isBlock: true, key: index },
+                    getResource('Start {{nextQSDisplayName}} quick start').replace('{{nextQSDisplayName}}', (_a = nextQuickStart === null || nextQuickStart === void 0 ? void 0 : nextQuickStart.spec) === null || _a === void 0 ? void 0 : _a.displayName),
+                    ' ',
+                    React__namespace.createElement(ArrowRightIcon__default['default'], { style: { marginLeft: 'var(--pf-global--spacer--xs)', verticalAlign: 'middle' } })));
+            })));
 };
 
-const QuickStartIntroduction = ({ tasks, introduction, allTaskStatuses, onTaskSelect, }) => {
+const QuickStartIntroduction = ({ tasks, introduction, allTaskStatuses, prerequisites, onTaskSelect, }) => {
     const { getResource } = React__namespace.useContext(QuickStartContext);
+    const prereqs = prerequisites === null || prerequisites === void 0 ? void 0 : prerequisites.filter((p) => p);
+    const [isPrereqsExpanded, setIsPrereqsExpanded] = React__namespace.useState(false);
+    const prereqList = (prereqs === null || prereqs === void 0 ? void 0 : prereqs.length) > 0 && (React__namespace.createElement(reactCore.ExpandableSection, { toggleText: getResource('View Prerequisites ({{totalPrereqs}})').replace('{{totalPrereqs}}', prereqs.length), onToggle: () => setIsPrereqsExpanded(!isPrereqsExpanded), className: "pfext-quick-start-intro__prereq" },
+        React__namespace.createElement(reactCore.List, { className: "pfext-quick-start-intro__prereq-list" }, prereqs.map((pr) => {
+            return (React__namespace.createElement(reactCore.ListItem, { key: pr, className: "pfext-quick-start-intro__prereq-list__item" },
+                React__namespace.createElement("span", { className: "pfext-quick-start-intro__prereq-list__item-content" }, pr)));
+        }))));
     return (React__namespace.createElement(React__namespace.Fragment, null,
         React__namespace.createElement(QuickStartMarkdownView, { content: introduction }),
+        prereqList,
         React__namespace.createElement("p", { style: { marginBottom: 'var(--pf-global--spacer--md)' } },
             getResource('In this quick start, you will complete {{count, number}} task', tasks.length).replace('{{count, number}}', tasks.length),
             ":"),
@@ -1945,7 +1985,7 @@ const QuickStartTaskReview = ({ review, taskStatus, onTaskReview, }) => {
         'pfext-quick-start-task-review--failed': taskStatus === exports.QuickStartTaskStatus.FAILED,
     });
     const title = React__namespace.createElement("span", { className: alertClassNames }, getResource('Check your work'));
-    return (React__namespace.createElement(reactCore.Alert, { variant: getAlertVariant(taskStatus), title: title, isInline: true },
+    return (React__namespace.createElement(reactCore.Alert, { className: "pfext-quick-start-task-review-alert", variant: getAlertVariant(taskStatus), title: title, isInline: true },
         React__namespace.createElement(QuickStartMarkdownView, { content: instructions }),
         React__namespace.createElement("span", { className: "pfext-quick-start-task-review__actions" },
             React__namespace.createElement(reactCore.Radio, { id: "review-success", name: "review-success", "data-testid": "qs-drawer-check-yes", label: getResource('Yes'), className: "pfext-quick-start-task-review__radio", isChecked: taskStatus === exports.QuickStartTaskStatus.SUCCESS, onChange: () => onTaskReview(exports.QuickStartTaskStatus.SUCCESS) }),
@@ -1954,31 +1994,32 @@ const QuickStartTaskReview = ({ review, taskStatus, onTaskReview, }) => {
 };
 
 const QuickStartTasks = ({ tasks, taskNumber, allTaskStatuses, onTaskReview, onTaskSelect, }) => {
-    const { getResource } = React__namespace.useContext(QuickStartContext);
+    const { getResource, alwaysShowTaskReview } = React__namespace.useContext(QuickStartContext);
     return (React__namespace.createElement("div", { className: "pfext-quick-start-tasks__list" }, tasks
         .filter((_, index) => allTaskStatuses[index] !== exports.QuickStartTaskStatus.INIT)
         .map((task, index) => {
         const { title, description, review } = task;
         const isActiveTask = index === taskNumber;
         const taskStatus = allTaskStatuses[index];
+        const shouldShowTaskReview = (!QUICKSTART_TASKS_INITIAL_STATES.includes(taskStatus) || alwaysShowTaskReview) &&
+            review;
         return (React__namespace.createElement(React__namespace.Fragment, { key: title },
             React__namespace.createElement(QuickStartTaskHeader, { taskIndex: index + 1, title: title, size: "md", subtitle: getResource('{{index, number}} of {{tasks, number}}')
                     .replace('{{index, number}}', index + 1)
                     .replace('{{tasks, number}}', tasks.length), taskStatus: taskStatus, isActiveTask: isActiveTask, onTaskSelect: onTaskSelect }),
             isActiveTask && (React__namespace.createElement("div", { style: { marginBottom: 'var(--pf-global--spacer--md)' } },
                 React__namespace.createElement(QuickStartMarkdownView, { content: description }),
-                !QUICKSTART_TASKS_INITIAL_STATES.includes(taskStatus) && review && (React__namespace.createElement(QuickStartTaskReview, { review: review, taskStatus: taskStatus, onTaskReview: onTaskReview }))))));
+                shouldShowTaskReview && (React__namespace.createElement(QuickStartTaskReview, { review: review, taskStatus: taskStatus, onTaskReview: onTaskReview }))))));
     })));
 };
 
 const QuickStartContent = React__namespace.forwardRef(({ quickStart, nextQuickStarts = [], taskNumber, allTaskStatuses, onTaskSelect, onTaskReview, onQuickStartChange, }, ref) => {
-    const { spec: { introduction, tasks, conclusion }, } = quickStart;
+    const { spec: { introduction, tasks, conclusion, prerequisites }, } = quickStart;
     const totalTasks = tasks.length;
-    const nextQS = nextQuickStarts.length > 0 && nextQuickStarts[0];
     return (React__namespace.createElement("div", { className: "pfext-quick-start-content", ref: ref },
-        taskNumber === -1 && (React__namespace.createElement(QuickStartIntroduction, { tasks: tasks, allTaskStatuses: allTaskStatuses, introduction: introduction, onTaskSelect: onTaskSelect })),
+        taskNumber === -1 && (React__namespace.createElement(QuickStartIntroduction, { tasks: tasks, allTaskStatuses: allTaskStatuses, introduction: introduction, prerequisites: prerequisites, onTaskSelect: onTaskSelect })),
         taskNumber > -1 && taskNumber < totalTasks && (React__namespace.createElement(QuickStartTasks, { tasks: tasks, taskNumber: taskNumber, allTaskStatuses: allTaskStatuses, onTaskReview: onTaskReview, onTaskSelect: onTaskSelect })),
-        taskNumber === totalTasks && (React__namespace.createElement(QuickStartConclusion, { tasks: tasks, conclusion: conclusion, allTaskStatuses: allTaskStatuses, nextQuickStart: nextQS, onQuickStartChange: onQuickStartChange, onTaskSelect: onTaskSelect }))));
+        taskNumber === totalTasks && (React__namespace.createElement(QuickStartConclusion, { tasks: tasks, conclusion: conclusion, allTaskStatuses: allTaskStatuses, nextQuickStarts: nextQuickStarts, onQuickStartChange: onQuickStartChange, onTaskSelect: onTaskSelect }))));
 });
 
 const QuickStartFooter = ({ status, taskNumber, totalTasks, onNext, onBack, footerClass, quickStartId, }) => {
@@ -2016,8 +2057,7 @@ const QuickStartFooter = ({ status, taskNumber, totalTasks, onNext, onBack, foot
     }, [taskNumber, totalTasks, PrimaryButtonText, status]);
     const getPrimaryButton = React__namespace.useMemo(() => (React__namespace.createElement(reactCore.Button, { variant: "primary", className: "pfext-quick-start-footer__actionbtn", onClick: onNext, "data-testid": `qs-drawer-${camelize(getPrimaryButtonText)}`, "data-test": `${getPrimaryButtonText} button` }, getPrimaryButtonText)), [getPrimaryButtonText, onNext]);
     const getSecondaryButton = React__namespace.useMemo(() => taskNumber === -1 && status !== exports.QuickStartStatus.NOT_STARTED ? (React__namespace.createElement(reactCore.Button, { variant: "secondary", onClick: onRestart, "data-testid": "qs-drawer-restart" }, SecondaryButtonText.RESTART)) : (taskNumber > -1 && (React__namespace.createElement(reactCore.Button, { variant: "secondary", onClick: onBack, "data-testid": "qs-drawer-back" }, SecondaryButtonText.BACK))), [onRestart, onBack, SecondaryButtonText, status, taskNumber]);
-    const getSideNoteAction = React__namespace.useMemo(() => status === exports.QuickStartStatus.COMPLETE &&
-        taskNumber === totalTasks && (React__namespace.createElement(reactCore.Button, { variant: "link", className: "pfext-quick-start-footer__restartbtn", onClick: onRestart, "data-testid": "qs-drawer-side-note-action" }, SecondaryButtonText.RESTART)), [status, SecondaryButtonText, onRestart, taskNumber, totalTasks]);
+    const getSideNoteAction = React__namespace.useMemo(() => taskNumber !== -1 && (React__namespace.createElement(reactCore.Button, { variant: "link", className: "pfext-quick-start-footer__restartbtn", onClick: onRestart, "data-testid": "qs-drawer-side-note-action" }, SecondaryButtonText.RESTART)), [taskNumber, onRestart, SecondaryButtonText.RESTART]);
     return (React__namespace.createElement("div", { className: `pfext-quick-start-footer ${footerClass}` },
         getPrimaryButton,
         getSecondaryButton,
@@ -2071,6 +2111,13 @@ const getElement = (appendTo) => {
     }
     return appendTo;
 };
+const useScrollTopOnTaskNumberChange = (node, taskNumber) => {
+    React__namespace.useEffect(() => {
+        if (node) {
+            node.scrollTo({ top: 0, behavior: 'smooth' });
+        }
+    }, [taskNumber, node]);
+};
 const QuickStartPanelContent = (_a) => {
     var { quickStarts = [], handleClose, activeQuickStartID, appendTo, isResizable = true, showClose = true } = _a, props = tslib.__rest(_a, ["quickStarts", "handleClose", "activeQuickStartID", "appendTo", "isResizable", "showClose"]);
     const { getResource } = React__namespace.useContext(QuickStartContext);
@@ -2079,6 +2126,7 @@ const QuickStartPanelContent = (_a) => {
     const quickStart = quickStarts.find((qs) => qs.metadata.name === activeQuickStartID);
     const { activeQuickStartState } = React__namespace.useContext(QuickStartContext);
     const taskNumber = activeQuickStartState === null || activeQuickStartState === void 0 ? void 0 : activeQuickStartState.taskNumber;
+    useScrollTopOnTaskNumberChange(contentRef, taskNumber);
     const nextQuickStarts = quickStarts.filter((qs) => { var _a; return (_a = quickStart === null || quickStart === void 0 ? void 0 : quickStart.spec.nextQuickStart) === null || _a === void 0 ? void 0 : _a.includes(qs.metadata.name); });
     const headerClasses = reactStyles.css('pfext-quick-start-panel-content__header', {
         'pfext-quick-start-panel-content__header__shadow': shadows === Shadows.top || shadows === Shadows.both,
@@ -2096,7 +2144,7 @@ const QuickStartPanelContent = (_a) => {
         }
         return Number.parseInt(taskNumber, 10) + 1;
     };
-    const content = quickStart ? (React__namespace.createElement(reactCore.DrawerPanelContent, Object.assign({ isResizable: isResizable, className: "pfext-quick-start-panel-content", "data-testid": `qs-drawer-${camelize(quickStart.spec.displayName)}`, "data-qs": `qs-step-${getStep()}`, "data-test": "quickstart drawer" }, props),
+    const content = quickStart ? (React__namespace.createElement(reactCore.DrawerPanelContent, Object.assign({ isResizable: isResizable, className: "pfext-quick-start__base", "data-testid": `qs-drawer-${camelize(quickStart.spec.displayName)}`, "data-qs": `qs-step-${getStep()}`, "data-test": "quickstart drawer" }, props),
         React__namespace.createElement("div", { className: headerClasses },
             React__namespace.createElement(reactCore.DrawerHead, null,
                 React__namespace.createElement("div", { className: "pfext-quick-start-panel-content__title" },
@@ -2115,7 +2163,7 @@ const QuickStartPanelContent = (_a) => {
 };
 
 const QuickStartContainer = (_a) => {
-    var { quickStarts, children, activeQuickStartID, allQuickStartStates, setActiveQuickStartID, setAllQuickStartStates, appendTo, fullWidth, onCloseInProgress, onCloseNotInProgress, resourceBundle, showCardFooters, language, loading = false, useQueryParams = true, markdown, contextProps } = _a, props = tslib.__rest(_a, ["quickStarts", "children", "activeQuickStartID", "allQuickStartStates", "setActiveQuickStartID", "setAllQuickStartStates", "appendTo", "fullWidth", "onCloseInProgress", "onCloseNotInProgress", "resourceBundle", "showCardFooters", "language", "loading", "useQueryParams", "markdown", "contextProps"]);
+    var { quickStarts, children, activeQuickStartID, allQuickStartStates, setActiveQuickStartID, setAllQuickStartStates, appendTo, fullWidth, onCloseInProgress, onCloseNotInProgress, resourceBundle, showCardFooters, language, loading = false, useQueryParams = true, markdown, contextProps, alwaysShowTaskReview = false } = _a, props = tslib.__rest(_a, ["quickStarts", "children", "activeQuickStartID", "allQuickStartStates", "setActiveQuickStartID", "setAllQuickStartStates", "appendTo", "fullWidth", "onCloseInProgress", "onCloseNotInProgress", "resourceBundle", "showCardFooters", "language", "loading", "useQueryParams", "markdown", "contextProps", "alwaysShowTaskReview"]);
     const valuesForQuickstartContext = useValuesForQuickStartContext(Object.assign({ allQuickStarts: quickStarts, activeQuickStartID,
         setActiveQuickStartID,
         allQuickStartStates,
@@ -2123,7 +2171,8 @@ const QuickStartContainer = (_a) => {
             show: showCardFooters,
         }, language, resourceBundle: Object.assign({}, resourceBundle), loading,
         useQueryParams,
-        markdown }, contextProps));
+        markdown,
+        alwaysShowTaskReview }, contextProps));
     React__namespace.useEffect(() => {
         if (quickStarts &&
             JSON.stringify(quickStarts) !== JSON.stringify(valuesForQuickstartContext.allQuickStarts)) {