@patternfly/patternfly 6.2.0 → 6.2.2

package/.gitignore

@@ -0,0 +1,25 @@
+/dist/
+**/node_modules/
+.sass-cache/
+/.vscode/
+/.cache/
+/public/
+/tmp/
+/src/icons/**/*.svg
+.DS_Store
+.blueprints
+npm-debug.log
+yarn-error.log
+package-lock.json
+/.idea
+/coverage/
+*.swp
+/workspace/
+/assets/
+/scripts/sizeReport/package-lock.json
+/scripts/sizeReport/report.html
+patternfly-docs/generated/**/*.js
+backstop_data/bitmaps_test*
+backstop_data/html_report*
+backstop_data/reports
+.history

package/.npmignore

@@ -0,0 +1,7 @@
+*
+*/
+!/dist
+!/dist/*
+!/dist/**/*
+!.gitignore
+!.npmignore

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Red Hat, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/README.md

@@ -0,0 +1,123 @@
+# PatternFly
+
+## Install
+
+- This assumes an environment is already set up for npm packages - if not, please use npm init following the steps at [https://docs.npmjs.com/getting-started/using-a-package.json](https://docs.npmjs.com/getting-started/using-a-package.json).
+- run `npm install @patternfly/patternfly --save`
+
+When you install PatternFly, the package includes:
+
+- a single file for the entire compiled library: `node_modules/@patternfly/patternfly/patternfly.css`
+- individual files with each component compiled separately: `node_modules/@patternfly/patternfly/<ComponentName>/styles.css`
+- a single file for the entire library's source (SASS): `node_modules/@patternfly/patternfly/patternfly.scss`
+- individual files for each component's source (SASS): `node_modules/@patternfly/patternfly/<ComponentName>/styles.scss`
+
+Any of the files above are meant for use in consuming the library. The recommended consumption approach will vary from project to project.
+
+## Development
+
+**PatternFly Development requires Node v18.0.0 or greater**
+
+To setup the PatternFly development environment:
+
+- clone the project
+- run `yarn install` from the project root
+- run `yarn start`
+- open your browser to `http://localhost:8001`
+
+After working on your contribution, check for [accessibility violations](#testing-for-accessibility).
+
+### Create components, layouts...
+
+To create source file scaffolding for a new component, layout, utility, or demo, run the NPM script:
+
+`node generate <CamelName>`
+
+Below are the full options for this script:
+
+```sh
+Options:
+  -f, --folder <folder>  Source folder (components, demos, layouts, or utilities) (default: "components")
+```
+
+#### Examples
+
+To create a "Test component" component (`.pf-v6-c-test-component`), run:
+
+`node generate TestComponent`
+
+To create a "Test layout" layout (`.pf-l-test-layout`), run:
+
+`node generate TestLayout -f layouts`
+
+To create 3 new demos named "Test demo", "Test demo 2", and "Test demo 3", run:
+
+`node generate TestDemo TestDemo2 TestDemo3 -f demos`
+
+
+#### Update screenshots
+When making visual changes to a full page example, new example preview screenshots must be generated. To update the screenshots:
+
+- open a terminal and run `yarn build && yarn serve`
+- in another terminal, run `yarn screenshots`
+
+## Guidelines for CSS development
+
+- For issues created in Core that will affect a component in PF-React, a follow up issue must be created in PF-React once the Pull Request is merged. The issue should include the Core PR #, the Core Release, a link to the component in https://core-staging.patternfly.org, and information detailing the change.
+- If global variables are modified in Core, a React issue should be opened to address this.
+- CSS developers should ensure that animation is well documented and communicated to the respective React developer.
+- Once the component/enhancement is complete it should receive sign off from a visual designer who can then update the master sketch file with any changes.
+
+### Handlebars guidelines 
+[For information on how to contribute, refer to our guidelines.](https://core-staging.patternfly.org/contribution)
+
+### CSS/Sass guidelines
+[For more information on using CSS and Sass, refer to our guidelines.](https://core-staging.patternfly.org/guidelines)
+
+### Custom icon guidelines
+[For more information on custom icons, refer to our guidelines.](https://core-staging.patternfly.org/adding-custom-icons)
+
+## Beta components
+
+When creating a brand new component, it should be released as beta in order to get feedback.
+
+## Testing for accessibility
+
+PatternFly uses [aXe: The Accessibility Engine](https://www.deque.com/axe/) to check for accessibility violations. Our goal is to meet WCAG 2.0 AA requirements, as noted in our [Accessibility guide](https://www.patternfly.org/accessibility/patternflys-accessibility).
+
+### How to perform an accessibility audit with aXe
+aXe is available as either a browser extension or npm script.
+
+To run the a11y audit locally:
+
+- install the latest [chromedriver](http://chromedriver.chromium.org/downloads) and ensure its available on your system `$PATH`
+  - macOS users can simply `brew cask install chromedriver`
+- open a terminal and run `yarn build && yarn serve`
+- in another terminal, run `yarn a11y`
+
+The tool is configured to return WCAG 2.0 AA violations for the full page renderings of all components, layouts, utilities, and demos. The tool will provide feedback about what the violation is and a link to documentation about how to address the violation.
+
+The same tool is also available as a browser extension for [Chrome](https://chrome.google.com/webstore/detail/axe-devtools-web-accessib/lhdoppojpmngadmnindnejefpokejbdd) and [Firefox](https://addons.mozilla.org/en-US/firefox/addon/axe-devtools/).
+
+### Fixing violations
+
+Ignore the violations that aren’t related to your contribution.
+
+Fix violations related to your contribution.
+
+If there are violations that are not obvious how to fix, then [create an issue](https://github.com/patternfly/patternfly/issues/new) with information about the violation that was found. For example, some violations might require further discussion before they can be addressed. And some violations may not be valid and require changes to the workspace or tooling to stop flagging the violation.
+
+If you have any suggestions about ways that we can improve how we use this tool, please let us know by opening an issue.
+
+## FAQ
+
+#### CSS Variables
+[How do I use CSS variables to customize the library?](https://core-staging.patternfly.org/guidelines#variables)
+
+#### Browser support
+PatternFly is supported on the latest two major versions of the following browsers:
+
+- Chrome
+- Firefox
+- Safari
+- Edge

package/{components → dist/components}/CodeEditor/code-editor.css

@@ -148,6 +148,9 @@
 .pf-v6-c-code-editor__main .monaco-editor {
   background-color: var(--pf-v6-c-code-editor__main--BackgroundColor);
 }
+.pf-v6-c-code-editor__main a.label-name {
+  text-decoration-line: none;
+}
 
 .pf-v6-c-code-editor__header + .pf-v6-c-code-editor__main {
   border-block-start-width: 0;

package/{components → dist/components}/CodeEditor/code-editor.scss

@@ -157,7 +157,7 @@
 }
 
 .#{$code-editor}__main {
-  position: relative; 
+  position: relative;
   flex-grow: 1;
   color: var(--#{$code-editor}__main--Color, inherit);
   background-color: var(--#{$code-editor}__main--BackgroundColor);
@@ -175,6 +175,8 @@
   .monaco-editor {
     background-color: var(--#{$code-editor}__main--BackgroundColor);
   }
+
+  a.label-name { text-decoration-line: none; } // revert normalize.scss
   // stylelint-enable selector-class-pattern
 }
 

package/{components → dist/components}/Page/page.css

@@ -3,8 +3,9 @@
   --pf-v6-c-page--inset: var(--pf-t--global--spacer--inset--page-chrome);
   --pf-v6-c-page--c-masthead--ZIndex: var(--pf-t--global--z-index--md);
   --pf-v6-c-page__sidebar--ZIndex: var(--pf-t--global--z-index--sm);
-  --pf-v6-c-page__sidebar--Width: 18.125rem;
-  --pf-v6-c-page__sidebar--xl--Width: 18.125rem;
+  --pf-v6-c-page__sidebar--Width--base: 18.125rem;
+  --pf-v6-c-page__sidebar--Width: var(--pf-v6-c-page__sidebar--Width--base);
+  --pf-v6-c-page__sidebar--xl--Width: var(--pf-v6-c-page__sidebar--Width--base);
   --pf-v6-c-page__sidebar--BackgroundColor: var(--pf-t--global--background--color--secondary--default);
   --pf-v6-c-page__sidebar--BoxShadow: none;
   --pf-v6-c-page__sidebar--TransitionDuration: var(--pf-t--global--motion--duration--slide-in--default);
@@ -432,7 +433,7 @@
   -webkit-overflow-scrolling: touch;
 }
 @media screen and (min-width: 75rem) {
-  .pf-v6-c-masthead + .pf-v6-c-page__main-container, .pf-v6-c-page__sidebar.pf-m-collapsed + .pf-v6-c-page__main-container,
+  .pf-v6-c-page.pf-m-no-sidebar, .pf-v6-c-masthead + .pf-v6-c-page__main-container, .pf-v6-c-page__sidebar.pf-m-collapsed + .pf-v6-c-page__main-container,
   .pf-v6-c-masthead + .pf-v6-c-page__drawer,
   .pf-v6-c-page__sidebar.pf-m-collapsed + .pf-v6-c-page__drawer {
     --pf-v6-c-page__main-container--GridArea: var(--pf-v6-c-page--masthead--main-container--GridArea);

package/{components → dist/components}/Page/page.scss

@@ -14,8 +14,9 @@ $pf-page-v6--height-breakpoint-map: build-breakpoint-map("base", "sm", "md", "lg
 
   // Sidebar
   --#{$page}__sidebar--ZIndex: var(--pf-t--global--z-index--sm);
-  --#{$page}__sidebar--Width: #{pf-size-prem(290px)};
-  --#{$page}__sidebar--xl--Width: #{pf-size-prem(290px)}; // TODO Can remove at breaking change
+  --#{$page}__sidebar--Width--base: #{pf-size-prem(290px)};
+  --#{$page}__sidebar--Width: var(--#{$page}__sidebar--Width--base);
+  --#{$page}__sidebar--xl--Width: var(--#{$page}__sidebar--Width--base);
   --#{$page}__sidebar--BackgroundColor: var(--pf-t--global--background--color--secondary--default);
   --#{$page}__sidebar--BoxShadow: none;
 
@@ -352,6 +353,7 @@ $pf-page-v6--height-breakpoint-map: build-breakpoint-map("base", "sm", "md", "lg
   -webkit-overflow-scrolling: touch;
 
   @media screen and (min-width: $pf-v6-global--breakpoint--xl) {
+    @at-root .#{$page}.pf-m-no-sidebar,
     .#{$masthead} + &,
     .#{$page}__sidebar.pf-m-collapsed + & {
       --#{$page}__main-container--GridArea: var(--#{$page}--masthead--main-container--GridArea);

package/{components → dist/components}/_index.css

@@ -3048,6 +3048,9 @@ label.pf-v6-c-check, .pf-v6-c-check__label,
 .pf-v6-c-code-editor__main .monaco-editor {
   background-color: var(--pf-v6-c-code-editor__main--BackgroundColor);
 }
+.pf-v6-c-code-editor__main a.label-name {
+  text-decoration-line: none;
+}
 
 .pf-v6-c-code-editor__header + .pf-v6-c-code-editor__main {
   border-block-start-width: 0;
@@ -11746,8 +11749,9 @@ ul.pf-v6-c-list {
   --pf-v6-c-page--inset: var(--pf-t--global--spacer--inset--page-chrome);
   --pf-v6-c-page--c-masthead--ZIndex: var(--pf-t--global--z-index--md);
   --pf-v6-c-page__sidebar--ZIndex: var(--pf-t--global--z-index--sm);
-  --pf-v6-c-page__sidebar--Width: 18.125rem;
-  --pf-v6-c-page__sidebar--xl--Width: 18.125rem;
+  --pf-v6-c-page__sidebar--Width--base: 18.125rem;
+  --pf-v6-c-page__sidebar--Width: var(--pf-v6-c-page__sidebar--Width--base);
+  --pf-v6-c-page__sidebar--xl--Width: var(--pf-v6-c-page__sidebar--Width--base);
   --pf-v6-c-page__sidebar--BackgroundColor: var(--pf-t--global--background--color--secondary--default);
   --pf-v6-c-page__sidebar--BoxShadow: none;
   --pf-v6-c-page__sidebar--TransitionDuration: var(--pf-t--global--motion--duration--slide-in--default);
@@ -12175,7 +12179,7 @@ ul.pf-v6-c-list {
   -webkit-overflow-scrolling: touch;
 }
 @media screen and (min-width: 75rem) {
-  .pf-v6-c-masthead + .pf-v6-c-page__main-container, .pf-v6-c-page__sidebar.pf-m-collapsed + .pf-v6-c-page__main-container,
+  .pf-v6-c-page.pf-m-no-sidebar, .pf-v6-c-masthead + .pf-v6-c-page__main-container, .pf-v6-c-page__sidebar.pf-m-collapsed + .pf-v6-c-page__main-container,
   .pf-v6-c-masthead + .pf-v6-c-page__drawer,
   .pf-v6-c-page__sidebar.pf-m-collapsed + .pf-v6-c-page__drawer {
     --pf-v6-c-page__main-container--GridArea: var(--pf-v6-c-page--masthead--main-container--GridArea);

package/{docs → dist/docs}/components/Page/examples/Page.md

@@ -412,6 +412,7 @@ This component provides the basic chrome for a page, including sidebar and main
 | `.pf-v6-c-page__main-body` | `<div>` | Creates the body section for a page section. **Required** |
 | `.pf-v6-c-page__main-group` | `<div>` | Creates the group of `.pf-v6-c-page__main-*` sections. Can be used in combination with `.pf-m-sticky-[top/bottom]` to make multiple sections sticky. |
 | `.pf-v6-c-page__drawer` | `<div>` | Creates a container for the drawer component when placing the main page element in the drawer body. |
+| `.pf-m-no-sidebar` | `.pf-v6-c-page` | Modifies the page grid for layouts without a sidebar. |
 | `.pf-m-expanded` | `.pf-v6-c-page__sidebar` | Modifies the sidebar for the expanded state. |
 | `.pf-m-collapsed` | `.pf-v6-c-page__sidebar` | Modifies the sidebar for the collapsed state. |
 | `.pf-m-page-insets` | `.pf-v6-c-page__sidebar-body` | Modifies a sidebar body padding/inset to visually match padding of page elements. |

package/{docs → dist/docs}/demos/Masthead/examples/Masthead.md

@@ -2066,7 +2066,7 @@ wrapperTag: div
 ### Horizontal nav
 
 ```html isFullscreen
-<div class="pf-v6-c-page" id="masthead-horizontal-nav">
+<div class="pf-v6-c-page pf-m-no-sidebar" id="masthead-horizontal-nav">
   <div class="pf-v6-c-skip-to-content">
     <a
       class="pf-v6-c-button pf-m-primary"

package/{docs → dist/docs}/demos/Nav/examples/Nav.md

@@ -1036,7 +1036,7 @@ section: components
 ### Horizontal nav
 
 ```html isFullscreen
-<div class="pf-v6-c-page" id="nav-horizontal-example">
+<div class="pf-v6-c-page pf-m-no-sidebar" id="nav-horizontal-example">
   <div class="pf-v6-c-skip-to-content">
     <a
       class="pf-v6-c-button pf-m-primary"
@@ -1678,7 +1678,7 @@ section: components
 ### Horizontal nav with horizontal subnav
 
 ```html isFullscreen
-<div class="pf-v6-c-page" id="nav-horizontal-example">
+<div class="pf-v6-c-page pf-m-no-sidebar" id="nav-horizontal-example">
   <div class="pf-v6-c-skip-to-content">
     <a
       class="pf-v6-c-button pf-m-primary"