Merge branch 'patternfly:main' into main

package.json

@@ -34,10 +34,10 @@
     ]
   },
   "devDependencies": {
-    "@patternfly/patternfly": "5.2.1",
-    "@patternfly/react-code-editor": "5.2.2",
-    "@patternfly/react-core": "5.2.2",
-    "@patternfly/react-table": "5.2.2",
+    "@patternfly/patternfly": "5.3.0-prerelease.5",
+    "@patternfly/react-code-editor": "5.3.0-prerelease.25",
+    "@patternfly/react-core": "5.3.0-prerelease.23",
+    "@patternfly/react-table": "5.3.0-prerelease.25",
     "@octokit/rest": "^19.0.7",
     "glob": "^8.1.0",
     "lerna": "^6.4.1",

packages/ast-helpers/CHANGELOG.md

@@ -3,6 +3,36 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 1.10.0 (2024-04-02)
+
+
+### Features
+
+* **Templates:** add to org site ([#3947](https://github.com/patternfly/patternfly-org/issues/3947)) ([a869dee](https://github.com/patternfly/patternfly-org/commit/a869dee87cc39296df9226f3fc1d780dce893a54))
+
+
+
+
+
+## 1.9.1 (2024-04-02)
+
+**Note:** Version bump only for package @patternfly/ast-helpers
+
+
+
+
+
+# 1.9.0 (2024-04-02)
+
+
+### Features
+
+* **docs:** update medium articles ([#3950](https://github.com/patternfly/patternfly-org/issues/3950)) ([5288ec1](https://github.com/patternfly/patternfly-org/commit/5288ec1fb1f7e744ed142585384840c8d415d9e5))
+
+
+
+
+
 ## 1.8.3 (2024-03-28)
 
 **Note:** Version bump only for package @patternfly/ast-helpers

packages/ast-helpers/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@patternfly/ast-helpers",
   "description": "Acorn AST helpers for working with live code",
-  "version": "1.8.3",
+  "version": "1.10.0",
   "author": "Red Hat",
   "license": "MIT",
   "publishConfig": {

packages/documentation-framework/CHANGELOG.md

@@ -3,6 +3,36 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 5.10.0 (2024-04-02)
+
+
+### Features
+
+* **Templates:** add to org site ([#3947](https://github.com/patternfly/patternfly-org/issues/3947)) ([a869dee](https://github.com/patternfly/patternfly-org/commit/a869dee87cc39296df9226f3fc1d780dce893a54))
+
+
+
+
+
+## 5.9.1 (2024-04-02)
+
+**Note:** Version bump only for package @patternfly/documentation-framework
+
+
+
+
+
+# 5.9.0 (2024-04-02)
+
+
+### Features
+
+* **docs:** update medium articles ([#3950](https://github.com/patternfly/patternfly-org/issues/3950)) ([5288ec1](https://github.com/patternfly/patternfly-org/commit/5288ec1fb1f7e744ed142585384840c8d415d9e5))
+
+
+
+
+
 ## 5.8.3 (2024-03-28)
 
 **Note:** Version bump only for package @patternfly/documentation-framework

packages/documentation-framework/components/cssVariables/cssVariables.js

@@ -180,7 +180,7 @@ export class CSSVariables extends React.Component {
             <Tr>
               {!this.props.hideSelectorColumn && (
                 <React.Fragment>
-                  <Th />
+                  <Th screenReaderText="Expand or collapse column" />
                   <Th>Selector</Th>
                 </React.Fragment>
               )}

packages/documentation-framework/components/sideNav/sideNav.js

@@ -96,7 +96,7 @@ const ExpandableNav = ({groupedRoutes, location, section, subsection = null}) =>
                   source.source === "react-deprecated" || source.source === "html-deprecated")
                 && !navObj.sources.some(source => source.source === "react" || source.source === "html")
               ),
-              isBeta: navObj.sources.some(source => source.beta && source.source !== 'react-next'),
+              isBeta: navObj.sources.some(source => source.beta && source.source !== 'react-next' && source.source !== 'react-templates'),
               isDemo: navObj.sources.some(source => (
                   source.source === "react-demos" || source.source === "html-demos")
                 && !navObj.sources.some(source => source.source === "react" || source.source === "html")

packages/documentation-framework/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@patternfly/documentation-framework",
   "description": "A framework to build documentation for PatternFly.",
-  "version": "5.8.3",
+  "version": "5.10.0",
   "author": "Red Hat",
   "license": "MIT",
   "private": false,
@@ -13,7 +13,7 @@
     "@babel/preset-env": "^7.24.3",
     "@babel/preset-react": "^7.24.1",
     "@mdx-js/util": "1.6.16",
-    "@patternfly/ast-helpers": "^1.8.3",
+    "@patternfly/ast-helpers": "^1.10.0",
     "@reach/router": "npm:@gatsbyjs/[email protected]",
     "autoprefixer": "9.8.6",
     "babel-loader": "^9.1.3",
@@ -73,10 +73,10 @@
     "webpack-merge": "5.8.0"
   },
   "peerDependencies": {
-    "@patternfly/patternfly": "5.2.1",
-    "@patternfly/react-code-editor": "5.2.2",
-    "@patternfly/react-core": "5.2.2",
-    "@patternfly/react-table": "5.2.2",
+    "@patternfly/patternfly": "5.3.0-prerelease.5",
+    "@patternfly/react-code-editor": "5.3.0-prerelease.25",
+    "@patternfly/react-core": "5.3.0-prerelease.23",
+    "@patternfly/react-table": "5.3.0-prerelease.25",
     "react": "^17.0.0 || ^18.0.0",
     "react-dom": "^17.0.0 || ^18.0.0"
   }

packages/documentation-framework/templates/mdx.js

@@ -158,7 +158,7 @@ export const MDXTemplate = ({
   componentsData
 }) => {
   const isDeprecated = sources.some(source => source.source === "react-deprecated" || source.source === "html-deprecated") && !sources.some(source => source.source === "react"  || source.source === "html");
-  const isBeta = sources.some(source => source.beta && source.source !== 'react-next')
+  const isBeta = sources.some(source => source.beta && source.source !== 'react-next' && source.source !== 'react-templates');
   const isDemo = sources.some(source => source.source === "react-demos" || source.source === "html-demos") && !sources.some(source => source.source === "react" || source.source === "html");
   // Build obj mapping source names to text displayed on tabs
   const tabNames = sources.reduce((acc, curSrc) => {

packages/documentation-framework/versions.json

@@ -1,9 +1,34 @@
 {
   "Releases": [
+    {
+      "name": "5.3.0",
+      "date": "2024-04-02",
+      "latest": true,
+      "versions": {
+        "@patternfly/patternfly": "5.3.0-prerelease.5",
+        "@patternfly/react-charts": "7.3.0-prerelease.6",
+        "@patternfly/react-code-editor": "5.3.0-prerelease.25",
+        "@patternfly/react-core": "5.3.0-prerelease.23",
+        "@patternfly/react-icons": "5.3.0-prerelease.3",
+        "@patternfly/react-styles": "5.3.0-prerelease.3",
+        "@patternfly/react-table": "5.3.0-prerelease.25",
+        "@patternfly/react-drag-drop": "5.3.0-prerelease.23",
+        "@patternfly/react-tokens": "5.3.0-prerelease.3",
+        "@patternfly/react-catalog-view-extension": "5.0.0",
+        "@patternfly/react-component-groups": "5.1.0",
+        "@patternfly/react-console": "5.0.0",
+        "@patternfly/react-log-viewer": "5.2.0",
+        "@patternfly/react-topology": "5.3.0-prerelease.5",
+        "@patternfly/react-user-feedback": "5.0.0",
+        "@patternfly/react-virtualized-extension": "5.0.0",
+        "@patternfly/quickstarts": "5.3.0-prerelease.1",
+        "@patternfly/react-templates": "1.0.0-prerelease.6"
+      }
+    },
     {
       "name": "5.2.2",
       "date": "2024-03-12",
-      "latest": true,
+      "hidden": true,
       "versions": {
         "@patternfly/patternfly": "5.2.1",
         "@patternfly/react-charts": "7.2.2",

packages/documentation-site/package.json

@@ -17,13 +17,13 @@
     "screenshots": "pf-docs-framework screenshots"
   },
   "dependencies": {
-    "@patternfly/documentation-framework": "^5.4.2",
-    "@patternfly/quickstarts": "^5.1.0",
+    "@patternfly/documentation-framework": "^5.9.0",
+    "@patternfly/quickstarts": "^5.3.0-prerelease.1",
     "@patternfly/react-catalog-view-extension": "5.0.0",
     "@patternfly/react-console": "5.0.0",
-    "@patternfly/react-docs": "6.2.2",
+    "@patternfly/react-docs": "6.3.0-prerelease.31",
     "@patternfly/react-log-viewer": "5.1.0",
-    "@patternfly/react-topology": "5.2.1",
+    "@patternfly/react-topology": "5.3.0-prerelease.5",
     "@patternfly/react-user-feedback": "5.0.0",
     "@patternfly/react-component-groups": "5.1.0",
     "@patternfly/react-virtualized-extension": "5.0.0",

packages/documentation-site/patternfly-docs/content/get-started/release-highlights.md

@@ -7,6 +7,76 @@ section: get-started
 import './get-started.css';
 import { Divider } from '@patternfly/react-core';
 
+## PatternFly 5.3
+
+PatternFly 5.3 is now live! Here are the highlights from this release. 
+
+### React templates 
+We created a new feature for React components, called "templates", which combine a component with logic that supports a specific use case. Templates also come with a streamlined API that offers additional, limited customization. This will help reduce the amount of boilerplate code needed for common and recurring use cases.
+
+Templates will also make it easier to upgrade your deprecated components going forward. For example, you can use a template to upgrade from the [current version of our select component](/components/menus/select) from [the deprecated version.](/components/menus/select/react-deprecated)
+
+### Component updates 
+
+#### Menu toggle with status indicator
+We added support for a status indicator [within the menu toggle component.](/components/menus/menu-toggle#status) This allows you to associate a menu toggle item with different statuses, such as "success", "warning", and "danger", so that users have more context about the effect that a selection may have. 
+
+Because [the select component](/components/menus/select) is built with a menu toggle, this status indication can also be utilized by select components, [as shown in this example.](/components/menus/select#with-validation) This update replicates functionality that was present in [the now deprecated select component](/components/menus/select/react-deprecated), which has not been supported in our current implementation until now. With this addition, you can now migrate any select components using validation to our updated select implementation.
+
+<img src="./img/menu-toggle-status.png" alt="Menu toggles with success, warning, and danger status indicators." width="300px"/>
+
+#### Dual list selector "next" version
+We created the "next" version of [the dual list selector component](/components/dual-list-selector), which offers a simpler, more composable implementation. We also updated all examples to be solely comprised of composable components.
+
+**Note:** As a reminder, our next components will be promoted with our next major release. Once a next component is promoted, it becomes the default recommended implementation for that component.
+
+#### Form select component bug fix
+We found a bug in [the form select component](/components/forms/form-select) that occasionally rendered the wrong color for menu items when a select menu placeholder was used in certain OS/browser combinations. We corrected this issue, so the appropriate color will now be used consistently.
+
+### Topology pipeline updates
+To enhance and improve the experience using [topology pipelines](/topology/pipelines), we added a few new features.
+
+#### New layouts
+We introduced a new vertical layout that can display pipelines from top to bottom, rather than the previous left-to-right default.
+
+<img src="./img/topology-vertical-pipelines.png" alt="Topology pipeline in a top-to-bottom vertical presentation." width="500px"/>
+
+We also added support for groups in pipeline views, which allows you to combine and nest graphs. Groups are supported in both vertical and horizontal layouts.
+
+<img src="./img/topology-pipeline-groups.png" alt="Multiple topology pipelines grouped within a pipeline." width="650px"/>
+
+#### Functional and visual enhancements
+To add more flexibility to topology pipelines, we added support for a couple of new features. These features introduce: 
+- Arrows as directional indicators between pipeline tasks. 
+
+  <img src="./img/topology-pipeline-arrows.png" alt="Topology pipeline with arrows between tasks." width="450px"/>
+
+- The ability to collapse and expand pipeline groups.
+
+  <img src="./img/topology-pipeline-expansion.png" alt="Topology pipeline before and after being collapsed." width="650px"/>
+
+### Quick starts extension updates
+We made a few updates to [our quick starts extension](/extensions/quick-starts), which lives in [the patternfly/patternfly-quickstarts repository.](https://github.com/patternfly/patternfly-quickstarts)
+
+#### Removed AsciiDoc code
+To clean up our codebase and processes, we removed AsciiDoc examples, which were no longer being utilized by any products. We still have support for AsciiDoc, but we generally recommend using Markdown instead.
+
+#### New bookmarks feature
+We added new functionality to cards in quick starts, which allows users to bookmark cards as needed. 
+
+<img src="./img/quickstarts-bookmark.png" alt="Card with bookmark action icon." width="300px"/>
+
+#### Bug fixes
+We fixed a few issues to enable: 
+- Clickable cards.
+- Active and hover card styles.
+- Links that open in a new tab.
+
+### Coming soon
+The release of our v6 alpha will be here soon. Keep an eye on [our Medium publication](https://medium.com/patternfly) and the PatternFly website for updates. We'll be sure to share an announcement as soon as the alpha is live!
+
+<Divider></Divider>
+
 ## PatternFly 5.2.2
 
 PatternFly 5.2.2 is now live! This was a patch release to fix a significant bug that was found.

packages/documentation-site/patternfly-docs/pages/featured-posts-data.js

@@ -1,5 +1,14 @@
 export const featuredPostsData = {
   post1: {
+    title: "Welcome to the PatternFly 6 alpha",
+    author: "Erin Donehoo",
+    length: "3 min read",
+    URL: "https://medium.com/patternfly/welcome-to-the-patternfly-6-alpha-6d6f64de5a73",
+    // Use resize:fit:600 in URL
+    imageURL:
+      "https://miro.medium.com/v2/resize:fit:600/format:webp/0*tc9YA_4LEFm1AZm9",
+  },
+  post2: {
     title: "Introducing component groups",
     author: "Filip Hlavac",
     length: "4 min read",
@@ -8,21 +17,15 @@ export const featuredPostsData = {
     imageURL:
       "https://miro.medium.com/v2/resize:fit:600/format:webp/0*j9kT2OT7NJuKJRwX",
   },
-  post2: {
-    title: "Webpack module federation | Think twice before sharing a dependency",
+  post3: {
+    title:
+      "Webpack module federation | Think twice before sharing a dependency",
     author: "Martin Maroši",
     length: "9 min read",
     URL: "https://medium.com/@marvusm.mmi/webpack-module-federation-think-twice-before-sharing-a-dependency-18b3b0e352cb",
     // Use resize:fit:600 in URL
-    imageURL: "https://miro.medium.com/v2/resize:fit:600/format:webp/1*wvPsa-Gq_sblqb51mCto7w.png",
-  },
-  post3: {
-    title: "Why did the chicken cross the road",
-    author: "Kevin Hatchoua",
-    length: "3 min read",
-    URL: "https://medium.com/patternfly/why-did-the-chicken-cross-the-road-1d4a43521dc3",
-    // Use resize:fit:600 in URL
-    imageURL: "https://miro.medium.com/v2/resize:fit:600/format:webp/0*B5u7pOVCF8vzeckn",
+    imageURL:
+      "https://miro.medium.com/v2/resize:fit:600/format:webp/1*wvPsa-Gq_sblqb51mCto7w.png",
   },
   post4: {
     title: "Migrating PatternFly v4 to v5",