playbook_ui 10.16.0 → 10.19.0.pre.popover.alpha1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cb62e7e4c4ce0582f7c7af3baec2eb4b35cb022ca13dc4b373e768f69bbbd32
-  data.tar.gz: 94a24d2c6cc426fcde35a23e33dafe44aec865a0913acba42fa716590eaaedb2
+  metadata.gz: '090e97cafaabff3f06f58cca0ce4a1416d09f6baea9f828e51c93059f279f292'
+  data.tar.gz: 580359a862a8567240f9759e2ab80b708688d528ddc054789e6f658352cc21e1
 SHA512:
-  metadata.gz: 9629982686a67ac50d4a4687ab2cb8194e5796982ba91459842efb615b2167fd92342cb3e60e645da24dc6291e944059248d38a50f85a8b746bd820b6f8d53ea
-  data.tar.gz: 05e31457c3ace5f05fa663d5031cc5d3367e0eb3b58f61c00df6b9d5df495ed91254335f74e10eaee5f807f611e70c3c408fb14248d60e2777dc93975ce3eb68
+  metadata.gz: 85c349d66339b000e6d7cb9077621b9e8d40852538d6e9eb7111947fabd0df9e11b3d2448a67609727c9fb915393ddf903140f43375be0947d5d749ffb6fb85a
+  data.tar.gz: b3774dfcbf0315c3b2fde5e145e7e0e33c3ceb23e5371aa01120ccca6f7294e7883e1f19c89dc73cdc3af2664d7b3484f0d9de5835119e862424902ee153bbc9

data/app/pb_kits/playbook/_playbook.scss

@@ -93,6 +93,10 @@
 @import 'pb_walkthrough/walkthrough';
 @import 'pb_weekday_stacked/weekday_stacked';
 @import './utilities/spacing';
+@import './utilities/cursor';
 @import './utilities/max_width';
 @import './utilities/positioning';
 @import './utilities/number_spacing';
+@import './utilities/shadow';
+@import './utilities/line_height';
+@import './utilities/display';

data/app/pb_kits/playbook/pb_background/background.test.js

@@ -0,0 +1,22 @@
+import { ensureAccessible, renderKit } from '../utilities/test-utils'
+
+import Background from './_background'
+
+const props = {
+  data: { testid: 'background' },
+  backgroundColor: null,
+}
+
+it('Should be accessible', async () => {
+  ensureAccessible(Background, props)
+})
+
+test('backgroundColor = success', () => {
+  const kit = renderKit(Background, props, { backgroundColor: 'success' })
+  expect(kit).toHaveClass('pb_background_kit pb_background_color_success')
+})
+
+test('backgroundColor = category_1', () => {
+  const kit = renderKit(Background, props, { backgroundColor: 'category_1' })
+  expect(kit).toHaveClass('pb_background_kit pb_background_color_category_1')
+})

data/app/pb_kits/playbook/pb_bar_graph/_bar_graph.jsx

@@ -24,6 +24,7 @@ type BarGraphProps = {
   legend?: boolean,
   toggleLegendClick?: boolean,
   height?: string,
+  colors: array,
 }
 
 export default class BarGraph extends React.Component<BarGraphProps> {
@@ -50,11 +51,13 @@ export default class BarGraph extends React.Component<BarGraphProps> {
       legend,
       height,
       toggleLegendClick,
+      colors  = [],
     } = this.props
 
     new pbChart(`.${className}`, {
       axisTitle: axisTitle,
       chartData: chartData,
+      colors: colors,
       id: id,
       pointStart: pointStart,
       subtitle: subTitle,

data/app/pb_kits/playbook/pb_bar_graph/bar_graph.rb

@@ -21,6 +21,8 @@ module Playbook
       prop :toggle_legend_click, type: Playbook::Props::Boolean,
                                  default: true
       prop :height
+      prop :colors, type: Playbook::Props::Array,
+                    default: []
 
       def chart_type
         orientation == "horizontal" ? "bar" : "column"
@@ -42,6 +44,7 @@ module Playbook
           legend: legend,
           toggleLegendClick: toggle_legend_click,
           height: height,
+          colors: colors,
         }
       end
 

data/app/pb_kits/playbook/pb_bar_graph/docs/_bar_graph_colors.html.erb

@@ -0,0 +1,26 @@
+<% data = [{
+    name: 'Installation',
+    data: [1475,200,3000,654,656]
+}, {
+    name: 'Manufacturing',
+    data: [4434,524,2320,440,500]
+}, {
+    name: 'Sales & Distribution',
+    data: [3387,743,1344,434,440,]
+}, {
+    name: 'Project Development',
+    data: [3227,878,999,780,1000]
+}, {
+    name: 'Other',
+    data: [1111,677,3245,500,200]
+}] %>
+
+<%= pb_rails("bar_graph", props: {
+    axis_title: 'Number of Employees',
+    chart_data: data,
+    id: "bar-colors",
+    y_axis_min: 0,
+    x_axis_categories:['Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec'],
+    title: 'Bar Graph with Custom Data Colors',
+    colors: ['data-4', 'data-5', 'data-6', 'data-7', 'data-8']
+}) %>

data/app/pb_kits/playbook/pb_bar_graph/docs/_bar_graph_colors.jsx

@@ -0,0 +1,37 @@
+import React from 'react'
+
+import BarGraph from '../_bar_graph'
+
+const chartData = [{
+  name: 'Installation',
+  data: [1475, 200, 3000, 654, 656],
+}, {
+  name: 'Manufacturing',
+  data: [4434, 524, 2320, 440, 500],
+}, {
+  name: 'Sales & Distribution',
+  data: [3387, 743, 1344, 434, 440],
+}, {
+  name: 'Project Development',
+  data: [3227, 878, 999, 780, 1000],
+}, {
+  name: 'Other',
+  data: [1111, 677, 3245, 500, 200],
+}]
+
+const BarGraphColors = (props) => (
+  <div>
+    <BarGraph
+        axisTitle="Number of Employees"
+        chartData={chartData}
+        colors={['data-4', 'data-5', 'data-6', 'data-7', 'data-8']}
+        id="bar-colors"
+        title="Bar Graph with Custom Data Colors"
+        xAxisCategories={['Jan', 'Feb', 'Mar', 'Apr', 'May']}
+        yAxisMin={0}
+        {...props}
+    />
+  </div>
+)
+
+export default BarGraphColors

data/app/pb_kits/playbook/pb_bar_graph/docs/_bar_graph_colors.md

@@ -0,0 +1,2 @@
+Custom data `colors` allow for color customization to match the needs of business requirements.
+Pass the prop colors and use desired values `data-1 | data-2 | data-3 | data-4 | data-5 | data-6 | data-7 | data-8` in an array. Hex colors are also available `eg: #CA0095`

data/app/pb_kits/playbook/pb_bar_graph/docs/example.yml

@@ -6,6 +6,7 @@ examples:
   - bar_graph_legend_non_clickable: Legend Non Clickable
   - bar_graph_height: Height
   - bar_graph_spline: Spline
+  - bar_graph_colors: Color Overrides
 
 
   react:
@@ -14,3 +15,4 @@ examples:
   - bar_graph_legend_non_clickable: Legend Non Clickable
   - bar_graph_height: Height
   - bar_graph_spline: Spline
+  - bar_graph_colors: Color Overrides

data/app/pb_kits/playbook/pb_bar_graph/docs/index.js

@@ -3,3 +3,4 @@ export { default as BarGraphLegend } from './_bar_graph_legend.jsx'
 export { default as BarGraphLegendNonClickable } from './_bar_graph_legend_non_clickable.jsx'
 export { default as BarGraphHeight } from './_bar_graph_height.jsx'
 export { default as BarGraphSpline } from './_bar_graph_spline.jsx'
+export { default as BarGraphColors } from './_bar_graph_colors.jsx'

data/app/pb_kits/playbook/pb_body/_body.jsx

@@ -12,7 +12,7 @@ type BodyProps = {
   aria?: object,
   className?: string,
   children?: array<React.ReactChild>,
-  color?: 'default' | 'light' | 'lighter',
+  color?: 'default' | 'light' | 'lighter' | 'link',
   dark?: boolean,
   data?: object,
   highlightedText?: array<string>,

data/app/pb_kits/playbook/pb_body/_body_mixins.scss

@@ -6,6 +6,7 @@ $pb_body_colors: (
   default:        $text_lt_default,
   light:          $text_lt_light,
   lighter:        $text_lt_lighter,
+  link:           $primary,
 );
 
 $pb_dark_body_colors: (
@@ -63,4 +64,4 @@ $pb_body_status: (
 
 @mixin pb_body_positive {
   @include pb_body($success);
-}
+}

data/app/pb_kits/playbook/pb_body/body.rb

@@ -4,7 +4,7 @@ module Playbook
   module PbBody
     class Body < Playbook::KitBase
       prop :color, type: Playbook::Props::Enum,
-                   values: %w[default light lighter],
+                   values: %w[default light lighter link],
                    default: "default"
       prop :status, type: Playbook::Props::Enum,
                     values: %w[neutral negative positive],

data/app/pb_kits/playbook/pb_body/body.test.js

@@ -0,0 +1,29 @@
+import React from 'react'
+import { render, screen } from '../utilities/test-utils'
+
+import Body from './_body'
+
+test('returns namespaced class name', () => {
+  render(
+    <Body
+        data={{ testid: 'primary-test' }}
+        text="Test colors"
+    />
+  )
+
+  const kit = screen.getByTestId('primary-test')
+  expect(kit).toHaveClass('pb_body_kit')
+})
+
+test('with colors', () => {
+  render(
+    <Body
+        color="success"
+        data={{ testid: 'primary-test' }}
+        text="Test colors"
+    />
+  )
+
+  const kit = screen.getByTestId('primary-test')
+  expect(kit).toHaveClass('pb_body_kit_success')
+})

data/app/pb_kits/playbook/pb_body/docs/_body_light.html.erb

@@ -12,6 +12,11 @@
   color: "lighter"
 }) %>
 
+<%= pb_rails("body", props: {
+  text: "I am a body kit (Link)",
+  color: "link"
+}) %>
+
 <%= pb_rails("body", props: {
   text: "I am a body kit (Status: negative)",
   status: "negative"

data/app/pb_kits/playbook/pb_body/docs/_body_light.jsx

@@ -18,6 +18,11 @@ const BodyLight = (props) => {
           text="I am a body kit (Lighter)"
           {...props}
       />
+      <Body
+          color="link"
+          text="I am a body kit (Link)"
+          {...props}
+      />
       <Body
           status="negative"
           text="I am a body kit (Status: negative)"

data/app/pb_kits/playbook/pb_body/docs/_body_light.md

@@ -0,0 +1,6 @@
+##### Prop
+This kit uses `default` color by default, and can be replaced with colors below:
+
+* `light` `lighter` `success` `error` `link`
+
+- These colors are not for standard usage. You can use the color prop to make fixes if colors are not appearing properly, but consult your UX team members if you are deciding to implement it

data/app/pb_kits/playbook/pb_button/_button.jsx

@@ -22,7 +22,7 @@ type ButtonPropTypes = {
   loading?: boolean,
   newWindow?: boolean,
   onClick?: EventHandler,
-  size: 'large' | 'medium' | 'small',
+  size?: 'sm' | 'md' | 'lg',
   text?: string,
   type: 'inline' | null,
   htmlType: string | 'button',
@@ -36,16 +36,16 @@ const buttonClassName = (props: ButtonPropTypes) => {
     disabled = false,
     fullWidth = false,
     loading = false,
-    size = null,
     type = 'inline',
     variant = 'primary',
+    size = null,
   } = props
 
   let className = 'pb_button_kit'
 
+  className += `${size !== null ? `_${size}` : ''}`
   className += `${variant !== null ? `_${variant}` : ''}`
   className += `${type !== null ? `_${type}` : ''}`
-  className += `${size !== null ? `_${size}` : ''}`
   className += `${fullWidth ? '_block' : ''}`
   className += disabled ? '_disabled' : '_enabled'
   className += loading ? '_loading' : ''

data/app/pb_kits/playbook/pb_button/_button.scss

@@ -1,7 +1,24 @@
 @import "./button_mixins";
 
+$pb_button_sizes: (
+  "sm":   0.75rem,
+  "md":   0.875rem,
+  "lg":   1.125rem,
+);
+
 [class^=pb_button_kit]{
   @include pb_button;
+  // Size =================
+  @each $name, $size in $pb_button_sizes {
+    &[class*=_#{$name}] {
+      font-size: $size;
+      padding: calc(#{$size} / 2) calc(#{$size} * 2.42) !important;
+    }
+  }
+  &[class*=_sm] {
+    min-height: 0;
+  }
+
   // Variants =================
   &[class*=_primary]  {
     @include pb_button_primary;

data/app/pb_kits/playbook/pb_button/button.rb

@@ -18,6 +18,9 @@ module Playbook
       prop :text
       prop :type
       prop :value
+      prop :size, type: Playbook::Props::Enum,
+                  values: ["sm", "md", "lg", nil],
+                  default: nil
 
       def options
         {
@@ -44,12 +47,12 @@ module Playbook
         link ? "a" : "button"
       end
 
-    private
-
       def classname
-        generate_classname("pb_button_kit", variant, full_width_class, disabled_class, loading_class)
+        generate_classname("pb_button_kit", size, variant, full_width_class, disabled_class, loading_class)
       end
 
+    private
+
       def disabled_class
         disabled ? "disabled" : "enabled"
       end

data/app/pb_kits/playbook/pb_button/button.test.js

@@ -89,3 +89,16 @@ test('click event', async () => {
 
   expect(screen.getByText('clicked button!')).toBeInTheDocument()
 })
+
+test('size prop', () => {
+  render(
+    <Button
+        data={{ testid: 'size-test' }}
+        size="sm"
+    />
+  )
+
+  const kit = screen.getByTestId('size-test')
+
+  expect(kit).toHaveClass('pb_button_kit_sm_primary_inline_enabled')
+})

data/app/pb_kits/playbook/pb_button/docs/_button_size.html.erb

@@ -0,0 +1,3 @@
+<%= pb_rails("button", props: { text: "Button sm size", size: "sm" }) %>
+<%= pb_rails("button", props: { text: "Button md size", size: "md" }) %>
+<%= pb_rails("button", props: { text: "Button lg size", size: "lg" }) %>

data/app/pb_kits/playbook/pb_button/docs/_button_size.jsx

@@ -0,0 +1,26 @@
+import React from 'react'
+import { Button } from '../../'
+
+const ButtonSize = (props) => (
+  <div>
+    <Button
+        size="sm"
+        text="Button sm size"
+        {...props}
+    />
+    {' '}
+    <Button
+        size="md"
+        text="Button md size"
+        {...props}
+    />
+    {' '}
+    <Button
+        size="lg"
+        text="Button lg size"
+        {...props}
+    />
+  </div>
+)
+
+export default ButtonSize

data/app/pb_kits/playbook/pb_button/docs/_button_size.md

@@ -0,0 +1 @@
+By default button has the `md` size style, even if you don't explicitly pass a size prop.

data/app/pb_kits/playbook/pb_button/docs/example.yml

@@ -7,6 +7,7 @@ examples:
   - button_block_content: Button Block Content
   - button_accessibility: Button Accessibility Options
   - button_options: Button Additional Options
+  - button_size: Button Size
   react:
   - button_default: Button Variants
   - button_full_width: Button Full Width
@@ -15,3 +16,4 @@ examples:
   - button_block_content: Button Block Content
   - button_accessibility: Button Accessibility Options
   - button_options: Button Additional Options (onClick)
+  - button_size: Button Size

data/app/pb_kits/playbook/pb_button/docs/index.js

@@ -5,3 +5,4 @@ export { default as ButtonLoading } from './_button_loading.jsx'
 export { default as ButtonBlockContent } from './_button_block_content.jsx'
 export { default as ButtonAccessibility } from './_button_accessibility.jsx'
 export { default as ButtonOptions } from './_button_options.jsx'
+export { default as ButtonSize } from './_button_size.jsx'

data/app/pb_kits/playbook/pb_caption/_caption.jsx

@@ -3,41 +3,54 @@
 import React from 'react'
 import classnames from 'classnames'
 import { buildAriaProps, buildCss, buildDataProps } from '../utilities/props'
-import { globalProps } from '../utilities/globalProps.js'
+import { deprecatedProps, globalProps } from '../utilities/globalProps.js'
 
 type CaptionProps = {
   aria?: object,
-  className?: string,
   children: array<React.ReactNode> | React.ReactNode,
+  className?: string,
+  color?: "default" | "light" | "lighter" | "success" | "error" | "link",
   data?: object,
   id?: string,
   size?: "xs" | "sm" | "md" | "lg" | "xl",
   tag?: "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p" | "span" | "div" | "caption",
   text?: string,
   variant?: null | "link",
-}
+};
 
 const Caption = (props: CaptionProps) => {
+  if (props.variant) deprecatedProps('Title', ['variant']) //variant prop is deprecated, use color instead
   const {
     aria = {},
-    className,
     children,
+    className,
+    color,
     data = {},
     id,
     size = 'md',
     tag = 'div',
     text,
-    variant = null,
   } = props
-  const tagOptions = ['h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'p', 'span', 'div', 'caption']
+  const tagOptions = [
+    'h1',
+    'h2',
+    'h3',
+    'h4',
+    'h5',
+    'h6',
+    'p',
+    'span',
+    'div',
+    'caption',
+  ]
   const Tag = tagOptions.includes(tag) ? tag : 'div'
 
   const ariaProps = buildAriaProps(aria)
   const dataProps = buildDataProps(data)
   const css = classnames(
-    buildCss('pb_caption_kit', size, variant),
+    buildCss('pb_caption_kit', size, color),
     globalProps(props),
-    className
+    className,
   )
 
   return (

data/app/pb_kits/playbook/pb_caption/_caption.scss

@@ -1,19 +1,25 @@
+@import "../tokens/colors";
 @import "caption_mixin";
 
-[class^=pb_caption_kit] {
+[class^="pb_caption_kit"] {
   @include caption;
 
-  &[class^=pb_caption_kit_lg] {
+  &[class^="pb_caption_kit_lg"] {
     @include caption_lg;
   }
 
-  &[class^=pb_caption_kit_xs] {
+  &[class^="pb_caption_kit_xs"] {
     @include caption_xs;
-    &[class*=_link]  {
-      color: $primary;
-    }
   }
-  &[class*=dark]{
-    @include caption_dark
+
+  @include pb_caption_kit_colors;
+
+  &.dark {
+    @include caption_dark;
+    @each $name, $color in $pb_dark_caption_colors {
+      &[class*="_#{$name}"] {
+        color: $color;
+      }
+    }
   }
 }

data/app/pb_kits/playbook/pb_caption/_caption_mixin.scss

@@ -1,6 +1,22 @@
 @import "../tokens/colors";
 @import "../tokens/typography";
 
+$pb_caption_colors: (
+  default:        $text_lt_default,
+  light:          $text_lt_light,
+  link:           $primary,
+  lighter:        $text_lt_lighter,
+  success:        $success,
+  error:          $error,
+);
+
+$pb_dark_caption_colors: (
+  default:        $text_dk_default,
+  light:          $text_dk_light,
+  link:           $primary,
+);
+
+
 @mixin caption($font_size: $font_smaller, $font_weight: $bold) {
   font-weight: $font_weight;
   color: $text_lt_light;
@@ -9,6 +25,10 @@
   letter-spacing: $lspace_looser;
 }
 
+@mixin caption_color($color: $text_lt_light) {
+  color: $color;
+}
+
 @mixin caption_lg {
   @include caption($font_large, $regular);
 }
@@ -22,3 +42,10 @@
 @mixin caption_dark {
   color: $text_dk_light;
 }
+@mixin pb_caption_kit_colors {
+  @each $name, $color in $pb_caption_colors {
+    &[class*="#{$name}"] {
+      color: $color
+    }
+  }
+}

data/app/pb_kits/playbook/pb_caption/caption.rb

@@ -10,12 +10,14 @@ module Playbook
                  values: %w[h1 h2 h3 h4 h5 h6 p span div caption],
                  default: "div"
       prop :text
-      prop :variant, type: Playbook::Props::Enum,
-                     values: [nil, "link"],
-                     default: nil
+      prop :variant, deprecated: true
+
+      prop :color, type: Playbook::Props::Enum,
+                   values: [nil, "default", "light", "lighter", "success", "error", "link"],
+                   default: nil
 
       def classname
-        generate_classname("pb_caption_kit", size, variant)
+        generate_classname("pb_caption_kit", size, color)
       end
     end
   end

data/app/pb_kits/playbook/pb_caption/caption.test.js

@@ -0,0 +1,29 @@
+import React from 'react'
+import { render, screen } from '../utilities/test-utils'
+
+import Caption from './_caption'
+
+test('returns namespaced class name', () => {
+  render(
+    <Caption
+        data={{ testid: 'primary-test' }}
+        text="Test colors"
+    />
+  )
+
+  const kit = screen.getByTestId('primary-test')
+  expect(kit).toHaveClass('pb_caption_kit_md')
+})
+
+test('with colors', () => {
+  render(
+    <Caption
+        color="success"
+        data={{ testid: 'primary-test' }}
+        text="Test colors"
+    />
+  )
+
+  const kit = screen.getByTestId('primary-test')
+  expect(kit).toHaveClass('pb_caption_kit_md_success')
+})

data/app/pb_kits/playbook/pb_caption/docs/_caption_colors.html.erb

@@ -0,0 +1,3 @@
+<%= pb_rails("caption", props: { text: "Test colors" }) %>
+<%= pb_rails("caption", props: { text: "Test colors", color: "success" }) %>
+<%= pb_rails("caption", props: { text: "Test colors", color: "link" }) %>

data/app/pb_kits/playbook/pb_caption/docs/_caption_colors.jsx

@@ -0,0 +1,25 @@
+import React from 'react'
+import { Caption } from '../../'
+
+const CaptionColors = (props) => {
+  return (
+    <div>
+      <Caption
+          text="Test colors"
+          {...props}
+      />
+      <Caption
+          color="success"
+          text="Test colors"
+          {...props}
+      />
+      <Caption
+          color="link"
+          text="Test colors"
+          {...props}
+      />
+    </div>
+  )
+}
+
+export default CaptionColors

data/app/pb_kits/playbook/pb_caption/docs/_caption_colors.md

@@ -0,0 +1,6 @@
+##### Prop
+Caption kit will use `light` color by default. Other available colors are: 
+
+* `default` `lighter` `success` `error` `link`
+
+- These colors are not for standard usage. You can use the color prop to make fixes if colors are not appearing properly, but consult your UX team members if you are deciding to implement it